@georgedong32/ccs 7.66.0

package/dist/config/unified-config-types.d.ts

@@ -0,0 +1,733 @@
+/**
+ * Unified Config Types for CCS v2
+ *
+ * This file defines the new unified YAML configuration format that consolidates:
+ * - config.json (API profiles)
+ * - profiles.json (account metadata)
+ * - *.settings.json (env vars)
+ *
+ * Into a single config.yaml structure.
+ */
+import type { TargetType } from '../targets/target-adapter';
+import type { CLIProxyProvider } from '../cliproxy/types';
+/**
+ * Unified config version.
+ * Version 2 = YAML unified format
+ * Version 3 = WebSearch config with model configuration for Gemini/OpenCode
+ * Version 4 = Copilot API integration (GitHub Copilot proxy)
+ * Version 5 = Remote proxy configuration (connect to remote CLIProxyAPI)
+ * Version 6 = Customizable auth tokens (API key and management secret)
+ * Version 7 = Quota management for hybrid auto+manual account control
+ * Version 8 = Thinking/reasoning budget configuration
+ * Version 9 = Real WebSearch backends (DuckDuckGo/Brave) with legacy CLI fallback
+ * Version 10 = Exa + Tavily WebSearch backends
+ * Version 11 = Discord Channels runtime auto-enable preferences
+ * Version 12 = Official Channels multi-provider support (Telegram, Discord, iMessage)
+ */
+export declare const UNIFIED_CONFIG_VERSION = 12;
+/**
+ * Supported CLIProxy providers.
+ * Derived from CLIPROXY_PROVIDER_IDS — single source of truth in provider-capabilities.ts.
+ */
+export declare const CLIPROXY_SUPPORTED_PROVIDERS: readonly CLIProxyProvider[];
+/**
+ * Account configuration (formerly in profiles.json).
+ * Represents an isolated Claude instance via CLAUDE_CONFIG_DIR.
+ */
+export interface AccountConfig {
+    /** ISO timestamp when account was created */
+    created: string;
+    /** ISO timestamp of last usage, null if never used */
+    last_used: string | null;
+    /** Context mode for project workspace data */
+    context_mode?: 'isolated' | 'shared';
+    /** Context-sharing group when context_mode='shared' */
+    context_group?: string;
+    /** Shared continuity depth when context_mode='shared' */
+    continuity_mode?: 'standard' | 'deeper';
+    /** Bare profile: no shared symlinks (commands, skills, agents, settings.json) */
+    bare?: boolean;
+}
+/**
+ * API-based profile configuration.
+ * Injects environment variables for alternative providers (GLM, Kimi, etc.).
+ *
+ * Settings are stored in separate *.settings.json files (matching Claude's pattern)
+ * to allow users to edit them directly without touching config.yaml.
+ */
+export interface ProfileConfig {
+    /** Profile type - currently only 'api' */
+    type: 'api';
+    /** Path to settings file (e.g., "~/.ccs/glm.settings.json") */
+    settings: string;
+    /** Target CLI to use for this profile (default: 'claude') */
+    target?: TargetType;
+}
+/**
+ * CLIProxy OAuth account nickname mapping.
+ * Maps user-friendly nicknames to email addresses.
+ */
+export type OAuthAccounts = Record<string, string>;
+/**
+ * CLIProxy variant configuration.
+ * User-defined variants of built-in OAuth providers.
+ *
+ * Settings are stored in separate *.settings.json files (matching Claude's pattern)
+ * to allow users to edit them directly without touching config.yaml.
+ */
+export interface CLIProxyVariantConfig {
+    /** Base provider to use */
+    provider: CLIProxyProvider;
+    /** Account nickname (references oauth_accounts) */
+    account?: string;
+    /** Path to settings file (e.g., "~/.ccs/gemini-custom.settings.json") */
+    settings?: string;
+    /** Unique port for variant isolation (8318-8417) */
+    port?: number;
+    /** Per-variant auth override (optional) */
+    auth?: CLIProxyAuthConfig;
+    /** Target CLI to use for this variant (default: 'claude') */
+    target?: TargetType;
+}
+/**
+ * Per-tier provider+model mapping for composite variants.
+ */
+export interface CompositeTierConfig {
+    /** Provider for this tier */
+    provider: CLIProxyProvider;
+    /** Model ID to use for this tier */
+    model: string;
+    /** Account nickname (optional, references oauth_accounts) */
+    account?: string;
+    /** Fallback provider+model if primary fails */
+    fallback?: {
+        provider: CLIProxyProvider;
+        model: string;
+        account?: string;
+    };
+    /** Per-tier thinking budget override (e.g. 'xhigh', 'medium', 'off') */
+    thinking?: string;
+}
+/**
+ * Composite variant configuration.
+ * Mixes different providers per Claude tier (opus, sonnet, haiku) in a single profile.
+ * Uses CLIProxyAPI root endpoints (/v1/messages) for model-based routing
+ * instead of provider-specific endpoints (/api/provider/{provider}).
+ */
+export interface CompositeVariantConfig {
+    /** Discriminator for composite type */
+    type: 'composite';
+    /** Which tier ANTHROPIC_MODEL equals (default must be one of the three) */
+    default_tier: 'opus' | 'sonnet' | 'haiku';
+    /** Per-tier provider+model mapping */
+    tiers: {
+        opus: CompositeTierConfig;
+        sonnet: CompositeTierConfig;
+        haiku: CompositeTierConfig;
+    };
+    /** Path to settings file */
+    settings?: string;
+    /** Shared port for the composite profile */
+    port?: number;
+    /** Per-variant auth override (optional) */
+    auth?: CLIProxyAuthConfig;
+    /** Target CLI to use for this composite variant (default: 'claude') */
+    target?: TargetType;
+}
+/**
+ * CLIProxy authentication configuration.
+ * Allows customization of API key and management secret for CLIProxyAPI.
+ */
+export interface CLIProxyAuthConfig {
+    /** API key for CCS-managed requests (default: 'ccs-internal-managed') */
+    api_key?: string;
+    /** Management secret for Control Panel login (default: 'ccs') */
+    management_secret?: string;
+}
+/**
+ * CLIProxy logging configuration.
+ * Controls whether CLIProxyAPI writes logs to disk.
+ * Logs can grow to several GB if left enabled.
+ */
+export interface CLIProxyLoggingConfig {
+    /** Enable logging to file (default: false to prevent disk bloat) */
+    enabled?: boolean;
+    /** Enable request logging for debugging (default: false) */
+    request_log?: boolean;
+}
+/**
+ * CLIProxy safety configuration.
+ * Controls high-risk flow safeguards for supported providers.
+ */
+export interface CLIProxySafetyConfig {
+    /** Allow skipping AGY responsibility checks and Gemini dashboard typed acknowledgement */
+    antigravity_ack_bypass?: boolean;
+}
+/**
+ * Default CLIProxy safety configuration.
+ */
+export declare const DEFAULT_CLIPROXY_SAFETY_CONFIG: CLIProxySafetyConfig;
+/**
+ * Token refresh configuration.
+ * Manages background token refresh worker settings.
+ */
+export interface TokenRefreshSettings {
+    /** Enable background token refresh (default: false) */
+    enabled?: boolean;
+    /** Refresh check interval in minutes (default: 30) */
+    interval_minutes?: number;
+    /** Preemptive refresh time in minutes (default: 45) */
+    preemptive_minutes?: number;
+    /** Maximum retry attempts per token (default: 3) */
+    max_retries?: number;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/**
+ * CLIProxy configuration section.
+ */
+export interface CLIProxyConfig {
+    /** Backend selection: 'original' or 'plus' (default: 'plus') */
+    backend?: 'original' | 'plus';
+    /** Nickname to email mapping for OAuth accounts */
+    oauth_accounts: OAuthAccounts;
+    /** Built-in providers (read-only, for reference) */
+    providers: readonly string[];
+    /** User-defined provider variants (single-provider or composite) */
+    variants: Record<string, CLIProxyVariantConfig | CompositeVariantConfig>;
+    /** Logging configuration (disabled by default) */
+    logging?: CLIProxyLoggingConfig;
+    /** Safety controls for high-risk provider flows */
+    safety?: CLIProxySafetyConfig;
+    /** Kiro: disable incognito browser mode (use normal browser to save credentials) */
+    kiro_no_incognito?: boolean;
+    /** Global auth configuration for CLIProxyAPI */
+    auth?: CLIProxyAuthConfig;
+    /** Background token refresh worker settings */
+    token_refresh?: TokenRefreshSettings;
+    /** Auto-sync API profiles to local CLIProxy config on settings change (default: true) */
+    auto_sync?: boolean;
+}
+/**
+ * User preferences.
+ */
+export interface PreferencesConfig {
+    /** UI theme preference */
+    theme?: 'light' | 'dark' | 'system';
+    /** Enable anonymous telemetry */
+    telemetry?: boolean;
+    /** Enable automatic update checks */
+    auto_update?: boolean;
+}
+/**
+ * DuckDuckGo WebSearch configuration.
+ */
+export interface DuckDuckGoWebSearchConfig {
+    /** Enable DuckDuckGo HTML search fallback (default: true) */
+    enabled?: boolean;
+    /** Number of results to fetch (default: 5) */
+    max_results?: number;
+}
+/**
+ * Brave WebSearch configuration.
+ */
+export interface BraveWebSearchConfig {
+    /** Enable Brave Search when BRAVE_API_KEY is available (default: false) */
+    enabled?: boolean;
+    /** Number of results to fetch (default: 5) */
+    max_results?: number;
+}
+/**
+ * Exa WebSearch configuration.
+ */
+export interface ExaWebSearchConfig {
+    /** Enable Exa Search when EXA_API_KEY is available (default: false) */
+    enabled?: boolean;
+    /** Number of results to fetch (default: 5) */
+    max_results?: number;
+}
+/**
+ * Tavily WebSearch configuration.
+ */
+export interface TavilyWebSearchConfig {
+    /** Enable Tavily Search when TAVILY_API_KEY is available (default: false) */
+    enabled?: boolean;
+    /** Number of results to fetch (default: 5) */
+    max_results?: number;
+}
+/**
+ * Gemini CLI WebSearch configuration.
+ */
+export interface GeminiWebSearchConfig {
+    /** Enable Gemini CLI legacy fallback (default: false) */
+    enabled?: boolean;
+    /** Model to use (default: gemini-2.5-flash) */
+    model?: string;
+    /** Timeout in seconds (default: 55) */
+    timeout?: number;
+}
+/**
+ * Grok CLI WebSearch configuration.
+ */
+export interface GrokWebSearchConfig {
+    /** Enable Grok CLI legacy fallback (default: false - requires GROK_API_KEY) */
+    enabled?: boolean;
+    /** Timeout in seconds (default: 55) */
+    timeout?: number;
+}
+/**
+ * OpenCode CLI WebSearch configuration.
+ */
+export interface OpenCodeWebSearchConfig {
+    /** Enable OpenCode CLI legacy fallback (default: false) */
+    enabled?: boolean;
+    /** Model to use (default: opencode/grok-code) */
+    model?: string;
+    /** Timeout in seconds (default: 60) */
+    timeout?: number;
+}
+/**
+ * WebSearch providers configuration.
+ * Uses deterministic search backends first, with optional legacy CLI fallback.
+ */
+export interface WebSearchProvidersConfig {
+    /** Exa Search API - API-backed search with strong relevance and content extraction */
+    exa?: ExaWebSearchConfig;
+    /** Tavily Search API - API-backed search optimized for agent/tool usage */
+    tavily?: TavilyWebSearchConfig;
+    /** DuckDuckGo HTML search - zero setup default backend */
+    duckduckgo?: DuckDuckGoWebSearchConfig;
+    /** Brave Search API - higher quality results when BRAVE_API_KEY is set */
+    brave?: BraveWebSearchConfig;
+    /** Gemini CLI - optional legacy LLM fallback */
+    gemini?: GeminiWebSearchConfig;
+    /** Grok CLI - optional legacy LLM fallback */
+    grok?: GrokWebSearchConfig;
+    /** OpenCode - optional legacy LLM fallback */
+    opencode?: OpenCodeWebSearchConfig;
+}
+/**
+ * Copilot API account type.
+ */
+export type CopilotAccountType = 'individual' | 'business' | 'enterprise';
+/**
+ * Copilot API configuration.
+ * Enables GitHub Copilot subscription usage via copilot-api proxy.
+ * Strictly opt-in - disabled by default.
+ *
+ * !! DISCLAIMER - USE AT YOUR OWN RISK !!
+ * This uses an UNOFFICIAL reverse-engineered API.
+ * Excessive usage may trigger GitHub account restrictions.
+ * CCS provides NO WARRANTY and accepts NO RESPONSIBILITY for any consequences.
+ */
+export interface CopilotConfig {
+    /** Enable Copilot integration (default: false) - must be explicitly enabled */
+    enabled: boolean;
+    /** Auto-start copilot-api daemon when using profile (default: false) */
+    auto_start: boolean;
+    /** Port for copilot-api proxy (default: 4141) */
+    port: number;
+    /** GitHub Copilot account type (default: individual) */
+    account_type: CopilotAccountType;
+    /** Rate limit in seconds between requests (null = no limit) */
+    rate_limit: number | null;
+    /** Wait instead of error when rate limit is hit (default: true) */
+    wait_on_limit: boolean;
+    /** Default model ID (e.g., claude-sonnet-4.5) */
+    model: string;
+    /** Model mapping for Claude tiers - maps opus/sonnet/haiku to specific models */
+    opus_model?: string;
+    sonnet_model?: string;
+    haiku_model?: string;
+}
+/**
+ * Cursor IDE integration configuration.
+ * Enables Cursor IDE usage via cursor proxy daemon.
+ */
+export interface CursorConfig {
+    /** Enable Cursor integration (default: false) */
+    enabled: boolean;
+    /** Port for cursor proxy daemon (default: 20129) */
+    port: number;
+    /** Auto-start daemon when CCS starts (default: false) */
+    auto_start: boolean;
+    /** Enable ghost mode to disable telemetry (default: true) */
+    ghost_mode: boolean;
+    /** Default model ID used by Cursor integration */
+    model: string;
+    /** Optional tier mapping for Claude-compatible model routing */
+    opus_model?: string;
+    /** Optional tier mapping for Claude-compatible model routing */
+    sonnet_model?: string;
+    /** Optional tier mapping for Claude-compatible model routing */
+    haiku_model?: string;
+}
+/**
+ * Remote proxy configuration.
+ * Connect to a remote CLIProxyAPI instance instead of spawning local binary.
+ */
+export interface ProxyRemoteConfig {
+    /** Enable remote proxy mode (default: false = local mode) */
+    enabled: boolean;
+    /** Remote proxy hostname or IP (empty = not configured) */
+    host: string;
+    /**
+     * Remote proxy port.
+     * Optional - defaults based on protocol:
+     * - HTTPS: 443
+     * - HTTP: 8317
+     * When empty/undefined, uses protocol default.
+     */
+    port?: number;
+    /** Protocol for remote connection */
+    protocol: 'http' | 'https';
+    /** Auth token for remote proxy API endpoints (optional, sent as header) */
+    auth_token: string;
+    /**
+     * Management key for remote proxy management API endpoints.
+     * CLIProxyAPI uses separate authentication for management endpoints
+     * (/v0/management/*) via 'secret-key' config.
+     * If not set, falls back to auth_token for backwards compatibility.
+     */
+    management_key?: string;
+    /** Connection timeout in milliseconds (default: 2000) */
+    timeout?: number;
+    /** Enable auto-sync profiles to remote on settings change (default: false) */
+    auto_sync?: boolean;
+}
+/**
+ * Fallback configuration when remote proxy is unreachable.
+ */
+export interface ProxyFallbackConfig {
+    /** Enable fallback to local proxy (default: true) */
+    enabled: boolean;
+    /** Auto-start local proxy without prompting (default: false = prompt user) */
+    auto_start: boolean;
+}
+/**
+ * Local proxy configuration.
+ */
+export interface ProxyLocalConfig {
+    /** Local proxy port (default: 8317) */
+    port: number;
+    /** Auto-start local binary (default: true) */
+    auto_start: boolean;
+}
+/**
+ * CLIProxy server configuration section.
+ * Controls whether CCS uses local or remote CLIProxyAPI instance.
+ */
+export interface CliproxyServerConfig {
+    /** Remote proxy settings */
+    remote: ProxyRemoteConfig;
+    /** Fallback behavior when remote is unreachable */
+    fallback: ProxyFallbackConfig;
+    /** Local proxy settings */
+    local: ProxyLocalConfig;
+}
+/**
+ * Global environment variables configuration.
+ * These env vars are injected into ALL non-Claude subscription profiles.
+ * Useful for disabling telemetry, bug commands, error reporting, etc.
+ */
+export interface GlobalEnvConfig {
+    /** Enable global env injection (default: true) */
+    enabled: boolean;
+    /** Environment variables to inject */
+    env: Record<string, string>;
+}
+/**
+ * Cross-profile continuity inheritance configuration.
+ * Maps execution profile names to source account profiles for CLAUDE_CONFIG_DIR reuse.
+ */
+export interface ContinuityConfig {
+    /** Profile name -> source account profile name */
+    inherit_from_account?: Record<string, string>;
+}
+/**
+ * Default global env vars for third-party profiles.
+ * These disable Claude Code telemetry/reporting since we're using proxy.
+ */
+export declare const DEFAULT_GLOBAL_ENV: Record<string, string>;
+/**
+ * WebSearch configuration.
+ * Uses deterministic local backends for third-party profiles.
+ * Legacy AI CLI fallbacks remain available for compatibility only.
+ */
+export interface WebSearchConfig {
+    /** Master switch - enable/disable WebSearch (default: true) */
+    enabled?: boolean;
+    /** Individual provider configurations */
+    providers?: WebSearchProvidersConfig;
+    /** @deprecated Use providers.gemini instead */
+    gemini?: {
+        enabled?: boolean;
+        timeout?: number;
+    };
+    /** @deprecated Unused */
+    mode?: 'sequential' | 'parallel';
+    /** @deprecated Unused */
+    provider?: 'auto' | 'web-search-prime' | 'brave' | 'tavily';
+    /** @deprecated Unused */
+    fallback?: boolean;
+    /** @deprecated Unused */
+    webSearchPrimeUrl?: string;
+    /** @deprecated Unused */
+    selectedProviders?: string[];
+    /** @deprecated Unused */
+    customMcp?: unknown[];
+}
+/**
+ * Auto quota management configuration.
+ * Controls automatic failover behavior.
+ */
+export interface AutoQuotaConfig {
+    /** Enable pre-flight quota check before requests (default: true) */
+    preflight_check: boolean;
+    /** Quota percentage below which account is "exhausted" (default: 5) */
+    exhaustion_threshold: number;
+    /** Tier priority for failover, highest to lowest (default: ['paid']) */
+    tier_priority: string[];
+    /** Minutes to skip exhausted account before retry (default: 5) */
+    cooldown_minutes: number;
+}
+/**
+ * Runtime quota monitor configuration.
+ * Controls adaptive polling during active sessions.
+ */
+export interface RuntimeMonitorConfig {
+    /** Enable runtime monitoring during sessions (default: true) */
+    enabled: boolean;
+    /** Poll interval in seconds when quota > warn_threshold (default: 300) */
+    normal_interval_seconds: number;
+    /** Poll interval in seconds when quota <= warn_threshold (default: 60) */
+    critical_interval_seconds: number;
+    /** Quota percentage that triggers fast polling + warning (default: 20) */
+    warn_threshold: number;
+    /** Quota percentage that triggers cooldown + switch (default: 5) */
+    exhaustion_threshold: number;
+    /** Minutes to cooldown exhausted account (default: 5) */
+    cooldown_minutes: number;
+}
+/**
+ * Manual quota management configuration.
+ * User-controlled overrides for account selection.
+ */
+export interface ManualQuotaConfig {
+    /** User-paused accounts (stored in accounts.json) */
+    paused_accounts: string[];
+    /** Force use of specific account (overrides auto-selection) */
+    forced_default: string | null;
+    /** Lock to specific tier only */
+    tier_lock: string | null;
+}
+/**
+ * Quota management mode.
+ * - auto: Fully automatic failover based on quota
+ * - manual: User controls everything, no auto-switching
+ * - hybrid: Auto-failover with user overrides (default)
+ */
+export type QuotaManagementMode = 'auto' | 'manual' | 'hybrid';
+/**
+ * Quota management configuration section.
+ * Controls hybrid auto+manual account selection for multi-account setups.
+ */
+export interface QuotaManagementConfig {
+    /** Management mode (default: hybrid) */
+    mode: QuotaManagementMode;
+    /** Auto mode settings */
+    auto: AutoQuotaConfig;
+    /** Manual mode settings */
+    manual: ManualQuotaConfig;
+    /** Runtime monitor settings */
+    runtime_monitor: RuntimeMonitorConfig;
+}
+/**
+ * Default auto quota configuration.
+ */
+export declare const DEFAULT_AUTO_QUOTA_CONFIG: AutoQuotaConfig;
+/**
+ * Default manual quota configuration.
+ */
+export declare const DEFAULT_MANUAL_QUOTA_CONFIG: ManualQuotaConfig;
+/**
+ * Default runtime monitor configuration.
+ */
+export declare const DEFAULT_RUNTIME_MONITOR_CONFIG: RuntimeMonitorConfig;
+/**
+ * Default quota management configuration.
+ */
+export declare const DEFAULT_QUOTA_MANAGEMENT_CONFIG: QuotaManagementConfig;
+/**
+ * Thinking mode for auto/manual/off control.
+ * - auto: Apply tier-based defaults (opus→high, sonnet→medium, haiku→low)
+ * - off: Disable thinking entirely
+ * - manual: Use explicit override value
+ */
+export type ThinkingMode = 'auto' | 'off' | 'manual';
+/**
+ * Tier-to-thinking level defaults.
+ * Maps Claude tier names to thinking level names.
+ */
+export interface ThinkingTierDefaults {
+    /** Thinking level for opus tier (default: 'high') */
+    opus: string;
+    /** Thinking level for sonnet tier (default: 'medium') */
+    sonnet: string;
+    /** Thinking level for haiku tier (default: 'low') */
+    haiku: string;
+}
+/**
+ * Thinking configuration section.
+ * Controls thinking/reasoning budget injection for CLIProxy providers.
+ */
+export interface ThinkingConfig {
+    /** Thinking mode (default: 'auto') */
+    mode: ThinkingMode;
+    /** Manual override value (level name or budget number) */
+    override?: string | number;
+    /** Tier-to-level mapping */
+    tier_defaults: ThinkingTierDefaults;
+    /** Per-provider overrides (e.g., { gemini: { opus: 'high' } }) */
+    provider_overrides?: Record<string, Partial<ThinkingTierDefaults>>;
+    /** Show warning when values are clamped (default: true) */
+    show_warnings?: boolean;
+}
+/**
+ * Default thinking tier defaults.
+ */
+export declare const DEFAULT_THINKING_TIER_DEFAULTS: ThinkingTierDefaults;
+/**
+ * Default thinking configuration.
+ */
+export declare const DEFAULT_THINKING_CONFIG: ThinkingConfig;
+/**
+ * Supported Anthropic official channel IDs.
+ */
+export type OfficialChannelId = 'telegram' | 'discord' | 'imessage';
+/**
+ * Official Channels configuration.
+ * Controls runtime-only injection of Anthropic's official channel plugins.
+ */
+export interface OfficialChannelsConfig {
+    /** Selected official channels to auto-enable for compatible sessions */
+    selected: OfficialChannelId[];
+    /** Also add --dangerously-skip-permissions when auto-enable is active */
+    unattended: boolean;
+}
+/**
+ * Default Official Channels configuration.
+ * Disabled by default because the feature requires explicit user setup.
+ */
+export declare const DEFAULT_OFFICIAL_CHANNELS_CONFIG: OfficialChannelsConfig;
+/**
+ * Dashboard authentication configuration.
+ * Optional login protection for CCS dashboard.
+ * Disabled by default for backward compatibility.
+ */
+export interface DashboardAuthConfig {
+    /** Enable dashboard authentication (default: false) */
+    enabled: boolean;
+    /** Username for dashboard login */
+    username: string;
+    /** Bcrypt-hashed password (use: npx bcrypt-cli hash 'password') */
+    password_hash: string;
+    /** Session timeout in hours (default: 24) */
+    session_timeout_hours?: number;
+}
+/**
+ * Default dashboard auth configuration.
+ * Disabled by default - must be explicitly enabled.
+ */
+export declare const DEFAULT_DASHBOARD_AUTH_CONFIG: DashboardAuthConfig;
+/**
+ * Image analysis configuration.
+ * Routes image/PDF files through CLIProxy for vision analysis.
+ */
+export interface ImageAnalysisConfig {
+    /** Enable image analysis via CLIProxy (default: true) */
+    enabled: boolean;
+    /** Timeout in seconds (default: 60) */
+    timeout: number;
+    /** Provider-to-model mapping for vision analysis */
+    provider_models: Record<string, string>;
+    /** Fallback backend used when a profile does not resolve to a provider-specific backend */
+    fallback_backend?: string;
+    /** Explicit profile-name-to-backend overrides for settings/custom aliases */
+    profile_backends?: Record<string, string>;
+}
+/**
+ * Default image analysis configuration.
+ * Enabled by default for CLIProxy providers with vision support.
+ */
+export declare const DEFAULT_IMAGE_ANALYSIS_CONFIG: ImageAnalysisConfig;
+/**
+ * Main unified configuration structure.
+ * Stored in ~/.ccs/config.yaml
+ */
+export interface UnifiedConfig {
+    /** Config version (7 for quota management) */
+    version: number;
+    /** Flag indicating setup wizard has been completed */
+    setup_completed?: boolean;
+    /** Default profile name to use when none specified */
+    default?: string;
+    /** Account-based profiles (isolated Claude instances) */
+    accounts: Record<string, AccountConfig>;
+    /** API-based profiles (env var injection) */
+    profiles: Record<string, ProfileConfig>;
+    /** CLIProxy configuration */
+    cliproxy: CLIProxyConfig;
+    /** User preferences */
+    preferences: PreferencesConfig;
+    /** WebSearch configuration */
+    websearch?: WebSearchConfig;
+    /** Global environment variables for all non-Claude subscription profiles */
+    global_env?: GlobalEnvConfig;
+    /** Cross-profile continuity inheritance mapping */
+    continuity?: ContinuityConfig;
+    /** Copilot API configuration (GitHub Copilot proxy) */
+    copilot?: CopilotConfig;
+    /** Cursor IDE configuration (Cursor proxy daemon) */
+    cursor?: CursorConfig;
+    /** CLIProxy server configuration for remote/local mode */
+    cliproxy_server?: CliproxyServerConfig;
+    /** Quota management configuration (v7+) */
+    quota_management?: QuotaManagementConfig;
+    /** Thinking/reasoning budget configuration (v8+) */
+    thinking?: ThinkingConfig;
+    /** Discord Channels runtime auto-enable preferences (v11+) */
+    channels?: OfficialChannelsConfig;
+    /** Dashboard authentication configuration (optional) */
+    dashboard_auth?: DashboardAuthConfig;
+    /** Image analysis configuration (vision via CLIProxy) */
+    image_analysis?: ImageAnalysisConfig;
+}
+/**
+ * Default Copilot configuration.
+ * Strictly opt-in - disabled by default.
+ * Uses gpt-4.1 as default model (free tier compatible).
+ */
+export declare const DEFAULT_COPILOT_CONFIG: CopilotConfig;
+/**
+ * Default Cursor configuration.
+ * Disabled by default, ghost mode enabled for privacy.
+ */
+export declare const DEFAULT_CURSOR_CONFIG: CursorConfig;
+/**
+ * Default CLIProxy server configuration.
+ * Local mode by default - remote must be explicitly enabled.
+ * Port is optional for remote - defaults based on protocol.
+ */
+export declare const DEFAULT_CLIPROXY_SERVER_CONFIG: CliproxyServerConfig;
+/**
+ * Create an empty unified config with defaults.
+ */
+export declare function createEmptyUnifiedConfig(): UnifiedConfig;
+/**
+ * Type guard for UnifiedConfig.
+ * Relaxed validation: accepts configs with version >= 1 and any subset of sections.
+ * Missing sections will be filled with defaults during merge.
+ */
+export declare function isUnifiedConfig(obj: unknown): obj is UnifiedConfig;
+//# sourceMappingURL=unified-config-types.d.ts.map