kiku-agent 1.0.11 → 1.2.0

package/server/web-chat/core/connection.js

@@ -0,0 +1,194 @@
+import fs from 'node:fs';
+import { createHash } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { LLMClient, LMStudioClient } from '../../agent/llmClient.js';
+import { KikuAgent } from '../../agent/agentCore.js';
+import { AgentMemory } from '../../agent/memory.js';
+import { ModelManager } from '../../agent/modelManager.js';
+import { config } from '../../agent/config.js';
+import { PUBLIC_REMOTE_TOOL_NAMES } from '../../agent/publicTools.js';
+
+export const webAgentCache = new Map();
+export let sharedWebMemory = new AgentMemory({ persistence: false });
+export let currentAgent = null;
+const MAX_WEB_AGENT_SESSIONS = 24;
+
+export function setSharedWebMemory(mem) {
+  if (mem) sharedWebMemory = mem;
+}
+
+export function setCurrentAgent(agent) {
+  if (agent) {
+    currentAgent = agent;
+    if (agent.memory) sharedWebMemory = agent.memory;
+  }
+}
+
+export function normalizeWebSessionId(value) {
+  const normalized = String(value || '').trim().replace(/[^a-zA-Z0-9_-]+/g, '_').slice(0, 100);
+  return normalized || null;
+}
+
+export function credentialFingerprint(value) {
+  if (!value) return 'no-key';
+  return createHash('sha256').update(String(value)).digest('hex').slice(0, 12);
+}
+
+export function computeSessionHash(messages) {
+  if (!Array.isArray(messages) || messages.length === 0) return '';
+  const payload = messages.map(m => (m.role || '') + ':' + (m.parts?.[0]?.content || m.text || '')).join('|');
+  return createHash('sha256').update(payload).digest('hex').slice(0, 16);
+}
+
+export function getWebAgentCacheKey({ sessionId, provider, model, apiKey }) {
+  if (!sessionId) return null;
+  return [sessionId, provider || 'lmstudio', model || 'default', credentialFingerprint(apiKey)].join(':');
+}
+
+export async function prepareWebAgent(agent, options = {}) {
+  await agent.ready();
+  if (Array.isArray(options.history) && options.history.length > 0) {
+    const agentMsgCount = agent.session?.messages?.length || 0;
+    const frontendMsgCount = options.history.length;
+    await agent.hydrateConversationHistory(options.history, {
+      sessionId: options.sessionId,
+      maxMessages: 24,
+      force: frontendMsgCount > agentMsgCount,
+    });
+  }
+  return agent;
+}
+
+export function cacheWebAgentConnection(cacheKey, connection) {
+  if (!cacheKey) return;
+  webAgentCache.delete(cacheKey);
+  webAgentCache.set(cacheKey, connection);
+  while (webAgentCache.size > MAX_WEB_AGENT_SESSIONS) {
+    const oldestKey = webAgentCache.keys().next().value;
+    const oldest = webAgentCache.get(oldestKey);
+    oldest?.agent?.saveSession?.().catch(() => {});
+    const msgCount = oldest?.agent?.session?.messages?.length || 0;
+    if (msgCount === 0) {
+      const storageFile = oldest?.agent?.session?.storageFile;
+      if (storageFile) {
+        fs.promises.unlink(storageFile).catch(() => {});
+      }
+    }
+    webAgentCache.delete(oldestKey);
+  }
+}
+
+export async function waitForLMStudio(baseUrl, timeoutMs = 8000) {
+  const client = new LMStudioClient({ baseUrl });
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const health = await client.checkConnection();
+      if (health.connected) return health;
+    } catch {}
+    await new Promise(r => setTimeout(r, 600));
+  }
+  return null;
+}
+
+export async function attemptAutoStartLMStudio(baseUrl, model) {
+  const isWin = process.platform === 'win32';
+  const isMac = process.platform === 'darwin';
+
+  const candidates = isWin
+    ? [
+      `${process.env.LOCALAPPDATA}\\LM Studio\\LM Studio.exe`,
+      `${process.env.LOCALAPPDATA}\\Programs\\LM Studio\\LM Studio.exe`,
+      'C:\\Program Files\\LM Studio\\LM Studio.exe'
+    ]
+    : isMac
+      ? ['/Applications/LM Studio.app/Contents/MacOS/LM Studio']
+      : ['lmstudio', '/usr/local/bin/lmstudio', '/opt/lmstudio/bin/lmstudio'];
+
+  const exe = candidates.find(p => {
+    if (p.includes('/') || p.includes('\\')) {
+      try { return fs.existsSync(p); } catch { return false; }
+    }
+    return true;
+  });
+
+  if (!exe) return null;
+
+  try {
+    let port = '1234';
+    try { const parsedUrl = new URL(baseUrl); if (parsedUrl.port) port = parsedUrl.port; } catch {}
+
+    const child = spawn(exe, isWin
+      ? ['--model', model || 'google/gemma-4-e4b', '--serve', '--port', port]
+      : ['serve', '--model', model || 'google/gemma-4-e4b', '--port', port],
+      { detached: true, stdio: 'ignore', windowsHide: true }
+    );
+    child.unref();
+
+    return await waitForLMStudio(baseUrl, 10000);
+  } catch {
+    return null;
+  }
+}
+
+export async function resolveAgentConnection(customOptions = {}) {
+  const provider = customOptions.provider || 'lmstudio';
+  const requestedModel = customOptions.model || config.providers?.[provider]?.model || 'google/gemma-4-e4b';
+  const baseUrl = customOptions.baseUrl || config.providers?.[provider]?.baseUrl || 'http://127.0.0.1:1234/v1';
+  const sessionId = normalizeWebSessionId(customOptions.sessionId);
+  // A remotely reachable endpoint must never inherit provider credentials from
+  // the server process. Only an explicitly supplied per-request key is used.
+  const apiKey = customOptions.apiKey || '';
+
+  const client = new LLMClient({
+    provider,
+    baseUrl,
+    model: requestedModel,
+    apiKey
+  });
+
+  const modelManager = new ModelManager(client, { requestedModel });
+  let resolution = await modelManager.resolve({ requestedModel });
+
+  if (provider === 'lmstudio' && resolution.state === 'server_offline' && process.env.NODE_ENV !== 'test' && !process.execArgv.includes('--test')) {
+    const started = await attemptAutoStartLMStudio(baseUrl, requestedModel);
+    if (started) {
+      resolution = await modelManager.resolve({ requestedModel });
+    }
+  }
+
+  if (resolution.connected && resolution.selectedModel) {
+    const agent = new KikuAgent({
+      client,
+      thinkingMode: customOptions.thinking || 'show',
+      memory: new AgentMemory({ persistence: false }),
+      sessionId,
+      sessionPersistence: false,
+      allowedToolNames: PUBLIC_REMOTE_TOOL_NAMES,
+    });
+    await prepareWebAgent(agent, { history: customOptions.history, sessionId });
+    const connection = {
+      ready: true,
+      agent,
+      client,
+      provider,
+      model: resolution.selectedModel,
+      models: resolution.models || [],
+      usedFallback: resolution.usedFallback || false,
+      resolution,
+      contentHash: computeSessionHash(agent.session?.messages || [])
+    };
+    return connection;
+  }
+
+  return {
+    ready: false,
+    client,
+    provider,
+    model: requestedModel,
+    models: resolution.models || [],
+    state: resolution.state,
+    error: resolution.error || 'Server offline',
+    resolution
+  };
+}

package/server/web-chat/core/conversationContext.js

@@ -0,0 +1,82 @@
+const FOLLOW_UP_PATTERNS = [
+  /^(?:แล้ว)?ทำไม(?:ถึง)?(?:น่า|จึง)?/i,
+  /^(?:แล้ว)?(?:เรื่อง|งาน|อัน|สิ่ง|คน)(?:นี้|นั้น)/i,
+  /^(?:เขา|เธอ|มัน|นี่|นั่น)(?:\s|$)/i,
+  /^(?:น่า)?จับตามอง(?:อย่างไร|ยังไง|ไหม|มั้ย)?[?.!]?$/i,
+  /^(?:why|how|what)\s+(?:is|are|does|do|about)\s+(?:it|this|that|they|she|he)\b/i,
+  /^(?:why|how)\s+(?:so|is that)\b/i,
+  /^(?:为什么|为何|怎么|这个|那个|她|他|它)/
+  ,/^(?:ดำเนินการต่อ|ทำต่อ|ต่อเลย|ต่อไป|ช่วย(?:วิเคราะห์|ขยาย|เจาะลึก)(?:ต่อ)?|continue|go on|proceed)(?:\s|:|$)/i
+];
+
+const DOMAIN_PATTERNS = {
+  fashion_event: /(?:vogue|gala|red\s*carpet|fashion|แฟชั่น|กาล่า|พรมแดง|งานแฟชั่น|盛典|红毯|时尚)/i,
+  drama: /(?:ซีรีส์|ละคร|ภาพยนตร์|หนัง|นักแสดง|บทบาท|ตัวละคร|in\s*blossom|yunxi|ฮวาเจียน|หยุนซี|剧|电视剧|电影|角色)/i,
+  music: /(?:เพลง|อัลบั้ม|ดนตรี|ost|single|concert|คอนเสิร์ต|music|song|歌曲|音乐|演唱会)/i,
+  brand: /(?:แบรนด์|พรีเซนเตอร์|ambassador|endorsement|versace|luxury|代言|品牌)/i,
+  awards: /(?:รางวัล|เกียรติยศ|award|ceremony|获奖|奖项)/i,
+  profile: /(?:ประวัติ|จวีจิ้งอี|ju\s*jingyi|kiku|鞠婧祎|profile|who\s+is)/i
+};
+
+function messageText(message) {
+  if (!message || typeof message !== 'object') return '';
+  if (typeof message.text === 'string') return message.text;
+  if (typeof message.content === 'string') return message.content;
+  if (Array.isArray(message.parts)) {
+    return message.parts.map(part => part?.content || part?.text || '').join(' ');
+  }
+  return '';
+}
+
+function cleanHistoryText(value) {
+  return String(value || '')
+    .replace(/\[SYSTEM (?:DIRECTIVE|INSTRUCTION)[\s\S]*?\]/gi, ' ')
+    .replace(/\[SUGGESTED_FOLLOW_UPS\][\s\S]*?\[\/SUGGESTED_FOLLOW_UPS\]/gi, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+export function detectConversationDomain(value) {
+  const text = String(value || '');
+  for (const [domain, pattern] of Object.entries(DOMAIN_PATTERNS)) {
+    if (pattern.test(text)) return domain;
+  }
+  return 'general';
+}
+
+export function isContextDependentQuery(query) {
+  const text = String(query || '').trim();
+  if (!text) return false;
+  const explicitContinuation = /^(?:ดำเนินการต่อ|ทำต่อ|ต่อเลย|ต่อไป|ช่วย(?:วิเคราะห์|ขยาย|เจาะลึก)(?:ต่อ)?|continue|go on|proceed)(?:\s|:|$)/i.test(text);
+  if (text.length > (explicitContinuation ? 500 : 100)) return false;
+  return FOLLOW_UP_PATTERNS.some(pattern => pattern.test(text));
+}
+
+export function resolveConversationContext(query, history = [], now = new Date()) {
+  const originalQuery = String(query || '').trim();
+  const recent = (Array.isArray(history) ? history : [])
+    .slice(-8)
+    .map(message => ({ role: message?.role, text: cleanHistoryText(messageText(message).slice(0, 6000)) }))
+    .filter(message => message.text);
+  const contextDependent = isContextDependentQuery(originalQuery);
+  const previousUser = [...recent].reverse().find(message => message.role === 'user');
+  const previousAssistant = [...recent].reverse().find(message => message.role === 'assistant' || message.role === 'bot');
+  const anchorSource = [previousUser?.text, previousAssistant?.text].filter(Boolean).join(' — ');
+  const anchor = anchorSource.slice(0, 1200);
+  const contextual = Boolean(contextDependent && anchor);
+  const domain = detectConversationDomain(contextual ? anchor : originalQuery);
+  const today = now.toISOString().slice(0, 10);
+
+  if (!contextual) {
+    return { originalQuery, contextual: false, anchor: '', domain, today, resolvedQuery: originalQuery };
+  }
+
+  const resolvedQuery = `[CONVERSATION TOPIC ANCHOR — priority over persona defaults]\n` +
+    `Current date: ${today}\n` +
+    `Previous topic: ${anchor}\n` +
+    `Current follow-up: ${originalQuery}\n` +
+    `Answer only the new request in the follow-up. Use the previous answer as context but do not copy or restate it unless a short recap is necessary. Do not switch the subject to Ju Jingyi, her biography, music, or dramas unless the previous topic or current follow-up explicitly requires it. If the reference is still ambiguous, ask one focused clarification question.\n` +
+    `[/CONVERSATION TOPIC ANCHOR]`;
+
+  return { originalQuery, contextual: true, anchor, domain, today, resolvedQuery };
+}

package/server/web-chat/core/directCatalogEngine.js

@@ -0,0 +1,196 @@
+import { executeTool } from '../../agent/tools.js';
+import { makeInspectableToolPayload } from './toolInspector.js';
+import { generateDynamicFollowUps } from './followUpEngine.js';
+import { buildDramaSpecialistAnswer } from './dramaKnowledge.js';
+
+export async function executeDirectCatalogKnowledge(query, _persona = 'default', options = {}) {
+  const toolsUsed = [];
+  const q = String(query || '').toLowerCase();
+  const conversationContext = options.conversationContext || null;
+  let answerParts = [];
+
+  const addToolExec = async (name, args) => {
+    try {
+      const t0 = Date.now();
+      const res = await executeTool(name, args);
+      const dur = Date.now() - t0;
+      toolsUsed.push({
+        name,
+        input: makeInspectableToolPayload(args),
+        result: makeInspectableToolPayload(res),
+        resultCount: Array.isArray(res?.results || res?.works || res?.songs || res?.brands || res?.awards)
+          ? (res.results || res.works || res.songs || res.brands || res.awards).length
+          : 1,
+        durationMs: dur
+      });
+      return res;
+    } catch {
+      return null;
+    }
+  };
+
+  const specialistAnswer = await buildDramaSpecialistAnswer(query, addToolExec);
+  if (specialistAnswer) answerParts.push(specialistAnswer);
+
+  if (!specialistAnswer && (q.includes('ประวัติ') || q.includes('who is') || q.includes('profile') || q.includes('slogan') || q.includes('ฉายา'))) {
+    const profile = await addToolExec('get_profile_and_fandom', {});
+    if (profile) {
+      answerParts.push(`### 🌸 ประวัติและข้อมูลส่วนตัว: จวีจิ้งอี (Ju Jingyi / 鞠婧祎)\n\n` +
+        `- **ชื่อภาษาจีน:** ${profile.profile?.nameCn || '鞠婧祎'} (${profile.profile?.pinyin || 'Jū Jìngyī'})\n` +
+        `- **ชื่อสากล/ฉายา:** Kiku / เสี่ยวจวี (小鞠) / สาวงาม 4,000 ปี\n` +
+        `- **วันเกิด:** ${profile.profile?.birthDate || '18 มิถุนายน 1994'}\n` +
+        `- **บ้านเกิด:** ${profile.profile?.birthPlace || 'เมืองสุ้ยหนิง มณฑลเสฉวน ประเทศจีน'}\n` +
+        `- **ชื่อกลุ่มแฟนคลับ (Fandom):** ${profile.fandom?.name || 'Miju (蜜橘 / ฮันนี่แทงเจอรีน)'}\n` +
+        `- **สโลแกนประจำตัว:** "${profile.fandom?.slogan || '鞠世无双，与祎同行'}" (หนึ่งเดียวในใต้หล้า เคียงคู่จิ้งอีตลอดไป)\n` +
+        `- **ความสามารถพิเศษ:** ขับร้อง, ไวโอลิน, เปียโน, กู่เจิง, เต้นรำ`);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('七星彩') || q.includes('qi xiang cai') || q.includes('qi xing cai') || q.includes('ชีซิงไฉ่'))) {
+    await addToolExec('search_works', { query: '七星彩' });
+    answerParts.push(`### 🎬 ข้อมูลซีรีส์ 《七星彩》 (Qi Xing Cai / ชีซิงไฉ่)\n\n` +
+      `**《七星彩》** เป็นโปรเจกต์ซีรีส์จีนโบราณฟอร์มยักษ์ (ระดับ S+) ผลิตโดย **Youku (优酷) และ Stellar Media (恒星引力传媒)** ดัดแปลงจากนวนิยายชื่อดังของ **หมิงเยว่ตัง (明月珰)**\n\n` +
+      `#### 📖 เรื่องย่อและเนื้อหาหลัก:\n` +
+      `- เล่าเรื่องราวของ **'จี้เฉิง' (纪澄)** บุตรสาวตระกูลพ่อค้าที่ครอบครัวประสบเคราะห์กรรม ถูกบีบให้แต่งงาน นางจึงต้องใช้ความฉลาด ปฏิภาณไหวพริบ และมารยาเอาตัวรอด เดินทางไปพึ่งพาญาติในตระกูลขุนนางใหญ่เพื่อหาคู่ครองที่พึ่งพาได้\n` +
+      `- นางได้พบกับ **'เสิ่นเช่อ' (沈彻)** แม่ทัพหนุ่มผู้ชาญฉลาด ทั้งสองชิงไหวชิงพริบ ผลัดกันรุกผลัดกันรับจนก่อเกิดเป็นความผูกพันและร่วมมือกันกอบกู้วิกฤตตระกูลและบ้านเมือง\n\n` +
+      `#### 🔥 ทำไมชาวเน็ตถึงให้ความสนใจอย่างมาก (เหตุผลที่เป็นกระแส):\n` +
+      `1. **ค่ายผู้ผลิตระดับท็อป (Stellar Media / 恒星引力):** เป็นค่ายเดียวกับที่สร้างผลงานภาพสวยอลังการอย่าง *ของรักของข้า (Love Between Fairy and Devil)* และ *สื่อรักยี่สิบสี่เทศกาล (Fox Spirit Matchmaker)* ทำให้คอซีรีส์ตั้งตารองานภาพและคอสตูมเป็นอย่างมาก\n` +
+      `2. **กระแสข่าวลือแคสติ้งนักแสดง (Casting Rumors / 选角瓜):** บทนางเอก 'จี้เฉิง' ต้องเป็นหญิงงามล่มเมืองที่ทั้งสวย ฉลาด ร้ายลึก และมีเสน่ห์ จึงมีการปล่อยข่าวลือในโซเชียลจีน (Weibo, Douban, Bilibili) จับคู่กับนักแสดงหญิงแถวหน้าหลายคน รวมถึงมีชื่อของ **'จวีจิ้งอี' (Ju Jingyi)**, หลูอวี้เสี่ยว, ซ่งจู่เอ๋อร์ ฯลฯ ถูกนำมาพูดถึงและถกเถียงกันอย่างกว้างขวาง\n` +
+      `3. **สถานะปัจจุบัน:** ยังอยู่ในขั้นตอนการเตรียมการ/รอประกาศอย่างเป็นทางการ (ยังไม่มีการยืนยันรายชื่อนักแสดงทางการจากทาง Youku หรือสตูดิโอของศิลปิน)\n\n` +
+      `> ⚠️ **ข้อควรระวัง (Disambiguation):** 《七星彩》 เป็นคนละผลงานกับซีรีส์และเพลง 《千香》 (The Eternal Fragrance / พันกลิ่นบุปผา) ที่จวีจิ้งอีนำแสดงร่วมกับ ซ่งเวยหลง นะคะ`);
+  }
+
+  if (!specialistAnswer && (q.includes('ซีรีส์') || q.includes('ละคร') || q.includes('หนัง') || q.includes('ผลงาน') || q.includes('ฮวาเจียนหลิง') || q.includes('หยุนซี') || q.includes('blossom') || q.includes('yunxi') || q.includes('fairy') || q.includes('บทบาท'))) {
+    const worksRes = await addToolExec('search_works', { query: q.replace(/(ซีรีส์|ละคร|หนัง|ผลงาน|เรื่อง|เด่น|ของ|จวีจิ้งอี)/g, '').trim() });
+    const works = worksRes?.works || [];
+    if (works.length > 0) {
+      let md = `### 🎬 ผลงานซีรีส์และภาพยนตร์ที่โดดเด่น (${works.length} เรื่อง)\n\n`;
+      works.slice(0, 15).forEach(w => {
+        md += `#### 🌟 **${w.titleTh || w.titleCn}** (${w.titleCn || ''})\n` +
+          `- **บทบาทที่ได้รับ:** ${w.role || w.character || 'นักแสดงนำ'}\n` +
+          `- **ปีที่ฉาย:** ${w.year || 'N/A'} • **ประเภท:** ${w.category || 'ซีรีส์โบราณ/โรแมนติก'}\n` +
+          `- **เรื่องย่อ:** ${w.synopsis || w.description || 'ผลงานซีรีส์ชื่อดังของจวีจิ้งอี'}\n` +
+          `- **ช่องทางรับชม:** ${w.streamingPlatform || w.platform || 'ไม่ระบุในแคตตาล็อก'}\n`;
+        if (w.youtubeSearchUrl) {
+          md += `- 🔗 [ดูตัวอย่างบน YouTube](${w.youtubeSearchUrl})\n\n`;
+        } else {
+          md += `\n`;
+        }
+      });
+      answerParts.push(md);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('เพลง') || q.includes('อัลบั้ม') || q.includes('ost') || q.includes('everyday') || q.includes('don\'t touch') || q.includes('ร้อง'))) {
+    const discoRes = await addToolExec('search_discography', { query: q.replace(/(เพลง|อัลบั้ม|ost|ของ|จวีจิ้งอี)/g, '').trim() });
+    const songs = discoRes?.songs || [];
+    if (songs.length > 0) {
+      let md = `### 🎵 ผลงานเพลงและเพลงประกอบซีรีส์ (Discography - ${songs.length} เพลง)\n\n`;
+      songs.slice(0, 20).forEach(s => {
+        md += `- **${s.titleTh || s.titleCn}** (${s.titleCn || ''}) — *ปี ${s.year || ''}* [ประเภท: ${s.work || 'Single'}]\n`;
+        if (s.youtubeUrl) md += `  - 🔗 [ฟังบน YouTube](${s.youtubeUrl})\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('แบรนด์') || q.includes('พรีเซนเตอร์') || q.includes('ambassador') || q.includes('versace') || q.includes('luxury'))) {
+    const brandsRes = await addToolExec('get_brand_endorsements', {});
+    const brands = brandsRes?.brands || [];
+    if (brands.length > 0) {
+      let md = `### 👑 บทบาท Brand Ambassador และพรีเซนเตอร์ระดับโลก (${brands.length} แบรนด์)\n\n`;
+      brands.slice(0, 15).forEach(b => {
+        md += `- **${b.brand}** — ตำแหน่ง: **${b.role}** (${b.category || 'Luxury'}) [ปี ${b.year || 'ปัจจุบัน'}]\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('รางวัล') || q.includes('award') || q.includes('เกียรติยศ') || q.includes('weibo'))) {
+    const awardsRes = await addToolExec('get_awards', {});
+    const awards = awardsRes?.awards || [];
+    if (awards.length > 0) {
+      let md = `### 🏆 รางวัลและความสำเร็จสำคัญ (${awards.length} รางวัล)\n\n`;
+      awards.slice(0, 20).forEach(a => {
+        md += `- **${a.year || ''}**: ${a.award || a.title} (${a.ceremony || 'งานประกาศรางวัล'}) — *${a.category || ''}*\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('ไทม์ไลน์') || q.includes('timeline') || q.includes('snh48') || q.includes('เส้นทาง') || q.includes('อดีต'))) {
+    const timelineRes = await addToolExec('get_career_timeline', {});
+    const events = timelineRes?.timeline || [];
+    if (events.length > 0) {
+      let md = `### 🌸 ไทม์ไลน์เส้นทางอาชีพสำคัญ (Career Timeline - ${events.length} เหตุการณ์)\n\n`;
+      events.slice(0, 20).forEach(e => {
+        md += `- **ปี ${e.year}**: ${e.title} — ${e.description || ''}\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  if (!specialistAnswer && (q.includes('บทบาท') || q.includes('ตัวละคร') || q.includes('character') || q.includes('role'))) {
+    const rolesRes = await addToolExec('get_character_roles', {});
+    const roles = rolesRes?.roles || [];
+    if (roles.length > 0) {
+      let md = `### 🎭 โครงสร้างบทบาทและตัวละครเด่น (${roles.length} บทบาท)\n\n`;
+      roles.slice(0, 15).forEach(r => {
+        md += `- **${r.nameTh || r.nameCn}** (${r.nameCn || ''}) จากเรื่อง *${r.drama || ''}* — บุคลิก: ${r.personality || r.archetype || 'ตัวเอก'}\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  // Handle Continuation Intents (เช่น "ดำเนินการต่อ...", "เจาะลึกด้วยเครื่องมือ")
+  if (!specialistAnswer && (q.includes('ดำเนินการต่อ') || q.includes('ต่อยอด') || q.includes('เจาะลึก'))) {
+    if (q.includes('ซีรีส์') || q.includes('ละคร') || q.includes('ฮวาเจียน') || q.includes('หยุนซี')) {
+      if (!toolsUsed.some(t => t.name === 'search_works')) {
+        await addToolExec('search_works', { query: 'In Blossom ฮวาเจียนลิ่ง' });
+      }
+      if (!toolsUsed.some(t => t.name === 'get_character_roles')) {
+        await addToolExec('get_character_roles', {});
+      }
+    } else if (q.includes('เพลง') || q.includes('ost') || q.includes('ดนตรี')) {
+      if (!toolsUsed.some(t => t.name === 'search_discography')) {
+        await addToolExec('search_discography', { query: 'เพลง' });
+      }
+      if (!toolsUsed.some(t => t.name === 'get_music_videos')) {
+        await addToolExec('get_music_videos', { query: 'MV' });
+      }
+    }
+  }
+
+  if (answerParts.length === 0) {
+    const shouldPreserveExternalTopic = conversationContext?.contextual || conversationContext?.domain === 'fashion_event';
+    if (shouldPreserveExternalTopic) {
+      const topic = String(conversationContext?.anchor || query || 'หัวข้อก่อนหน้า').slice(0, 360);
+      answerParts.push(`### อ้างอิงหัวข้อเดิม\n\n` +
+        `คำถามนี้ต่อเนื่องจาก **${topic}**\n\n` +
+        `ขณะนี้ระบบกำลังทำงานในโหมดฐานข้อมูลภายในและไม่มีข้อมูลสดที่เพียงพอสำหรับยืนยันรายละเอียดของหัวข้อนี้ จึงจะไม่เปลี่ยนไปตอบประวัติหรือผลงานของศิลปินแทน หากต้องการข้อสรุปที่แม่นยำ ควรตรวจสอบประกาศทางการล่าสุดของงานก่อนค่ะ`);
+    } else {
+      await addToolExec('get_profile_and_fandom', {});
+      const worksRes = await addToolExec('search_works', { featuredOnly: true });
+      let md = `### 🌸 ข้อมูลสรุป จวีจิ้งอี (Ju Jingyi / 鞠婧祎)\n\n`;
+      md += `จวีจิ้งอี เป็นศิลปิน นักร้อง และนักแสดงหญิงชั้นนำของประเทศจีน เจ้าของฉายา "สาวงาม 4,000 ปี" และ Global Brand Ambassador ของ Versace\n\n`;
+      md += `#### 🎬 ผลงานซีรีส์เด่น:\n`;
+      (worksRes?.works || []).slice(0, 4).forEach(w => {
+        md += `- **${w.titleTh || w.titleCn}** รับบทเป็น *${w.role || w.character}* (ปี ${w.year})\n`;
+      });
+      answerParts.push(md);
+    }
+  }
+
+  const headerNotice = `> 💡 **โหมดฐานข้อมูลอัจฉริยะ (Direct Catalog Knowledge Mode)**\n` +
+    `> *ระบบสืบค้นข้อมูลจาก Local Database ให้โดยตรงทันทีอย่างแม่นยำ (เปิด LM Studio เพื่อเปิดใช้งาน Generative AI)*\n\n`;
+
+  const finalMarkdown = headerNotice + answerParts.join('\n\n');
+  const suggestions = generateDynamicFollowUps({ query, answer: finalMarkdown, tools: toolsUsed });
+
+  return {
+    answer: finalMarkdown,
+    thinking: 'ตรวจพบ LM Studio ออฟไลน์ -> เปิดใช้งาน Auto Direct Catalog Knowledge Engine...',
+    tools: toolsUsed,
+    suggestions
+  };
+}

package/server/web-chat/core/dramaKnowledge.js

@@ -0,0 +1,142 @@
+const WHITE_SNAKE_PATTERN = /(?:ตำนานนางพญางูขาว|นางพญางูขาว|the\s+legend\s+of\s+white\s+snake|新白娘子传奇|ไป๋ซู่เจิน|bai\s+suzhen)/i;
+const STORY_PATTERN = /(?:เล่า|เรื่องราว|เรื่องย่อ|เกร็ด|story|storyline|synopsis|trivia)/i;
+const COMPARISON_PATTERN = /(?:เปรียบเทียบ|เทียบ|พัฒนาการ|จุดเปลี่ยน|compare|comparison|evolution|breakthrough)/i;
+const PAST_ERA_PATTERN = /(?:อดีต|ยุคไอดอล|snh48|ช่วงแรก|ก่อนหน้า|early|past|idol)/i;
+
+export function detectDramaKnowledgeIntent(query) {
+  const text = String(query || '').trim();
+  if (WHITE_SNAKE_PATTERN.test(text) && STORY_PATTERN.test(text)) return 'white-snake-story';
+  if (COMPARISON_PATTERN.test(text) && /2024/.test(text) && PAST_ERA_PATTERN.test(text)) {
+    return 'acting-era-comparison';
+  }
+  return null;
+}
+
+export function assessDramaAnswerQuality(query, answer) {
+  const intent = detectDramaKnowledgeIntent(query);
+  if (!intent) return { applicable: false, valid: true, issues: [] };
+
+  const text = String(answer || '');
+  const issues = [];
+  const unsupported = /(?:ระดับแนวหน้า|ไม่มีใครเทียบได้|ก้าวข้ามจากไอดอล(?:ได้)?อย่างสมบูรณ์|ได้รับรางวัลมากมาย)/i;
+  if (unsupported.test(text)) issues.push('unsupported-career-claim');
+  if (/★\s*\d+(?:\.\d+)?\s*\/\s*10/.test(text)) issues.push('unattributed-rating');
+
+  if (intent === 'white-snake-story') {
+    if (!/(?:ไป๋ซู่เจิน|bai\s+suzhen).{0,100}(?:งูขาว|white[- ]snake spirit)/is.test(text)) {
+      issues.push('missing-bai-suzhen-identity');
+    }
+    if (!/(?:สวี่เซียน|xu\s+xian).{0,80}(?:มนุษย์ชาย|human man|human scholar|mortal)/is.test(text)) {
+      issues.push('missing-xu-xian-identity');
+    }
+    if (/(?:ตัวละครเอก|นางเอก|protagonist).{0,80}(?:มนุษย์สาว|human woman).{0,200}(?:พญางูขาว|white snake)/is.test(text)) {
+      issues.push('reversed-species-or-gender');
+    }
+  }
+
+  if (intent === 'acting-era-comparison') {
+    if (!/In\s+Blossom/i.test(text) || !/Sword\s+and\s+Fairy\s+4/i.test(text)) {
+      issues.push('incomplete-2024-comparison');
+    }
+    if (!/(?:2016|2017|2018|2019)/.test(text)) issues.push('missing-past-work-evidence');
+    if (!/(?:ตัวตน|identity).{0,100}(?:หยางไฉ่เวย|yang\s+caiwei).{0,160}(?:รูปลักษณ์|ร่าง|appearance).{0,100}(?:ซ่างกวนจื่อ|shangguan\s+zhi)/is.test(text)) {
+      issues.push('imprecise-in-blossom-role');
+    }
+    if (/(?:สลับเล่น\s*2|เล่น\s*2\s*(?:บทบาท|คาแรคเตอร์)|dual-role performance)/i.test(text)) {
+      issues.push('false-dual-role-framing');
+    }
+  }
+
+  return { applicable: true, valid: issues.length === 0, issues };
+}
+
+function bulletList(items = []) {
+  return items.filter(Boolean).map(item => `- ${item}`).join('\n');
+}
+
+async function loadWork(addToolExec, workIdOrTitle) {
+  const result = await addToolExec('get_work_detail', { workIdOrTitle });
+  return result?.status === 'success' ? result.work : null;
+}
+
+function renderWhiteSnakeStory(work) {
+  const title = work.titleTh || work.titleEn || 'ตำนานนางพญางูขาว';
+  const facts = [
+    work.year ? `ออกอากาศในปี **${work.year}**` : '',
+    work.role ? `จวีจิ้งอีรับบท **${work.role}**` : '',
+    work.episodes ? `จำนวน **${work.episodes}**` : '',
+    work.platform ? `แพลตฟอร์มที่ระบุในแคตตาล็อก: **${work.platform}**` : ''
+  ];
+
+  const highlights = (work.highlights || []).slice(0, 3).map(item => `**เกร็ด:** ${item}`);
+
+  return `### ${title}
+
+**เรื่องย่อที่ถูกต้อง:** ${work.synopsis}
+
+จุดสำคัญที่ต้องไม่สลับกันคือ **ไป๋ซู่เจินเป็นวิญญาณ/ปีศาจงูขาวที่บำเพ็ญเพียรจนแปลงกายเป็นหญิงมนุษย์** ส่วน **สวี่เซียนเป็นมนุษย์ชาย** ความขัดแย้งจึงเกิดจากความรักข้ามเผ่าพันธุ์ การช่วยรักษาผู้คน และการเผชิญหน้ากับฝาไห่ ไม่ใช่เรื่องของมนุษย์สาวที่ไปพบ “พญางูขาว” เพศชายค่ะ
+
+#### ข้อมูลจากแคตตาล็อก
+
+${bulletList([...facts, ...highlights])}
+
+#### มองในแง่การแสดง
+
+บทไป๋ซู่เจินต้องประสานความอ่อนโยนของคนรักและผู้เยียวยาเข้ากับสถานะของสิ่งเหนือธรรมชาติ รวมถึงรับน้ำหนักฉากรัก การพลัดพราก และการเสียสละ อย่างไรก็ดี ข้อความนี้เป็น **การวิเคราะห์จากโครงสร้างบท** ไม่ใช่หลักฐานสำหรับคำตัดสินเชิงจัดอันดับหรือข้อสรุปเด็ดขาดเกี่ยวกับสถานะทางอาชีพค่ะ`;
+}
+
+function renderActingEraComparison(works) {
+  const [inBlossom, swordFairy, novoland, detective, yunxi, whiteSnake] = works;
+  const missing = works.some(work => !work);
+
+  const sourceNote = missing
+    ? '> หมายเหตุ: แคตตาล็อกบางรายการไม่พร้อมใช้งาน จึงวิเคราะห์เฉพาะรายการที่ค้นคืนได้ค่ะ\n\n'
+    : '';
+
+  return `### ข้อสรุปก่อน
+
+ปี 2024 แสดงให้เห็น **การเพิ่มภาระของตัวละครต่อการขับเคลื่อนเรื่อง** มากกว่าการเปลี่ยนจาก “ภาพลักษณ์” ไปเป็น “การแสดงจริง” แบบฉับพลัน เพราะผลงานก่อนหน้านั้นก็มีบทโศกนาฏกรรม สืบสวน และตัวละครที่ต้องตัดสินใจหนักอยู่แล้ว จุดเปลี่ยนจึงควรอธิบายว่าเป็น **วิวัฒนาการต่อเนื่องของชนิดบทและพื้นที่การแสดง** ค่ะ
+
+${sourceNote}| ช่วง | ตัวอย่างบทที่ยืนยันได้ | สิ่งที่บทเรียกร้อง |
+|---|---|---|
+| ระยะแรก 2016–2017 | **${novoland?.role || 'เสวี่ยเฟยซวง'}** ใน *${novoland?.titleEn || 'Novoland: The Castle in the Sky'}*; **${detective?.role || 'ซ่างกวนจื่อซู'}** ใน *${detective?.titleEn || 'Detective Samoyeds'}* | จากบทเจ้าหญิงโศกนาฏกรรมไปสู่สมาชิกทีมสืบสวน เป็นช่วงทดลองคาแรกเตอร์ที่ต่างกัน ไม่ได้มีแต่บทสดใสแบบไอดอล |
+| ช่วงสร้างฐาน 2018–2019 | **${yunxi?.role || 'หานอวิ๋นซี'}** ใน *${yunxi?.titleEn || 'Legend of Yunxi'}*; **${whiteSnake?.role || 'ไป๋ซู่เจิน'}** ใน *${whiteSnake?.titleEn || 'The Legend of White Snake'}* | รับบทนำที่ต้องแบกเส้นเรื่องยาวขึ้น ทั้งการแพทย์/การเมือง ความรักข้ามเผ่าพันธุ์ และโศกนาฏกรรม |
+| ปี 2024 | **${inBlossom?.role || 'ตัวตนหยางไฉ่เวยในร่างซ่างกวนจื่อ'}** ใน *${inBlossom?.titleEn || 'In Blossom'}*; **${swordFairy?.role || 'หานหลิงซา'}** ใน *${swordFairy?.titleEn || 'Sword and Fairy 4'}* | บทหนึ่งขับเคลื่อนการสืบคดีผ่านปัญหาเรื่องตัวตนและรูปลักษณ์ อีกบทใช้พลังทางกาย จังหวะผจญภัย และความสัมพันธ์แบบคณะ |
+
+#### จุดเปลี่ยนที่เห็นได้จากตัวบท
+
+- **จากตัวละครในวงเรื่อง ไปสู่ผู้ขับเคลื่อนกลไกเรื่อง:** งานปี 2024 ให้ตัวละครของเธอมีหน้าที่ลงมือสืบ ค้น และตัดสินใจต่อเนื่อง ไม่ได้มีไว้รองรับเส้นโรแมนติกอย่างเดียวค่ะ
+- **เครื่องมือการแสดงหลากหลายขึ้น:** *In Blossom* เน้นความระแวดระวัง การซ่อนตัวตน และการอ่านคู่สนทนา ขณะที่ *Sword and Fairy 4* เน้นพลังงานทางกาย ความคล่องแคล่ว และจังหวะของทีมนักผจญภัยค่ะ
+- **มีความต่อเนื่องมากกว่าการหักมุม:** หานอวิ๋นซีและซ่างกวนจื่อซูในผลงานก่อนปี 2024 ก็เป็นหญิงฉลาดที่แก้ปัญหา ส่วนไป๋ซู่เจินและเสวี่ยเฟยซวงก็มีน้ำหนักทางโศกนาฏกรรมอยู่แล้ว ปี 2024 จึงต่อยอดสิ่งเหล่านี้ ไม่ได้เริ่มจากศูนย์ค่ะ
+- **ข้อควรระวังเรื่อง “สองบทบาท” ใน In Blossom:** จวีจิ้งอีปรากฏในรูปลักษณ์ของ **ซ่างกวนจื่อหลังเหตุเปลี่ยนใบหน้า/สลับชะตา แต่ตัวตนภายในคือหยางไฉ่เวย** จึงแม่นกว่าหากเรียกว่า “ตัวละครที่มีความไม่ตรงกันระหว่างตัวตนกับรูปลักษณ์” แทนการบอกว่าเธอสลับเล่นสองคนที่แยกจากกันตลอดเรื่องค่ะ
+
+#### สิ่งที่คำตอบเดิมสรุปแรงเกินหลักฐาน
+
+- คำยกย่องเชิงจัดอันดับและข้อสรุปเด็ดขาดเรื่องสถานะทางอาชีพต้องมีแหล่งอ้างอิงเฉพาะ จึงไม่ควรใช้เป็นข้อเท็จจริงลอย ๆ ค่ะ
+- คะแนน 9.x/10 ในแคตตาล็อกไม่มีชื่อสำนักหรือเกณฑ์กำกับ จึงไม่ควรนำมาใช้พิสูจน์คุณภาพการแสดงค่ะ
+- การวิเคราะห์ด้านแววตา ภาษากาย หรือคุณภาพฉากใดฉากหนึ่งควรอ้างฉากจริงหรือบทวิจารณ์ที่ตรวจสอบได้ ไม่ควรอนุมานจากเรื่องย่อเพียงอย่างเดียวค่ะ
+
+**สรุป:** จุดเปลี่ยนในปี 2024 คือความซับซ้อนของ “หน้าที่ในเรื่อง” และวิธีรักษาตัวตนภายใต้สถานการณ์กดดัน มากกว่าการเปลี่ยนจากนักแสดงที่ขายภาพลักษณ์ไปเป็นนักแสดงคุณภาพแบบขาว–ดำค่ะ`;
+}
+
+export async function buildDramaSpecialistAnswer(query, addToolExec) {
+  const intent = detectDramaKnowledgeIntent(query);
+  if (!intent) return null;
+
+  if (intent === 'white-snake-story') {
+    const work = await loadWork(addToolExec, 'the-legend-of-white-snake');
+    return work ? renderWhiteSnakeStory(work) : null;
+  }
+
+  const workIds = [
+    'in-blossom',
+    'sword-and-fairy-4',
+    'novoland-castle-in-the-sky',
+    'detective-samoyeds',
+    'legend-of-yunxi',
+    'the-legend-of-white-snake'
+  ];
+  const works = [];
+  for (const workId of workIds) works.push(await loadWork(addToolExec, workId));
+  return renderActingEraComparison(works);
+}