@lingxiao-office/sdk 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,1225 @@
+import { z } from 'zod';
+/**
+ * 配置系统 v3
+ *
+ * 核心原则：
+ * - 所有模型通过 model_providers 管理，每个 id 全局唯一
+ * - leader_model / agent_model 必须是 model_providers 里存在的 id
+ * - 不再有全局 provider 凭据/地址回退
+ * - credentials 存放 envKey → apiKey 映射
+ *
+ * settings.json 格式（v3）：
+ * {
+ *   "version": 3,
+ *   "credentials": { "mykey": "sk-xxx" },
+ *   "llm": {
+ *     "leader_model": "my-model-id",
+ *     "agent_model": "my-model-id",
+ *     "model_providers": {
+ *       "openai": [{ "id": "my-model-id", "envKey": "mykey", "baseUrl": "https://...", "provider": "openai" }]
+ *     }
+ *   }
+ * }
+ */
+export declare const CONFIG_DIR: string;
+export declare const SETTINGS_FILE: string;
+export declare const CACHE_DIR: string;
+export declare const GLOBAL_SKILLS_DIR: string;
+export type LLMProvider = 'openai' | 'anthropic' | 'auto';
+export interface ModelCapabilities {
+    thinking_mode?: string;
+    param_name?: string;
+    param_value?: unknown;
+    contextWindowSize?: number;
+    max_output_tokens?: number;
+    modalities?: import('./llm/types.js').InputModalities;
+}
+export interface ModelGenerationConfig {
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    timeout?: number;
+    maxRetries?: number;
+    extra_body?: Record<string, unknown>;
+}
+export interface ModelPricingConfig {
+    inputPerMToken: number;
+    outputPerMToken: number;
+    cacheReadPerMToken?: number;
+    cacheCreationPerMToken?: number;
+}
+export interface ModelProviderConfig {
+    id: string;
+    name?: string;
+    /** 实际发送给 API 的模型名（如 deepseek-v4-pro），未设置时回退到 id */
+    model?: string;
+    description?: string;
+    apiKey: string;
+    envKey?: string;
+    baseUrl: string;
+    provider: 'openai' | 'anthropic';
+    /** OpenAI-compatible wire protocol for external Codex/Responses drivers. */
+    wireApi?: 'chat' | 'responses';
+    /** Codex/OpenAI Responses: disable server-side response storage. */
+    disableResponseStorage?: boolean;
+    /** Codex CLI network access policy passthrough. */
+    networkAccess?: 'enabled' | 'disabled' | 'restricted';
+    /** 上下文窗口大小（token 数），默认 200K（200000） */
+    contextWindowSize?: number;
+    generationConfig?: ModelGenerationConfig;
+    capabilities?: ModelCapabilities;
+    pricing?: ModelPricingConfig;
+}
+export type ModelProvidersConfig = {
+    [provider: string]: ModelProviderConfig[];
+};
+export interface RuntimeModelSnapshot {
+    snapshotId: string;
+    provider: 'openai' | 'anthropic';
+    modelId: string;
+    /** 实际发送给 API 的模型名（如 deepseek-v4-pro），未设置时回退到 modelId */
+    model?: string;
+    apiKey: string;
+    baseUrl: string;
+    generationConfig?: ModelGenerationConfig;
+    capabilities?: ModelCapabilities;
+    pricing?: ModelPricingConfig;
+}
+export type ConfigSourceType = 'modelProvider' | 'env' | 'settings' | 'default';
+export type ConfigSourceOld = 'default' | 'env' | 'file' | 'override';
+export interface ConfigSource {
+    type: ConfigSourceType;
+    path: string;
+    value: unknown;
+}
+export type ConfigSources = Record<string, ConfigSource>;
+export interface ModelCapability {
+    thinking_mode: string;
+    param_name: string;
+    param_value: unknown;
+}
+declare const MarketplaceSourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        mcp_registry: "mcp_registry";
+        skill_index: "skill_index";
+        plugin_index: "plugin_index";
+    }>;
+    url: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    official: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const McpServerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    transport: z.ZodLiteral<"streamable-http">;
+    url: z.ZodString;
+    headers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    registry: z.ZodOptional<z.ZodObject<{
+        source_id: z.ZodOptional<z.ZodString>;
+        server_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    origin: z.ZodOptional<z.ZodObject<{
+        plugin_id: z.ZodOptional<z.ZodString>;
+        plugin_version: z.ZodOptional<z.ZodString>;
+        plugin_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    installed_at: z.ZodOptional<z.ZodNumber>;
+    updated_at: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    transport: z.ZodLiteral<"stdio">;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    registry: z.ZodOptional<z.ZodObject<{
+        source_id: z.ZodOptional<z.ZodString>;
+        server_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    origin: z.ZodOptional<z.ZodObject<{
+        plugin_id: z.ZodOptional<z.ZodString>;
+        plugin_version: z.ZodOptional<z.ZodString>;
+        plugin_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    installed_at: z.ZodOptional<z.ZodNumber>;
+    updated_at: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "transport">;
+export type MarketplaceSourceConfig = z.infer<typeof MarketplaceSourceSchema>;
+export type McpServerConfig = z.infer<typeof McpServerConfigSchema>;
+declare const UserToolParameterSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+}, z.core.$strip>;
+export declare const UserToolSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    kind: z.ZodEnum<{
+        python: "python";
+        http: "http";
+        shell: "shell";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodDefault<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strip>>>;
+    http: z.ZodOptional<z.ZodObject<{
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+            PATCH: "PATCH";
+            HEAD: "HEAD";
+        }>>;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body_template: z.ZodOptional<z.ZodString>;
+        json_template: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    shell: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    python: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    created_at: z.ZodOptional<z.ZodNumber>;
+    updated_at: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UserToolSpec = z.infer<typeof UserToolSpecSchema>;
+export type UserToolParameter = z.infer<typeof UserToolParameterSchema>;
+/**
+ * Roles group — Agent 角色与工具配置
+ *
+ * 所有内置角色默认带"基础工具集"（read/write/搜索/python/shell/structured_patch）。
+ * 这里允许用户细化：
+ *   - basic_tools_enabled: false 时关闭所有角色的基础工具补齐（角色 tools 退回每个 profile 自身定义）
+ *   - overrides[name].tools_added / tools_removed：在最终 tools 上加 / 减
+ *
+ * 历史背景：用户反馈 ux_designer 派活时缺 file_create 被迫重派，
+ * 决定全角色统一基础工具集，并把这一开关搬到 settings.json 让 leader 统一感知。
+ */
+declare const RoleOverrideSchema: z.ZodObject<{
+    tools_added: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tools_removed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const RolesGroupSchema: z.ZodObject<{
+    basic_tools_enabled: z.ZodDefault<z.ZodBoolean>;
+    overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        tools_added: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        tools_removed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RoleOverrideConfig = z.infer<typeof RoleOverrideSchema>;
+export type RolesGroupConfig = z.infer<typeof RolesGroupSchema>;
+/**
+ * Prompts group — 系统 prompt override 管理
+ *
+ * 允许用户自定义 Leader 和 worker 角色的系统提示词。
+ * overrides 是一个 key→content 的映射，key 格式：
+ *   - leader_solo / leader_team / leader_workflow
+ *   - research / explore / coding / verify / review / frontend / backend / fullstack / qa / ux_designer / planner / evaluator / architect
+ * 运行时：worker prompts 在 collectBuiltinRoles 时覆盖 zh/en 两个 locale；
+ * Leader prompts 在 getSystemPrompt() 中按 profile 检查。
+ */
+declare const PromptsGroupSchema: z.ZodObject<{
+    overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type PromptsGroupConfig = z.infer<typeof PromptsGroupSchema>;
+export declare const ConfigSchema: z.ZodPreprocess<z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    llm: z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            openai: "openai";
+            anthropic: "anthropic";
+        }>>;
+        leader_model: z.ZodDefault<z.ZodString>;
+        agent_model: z.ZodDefault<z.ZodString>;
+        model_providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodType<ModelProviderConfig, unknown, z.core.$ZodTypeInternals<ModelProviderConfig, unknown>>>>>;
+        gateway_routes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            primary: z.ZodOptional<z.ZodString>;
+            fallbacks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            require: z.ZodDefault<z.ZodObject<{
+                thinking: z.ZodOptional<z.ZodBoolean>;
+                vision: z.ZodOptional<z.ZodBoolean>;
+                longContextTokens: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            max_cost_per_mtoken: z.ZodOptional<z.ZodNumber>;
+            data_policy: z.ZodOptional<z.ZodEnum<{
+                standard: "standard";
+                local_only: "local_only";
+                zdr_required: "zdr_required";
+                redact_sensitive: "redact_sensitive";
+            }>>;
+        }, z.core.$strip>>>;
+        gateway_fallback_models: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        request_timeout_s: z.ZodDefault<z.ZodNumber>;
+        connect_timeout_s: z.ZodDefault<z.ZodNumber>;
+        max_retries: z.ZodDefault<z.ZodNumber>;
+        backoff_base_ms: z.ZodDefault<z.ZodNumber>;
+        first_token_timeout_s: z.ZodDefault<z.ZodNumber>;
+        first_token_timeout_thinking_s: z.ZodDefault<z.ZodNumber>;
+        context_max_tokens: z.ZodDefault<z.ZodNumber>;
+        capped_max_tokens: z.ZodDefault<z.ZodNumber>;
+        escalated_max_tokens: z.ZodDefault<z.ZodNumber>;
+        thinking_budget_tokens: z.ZodDefault<z.ZodNumber>;
+        enable_streaming: z.ZodDefault<z.ZodBoolean>;
+        show_thinking_content: z.ZodDefault<z.ZodBoolean>;
+        enable_thinking_instruction: z.ZodDefault<z.ZodBoolean>;
+        enable_extended_thinking: z.ZodDefault<z.ZodBoolean>;
+        reasoning_effort: z.ZodDefault<z.ZodEnum<{
+            low: "low";
+            high: "high";
+            none: "none";
+            minimal: "minimal";
+            medium: "medium";
+            xhigh: "xhigh";
+            adaptive: "adaptive";
+        }>>;
+        reasoning_temperature: z.ZodDefault<z.ZodNumber>;
+        wiki_model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    llm_gateway: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        provider: z.ZodDefault<z.ZodEnum<{
+            openai: "openai";
+            anthropic: "anthropic";
+        }>>;
+        model: z.ZodDefault<z.ZodString>;
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        inject_env: z.ZodDefault<z.ZodBoolean>;
+        override_existing_env: z.ZodDefault<z.ZodBoolean>;
+        api_key: z.ZodDefault<z.ZodString>;
+        virtual_keys: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            key: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            model: z.ZodOptional<z.ZodString>;
+            provider: z.ZodOptional<z.ZodEnum<{
+                openai: "openai";
+                anthropic: "anthropic";
+            }>>;
+            rpm: z.ZodOptional<z.ZodNumber>;
+            tpm: z.ZodOptional<z.ZodNumber>;
+            daily_token_budget: z.ZodOptional<z.ZodNumber>;
+            expires_at: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        default_rpm: z.ZodDefault<z.ZodNumber>;
+        default_tpm: z.ZodDefault<z.ZodNumber>;
+        default_daily_token_budget: z.ZodDefault<z.ZodNumber>;
+        trace_enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    agents: z.ZodObject<{
+        max_concurrent: z.ZodDefault<z.ZodNumber>;
+        max_iterations: z.ZodDefault<z.ZodNumber>;
+        max_runtime_minutes: z.ZodDefault<z.ZodNumber>;
+        permission_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        tool_result_max_chars: z.ZodDefault<z.ZodNumber>;
+        max_conversation_messages: z.ZodDefault<z.ZodNumber>;
+        max_conversation_bytes: z.ZodDefault<z.ZodNumber>;
+        max_agent_messages: z.ZodDefault<z.ZodNumber>;
+        max_agent_messages_bytes: z.ZodDefault<z.ZodNumber>;
+        max_continuation_depth: z.ZodDefault<z.ZodNumber>;
+        worker_completion_judge_enabled: z.ZodDefault<z.ZodBoolean>;
+        external_agents_enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    verification: z.ZodObject<{
+        completion_gate_enabled: z.ZodDefault<z.ZodBoolean>;
+        typecheck: z.ZodDefault<z.ZodBoolean>;
+        build: z.ZodDefault<z.ZodBoolean>;
+        affected_tests: z.ZodDefault<z.ZodBoolean>;
+        full_tests: z.ZodDefault<z.ZodBoolean>;
+        self_repair_budget: z.ZodDefault<z.ZodNumber>;
+        build_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        test_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        judge_gated_by_contract: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    leader: z.ZodObject<{
+        max_tool_rounds: z.ZodDefault<z.ZodNumber>;
+        max_runtime_minutes: z.ZodDefault<z.ZodNumber>;
+        round_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        probe_silence_seconds: z.ZodDefault<z.ZodNumber>;
+        probe_max_interval_seconds: z.ZodDefault<z.ZodNumber>;
+        probe_backoff_multiplier: z.ZodDefault<z.ZodNumber>;
+        idle_warning_seconds: z.ZodDefault<z.ZodNumber>;
+        idle_probe_max_wait_ms: z.ZodDefault<z.ZodNumber>;
+        idle_probe_backoff_base_ms: z.ZodDefault<z.ZodNumber>;
+        stream_buffer_flush_threshold: z.ZodDefault<z.ZodNumber>;
+        agent_report_max_chars: z.ZodDefault<z.ZodNumber>;
+        plan_review_enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    health: z.ZodObject<{
+        poll_interval_seconds: z.ZodDefault<z.ZodNumber>;
+        stall_threshold_seconds: z.ZodDefault<z.ZodNumber>;
+        stuck_threshold_seconds: z.ZodDefault<z.ZodNumber>;
+        runaway_threshold_seconds: z.ZodDefault<z.ZodNumber>;
+        nudge_cooldown_seconds: z.ZodDefault<z.ZodNumber>;
+        max_nudge_before_escalation: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    context: z.ZodObject<{
+        token_limit: z.ZodOptional<z.ZodNumber>;
+        autocompact_enabled: z.ZodDefault<z.ZodBoolean>;
+        max_output_tokens_for_summary: z.ZodDefault<z.ZodNumber>;
+        autocompact_buffer_tokens: z.ZodDefault<z.ZodNumber>;
+        autocompact_ratio: z.ZodDefault<z.ZodNumber>;
+        autocompact_model_ratio_overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        compact_llm_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        max_consecutive_failures: z.ZodDefault<z.ZodNumber>;
+        max_request_bytes: z.ZodDefault<z.ZodNumber>;
+        max_single_message_bytes: z.ZodDefault<z.ZodNumber>;
+        preserved_system_count: z.ZodDefault<z.ZodNumber>;
+        preserved_recent_count: z.ZodDefault<z.ZodNumber>;
+        max_recent_message_count: z.ZodDefault<z.ZodNumber>;
+        post_compact_token_budget: z.ZodDefault<z.ZodNumber>;
+        recent_window_token_budget: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    truncation: z.ZodObject<{
+        shell_stdout_max: z.ZodDefault<z.ZodNumber>;
+        shell_stderr_max: z.ZodDefault<z.ZodNumber>;
+        python_max_output: z.ZodDefault<z.ZodNumber>;
+        tool_result_preview: z.ZodDefault<z.ZodNumber>;
+        webfetch_markdown_max: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    timeouts: z.ZodObject<{
+        graceful_shutdown_ms: z.ZodDefault<z.ZodNumber>;
+        hook_default_ms: z.ZodDefault<z.ZodNumber>;
+        hook_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        permission_sync_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        heartbeat_interval_ms: z.ZodDefault<z.ZodNumber>;
+        browser_goto_ms: z.ZodDefault<z.ZodNumber>;
+        browser_text_max: z.ZodDefault<z.ZodNumber>;
+        browser_html_max: z.ZodDefault<z.ZodNumber>;
+        worker_spawn_ms: z.ZodDefault<z.ZodNumber>;
+        worker_heartbeat_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        worker_max_runtime_ms: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    web_api: z.ZodDefault<z.ZodObject<{
+        prompt_enhance_max_chars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    paths: z.ZodObject<{
+        db_path: z.ZodDefault<z.ZodString>;
+        log_dir: z.ZodDefault<z.ZodString>;
+        skills_dir: z.ZodDefault<z.ZodString>;
+        chrome_path: z.ZodDefault<z.ZodString>;
+        bundled_skills_dir: z.ZodDefault<z.ZodString>;
+        global_skills_dir: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    skills: z.ZodDefault<z.ZodObject<{
+        disabled_names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        disabled_refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    plugins: z.ZodDefault<z.ZodObject<{
+        disabled_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    marketplaces: z.ZodDefault<z.ZodObject<{
+        sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<{
+                mcp_registry: "mcp_registry";
+                skill_index: "skill_index";
+                plugin_index: "plugin_index";
+            }>;
+            url: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            official: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    mcp: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        servers: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            transport: z.ZodLiteral<"streamable-http">;
+            url: z.ZodString;
+            headers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+            registry: z.ZodOptional<z.ZodObject<{
+                source_id: z.ZodOptional<z.ZodString>;
+                server_name: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            origin: z.ZodOptional<z.ZodObject<{
+                plugin_id: z.ZodOptional<z.ZodString>;
+                plugin_version: z.ZodOptional<z.ZodString>;
+                plugin_path: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            installed_at: z.ZodOptional<z.ZodNumber>;
+            updated_at: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            transport: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            registry: z.ZodOptional<z.ZodObject<{
+                source_id: z.ZodOptional<z.ZodString>;
+                server_name: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            origin: z.ZodOptional<z.ZodObject<{
+                plugin_id: z.ZodOptional<z.ZodString>;
+                plugin_version: z.ZodOptional<z.ZodString>;
+                plugin_path: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            installed_at: z.ZodOptional<z.ZodNumber>;
+            updated_at: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "transport">>>;
+        tool_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tools: z.ZodDefault<z.ZodObject<{
+        user_defined: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            kind: z.ZodEnum<{
+                python: "python";
+                http: "http";
+                shell: "shell";
+            }>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            parameters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodDefault<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                }>>;
+                description: z.ZodOptional<z.ZodString>;
+                required: z.ZodDefault<z.ZodBoolean>;
+                default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            }, z.core.$strip>>>;
+            http: z.ZodOptional<z.ZodObject<{
+                method: z.ZodDefault<z.ZodEnum<{
+                    GET: "GET";
+                    POST: "POST";
+                    PUT: "PUT";
+                    DELETE: "DELETE";
+                    PATCH: "PATCH";
+                    HEAD: "HEAD";
+                }>>;
+                url: z.ZodString;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                body_template: z.ZodOptional<z.ZodString>;
+                json_template: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                timeout_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            shell: z.ZodOptional<z.ZodObject<{
+                command: z.ZodString;
+                cwd: z.ZodOptional<z.ZodString>;
+                timeout_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            python: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                timeout_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            created_at: z.ZodOptional<z.ZodNumber>;
+            updated_at: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        disabled_names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        execution_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    roles: z.ZodDefault<z.ZodObject<{
+        basic_tools_enabled: z.ZodDefault<z.ZodBoolean>;
+        overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            tools_added: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            tools_removed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    prompts: z.ZodDefault<z.ZodObject<{
+        overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    server: z.ZodObject<{
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        random_port: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    network: z.ZodDefault<z.ZodObject<{
+        user_agent: z.ZodDefault<z.ZodString>;
+        proxy: z.ZodDefault<z.ZodObject<{
+            protocol: z.ZodDefault<z.ZodEnum<{
+                http: "http";
+                socks5: "socks5";
+            }>>;
+            host: z.ZodDefault<z.ZodString>;
+            port: z.ZodDefault<z.ZodNumber>;
+            username: z.ZodDefault<z.ZodString>;
+            password: z.ZodDefault<z.ZodString>;
+            no_proxy: z.ZodDefault<z.ZodString>;
+            url: z.ZodDefault<z.ZodString>;
+            llm_enabled: z.ZodDefault<z.ZodBoolean>;
+            tools_enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    browser: z.ZodDefault<z.ZodObject<{
+        daemon: z.ZodDefault<z.ZodBoolean>;
+        idle_ms: z.ZodOptional<z.ZodNumber>;
+        proxy: z.ZodOptional<z.ZodObject<{
+            server: z.ZodDefault<z.ZodString>;
+            username: z.ZodOptional<z.ZodString>;
+            password: z.ZodOptional<z.ZodString>;
+            bypass: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    security: z.ZodObject<{
+        permission_mode: z.ZodDefault<z.ZodEnum<{
+            yolo: "yolo";
+            networked: "networked";
+            dev: "dev";
+            strict: "strict";
+        }>>;
+        auto_allow_bash_if_sandboxed: z.ZodDefault<z.ZodBoolean>;
+        dangerous_command_guard: z.ZodDefault<z.ZodBoolean>;
+        block_private_network: z.ZodDefault<z.ZodBoolean>;
+        hardened_mode: z.ZodDefault<z.ZodBoolean>;
+        env_allowlist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    memory: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        auto_memory_enabled: z.ZodDefault<z.ZodBoolean>;
+        intuition_enabled: z.ZodDefault<z.ZodBoolean>;
+        tacit_mode_enabled: z.ZodDefault<z.ZodBoolean>;
+        intuition_profile: z.ZodDefault<z.ZodEnum<{
+            balanced: "balanced";
+            low_interrupt: "low_interrupt";
+            autonomous_partner: "autonomous_partner";
+        }>>;
+        reconcile_on_search: z.ZodDefault<z.ZodBoolean>;
+        search_score_floor: z.ZodDefault<z.ZodNumber>;
+        dream: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            auto_interval_days: z.ZodDefault<z.ZodNumber>;
+            session_lookback_days: z.ZodDefault<z.ZodNumber>;
+            max_lines: z.ZodDefault<z.ZodNumber>;
+            max_bytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        distill: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            auto_interval_days: z.ZodDefault<z.ZodNumber>;
+            session_lookback_days: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        embedding: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            model: z.ZodDefault<z.ZodString>;
+            dimensions: z.ZodDefault<z.ZodNumber>;
+            hybrid_weight_fts: z.ZodDefault<z.ZodNumber>;
+            hybrid_weight_vector: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        gc: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            dry_run: z.ZodDefault<z.ZodBoolean>;
+            max_deletions: z.ZodDefault<z.ZodNumber>;
+            interval_days: z.ZodDefault<z.ZodNumber>;
+            protected_types: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    checkpoint: z.ZodObject<{
+        file_checkpointing_enabled: z.ZodDefault<z.ZodBoolean>;
+        max_checkpoints: z.ZodDefault<z.ZodNumber>;
+        auto_gc_enabled: z.ZodDefault<z.ZodBoolean>;
+        max_workspace_files: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    ui: z.ZodObject<{
+        language: z.ZodDefault<z.ZodEnum<{
+            zh: "zh";
+            en: "en";
+        }>>;
+        include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
+        prompt_suggestion_enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    message_bus: z.ZodObject<{
+        warning_threshold: z.ZodDefault<z.ZodNumber>;
+        critical_threshold: z.ZodDefault<z.ZodNumber>;
+        max_history_bytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    observability: z.ZodObject<{
+        tracing: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            persist: z.ZodDefault<z.ZodBoolean>;
+            maxSpans: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        metrics: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        langfuse: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            baseUrl: z.ZodDefault<z.ZodString>;
+            secretKey: z.ZodDefault<z.ZodString>;
+            publicKey: z.ZodDefault<z.ZodString>;
+            traceLlmCalls: z.ZodDefault<z.ZodBoolean>;
+            traceToolCalls: z.ZodDefault<z.ZodBoolean>;
+            traceAgentLifecycle: z.ZodDefault<z.ZodBoolean>;
+            sampleRate: z.ZodDefault<z.ZodNumber>;
+            maskSensitive: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    taskPriority: z.ZodObject<{
+        weights: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strip>;
+    scaling: z.ZodObject<{
+        remoteWorkers: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            listenPort: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    git: z.ZodDefault<z.ZodObject<{
+        platform: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            github: "github";
+            gitlab: "gitlab";
+            gitea: "gitea";
+        }>>;
+        token: z.ZodDefault<z.ZodString>;
+        api_url: z.ZodDefault<z.ZodString>;
+        default_target_branch: z.ZodDefault<z.ZodString>;
+        auto_detect_remote: z.ZodDefault<z.ZodBoolean>;
+        pre_commit_gate: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            type_check: z.ZodDefault<z.ZodBoolean>;
+            command: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    blackboard: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        max_nodes: z.ZodDefault<z.ZodNumber>;
+        max_edges: z.ZodDefault<z.ZodNumber>;
+        max_node_content_chars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    advanced: z.ZodDefault<z.ZodObject<{
+        cleanup_period_days: z.ZodDefault<z.ZodNumber>;
+        image_history_retain_rounds: z.ZodDefault<z.ZodNumber>;
+        tool_result_retain_rounds: z.ZodDefault<z.ZodNumber>;
+        defer_tool_loading: z.ZodDefault<z.ZodBoolean>;
+        ignore_gitignore: z.ZodDefault<z.ZodBoolean>;
+        hook_output_collapsed: z.ZodDefault<z.ZodBoolean>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    credentials: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    initialized: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function validateModelProvidersConfig(modelProviders: ModelProvidersConfig, credentials?: Record<string, string>): string[];
+export declare function normalizeRawModelProviders(raw: Record<string, unknown>): void;
+export declare function normalizeMarketplaceSources(sources: MarketplaceSourceConfig[] | undefined): MarketplaceSourceConfig[];
+export declare function loadSettings(): Config;
+export declare function saveSettings(cfg: Config): void;
+/**
+ * 动态更新配置并持久化到 settings.json。
+ * 用于运行时修改配置（如 Web UI 开关）。
+ */
+export declare function updateConfig(partial: Partial<Config>): Promise<void>;
+export declare function generateDefaultSettings(): void;
+export declare const config: {
+    version: number;
+    llm: {
+        provider: "auto" | "openai" | "anthropic";
+        leader_model: string;
+        agent_model: string;
+        model_providers: Record<string, ModelProviderConfig[]>;
+        gateway_routes: Record<string, {
+            fallbacks: string[];
+            require: {
+                thinking?: boolean | undefined;
+                vision?: boolean | undefined;
+                longContextTokens?: number | undefined;
+            };
+            primary?: string | undefined;
+            max_cost_per_mtoken?: number | undefined;
+            data_policy?: "standard" | "local_only" | "zdr_required" | "redact_sensitive" | undefined;
+        }>;
+        gateway_fallback_models: string[];
+        request_timeout_s: number;
+        connect_timeout_s: number;
+        max_retries: number;
+        backoff_base_ms: number;
+        first_token_timeout_s: number;
+        first_token_timeout_thinking_s: number;
+        context_max_tokens: number;
+        capped_max_tokens: number;
+        escalated_max_tokens: number;
+        thinking_budget_tokens: number;
+        enable_streaming: boolean;
+        show_thinking_content: boolean;
+        enable_thinking_instruction: boolean;
+        enable_extended_thinking: boolean;
+        reasoning_effort: "low" | "high" | "none" | "minimal" | "medium" | "xhigh" | "adaptive";
+        reasoning_temperature: number;
+        wiki_model?: string | undefined;
+    };
+    llm_gateway: {
+        enabled: boolean;
+        provider: "openai" | "anthropic";
+        model: string;
+        host: string;
+        port: number;
+        inject_env: boolean;
+        override_existing_env: boolean;
+        api_key: string;
+        virtual_keys: {
+            id: string;
+            key: string;
+            enabled: boolean;
+            label?: string | undefined;
+            model?: string | undefined;
+            provider?: "openai" | "anthropic" | undefined;
+            rpm?: number | undefined;
+            tpm?: number | undefined;
+            daily_token_budget?: number | undefined;
+            expires_at?: number | undefined;
+        }[];
+        default_rpm: number;
+        default_tpm: number;
+        default_daily_token_budget: number;
+        trace_enabled: boolean;
+    };
+    agents: {
+        max_concurrent: number;
+        max_iterations: number;
+        max_runtime_minutes: number;
+        permission_timeout_ms: number;
+        tool_result_max_chars: number;
+        max_conversation_messages: number;
+        max_conversation_bytes: number;
+        max_agent_messages: number;
+        max_agent_messages_bytes: number;
+        max_continuation_depth: number;
+        worker_completion_judge_enabled: boolean;
+        external_agents_enabled: boolean;
+    };
+    verification: {
+        completion_gate_enabled: boolean;
+        typecheck: boolean;
+        build: boolean;
+        affected_tests: boolean;
+        full_tests: boolean;
+        self_repair_budget: number;
+        build_timeout_ms: number;
+        test_timeout_ms: number;
+        judge_gated_by_contract: boolean;
+    };
+    leader: {
+        max_tool_rounds: number;
+        max_runtime_minutes: number;
+        round_timeout_ms: number;
+        probe_silence_seconds: number;
+        probe_max_interval_seconds: number;
+        probe_backoff_multiplier: number;
+        idle_warning_seconds: number;
+        idle_probe_max_wait_ms: number;
+        idle_probe_backoff_base_ms: number;
+        stream_buffer_flush_threshold: number;
+        agent_report_max_chars: number;
+        plan_review_enabled: boolean;
+    };
+    health: {
+        poll_interval_seconds: number;
+        stall_threshold_seconds: number;
+        stuck_threshold_seconds: number;
+        runaway_threshold_seconds: number;
+        nudge_cooldown_seconds: number;
+        max_nudge_before_escalation: number;
+    };
+    context: {
+        autocompact_enabled: boolean;
+        max_output_tokens_for_summary: number;
+        autocompact_buffer_tokens: number;
+        autocompact_ratio: number;
+        autocompact_model_ratio_overrides: Record<string, number>;
+        compact_llm_timeout_ms: number;
+        max_consecutive_failures: number;
+        max_request_bytes: number;
+        max_single_message_bytes: number;
+        preserved_system_count: number;
+        preserved_recent_count: number;
+        max_recent_message_count: number;
+        post_compact_token_budget: number;
+        recent_window_token_budget: number;
+        token_limit?: number | undefined;
+    };
+    truncation: {
+        shell_stdout_max: number;
+        shell_stderr_max: number;
+        python_max_output: number;
+        tool_result_preview: number;
+        webfetch_markdown_max: number;
+    };
+    timeouts: {
+        graceful_shutdown_ms: number;
+        hook_default_ms: number;
+        hook_timeout_ms: number;
+        permission_sync_timeout_ms: number;
+        heartbeat_interval_ms: number;
+        browser_goto_ms: number;
+        browser_text_max: number;
+        browser_html_max: number;
+        worker_spawn_ms: number;
+        worker_heartbeat_timeout_ms: number;
+        worker_max_runtime_ms: number;
+    };
+    web_api: {
+        prompt_enhance_max_chars: number;
+    };
+    paths: {
+        db_path: string;
+        log_dir: string;
+        skills_dir: string;
+        chrome_path: string;
+        bundled_skills_dir: string;
+        global_skills_dir: string;
+    };
+    skills: {
+        disabled_names: string[];
+        disabled_refs: string[];
+    };
+    plugins: {
+        disabled_ids: string[];
+        dirs: string[];
+    };
+    marketplaces: {
+        sources: {
+            id: string;
+            type: "mcp_registry" | "skill_index" | "plugin_index";
+            enabled: boolean;
+            official: boolean;
+            title?: string | undefined;
+            url?: string | undefined;
+        }[];
+    };
+    mcp: {
+        enabled: boolean;
+        servers: ({
+            id: string;
+            name: string;
+            enabled: boolean;
+            transport: "streamable-http";
+            url: string;
+            headers: {
+                name: string;
+                value: string;
+            }[];
+            title?: string | undefined;
+            description?: string | undefined;
+            registry?: {
+                source_id?: string | undefined;
+                server_name?: string | undefined;
+                version?: string | undefined;
+            } | undefined;
+            origin?: {
+                plugin_id?: string | undefined;
+                plugin_version?: string | undefined;
+                plugin_path?: string | undefined;
+            } | undefined;
+            installed_at?: number | undefined;
+            updated_at?: number | undefined;
+        } | {
+            id: string;
+            name: string;
+            enabled: boolean;
+            transport: "stdio";
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+            title?: string | undefined;
+            description?: string | undefined;
+            cwd?: string | undefined;
+            registry?: {
+                source_id?: string | undefined;
+                server_name?: string | undefined;
+                version?: string | undefined;
+            } | undefined;
+            origin?: {
+                plugin_id?: string | undefined;
+                plugin_version?: string | undefined;
+                plugin_path?: string | undefined;
+            } | undefined;
+            installed_at?: number | undefined;
+            updated_at?: number | undefined;
+        })[];
+        tool_timeout_ms: number;
+    };
+    tools: {
+        user_defined: {
+            name: string;
+            description: string;
+            kind: "python" | "http" | "shell";
+            enabled: boolean;
+            parameters: {
+                name: string;
+                type: "string" | "number" | "boolean";
+                required: boolean;
+                description?: string | undefined;
+                default?: string | number | boolean | undefined;
+            }[];
+            http?: {
+                method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD";
+                url: string;
+                headers?: Record<string, string> | undefined;
+                body_template?: string | undefined;
+                json_template?: Record<string, unknown> | undefined;
+                timeout_ms?: number | undefined;
+            } | undefined;
+            shell?: {
+                command: string;
+                cwd?: string | undefined;
+                timeout_ms?: number | undefined;
+            } | undefined;
+            python?: {
+                code: string;
+                timeout_ms?: number | undefined;
+            } | undefined;
+            created_at?: number | undefined;
+            updated_at?: number | undefined;
+        }[];
+        disabled_names: string[];
+        execution_timeout_ms: number;
+    };
+    roles: {
+        basic_tools_enabled: boolean;
+        overrides: Record<string, {
+            tools_added: string[];
+            tools_removed: string[];
+        }>;
+    };
+    prompts: {
+        overrides: Record<string, string>;
+    };
+    server: {
+        host: string;
+        port: number;
+        random_port: boolean;
+    };
+    network: {
+        user_agent: string;
+        proxy: {
+            protocol: "http" | "socks5";
+            host: string;
+            port: number;
+            username: string;
+            password: string;
+            no_proxy: string;
+            url: string;
+            llm_enabled: boolean;
+            tools_enabled: boolean;
+        };
+    };
+    browser: {
+        daemon: boolean;
+        idle_ms?: number | undefined;
+        proxy?: {
+            server: string;
+            username?: string | undefined;
+            password?: string | undefined;
+            bypass?: string | undefined;
+        } | undefined;
+    };
+    security: {
+        permission_mode: "yolo" | "networked" | "dev" | "strict";
+        auto_allow_bash_if_sandboxed: boolean;
+        dangerous_command_guard: boolean;
+        block_private_network: boolean;
+        hardened_mode: boolean;
+        env_allowlist: string[];
+    };
+    memory: {
+        enabled: boolean;
+        auto_memory_enabled: boolean;
+        intuition_enabled: boolean;
+        tacit_mode_enabled: boolean;
+        intuition_profile: "balanced" | "low_interrupt" | "autonomous_partner";
+        reconcile_on_search: boolean;
+        search_score_floor: number;
+        dream: {
+            enabled: boolean;
+            auto_interval_days: number;
+            session_lookback_days: number;
+            max_lines: number;
+            max_bytes: number;
+        };
+        distill: {
+            enabled: boolean;
+            auto_interval_days: number;
+            session_lookback_days: number;
+        };
+        embedding: {
+            enabled: boolean;
+            model: string;
+            dimensions: number;
+            hybrid_weight_fts: number;
+            hybrid_weight_vector: number;
+        };
+        gc: {
+            enabled: boolean;
+            dry_run: boolean;
+            max_deletions: number;
+            interval_days: number;
+            protected_types: string[];
+        };
+    };
+    checkpoint: {
+        file_checkpointing_enabled: boolean;
+        max_checkpoints: number;
+        auto_gc_enabled: boolean;
+        max_workspace_files: number;
+    };
+    ui: {
+        language: "zh" | "en";
+        include_co_authored_by: boolean;
+        prompt_suggestion_enabled: boolean;
+    };
+    message_bus: {
+        warning_threshold: number;
+        critical_threshold: number;
+        max_history_bytes: number;
+    };
+    observability: {
+        tracing: {
+            enabled: boolean;
+            persist: boolean;
+            maxSpans: number;
+        };
+        metrics: {
+            enabled: boolean;
+        };
+        langfuse: {
+            enabled: boolean;
+            baseUrl: string;
+            secretKey: string;
+            publicKey: string;
+            traceLlmCalls: boolean;
+            traceToolCalls: boolean;
+            traceAgentLifecycle: boolean;
+            sampleRate: number;
+            maskSensitive: boolean;
+        };
+    };
+    taskPriority: {
+        weights: Record<string, number>;
+    };
+    scaling: {
+        remoteWorkers: {
+            enabled: boolean;
+            listenPort: number;
+        };
+    };
+    git: {
+        platform: "none" | "github" | "gitlab" | "gitea";
+        token: string;
+        api_url: string;
+        default_target_branch: string;
+        auto_detect_remote: boolean;
+        pre_commit_gate: {
+            enabled: boolean;
+            type_check: boolean;
+            command: string;
+        };
+    };
+    blackboard: {
+        enabled: boolean;
+        max_nodes: number;
+        max_edges: number;
+        max_node_content_chars: number;
+    };
+    advanced: {
+        cleanup_period_days: number;
+        image_history_retain_rounds: number;
+        tool_result_retain_rounds: number;
+        defer_tool_loading: boolean;
+        ignore_gitignore: boolean;
+        hook_output_collapsed: boolean;
+        env: Record<string, string>;
+    };
+    credentials: Record<string, string>;
+    initialized: boolean;
+};
+/**
+ * 判断某个 llm.* 配置键是否被用户显式设定（settings.json 或环境变量），
+ * 而非来自 ConfigSchema 的默认值。用于让用户配置优先生效、避免 schema
+ * 默认值静默覆盖更高优先级的语义（如 reasoning_effort 强度档位）。
+ */
+export declare function isLlmConfigUserSet(path: string): boolean;
+export declare function refreshRuntimeConfig(): Config;
+type ConfigReloadHandler = (cfg: Config) => void;
+export declare function onConfigReload(handler: ConfigReloadHandler): () => void;
+export declare function fireConfigReload(): void;
+export declare function startSettingsWatcher(): void;
+export declare function stopSettingsWatcher(): void;
+export declare let AGENT_MAX_ITERATIONS: number;
+export declare let AGENT_MAX_RUNTIME_MINUTES: number;
+export declare let LEADER_MAX_TOOL_ROUNDS: number;
+export declare let LEADER_MAX_RUNTIME_MINUTES: number;
+export declare let LEADER_ROUND_TIMEOUT_MS: number;
+export declare let LEADER_PROBE_SILENCE_SECONDS: number;
+export declare let LEADER_PROBE_MAX_INTERVAL_SECONDS: number;
+export declare let LEADER_PROBE_BACKOFF_MULTIPLIER: number;
+export declare let LEADER_IDLE_WARNING_SECONDS: number;
+export declare let PLAN_REVIEW_ENABLED: boolean;
+export declare let ENABLE_STREAMING: boolean;
+export declare let ENABLE_THINKING_INSTRUCTION: boolean;
+export declare let MAX_CONVERSATION_MESSAGES: number;
+export declare let MAX_CONVERSATION_BYTES: number;
+export declare let MAX_AGENT_MESSAGES: number;
+export declare let MAX_AGENT_MESSAGES_BYTES: number;
+export declare let HEALTH_POLL_INTERVAL_SECONDS: number;
+export declare let HEALTH_STALL_THRESHOLD_SECONDS: number;
+export declare let HEALTH_STUCK_THRESHOLD_SECONDS: number;
+export declare let HEALTH_RUNAWAY_THRESHOLD_SECONDS: number;
+export declare let HEALTH_NUDGE_COOLDOWN_SECONDS: number;
+export declare let HEALTH_MAX_NUDGE_BEFORE_ESCALATION: number;
+/**
+ * 同步派生常量：将 config 对象的最新值写回 export let 变量。
+ *
+ * 这些变量在模块加载时从 config 快照赋值，之后 config 对象可能被
+ * refreshRuntimeConfig() 原地更新。调用此函数让所有派生常量与
+ * 最新 config 保持一致，确保消费方读到热加载后的新值。
+ */
+export declare function syncDerivedConstants(): void;
+export declare function getConfigSource(path: string): ConfigSourceOld;
+export declare function getConfigValue(path: string): unknown;
+export declare function setConfigValue(path: string, value: unknown): void;
+export {};
+//# sourceMappingURL=config.d.ts.map