kiku-agent 1.0.10 → 1.0.11

package/server/agent/config.js

@@ -1,3 +1,7 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { PROVIDER_KEYS_FILE, SETTINGS_FILE } from './appPaths.js';
+
 const PROVIDER_MODEL_ALIASES = {
   openai: {
     'o1-mini': 'gpt-5.6-luna',
@@ -26,255 +30,402 @@ export function normalizeProviderModel(providerId, modelId) {
 }
 
 export const CLOUD_PROVIDERS = {
-  lmstudio: {
-    id: 'lmstudio',
-    name: 'LM Studio (Local)',
-    baseUrl: process.env.LMSTUDIO_BASE_URL || process.env.OPENAI_BASE_URL || 'http://127.0.0.1:1234/v1',
-    apiKey: process.env.LMSTUDIO_API_KEY || 'lm-studio',
-    defaultModel: 'google/gemma-4-e4b',
-    isLocal: true,
-    envKey: 'LMSTUDIO_BASE_URL',
-    docUrl: 'https://lmstudio.ai/docs',
-    apiRefUrl: 'https://lmstudio.ai/docs/api/local-server',
-    pricingSummary: '100% Free / Local (No API Key required)',
-    features: ['local', 'private', 'offline', 'zero-cost', 'openai-compatible'],
-    recommendedModels: [
-      { id: 'google/gemma-4-e4b', name: 'Gemma 4 e4b (Default / Q4_K_M)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: 'Recommended default. Balanced 4-bit quantization (Q4_K_M) — fastest inference and lowest RAM usage.' },
-      { id: 'google/gemma-4-e4b-Q4_K_M', name: 'Gemma 4 e4b (Q4_K_M Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '4-bit medium quantization (Q4_K_M) optimized for speed and low memory footprint (~2.5GB RAM).' },
-      { id: 'google/gemma-4-e4b-Q6_K', name: 'Gemma 4 e4b (Q6_K Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '6-bit quantization (Q6_K) offering higher precision and near-original fidelity (~3.5GB RAM).' },
-      { id: 'google/gemma-4-e4b-Q8_0', name: 'Gemma 4 e4b (Q8_0 Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '8-bit full quantization (Q8_0) for maximum accuracy and reasoning precision (~4.5GB RAM).' },
-    ],
-  },
-  openai: {
-    id: 'openai',
-    name: 'OpenAI Cloud',
-    baseUrl: process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1',
-    apiKey: process.env.OPENAI_API_KEY || '',
+  lmstudio: {
+    id: 'lmstudio',
+    name: 'LM Studio (Local)',
+    baseUrl: process.env.LMSTUDIO_BASE_URL || process.env.OPENAI_BASE_URL || 'http://127.0.0.1:1234/v1',
+    apiKey: process.env.LMSTUDIO_API_KEY || 'lm-studio',
+    defaultModel: 'google/gemma-4-e4b',
+    isLocal: true,
+    envKey: 'LMSTUDIO_BASE_URL',
+    docUrl: 'https://lmstudio.ai/docs',
+    apiRefUrl: 'https://lmstudio.ai/docs/api/local-server',
+    pricingSummary: '100% Free / Local (No API Key required)',
+    features: ['local', 'private', 'offline', 'zero-cost', 'openai-compatible'],
+    recommendedModels: [
+      { id: 'google/gemma-4-e4b', name: 'Gemma 4 e4b (Default / Q4_K_M)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: 'Recommended default. Balanced 4-bit quantization (Q4_K_M) — fastest inference and lowest RAM usage.' },
+      { id: 'google/gemma-4-e4b-Q4_K_M', name: 'Gemma 4 e4b (Q4_K_M Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '4-bit medium quantization (Q4_K_M) optimized for speed and low memory footprint (~2.5GB RAM).' },
+      { id: 'google/gemma-4-e4b-Q6_K', name: 'Gemma 4 e4b (Q6_K Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '6-bit quantization (Q6_K) offering higher precision and near-original fidelity (~3.5GB RAM).' },
+      { id: 'google/gemma-4-e4b-Q8_0', name: 'Gemma 4 e4b (Q8_0 Quant)', tier: 'free', cost: '$0.00 (Local)', context: '8k', hasTools: true, description: '8-bit full quantization (Q8_0) for maximum accuracy and reasoning precision (~4.5GB RAM).' },
+    ],
+  },
+  openai: {
+    id: 'openai',
+    name: 'OpenAI Cloud',
+    baseUrl: process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1',
+    apiKey: process.env.OPENAI_API_KEY || '',
     defaultModel: normalizeProviderModel('openai', process.env.OPENAI_MODEL || 'gpt-5.6-luna'),
-    isLocal: false,
-    envKey: 'OPENAI_API_KEY',
+    isLocal: false,
+    envKey: 'OPENAI_API_KEY',
     docUrl: 'https://developers.openai.com/api/docs/models',
     apiRefUrl: 'https://developers.openai.com/api/reference',
     pricingSummary: 'GPT-5.6 Luna: $0.20/1M in, $1.20/1M out; Terra/Sol available for higher capability',
-    features: ['tools', 'streaming', 'vision', 'reasoning', 'system-prompt'],
-    recommendedModels: [
+    features: ['tools', 'streaming', 'vision', 'reasoning', 'system-prompt'],
+    recommendedModels: [
       { id: 'gpt-5.6-luna', name: 'GPT-5.6 Luna', tier: 'cost-sensitive', cost: '$0.20 / 1M in', context: '1.05M', hasTools: true, description: 'Recommended default for efficient, high-volume multilingual agent workloads.' },
       { id: 'gpt-5.6-terra', name: 'GPT-5.6 Terra', tier: 'balanced', cost: '$2.00 / 1M in', context: '1.05M', hasTools: true, description: 'Balances intelligence and cost for production reasoning and tool use.' },
       { id: 'gpt-5.6-sol', name: 'GPT-5.6 Sol', tier: 'flagship', cost: '$4.00 / 1M in', context: '1.05M', hasTools: true, description: 'Flagship model for complex professional reasoning and coding.' },
-    ],
-  },
-  openrouter: {
-    id: 'openrouter',
-    name: 'OpenRouter Cloud',
-    baseUrl: process.env.OPENROUTER_BASE_URL || 'https://openrouter.ai/api/v1',
-    apiKey: process.env.OPENROUTER_API_KEY || '',
+    ],
+  },
+  openrouter: {
+    id: 'openrouter',
+    name: 'OpenRouter Cloud',
+    baseUrl: process.env.OPENROUTER_BASE_URL || 'https://openrouter.ai/api/v1',
+    apiKey: process.env.OPENROUTER_API_KEY || '',
     defaultModel: normalizeProviderModel('openrouter', process.env.OPENROUTER_MODEL || 'openrouter/auto'),
     extraHeaders: {
       'HTTP-Referer': 'https://jujingyi-kikuuu.vercel.app/',
       'X-OpenRouter-Title': 'Kiku Agent',
     },
-    isLocal: false,
-    envKey: 'OPENROUTER_API_KEY',
+    isLocal: false,
+    envKey: 'OPENROUTER_API_KEY',
     docUrl: 'https://openrouter.ai/docs/guides/routing/routers/auto-router',
     apiRefUrl: 'https://openrouter.ai/docs/api/reference/overview',
     pricingSummary: 'Auto Router selects a current model dynamically; usage is billed at the routed model rate',
-    features: ['universal-routing', 'tools', 'streaming', 'free-tier', 'fallback'],
-    recommendedModels: [
+    features: ['universal-routing', 'tools', 'streaming', 'free-tier', 'fallback'],
+    recommendedModels: [
       { id: 'openrouter/auto', name: 'OpenRouter Auto Router', tier: 'dynamic', cost: 'Routed model rate', context: 'Model-dependent', hasTools: true, description: 'Recommended default. Chooses from the current catalog so a retired third-party model does not break startup.' },
-    ],
-  },
+    ],
+  },
   groq: {
-    id: 'groq',
-    name: 'Groq Cloud',
-    baseUrl: process.env.GROQ_BASE_URL || 'https://api.groq.com/openai/v1',
-    apiKey: process.env.GROQ_API_KEY || '',
+    id: 'groq',
+    name: 'Groq Cloud',
+    baseUrl: process.env.GROQ_BASE_URL || 'https://api.groq.com/openai/v1',
+    apiKey: process.env.GROQ_API_KEY || '',
     defaultModel: normalizeProviderModel('groq', process.env.GROQ_MODEL || 'openai/gpt-oss-120b'),
-    isLocal: false,
-    envKey: 'GROQ_API_KEY',
-    docUrl: 'https://console.groq.com/docs/quickstart',
-    apiRefUrl: 'https://console.groq.com/docs/api-reference',
+    isLocal: false,
+    envKey: 'GROQ_API_KEY',
+    docUrl: 'https://console.groq.com/docs/quickstart',
+    apiRefUrl: 'https://console.groq.com/docs/api-reference',
     pricingSummary: 'Ultra-fast LPU inference (GPT-OSS 20B: $0.075/1M in, GPT-OSS 120B: $0.15/1M in)',
-    features: ['lpu-speed', 'tools', 'streaming', 'openai-compatible'],
+    features: ['lpu-speed', 'tools', 'streaming', 'openai-compatible'],
     recommendedModels: [
       { id: 'openai/gpt-oss-120b', name: 'GPT-OSS 120B', tier: 'flagship', cost: '$0.15 / 1M in', context: '131k', hasTools: true, description: 'Recommended default. Production-grade 120B reasoning model with tool use on Groq.' },
       { id: 'openai/gpt-oss-20b', name: 'GPT-OSS 20B', tier: 'ultra-cheap', cost: '$0.075 / 1M in', context: '131k', hasTools: true, description: 'Fast production model for lower-cost, high-volume requests.' },
     ],
-  },
-  deepseek: {
-    id: 'deepseek',
-    name: 'DeepSeek Cloud',
+  },
+  deepseek: {
+    id: 'deepseek',
+    name: 'DeepSeek Cloud',
     baseUrl: process.env.DEEPSEEK_BASE_URL || 'https://api.deepseek.com',
-    apiKey: process.env.DEEPSEEK_API_KEY || '',
+    apiKey: process.env.DEEPSEEK_API_KEY || '',
     defaultModel: normalizeProviderModel('deepseek', process.env.DEEPSEEK_MODEL || 'deepseek-v4-flash'),
-    isLocal: false,
-    envKey: 'DEEPSEEK_API_KEY',
-    docUrl: 'https://api-docs.deepseek.com',
-    apiRefUrl: 'https://api-docs.deepseek.com/api/create-chat-completion',
+    isLocal: false,
+    envKey: 'DEEPSEEK_API_KEY',
+    docUrl: 'https://api-docs.deepseek.com',
+    apiRefUrl: 'https://api-docs.deepseek.com/api/create-chat-completion',
     pricingSummary: 'V4 Flash: $0.22-$0.44/1M uncached input; V4 Pro: $0.66-$1.32/1M (off-peak/peak)',
     features: ['deepseek-v4', 'thinking', 'tools', 'streaming', 'context-cache', '1m-context'],
-    recommendedModels: [
+    recommendedModels: [
       { id: 'deepseek-v4-flash', name: 'DeepSeek V4 Flash', tier: 'balanced', cost: '$0.22-$0.44 / 1M uncached in', context: '1M', hasTools: true, description: 'Recommended default. Current V4 model with tool calls and thinking/non-thinking modes.' },
       { id: 'deepseek-v4-pro', name: 'DeepSeek V4 Pro', tier: 'flagship', cost: '$0.66-$1.32 / 1M uncached in', context: '1M', hasTools: true, description: 'Higher-capability V4 model with tool calls and thinking mode.' },
-    ],
-  },
-  gemini: {
-    id: 'gemini',
-    name: 'Google Gemini Cloud',
-    baseUrl: process.env.GEMINI_BASE_URL || 'https://generativelanguage.googleapis.com/v1beta/openai/',
-    apiKey: process.env.GEMINI_API_KEY || '',
+    ],
+  },
+  gemini: {
+    id: 'gemini',
+    name: 'Google Gemini',
+    baseUrl: process.env.GEMINI_BASE_URL || 'https://generativelanguage.googleapis.com/v1beta/openai',
+    apiKey: process.env.GEMINI_API_KEY || '',
     defaultModel: normalizeProviderModel('gemini', process.env.GEMINI_MODEL || 'gemini-3.7-flash'),
-    isLocal: false,
-    envKey: 'GEMINI_API_KEY',
+    isLocal: false,
+    envKey: 'GEMINI_API_KEY',
     docUrl: 'https://ai.google.dev/gemini-api/docs',
     apiRefUrl: 'https://ai.google.dev/api/generate-content',
     pricingSummary: 'Gemini 3.7 Flash: free tier available; paid standard $0.75/1M input through 2026',
-    features: ['1m-context', 'multimodal', 'tools', 'streaming', 'thinking'],
-    recommendedModels: [
+    features: ['1m-context', 'multimodal', 'tools', 'streaming', 'thinking'],
+    recommendedModels: [
       { id: 'gemini-3.7-flash', name: 'Gemini 3.7 Flash', tier: 'latest-stable', cost: '$0.75 / 1M in (2026)', context: '1M', hasTools: true, description: 'Recommended default. Latest stable Flash model for agentic workflows and multimodal reasoning.' },
       { id: 'gemini-3.5-flash-lite', name: 'Gemini 3.5 Flash-Lite', tier: 'lowest-cost', cost: '$0.30 / 1M in', context: '1M', hasTools: true, description: 'Stable, cost-efficient model for high-volume translation and simple processing.' },
       { id: 'gemini-3.6-flash', name: 'Gemini 3.6 Flash', tier: 'stable', cost: '$0.75 / 1M in (2026)', context: '1M', hasTools: true, description: 'Stable previous-generation Flash fallback with function calling and thinking.' },
-    ],
-  },
-  custom: {
-    id: 'custom',
-    name: 'Custom OpenAI-Compatible',
-    baseUrl: process.env.LLM_BASE_URL || '',
-    apiKey: process.env.LLM_API_KEY || '',
-    defaultModel: process.env.LLM_MODEL || 'default',
-    isLocal: false,
-    envKey: 'LLM_BASE_URL',
-    docUrl: 'https://platform.openai.com/docs/api-reference',
-    apiRefUrl: 'https://platform.openai.com/docs/api-reference/chat',
-    pricingSummary: 'Self-hosted or Custom Gateway',
-    features: ['custom-endpoint', 'openai-compatible', 'tools', 'streaming'],
-    recommendedModels: [
-      { id: 'default', name: 'Default Model', tier: 'custom', cost: 'Custom', context: 'Custom', hasTools: true, description: 'Custom model specified via LLM_MODEL or /model use <id>.' },
-    ],
-  },
-};
-
-export function resolveDefaultProvider() {
-  const explicit = process.env.LLM_PROVIDER?.toLowerCase();
-  if (explicit && CLOUD_PROVIDERS[explicit]) return explicit;
-
-  if (process.env.OPENROUTER_API_KEY) return 'openrouter';
-  if (process.env.OPENAI_API_KEY) return 'openai';
-  if (process.env.GEMINI_API_KEY) return 'gemini';
-  if (process.env.DEEPSEEK_API_KEY) return 'deepseek';
-  if (process.env.GROQ_API_KEY) return 'groq';
-  if (process.env.LLM_API_KEY && process.env.LLM_BASE_URL) return 'custom';
-
-  return 'lmstudio';
-}
-
-export function getProvider(id) {
-  const pId = String(id || '').toLowerCase().trim();
-  return CLOUD_PROVIDERS[pId] || null;
-}
-
-export function getProviderList() {
-  return Object.values(CLOUD_PROVIDERS);
-}
-
-export function getRecommendedModels(providerId) {
-  const provider = getProvider(providerId);
-  return provider ? (provider.recommendedModels || []) : [];
-}
-
-const defaultProviderId = resolveDefaultProvider();
-const defaultProviderConfig = CLOUD_PROVIDERS[defaultProviderId] || CLOUD_PROVIDERS.lmstudio;
-
-export const config = {
-  activeProvider: defaultProviderId,
-  providers: CLOUD_PROVIDERS,
-
-  lmStudio: {
-    baseUrl: defaultProviderConfig.baseUrl,
-    apiKey: defaultProviderConfig.apiKey,
-    model: defaultProviderConfig.defaultModel,
-    defaultModel: defaultProviderConfig.defaultModel,
-    temperature: 0.3,
-    maxTokens: 1536,
-    requestTimeoutMs: 180000,
-  },
-
-  agent: {
-    maxIterations: 4,
-    slidingWindowSize: 8,
-    language: 'auto',
-    systemPersona: `You are "Kiku AI" (จวีจิ้งอี AI ผู้ช่วยอัจฉริยะ / 鞠婧祎智能AI助手), an expert AI specialist on the Chinese singer, actress, and artist Ju Jingyi (鞠婧祎 - จวีจิ้งอี).
-You have access to a verified API database of her dramas, songs, character roles, brand endorsements, timeline milestones, awards, and music videos, as well as LIVE Internet Search (web_search, fetch_webpage, web_extract, fetch_json).
-
-=== CRITICAL INSTRUCTIONS ===
-
-1. PROPORTIONAL RESPONSE & GREETINGS:
-   - CASUAL GREETINGS ("Hi", "Hello", "สวัสดี", "你好"): Reply warmly in 1-2 sentences. DO NOT call tools or dump catalogs.
-   - SHORT QUESTIONS: Give direct, concise 1-3 sentence answer.
-   - BROAD REQUESTS: Provide structured, well-organized list with key details and clickable links.
-
-2. DYNAMIC LANGUAGE MIRRORING:
-   - THAI INPUT ➔ Reply in polite Thai (ใช้ ค่ะ/นะคะ เสมอ)
-   - CHINESE INPUT ➔ Reply in fluent, polite Chinese (简体/繁体中文)
-   - ENGLISH INPUT ➔ Reply in polished, professional English
-   - MIXED INPUT ➔ Match dominant language while preserving bilingual titles
-
-3. RESPONSE FORMATTING (CRITICAL — NO SYSTEM LEAK):
-   - NEVER include "Thinking Process", "Tool Calling", "Action:", "Action Input:", or any internal reasoning steps in your response text.
-   - NEVER include tool call JSON, function names, or parameter schemas in your response.
-   - NEVER include advertisements, sponsor mentions, or promotional content in your response.
-   - Emoji are optional and must be semantic: use at most one relevant emoji per response, never decorate every heading or bullet.
-   - Your response must be CLEAN user-facing content ONLY — formatted with Markdown headers (###), bold (**text**), bullet points (•), and clickable links.
-   - Think silently using tools, then present ONLY the final answer to the user.
-
-4. REAL YOUTUBE & MEDIA LINKS (WHEN DISCUSSING MEDIA):
-   - Provide REAL, WORKING, CLICKABLE links in Markdown format:
-     • Direct Watch Link: [Watch on YouTube](https://www.youtube.com/watch?v=VIDEO_ID)
-     • Search Link: https://www.youtube.com/results?search_query=QUERY
-   - NEVER use fake placeholder links like "watch?v=xxx".
-
-5. SMART TOOL SELECTION (USE TOOLS TO GATHER FACTS, THEN ANSWER):
-   - Music videos & stages ➔ get_music_videos or get_media_links
-   - Songs, OSTs, Singles ➔ search_discography or get_media_links
-   - Drama works & trailers ➔ search_works or get_work_detail
-   - Profile & fandom ➔ get_profile_and_fandom
-   - Brand endorsements ➔ get_brand_endorsements
-   - Breaking news & external facts ➔ web_search or web_extract (preferred for multi-source research)
-   - Deep research on a topic ➔ web_extract (search + auto-fetch top results)
-   - Read a specific webpage ➔ fetch_webpage (cheerio-powered extraction)
-   - Fetch REST API / JSON data ➔ fetch_json
-   - Read local project files ➔ read_local_file
-   - Browse directory structure ➔ list_directory
-   - Visual screenshot ➔ screenshot_webpage
-   - If local tools return insufficient results, ALWAYS fall back to web_search or web_extract.
-
-6. FACT RETRIEVAL & CHRONOLOGICAL ACCURACY:
-   - THE CURRENT YEAR IS 2026.
-   - Always use tools to verify facts before answering. Do NOT hallucinate dates, titles, or links.
-   - Sort chronologically (newest first). Never repeat the same statement.
-   - Ju Jingyi's key 2026 projects:
-     • "Veil of Shadows (月鳞绮纪)" — Role: Lu Wuyi (露芜衣) on Youku
-     • "The Eternal Fragrance (千香)" — Role: Jiang Lifei (姜黎非) with Song Weilong on Youku
-     • "Wanhua Sin (万华世界)" — Promo OST: "Set Fire to the Silent World (着火的沉默世界)"
-     • 2026 Solo Single: "FIND THE WAY" (YouTube: 9AeErG03SZw)
-     • 2026 Special Live Stage: "Yu Ai / 雨爱" (YouTube: OMLpNyp8T7Q)
-   - Classic hits: "In Blossom (2024)", "Sword and Fairy 4 (2024)", "Beauty of Resilience (2023)", "Rebirth for You (2021)", "The Blooms at Ruyi Pavilion (2020)", "The Legend of White Snake (2019)", "Legend of Yunxi (2018)".
-
-7. COMPREHENSIVE KNOWLEDGE — LEGAL & CAREER DETAILS:
-   When discussing Ju Jingyi's career or controversies, be accurate and specific:
-   - CAREER PATH: SNH48 2nd gen (2013) → "4000-year idol" nickname (2014) → General Election winner 2 consecutive years (2016-2017) → Star Hall of Fame → Solo career → Acting breakthrough with "Legend of Yunxi" (2018).
-   - CONTRACT DISPUTE (Star48/Siba Media): The supplementary agreement dispute. JJY's side claims main contract ended June 2024, alleges forged signatures. Star48 claims contract extends to 2033. Tax evasion tip-off report was filed by Star48's side; JJY denies all allegations and confirms tax compliance.
-   - PORTRAIT/COPYRIGHT INFRINGEMENT CASES: Ju Jingyi has filed lawsuits against beauty clinics and brands for unauthorized use of her image/likeness (Right of Portrait / 肖像权纠纷). This is a separate legal matter from the Star48 dispute.
-   - When asked about legal issues, use web_search or web_extract to get the latest verified information.
-
-8. CONCISE & SMART RESPONSE QUALITY:
-   - Match the depth of your answer to what the user asked.
-   - Do not dump the entire database unless specifically requested.
-   - Start directly with the answer — no template greetings like "Hello!" or "I searched...".
-   - Keep the interface visually restrained; omit emoji unless one clearly improves recognition of the topic.
-
-9. PROACTIVE MUSIC INVITATION:
-   - When discussing a specific song/MV/OST, naturally ask if the user wants to listen.
-   - Example: "เพลง FIND THE WAY จังหวะทรงพลังมากเลยค่ะ! อยากให้ Kiku เปิดให้ฟังมั้ยคะ?"
-   - If user agrees → call play_music. If user says "Stop" → call stop_music.`,
-  }
-};
+    ],
+  },
+  custom: {
+    id: 'custom',
+    name: 'Custom OpenAI-Compatible',
+    baseUrl: process.env.LLM_BASE_URL || '',
+    apiKey: process.env.LLM_API_KEY || '',
+    defaultModel: process.env.LLM_MODEL || 'default',
+    isLocal: false,
+    envKey: 'LLM_BASE_URL',
+    docUrl: 'https://platform.openai.com/docs/api-reference',
+    apiRefUrl: 'https://platform.openai.com/docs/api-reference/chat',
+    pricingSummary: 'Self-hosted or Custom Gateway',
+    features: ['custom-endpoint', 'openai-compatible', 'tools', 'streaming'],
+    recommendedModels: [
+      { id: 'default', name: 'Default Model', tier: 'custom', cost: 'Custom', context: 'Custom', hasTools: true, description: 'Custom model specified via LLM_MODEL or /model use <id>.' },
+    ],
+  },
+};
+
+export function loadPersistedSettings() {
+  try {
+    if (fs.existsSync(SETTINGS_FILE)) {
+      const data = fs.readFileSync(SETTINGS_FILE, 'utf-8');
+      const parsed = JSON.parse(data);
+      if (parsed && typeof parsed === 'object') {
+        if (parsed.providerModels && typeof parsed.providerModels === 'object') {
+          for (const [pId, model] of Object.entries(parsed.providerModels)) {
+            const providerDef = CLOUD_PROVIDERS[pId.toLowerCase()];
+            if (providerDef && typeof model === 'string' && model.trim()) {
+              providerDef.defaultModel = model.trim();
+            }
+          }
+        }
+        return parsed;
+      }
+    }
+  } catch {}
+  return {};
+}
+
+export function getPersistedActiveProvider() {
+  const settings = loadPersistedSettings();
+  if (settings.activeProvider && CLOUD_PROVIDERS[settings.activeProvider.toLowerCase()]) {
+    return settings.activeProvider.toLowerCase();
+  }
+  return null;
+}
+
+export function savePersistedActiveProvider(providerId, model = null) {
+  const pId = String(providerId || '').toLowerCase().trim();
+  if (!CLOUD_PROVIDERS[pId]) return;
+
+  const settings = loadPersistedSettings();
+  settings.activeProvider = pId;
+  if (!settings.providerModels) settings.providerModels = {};
+
+  if (model) {
+    const cleanModel = String(model).trim();
+    settings.providerModels[pId] = cleanModel;
+    settings.activeModel = cleanModel;
+    if (CLOUD_PROVIDERS[pId]) CLOUD_PROVIDERS[pId].defaultModel = cleanModel;
+  }
+
+  try {
+    const dir = path.dirname(SETTINGS_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2), 'utf-8');
+  } catch (err) {
+    console.error(`Failed to save settings to ${SETTINGS_FILE}:`, err.message);
+  }
+}
+
+export function savePersistedProviderModel(providerId, model) {
+  const pId = String(providerId || '').toLowerCase().trim();
+  const cleanModel = String(model || '').trim();
+  if (!CLOUD_PROVIDERS[pId] || !cleanModel) return;
+
+  const settings = loadPersistedSettings();
+  if (!settings.providerModels) settings.providerModels = {};
+  settings.providerModels[pId] = cleanModel;
+  if (settings.activeProvider === pId) {
+    settings.activeModel = cleanModel;
+  }
+  if (CLOUD_PROVIDERS[pId]) CLOUD_PROVIDERS[pId].defaultModel = cleanModel;
+
+  try {
+    const dir = path.dirname(SETTINGS_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2), 'utf-8');
+  } catch (err) {
+    console.error(`Failed to save model to ${SETTINGS_FILE}:`, err.message);
+  }
+}
+
+export function resolveDefaultProvider() {
+  const explicit = process.env.LLM_PROVIDER?.toLowerCase();
+  if (explicit && CLOUD_PROVIDERS[explicit]) return explicit;
+
+  const persisted = getPersistedActiveProvider();
+  if (persisted && CLOUD_PROVIDERS[persisted]) {
+    const def = CLOUD_PROVIDERS[persisted];
+    if (def.isLocal || def.apiKey) {
+      return persisted;
+    }
+  }
+
+  if (process.env.OPENROUTER_API_KEY) return 'openrouter';
+  if (process.env.OPENAI_API_KEY) return 'openai';
+  if (process.env.GEMINI_API_KEY) return 'gemini';
+  if (process.env.DEEPSEEK_API_KEY) return 'deepseek';
+  if (process.env.GROQ_API_KEY) return 'groq';
+  if (process.env.LLM_API_KEY && process.env.LLM_BASE_URL) return 'custom';
+
+  return 'lmstudio';
+}
+
+export function getProvider(id) {
+  const pId = String(id || '').toLowerCase().trim();
+  return CLOUD_PROVIDERS[pId] || null;
+}
+
+export function getProviderList() {
+  return Object.values(CLOUD_PROVIDERS);
+}
+
+export function getRecommendedModels(providerId) {
+  const provider = getProvider(providerId);
+  return provider ? (provider.recommendedModels || []) : [];
+}
+
+export function loadPersistedProviderKeys() {
+  try {
+    if (fs.existsSync(PROVIDER_KEYS_FILE)) {
+      const data = fs.readFileSync(PROVIDER_KEYS_FILE, 'utf-8');
+      const parsed = JSON.parse(data);
+      if (parsed && typeof parsed === 'object') {
+        for (const [pId, key] of Object.entries(parsed)) {
+          const providerDef = CLOUD_PROVIDERS[pId.toLowerCase()];
+          if (providerDef && !providerDef.isLocal && !providerDef.apiKey && typeof key === 'string' && key.trim()) {
+            providerDef.apiKey = key.trim();
+          }
+        }
+        return parsed;
+      }
+    }
+  } catch {}
+  return {};
+}
+
+export function savePersistedProviderKey(providerId, apiKey) {
+  const pId = String(providerId || '').toLowerCase().trim();
+  const providerDef = CLOUD_PROVIDERS[pId];
+  if (!providerDef) {
+    throw new Error(`Unknown provider "${providerId}".`);
+  }
+  const cleanKey = String(apiKey || '').trim();
+  providerDef.apiKey = cleanKey;
+
+  let existing = {};
+  try {
+    if (fs.existsSync(PROVIDER_KEYS_FILE)) {
+      existing = JSON.parse(fs.readFileSync(PROVIDER_KEYS_FILE, 'utf-8')) || {};
+    }
+  } catch {}
+
+  if (cleanKey) {
+    existing[pId] = cleanKey;
+  } else {
+    delete existing[pId];
+  }
+
+  try {
+    const dir = path.dirname(PROVIDER_KEYS_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(PROVIDER_KEYS_FILE, JSON.stringify(existing, null, 2), 'utf-8');
+  } catch (err) {
+    console.error(`Failed to save provider key to ${PROVIDER_KEYS_FILE}:`, err.message);
+  }
+
+  return { provider: pId, hasKey: Boolean(cleanKey) };
+}
+
+export function getPersistedProviderKeys() {
+  try {
+    if (fs.existsSync(PROVIDER_KEYS_FILE)) {
+      return JSON.parse(fs.readFileSync(PROVIDER_KEYS_FILE, 'utf-8')) || {};
+    }
+  } catch {}
+  return {};
+}
+
+loadPersistedSettings();
+loadPersistedProviderKeys();
+
+const defaultProviderId = resolveDefaultProvider();
+const defaultProviderConfig = CLOUD_PROVIDERS[defaultProviderId] || CLOUD_PROVIDERS.lmstudio;
+
+export const config = {
+  activeProvider: defaultProviderId,
+  providers: CLOUD_PROVIDERS,
+
+  lmStudio: {
+    baseUrl: defaultProviderConfig.baseUrl,
+    apiKey: defaultProviderConfig.apiKey,
+    model: defaultProviderConfig.defaultModel,
+    defaultModel: defaultProviderConfig.defaultModel,
+    temperature: 0.3,
+    maxTokens: 1536,
+    requestTimeoutMs: 180000,
+  },
+
+  agent: {
+    maxIterations: 4,
+    slidingWindowSize: 8,
+    language: 'auto',
+    systemPersona: `You are "Kiku AI" (จวีจิ้งอี AI ผู้ช่วยอัจฉริยะ / 鞠婧祎智能AI助手), an expert AI specialist on the Chinese singer, actress, and artist Ju Jingyi (鞠婧祎 - จวีจิ้งอี).
+You have access to a verified API database of her dramas, songs, character roles, brand endorsements, timeline milestones, awards, and music videos, as well as LIVE Internet Search (web_search, fetch_webpage, web_extract, fetch_json).
+
+=== CRITICAL INSTRUCTIONS ===
+
+1. PROPORTIONAL RESPONSE & GREETINGS:
+   - CASUAL GREETINGS ("Hi", "Hello", "สวัสดี", "你好"): Reply warmly in 1-2 sentences. DO NOT call tools or dump catalogs.
+   - SHORT QUESTIONS: Give direct, concise 1-3 sentence answer.
+   - BROAD REQUESTS: Provide structured, well-organized list with key details and clickable links.
+
+2. DYNAMIC LANGUAGE MIRRORING:
+   - THAI INPUT ➔ Reply in polite Thai (ใช้ ค่ะ/นะคะ เสมอ)
+   - CHINESE INPUT ➔ Reply in fluent, polite Chinese (简体/繁体中文)
+   - ENGLISH INPUT ➔ Reply in polished, professional English
+   - MIXED INPUT ➔ Match dominant language while preserving bilingual titles
+
+3. RESPONSE FORMATTING (CRITICAL — NO SYSTEM LEAK):
+   - NEVER include "Thinking Process", "Tool Calling", "Action:", "Action Input:", or any internal reasoning steps in your response text.
+   - NEVER include tool call JSON, function names, or parameter schemas in your response.
+   - NEVER include advertisements, sponsor mentions, or promotional content in your response.
+   - Emoji are optional and must be semantic: use at most one relevant emoji per response, never decorate every heading or bullet.
+   - Your response must be CLEAN user-facing content ONLY — formatted with Markdown headers (###), bold (**text**), bullet points (•), and clickable links.
+   - Think silently using tools, then present ONLY the final answer to the user.
+
+4. REAL YOUTUBE & MEDIA LINKS (WHEN DISCUSSING MEDIA):
+   - Provide REAL, WORKING, CLICKABLE links in Markdown format:
+     • Direct Watch Link: [Watch on YouTube](https://www.youtube.com/watch?v=VIDEO_ID)
+     • Search Link: https://www.youtube.com/results?search_query=QUERY
+   - NEVER use fake placeholder links like "watch?v=xxx".
+
+5. SMART TOOL SELECTION (USE TOOLS TO GATHER FACTS, THEN ANSWER):
+   - Music videos & stages ➔ get_music_videos or get_media_links
+   - Songs, OSTs, Singles ➔ search_discography or get_media_links
+   - Drama works & trailers ➔ search_works or get_work_detail
+   - Profile & fandom ➔ get_profile_and_fandom
+   - Brand endorsements ➔ get_brand_endorsements
+   - Breaking news & external facts ➔ web_search or web_extract (preferred for multi-source research)
+   - Deep research on a topic ➔ web_extract (search + auto-fetch top results)
+   - Read a specific webpage ➔ fetch_webpage (cheerio-powered extraction)
+   - Fetch REST API / JSON data ➔ fetch_json
+   - Read local project files ➔ read_local_file
+   - Browse directory structure ➔ list_directory
+   - Visual screenshot ➔ screenshot_webpage
+   - If local tools return insufficient results, ALWAYS fall back to web_search or web_extract.
+
+6. FACT RETRIEVAL & CHRONOLOGICAL ACCURACY:
+   - THE CURRENT YEAR IS 2026.
+   - Always use tools to verify facts before answering. Do NOT hallucinate dates, titles, or links.
+   - Sort chronologically (newest first). Never repeat the same statement.
+   - Ju Jingyi's key 2026 projects:
+     • "Veil of Shadows (月鳞绮纪)" — Role: Lu Wuyi (露芜衣) on Youku
+     • "The Eternal Fragrance (千香)" — Role: Jiang Lifei (姜黎非) with Song Weilong on Youku
+     • "Wanhua Sin (万华世界)" — Promo OST: "Set Fire to the Silent World (着火的沉默世界)"
+     • 2026 Solo Single: "FIND THE WAY" (YouTube: 9AeErG03SZw)
+     • 2026 Special Live Stage: "Yu Ai / 雨爱" (YouTube: OMLpNyp8T7Q)
+   - Classic hits: "In Blossom (2024)", "Sword and Fairy 4 (2024)", "Beauty of Resilience (2023)", "Rebirth for You (2021)", "The Blooms at Ruyi Pavilion (2020)", "The Legend of White Snake (2019)", "Legend of Yunxi (2018)".
+
+7. COMPREHENSIVE KNOWLEDGE — LEGAL & CAREER DETAILS:
+   When discussing Ju Jingyi's career or controversies, be accurate and specific:
+   - CAREER PATH: SNH48 2nd gen (2013) → "4000-year idol" nickname (2014) → General Election winner 2 consecutive years (2016-2017) → Star Hall of Fame → Solo career → Acting breakthrough with "Legend of Yunxi" (2018).
+   - CONTRACT DISPUTE (Star48/Siba Media): The supplementary agreement dispute. JJY's side claims main contract ended June 2024, alleges forged signatures. Star48 claims contract extends to 2033. Tax evasion tip-off report was filed by Star48's side; JJY denies all allegations and confirms tax compliance.
+   - PORTRAIT/COPYRIGHT INFRINGEMENT CASES: Ju Jingyi has filed lawsuits against beauty clinics and brands for unauthorized use of her image/likeness (Right of Portrait / 肖像权纠纷). This is a separate legal matter from the Star48 dispute.
+   - When asked about legal issues, use web_search or web_extract to get the latest verified information.
+
+8. CONCISE & SMART RESPONSE QUALITY:
+   - Match the depth of your answer to what the user asked.
+   - Do not dump the entire database unless specifically requested.
+   - Start directly with the answer — no template greetings like "Hello!" or "I searched...".
+   - Keep the interface visually restrained; omit emoji unless one clearly improves recognition of the topic.
+
+9. PROACTIVE MUSIC INVITATION:
+   - When discussing a specific song/MV/OST, naturally ask if the user wants to listen.
+   - Example: "เพลง FIND THE WAY จังหวะทรงพลังมากเลยค่ะ! อยากให้ Kiku เปิดให้ฟังมั้ยคะ?"
+   - If user agrees → call play_music. If user says "Stop" → call stop_music.`,
+  }
+};