kiku-agent 1.2.0 → 1.3.1

package/server/agent/clarifyingQuestions.js

@@ -2,9 +2,6 @@
 
 import { eventBus, Events } from './eventBus.js';
 
-// Languages supported by the clarifying-question system. Add a new code here
-// and fill its entries in the per-language `questions` / `options` maps below
-// to extend coverage.
 export const SUPPORTED_LANGUAGES = ['en', 'th', 'zh', 'ja', 'ko'];
 
 const LANGUAGE_ALIASES = {
@@ -23,8 +20,6 @@ const LANGUAGE_ALIASES = {
   'ko-kr': 'ko',
 };
 
-// Normalize any user/system supplied language tag (e.g. "JP", "zh-TW") to a
-// supported code; unknown tags fall back to English.
 export function normalizeLang(lang, fallback = 'en') {
   if (!lang || typeof lang !== 'string') return fallback;
   const key = lang.trim().toLowerCase().replace('_', '-');
@@ -247,7 +242,6 @@ const AMBIGUITY_PATTERNS = [
   }
 ];
 
-// Resolve a pattern's question + options for a given language with English fallback.
 function localizePattern(pattern, lang) {
   const questions = pattern.questions || {};
   const options = pattern.options || {};
@@ -259,6 +253,15 @@ function localizePattern(pattern, lang) {
   };
 }
 
+const KNOWN_WORKS_OR_CHARACTERS_REGEX = /(花间令|花間令|In Blossom|ฮวาเจียนลิ่ง|芸汐传|芸汐伝|Yunxi|หยุนซี|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|The Blooms at Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|杨采薇|上官芷|หยางไฉ่เวย|ซ่างกวนจื่อ|韩芸汐|หานหยุนซี|白素贞|ไป๋ซู่เจิน|傅容|ฟู่หรง|姜保宁|เจียงเป่าหนิง|韩菱纱|หานหลิงซา)/i;
+
+const SPECIFICITY_PATTERNS = [
+  /\b(exactly|specifically|precisely|particular)\b/i,
+  /\b\d{4}\b/,
+  /["'"]/,
+  /\b(by|from|in|at|on)\b.*\b(Ju Jingyi|鞠婧祎|จวีจิ้งอี)\b/i,
+];
+
 export function calculateConfidence(query, detectedAmbiguities = []) {
   if (!query || typeof query !== 'string') {
     return { score: 0, level: 'very_low', shouldAsk: true };
@@ -267,8 +270,6 @@ export function calculateConfidence(query, detectedAmbiguities = []) {
   const trimmed = query.trim();
   let score = 1.0;
 
-  // CJK scripts do not separate words with spaces, so estimate word count from
-  // character length instead to avoid unfairly penalizing zh/ja/ko queries.
   const cjkChars = (trimmed.match(/[\u3040-\u30FF\u3400-\u9FFF\uAC00-\uD7AF]/g) || []).length;
   const wordCount = cjkChars > 0
     ? Math.max(1, Math.round(cjkChars / 2))
@@ -277,8 +278,7 @@ export function calculateConfidence(query, detectedAmbiguities = []) {
   else if (wordCount < 5) score -= 0.1;
   else if (wordCount > 15) score += 0.1;
 
-  const knownWorksOrCharacters = /(花间令|花間令|In Blossom|ฮวาเจียนลิ่ง|芸汐传|芸汐伝|Yunxi|หยุนซี|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|The Blooms at Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|杨采薇|上官芷|หยางไฉ่เวย|ซ่างกวนจื่อ|韩芸汐|หานหยุนซี|白素贞|ไป๋ซู่เจิน|傅容|ฟู่หรง|姜保宁|เจียงเป่าหนิง|韩菱纱|หานหลิงซา)/i;
-  if (knownWorksOrCharacters.test(trimmed)) {
+  if (KNOWN_WORKS_OR_CHARACTERS_REGEX.test(trimmed)) {
     return {
       score: 0.95,
       level: 'high',
@@ -287,14 +287,7 @@ export function calculateConfidence(query, detectedAmbiguities = []) {
     };
   }
 
-  const specificityPatterns = [
-    /\b(exactly|specifically|precisely|particular)\b/i,
-    /\b\d{4}\b/,
-    /["'"]/,
-    /\b(by|from|in|at|on)\b.*\b(Ju Jingyi|鞠婧祎|จวีจิ้งอี)\b/i,
-  ];
-
-  for (const pattern of specificityPatterns) {
+  for (const pattern of SPECIFICITY_PATTERNS) {
     if (pattern.test(trimmed)) score += 0.15;
   }
 
@@ -346,8 +339,6 @@ export function detectAmbiguities(query, detectedLang = 'en') {
   return detected;
 }
 
-// Known Ju Jingyi works/characters so clarifying questions can reference the
-// actual subject of the user's query instead of generic facet questions.
 const KNOWN_ENTITY_PATTERNS = [
   {
     key: 'in_blossom',
@@ -392,12 +383,22 @@ export function stripSystemDirectives(text) {
 
 const KNOWN_ENTITY_REGEX = /(花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง|芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|SNH48)/i;
 
-// Returns a recognized topic label (localized) that appears in the query, or null.
+const ENTITY_REGEX_MAP = {
+  in_blossom: /(?:in_blossom|花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง)/i,
+  legend_of_yunxi: /(?:legend_of_yunxi|芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี)/i,
+  sword_fairy_4: /(?:sword_fairy_4|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่)/i,
+  white_snake: /(?:white_snake|新白娘子传奇|White Snake|นางพญางูขาว)/i,
+  ruyi_pavilion: /(?:ruyi_pavilion|如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา)/i,
+  rebirth_for_you: /(?:rebirth_for_you|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ)/i,
+  snh48: /(?:snh48|SNH48)/i,
+};
+
 function extractQueryTopic(query, lang) {
   if (!query || typeof query !== 'string') return null;
   const clean = stripSystemDirectives(query);
   const hit = KNOWN_ENTITY_PATTERNS.find(p => {
-    try { return new RegExp(escapeRegex(p.key) + '|' + entityRegexFor(p.key), 'i').test(clean); } catch { return false; }
+    const rx = ENTITY_REGEX_MAP[p.key];
+    return rx ? rx.test(clean) : false;
   });
   if (hit) return (hit.labels && hit.labels[lang]) || hit.labels.en;
   const rawMatch = clean.match(KNOWN_ENTITY_REGEX);
@@ -422,7 +423,6 @@ function escapeRegex(str) {
   return String(str).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
-// Extract a short noun phrase that likely represents the topic (fallback when no known entity).
 function extractQueryPhrase(query) {
   if (!query || typeof query !== 'string') return '';
   const cleaned = stripSystemDirectives(query)
@@ -447,8 +447,6 @@ function synthesizeDynamicQuestions(query, lang = 'en', detectedAmbiguities = []
 
   const topic = extractQueryTopic(query, lang) || extractQueryPhrase(query) || null;
 
-  // 1) Subject-aware questions that reference the actual topic the user asked about,
-  //    so the clarifying questions feel directly connected to the query.
   if (topic) {
     const subject = String(topic).trim();
     if (!addedCategories.has('subject_focus') && results.length < maxQuestions) {
@@ -524,154 +522,219 @@ function synthesizeDynamicQuestions(query, lang = 'en', detectedAmbiguities = []
     }
   }
 
-  // 2) Specific detected ambiguity categories (from the query).
+  const clean = stripSystemDirectives(query);
+  const isMusic = /(เพลง|ร้องเพลง|ดนตรี|ซิงเกิล|อัลบั้ม|สเตจ|คอนเสิร์ต|ost|song|music|single|album|concert|stage|find the way|0\.2s|曲|歌|음악|노래)/i.test(clean);
+  const isDrama = /(ซีรีส์|ละคร|หนัง|ภาพยนตร์|การแสดง|บทบาท|ตัวละคร|เรื่อง|ฮวาเจียน|หยุนซี|งูขาว|仙剑|花间令|芸汐|drama|series|movie|acting|character|role|in blossom|yunxi)/i.test(clean);
+  const isFashion = /(แบรนด์|พรีเซนเตอร์|แอมบาสเดอร์|แฟชั่น|เครื่องประดับ|ชุด|แต่งหน้า|เมคอัพ|fashion|brand|ambassador|fred|versace|prsr|makeup)/i.test(clean);
+
   if (Array.isArray(detectedAmbiguities) && detectedAmbiguities.length > 0) {
     for (const amb of detectedAmbiguities) {
       if (amb.category && amb.question && amb.options && !addedCategories.has(amb.category)) {
+       
+        if (amb.category === 'media_type' && ((isMusic && !isDrama) || (isDrama && !isMusic))) {
+          continue;
+        }
         addQ(amb.category, amb.question, (amb.options || []).slice(0, 4));
       }
     }
   }
 
-  // 3) Generic facet fillers to reach the target count.
-  if (lang === 'th') {
-    addQ('media_type', 'อยากให้เน้นผลงานการแสดงซีรีส์ หรือผลงานเพลงเดี่ยวและเพลงประกอบ (OST) คะ?', [
-      'ผลงานซีรีส์ (Dramas)',
-      'ผลงานเพลงเดี่ยวและ OST',
-      'รวมทุกประเภทผลงาน'
-    ]);
-    addQ('career_phase', 'คุณสนใจผลงานช่วงศิลปินเดี่ยวและนักแสดงในปัจจุบัน หรือช่วงยุคไอดอลวง SNH48 คะ?', [
-      'ศิลปินเดี่ยวปัจจุบัน (Solo)',
-      'ช่วงยุควง SNH48',
-      'ทุกช่วงเวลาทั้งหมด'
-    ]);
-    addQ('timeframe', 'ต้องการให้อัปเดตผลงานช่วงล่าสุด (ปี 2024-2026) หรือดูผลงานสร้างชื่อในอดีตคะ?', [
-      'ผลงานล่าสุด (2024-2026)',
-      'ผลงานสร้างชื่อในอดีต',
-      'ผลงานทั้งหมดตลอดกาล'
-    ]);
-    addQ('depth', 'ต้องการคำตอบแบบสรุปประเด็นสำคัญ หรือเจาะลึกรายละเอียดและเรื่องย่อเบื้องหลังคะ?', [
-      'สรุปกระชับ ได้ใจความ',
-      'เจาะลึกละเอียด ครบถ้วน',
-      'ไฮไลต์ยอดนิยม'
-    ]);
-    if (results.length < maxQuestions) {
-      addQ('aspect_focus', 'สนใจเจาะลึกด้านบทบาทการแสดง ตัวละคร หรือกระแสตอบรับและรางวัลคะ?', [
-        'บทบาทและการแสดง',
-        'ตัวละครและเนื้อเรื่อง',
-        'กระแสตอบรับและรางวัล'
+  if (isMusic && !isDrama) {
+    if (lang === 'th') {
+      addQ('music_aspect', 'สนใจผลงานเพลงแนวไหนเป็นพิเศษคะ?', [
+        'เพลงประกอบซีรีส์ (OST) ซึ้งๆ',
+        'ซิงเกิลเดี่ยวแนวป๊อป/แดนซ์',
+        'สเตจแสดงสดไวรัล',
+        'ผลงานเพลงทั้งหมด'
+      ]);
+      addQ('stage_vibe', 'อยากเจาะลึกเพลงฮิตช่วงไหนคะ?', [
+        'ซิงเกิลใหม่ล่าสุด (0.2s, FIND THE WAY)',
+        'เพลงคลาสสิกสร้างชื่อ (叹云兮, 恋爱告急)',
+        'เพลงที่มีสเตจเต้นไวรัล'
+      ]);
+    } else if (lang === 'zh') {
+      addQ('music_aspect', '想了解哪种风格的音乐作品？', [
+        '经典影视原声 (OST)',
+        '个人 Solo 唱跳单曲',
+        '出圈神级现场舞台',
+        '全部音乐作品'
+      ]);
+      addQ('stage_vibe', '想聚焦哪个时期的音乐？', [
+        '最新单曲 (0.2s, FIND THE WAY)',
+        '经典代表作 (叹云兮, 恋爱告急)',
+        '出圈舞台曲目'
+      ]);
+    } else if (lang === 'ja') {
+      addQ('music_aspect', 'どのスタイルの音楽作品に興味がありますか？', [
+        'ドラマ主題歌 (OST)',
+        'ソロ楽曲・ダンス曲',
+        '話題のライブステージ',
+        '全楽曲'
+      ]);
+      addQ('stage_vibe', '特に注目したい楽曲の時期はありますか？', [
+        '最新シングル (0.2s, FIND THE WAY)',
+        '定番の代表曲 (叹云兮, 恋爱告急)',
+        'バイラルステージ曲'
+      ]);
+    } else if (lang === 'ko') {
+      addQ('music_aspect', '어떤 스타일의 음악 작품에 더 관심이 있으신가요?', [
+        '드라마 OST',
+        '솔로 팝·댄스 곡',
+        '화제의 라이브 무대',
+        '전체 음악'
+      ]);
+      addQ('stage_vibe', '특히 주목하고 싶은 시기의 곡이 있으신가요?', [
+        '최신 싱글 (0.2s, FIND THE WAY)',
+        '대표 명곡 (탄윈시, 연애고급)',
+        '인기 무대 곡'
+      ]);
+    } else {
+      addQ('music_aspect', 'Which musical style are you most interested in?', [
+        'Iconic Drama OSTs',
+        'Solo Pop & Dance Singles',
+        'Viral Live Stages',
+        'Complete Discography'
       ]);
     }
-  } else if (lang === 'zh') {
-    addQ('media_type', '请问您希望重点了解影视剧作品，还是个人单曲与影视原声 (OST)？', [
-      '影视剧作品 (Dramas)',
-      '个人单曲与 OST',
-      '全方位作品介绍'
-    ]);
-    addQ('career_phase', '请问您想了解个人 Solo 时期作品，还是 SNH48 组合时期的舞台？', [
-      '个人 Solo 时期作品',
-      'SNH48 组合时期',
-      '全部演艺阶段'
-    ]);
-    addQ('timeframe', '请问您想了解近年 (2024-2026) 的最新动态，还是历年经典代表作？', [
-      '最新动态 (2024-2026)',
-      '历年经典代表作',
-      '历年全部作品'
-    ]);
-    addQ('depth', '您希望获取快速简练的重点总结，还是包含剧情与幕后细节的深度解读？', [
-      '精简要点总结',
-      '深度详尽解读',
-      '热门高光盘点'
-    ]);
-    if (results.length < maxQuestions) {
-      addQ('aspect_focus', '您想重点了解角色演技、故事设定还是作品热度与奖项？', [
-        '角色表现与演技',
-        '故事与人设解读',
+  } else if (isDrama && !isMusic) {
+    if (lang === 'th') {
+      addQ('drama_genre', 'สนใจซีรีส์สไตล์ไหนเป็นพิเศษคะ?', [
+        'พีเรียดสืบสวนเข้มข้น (ฮวาเจียนลิ่ง)',
+        'โรแมนติกแฟนตาซี/เทพเซียน',
+        'ผลงานล่าสุดที่กำลังจะมา (Veil of Shadows)',
+        'ซีรีส์มาสเตอร์พีซทั้งหมด'
+      ]);
+      addQ('drama_aspect', 'อยากเน้นเนื้อหาด้านใดในซีรีส์คะ?', [
+        'บทบาทและการแสดงอันเป็นเอกลักษณ์',
+        'เคมีคู่และเส้นเรื่องความรัก',
+        'กระแสตอบรับ เรตติ้ง และรางวัล'
+      ]);
+    } else if (lang === 'zh') {
+      addQ('drama_genre', '想探索哪种类型的影视剧作？', [
+        '古装悬疑探案 (如《花间令》)',
+        '仙侠奇幻/浪漫言情',
+        '即将上线的待播新剧',
+        '历年代表作全景'
+      ]);
+      addQ('drama_aspect', '想重点了解影视作品的哪一方面？', [
+        '角色塑造与演技高光',
+        'CP默契与感情线',
         '热度口碑与奖项'
       ]);
-    }
-  } else if (lang === 'ja') {
-    addQ('media_type', '演技ドラマ作品と、ソロ楽曲や映画・ドラマの主題歌 (OST)、どちらを重視しましょうか？', [
-      'ドラマ作品',
-      '楽曲・OST',
-      'すべての作品'
-    ]);
-    addQ('career_phase', '現在のソロ活動と、SNH48 アイドルグループ時代のどちらが気になりますか？', [
-      '現在のソロ活動',
-      'SNH48 時代',
-      '全期間'
-    ]);
-    addQ('timeframe', '最近の活動 (2024-2026) と、過去の代表作のどちらをご覧になりたいですか？', [
-      '最新の活動 (2024-2026)',
-      '過去の代表作',
-      '全期間の作品'
-    ]);
-    addQ('depth', '簡潔な要約と、詳細な解説のどちらをご希望ですか？', [
-      '簡潔な要約',
-      '詳細な解説',
-      '人気ハイライト'
-    ]);
-    if (results.length < maxQuestions) {
-      addQ('aspect_focus', '演技、キャラクター、評価・賞のどれを深掘りしましょうか？', [
-        '演技と役柄',
-        'キャラクターとストーリー',
-        '評価と賞'
+    } else if (lang === 'ja') {
+      addQ('drama_genre', 'どのジャンルのドラマに興味がありますか？', [
+        '時代劇・サスペンス探偵 (花間令など)',
+        '仙侠・ロマンスファンタジー',
+        '公開予定の最新作',
+        '歴代の代表作'
+      ]);
+      addQ('drama_aspect', 'ドラマのどの側面に注目しますか？', [
+        '演技と独自のキャラクター',
+        '相手役とのケミ・恋愛模様',
+        '反響・視聴率・受賞歴'
+      ]);
+    } else if (lang === 'ko') {
+      addQ('drama_genre', '어떤 장르의 드라마를 더 알아보고 싶으신가요?', [
+        '고장극·미스터리 수사 (화간령 등)',
+        '선협·로맨스 판타지',
+        '공개 예정 신작',
+        '역대 대표작'
+      ]);
+      addQ('drama_aspect', '드라마의 어떤 점에 주목하고 싶으신가요?', [
+        '연기와 매력적인 캐릭터',
+        '주연 케미와 로맨스',
+        '반응·시청률·수상 내역'
+      ]);
+    } else {
+      addQ('drama_genre', 'Which drama style would you like to explore?', [
+        'Historical Mystery & Investigation',
+        'Romance & Xianxia Fantasy',
+        'Upcoming & Latest Projects',
+        'All Masterpiece Dramas'
       ]);
     }
-  } else if (lang === 'ko') {
-    addQ('media_type', '연기 드라마 작품과 솔로 곡·주제가 (OST) 중 어떤 것을 중점적으로 볼까요?', [
-      '드라마 작품',
-      '솔로 곡·OST',
-      '전체 작품'
-    ]);
-    addQ('career_phase', '현재 솔로 활동과 SNH48 아이돌 그룹 시절 중 어떤 시기가 궁금하신가요?', [
-      '현재 솔로 활동',
-      'SNH48 시절',
-      '전체 시기'
-    ]);
-    addQ('timeframe', '최근 활동 (2024-2026)과 대표작 중 어떤 것을 볼까요?', [
-      '최근 활동 (2024-2026)',
-      '대표작',
-      '전체 작품'
-    ]);
-    addQ('depth', '간결한 요약과 상세한 해설 중 어떤 걸 원하시나요?', [
-      '간결한 요약',
-      '상세한 해설',
-      '인기 하이라이트'
-    ]);
-    if (results.length < maxQuestions) {
-      addQ('aspect_focus', '연기, 캐릭터, 평가·수상 중 어떤 부분을 깊이 알아볼까요?', [
-        '연기와 배역',
-        '캐릭터와 스토리',
-        '평가와 수상'
+  } else if (isFashion) {
+    if (lang === 'th') {
+      addQ('fashion_aspect', 'สนใจเจาะลึกด้านแฟชั่นและลุคไวรัลมุมไหนคะ?', [
+        'เครื่องประดับชั้นสูง FRED Paris',
+        'แบรนด์แอมบาสเดอร์ระดับโลก (Versace, PRSR)',
+        'สไตล์การแต่งหน้า Ju Jingyi Makeup ยอดฮิต'
+      ]);
+    } else if (lang === 'zh') {
+      addQ('fashion_aspect', '想了解哪方面的时尚与出圈造型？', [
+        '法国高级珠宝 FRED Paris',
+        '全球品牌代言 (Versace, PRSR)',
+        '出圈鞠式美学与妆容'
+      ]);
+    } else if (lang === 'ja') {
+      addQ('fashion_aspect', 'どのファッションやビジュアルに注目しますか？', [
+        'フランス高級ジュエリー FRED Paris',
+        'グローバルブランドアンバサダー (Versace, PRSR)',
+        '話題のキク風メイク＆スタイル'
+      ]);
+    } else if (lang === 'ko') {
+      addQ('fashion_aspect', '어떤 패션과 스타일링에 관심이 있으신가요?', [
+        '프랑스 하이주얼리 FRED Paris',
+        '글로벌 브랜드 앰버서더 (Versace, PRSR)',
+        '화제의 쥐징이 메이크업 & 스타일'
+      ]);
+    } else {
+      addQ('fashion_aspect', 'Which fashion aspect would you like to explore?', [
+        'FRED Paris High Jewelry',
+        'Global Ambassadorships (Versace, PRSR)',
+        'Viral Ju Jingyi Makeup & Style'
       ]);
     }
   } else {
-    addQ('media_type', 'Would you like to focus on her acting dramas, or her solo music and OSTs?', [
-      'Acting Dramas',
-      'Solo Music & OSTs',
-      'All Works'
-    ]);
-    addQ('career_phase', 'Are you interested in her current Solo career or her SNH48 idol group era?', [
-      'Current Solo works',
-      'SNH48 group era',
-      'All career eras'
-    ]);
-    addQ('timeframe', 'Would you prefer updates on her recent works (2024-2026) or her classic breakthrough hits?', [
-      'Recent works (2024-2026)',
-      'Classic breakthrough hits',
-      'All time works'
-    ]);
-    addQ('depth', 'Would you prefer a concise quick summary or an in-depth comprehensive breakdown?', [
-      'Concise summary',
-      'In-depth breakdown',
-      'Key highlights'
-    ]);
-    if (results.length < maxQuestions) {
-      addQ('aspect_focus', 'Would you like to focus on character portrayals, storylines, or reception & awards?', [
-        'Character & Acting',
-        'Story & Lore',
-        'Reception & Awards'
+    if (lang === 'th') {
+      addQ('fan_focus', 'อยากให้เสี่ยวจวีพาไปสำรวจมิติไหนก่อนดีคะ?', [
+        'ผลงานมาสเตอร์พีซและบทบาทสร้างชื่อ',
+        'อัปเดตผลงานและกิจกรรมล่าสุด (2024-2026)',
+        'เสน่ห์ด้านดนตรีและสเตจแสดงสด'
+      ]);
+      addQ('timeframe_focus', 'ช่วงเวลาที่อยากให้โฟกัสเป็นพิเศษ?', [
+        'ผลงานยุคศิลปินเดี่ยวปัจจุบัน',
+        'ผลงานสร้างชื่อคลาสสิกในอดีต',
+        'ไทม์ไลน์พัฒนาการทั้งหมด'
+      ]);
+    } else if (lang === 'zh') {
+      addQ('fan_focus', '想从小鞠的哪个精彩视角开始了解呢？', [
+        '出圈代表作与封神角色',
+        '近年最新动态与作品 (2024-2026)',
+        '舞台魅力与音乐全纪录'
+      ]);
+      addQ('timeframe_focus', '想聚焦哪个成长阶段呢？', [
+        '个人 Solo 发展期',
+        '经典作品巅峰期',
+        '全时段全景历程'
+      ]);
+    } else if (lang === 'ja') {
+      addQ('fan_focus', 'キクのどの魅力的なポイントから見ていきましょうか？', [
+        '代表作と名キャラクター',
+        '最新の活動・作品 (2024-2026)',
+        '音楽とステージパフォーマンス'
+      ]);
+      addQ('timeframe_focus', '特に注目したい活動時期はありますか？', [
+        '現在のソロ活動期',
+        '過去の名作時代',
+        '全活動期間'
+      ]);
+    } else if (lang === 'ko') {
+      addQ('fan_focus', '쥐징이의 어떤 매력적인 부분부터 살펴볼까요?', [
+        '대표작과 인기 캐릭터',
+        '최신 활동 및 작품 (2024-2026)',
+        '음악과 무대 퍼포먼스'
+      ]);
+      addQ('timeframe_focus', '특별히 주목하고 싶은 활동 시기가 있으신가요?', [
+        '현재 솔로 활동기',
+        '과거 대표작 시절',
+        '전체 활동 기간'
+      ]);
+    } else {
+      addQ('fan_focus', 'Which dimension would you like to explore first?', [
+        'Signature Masterpieces & Breakthrough Roles',
+        'Latest Updates & New Releases (2024-2026)',
+        'Music & Stage Highlights'
       ]);
     }
   }
@@ -679,9 +742,18 @@ function synthesizeDynamicQuestions(query, lang = 'en', detectedAmbiguities = []
   return results.slice(0, maxQuestions);
 }
 
+export function cleanThinkingBlocks(raw) {
+  if (!raw || typeof raw !== 'string') return '';
+  return raw
+    .replace(/<think>[\s\S]*?<\/think>/gi, '')
+    .replace(/<thought>[\s\S]*?<\/thought>/gi, '')
+    .replace(/```thought[\s\S]*?```/gi, '')
+    .trim();
+}
+
 function extractJsonArray(text) {
   if (!text || typeof text !== 'string') return null;
-  let cleaned = text.trim();
+  let cleaned = cleanThinkingBlocks(text);
   const fenceMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
   if (fenceMatch) {
     cleaned = fenceMatch[1].trim();
@@ -710,41 +782,45 @@ function extractJsonArray(text) {
 
 const LLM_SYSTEM_PROMPTS = {
   th:
-    'คุณคือ Kiku AI ระบบผู้ช่วยอัจฉริยะทางการของ "จวีจิ้งอี" (Ju Jingyi / 鞠婧祎 / เสี่ยงจวี)\n' +
-    'หน้าที่: วิเคราะห์คำถามของผู้ใช้ และคิดคำถามเจาะจง 3-4 ข้ออย่างเป็นมิตร สุภาพ (ลงท้ายด้วย คะ/นะคะ) เพื่อถามกลับผู้ใช้ก่อนจะเริ่มค้นหาข้อมูลหรือเริ่มกระบวนการ Timeline Agent\n' +
+    'คุณคือ Kiku AI ระบบผู้ช่วยอัจฉริยะทางการและเพื่อนรู้ใจของแฟนคลับ "จวีจิ้งอี" (Ju Jingyi / 鞠婧祎 / เสี่ยวจวี)\n' +
+    'หน้าที่: วิเคราะห์คำถามของแฟนคลับ และคิดคำถามชวนคุย/เจาะลึก 2-3 ข้ออย่างเป็นกันเอง สุภาพ น่ารัก (ลงท้ายด้วย คะ/นะคะ) เพื่อให้แฟนคลับเลือกมุมมองที่อยากรู้จริงก่อนเริ่มค้นหาข้อมูล\n' +
     'เป้าหมาย:\n' +
-    '1. เจาะลึกความต้องการให้แคบลงและตรงกับสิ่งที่ผู้ใช้ถามจริง (เช่น บทบาท/ตัวละคร, ผลงานซีรีส์ vs เพลง, ช่วงปี พ.ศ./ค.ศ., ยุคปัจจุบัน vs ไอดอล SNH48, ความละเอียดของข้อมูล)\n' +
-    '2. แต่ละข้อต้องให้ตัวเลือกคำตอบ 2-4 ตัวเลือกที่เกี่ยวข้องโดยตรงเพื่อให้ผู้ใช้กดเลือกได้ทันที\n' +
-    '3. ห้ามพูดนอกเรื่อง หรือแต่งประโยคระบบคำสั่งลงในคำถาม\n' +
+    '1. วิเคราะห์สิ่งที่แฟนคลับถามจริงๆ แล้วสร้างคำถามเจาะลึกที่สร้างสรรค์ ตรงประเด็น และเข้าถึงใจแฟนคลับ เช่น หากถามถึงซีรีส์ ให้ชวนคุยมิติของตัวละคร/เคมีคู่/เบื้องหลังการแสดง หรือหากถามถึงเพลง ให้ชวนคุยสไตล์เพลง/ความหมาย/สเตจไวรัล\n' +
+    '2. หลีกเลี่ยงการถามคำถามแบบฟอร์มแห้งๆ ทั่วไป (ห้ามถามซ้ำซากเรื่อง ละครหรือเพลง, SNH48 หรือเดี่ยว, ปีไหน, ละเอียดแค่ไหน หากบริบทคำถามเดิมชัดเจนอยู่แล้ว)\n' +
+    '3. แต่ละข้อให้ตัวเลือกคำตอบ 2-4 ตัวเลือกที่สั้นกระชับ ชัดเจน น่ากดเลือก\n' +
     '4. ส่งคำตอบเป็น JSON Array เท่านั้น ห้ามใส่คำอธิบายอื่นนอกเหนือจาก JSON:\n' +
-    '[{"category": "subject_focus", "question": "คำถามภาษาไทย", "options": ["ตัวเลือก 1", "ตัวเลือก 2", "ตัวเลือก 3"]}]',
+    '[{"category": "drama_aspect", "question": "เกี่ยวกับฮวาเจียนลิ่ง สนใจเจาะลึกมิติตัวละครหรือเคมีคู่กับพานเยว่คะ?", "options": ["มิติตัวละครหยางไฉ่เวย", "เคมีคู่พานเยว่", "เบื้องหลังการถ่ายทำ"]}]',
   zh:
-    '你是鞠婧祎官方智能粉丝助手 Kiku。\n' +
-    '任务：根据用户的提问，主动思考并提出 3-4 个礼貌贴切的追问（针对具体作品、角色、音乐还是影视、年份阶段、SNH48时期还是Solo、详略程度等不同维度），以便在进入 Timeline Agent 检索前准确定位用户需求。\n' +
-    '每个追问提供 2-4 个清晰选项。\n' +
-    '仅输出合法的 JSON Array 格式，不要包含任何多余文字：\n' +
-    '[{"category": "subject_focus", "question": "中文追问", "options": ["选项1", "选项2", "选项3"]}]',
+    '你是鞠婧祎官方智能粉丝助手 Kiku，也是粉丝们的贴心同好小伙伴。\n' +
+    '任务：根据粉丝的具体提问，主动构思 2-3 个亲切有爱、针对性极强的追问，让粉丝选择最想探索的专属视角。\n' +
+    '要求：\n' +
+    '1. 紧密结合问题核心（如角色内心、名场面解析、声乐/舞台魅力、造型出圈点、幕后花絮），切忌千篇一律的固定模板问卷（切勿生硬追问影视还是音乐、SNH还是Solo等已明确的信息）。\n' +
+    '2. 每个追问提供 2-4 个精炼、有吸引力的点击选项。\n' +
+    '3. 仅输出合法的 JSON Array 格式，不要包含任何多余文字：\n' +
+    '[{"category": "highlight_aspect", "question": "追问内容？", "options": ["选项1", "选项2", "选项3"]}]',
+  en:
+    'You are Kiku AI, the official intelligent assistant and companion for Ju Jingyi (鞠婧祎) fans.\n' +
+    'Task: Analyze the fan\'s inquiry and generate 2-3 engaging, creative, and highly targeted follow-up questions tailored specifically to what they asked, allowing them to explore deeper nuances.\n' +
+    'Guidelines:\n' +
+    '1. Craft personalized exploration angles (e.g., character psychology, signature scenes, vocal style/stage presence, fashion highlights, behind-the-scenes) instead of dry, robotic survey templates.\n' +
+    '2. Never ask redundant boilerplate questions (like "drama vs music" or "solo vs SNH48" if the context is already implied).\n' +
+    '3. Provide 2-4 concise, clickable options per question.\n' +
+    '4. Output ONLY a valid JSON Array with no other text:\n' +
+    '[{"category": "fan_focus", "question": "Question?", "options": ["Option 1", "Option 2", "Option 3"]}]',
   ja:
     'あなたは鞠婧祎（Ju Jingyi）公式ファンアシスタント「Kiku AI」です。\n' +
-    'タスク：ユーザーの質問を分析し、Timeline Agent が検索を始める前に意図を正確に把握できるよう、3〜4件の丁寧で的確な確認質問を日本語で生成してください（具体的な作品・役柄、ドラマか音楽か、Solo か SNH48 か、時期、詳しさなどの観点）。\n' +
-    '各質問には2〜4個の選択肢を付けてください。\n' +
-    'JSON配列のみを出力し、他の文章は含めないでください：\n' +
-    '[{"category": "subject_focus", "question": "日本語の質問", "options": ["選択肢1", "選択肢2", "選択肢3"]}]',
+    'タスク：ファンの質問を分析し、より深く魅力的な回答を届けるために、文脈に合わせた2〜3件の親しみやすく的確な確認質問を日本語で生成してください。\n' +
+    '固定的なアンケート調（毎回ドラマか音楽か、時期はいつか等）を避け、役柄の魅力、名シーン、楽曲の世界観などファンがワクワクする切り口を提示してください。\n' +
+    '各質問には2〜4個の簡潔な選択肢を付けて、JSON配列のみを出力してください：\n' +
+    '[{"category": "fan_focus", "question": "質問内容？", "options": ["選択肢1", "選択肢2", "選択肢3"]}]',
   ko:
     '당신은 Ju Jingyi(鞠婧祎) 공식 팬 어시스턴트 Kiku AI입니다.\n' +
-    '임무: 사용자의 질문을 분석하여 Timeline Agent가 검색을 시작하기 전에 의도를 정확히 파악할 수 있도록 3-4개의 정중한 확인 질문을 한국어로 생성하세요(구체적 작품·배역, 드라마 vs 음악, Solo vs SNH48, 시기, 상세도 등의 관점).\n' +
-    '각 질문에는 2-4개의 선택지를 제공하세요.\n' +
-    'JSON 배열만 출력하고 다른 문장은 포함하지 마세요:\n' +
-    '[{"category": "subject_focus", "question": "한국어 질문", "options": ["선택지1", "선택지2", "선택지3"]}]',
-  en:
-    'You are Kiku AI, the official assistant for Ju Jingyi (鞠婧祎).\n' +
-    'Task: Analyze the user inquiry and generate 3-4 polite, targeted clarifying questions across relevant dimensions (specific role/work, drama vs music, solo vs SNH48, timeframe, depth) to pinpoint their intent before the Timeline Agent begins searching.\n' +
-    'Provide 2-4 concise clickable options per question.\n' +
-    'Output ONLY a valid JSON Array with no other text:\n' +
-    '[{"category": "subject_focus", "question": "Question?", "options": ["Option 1", "Option 2", "Option 3"]}]',
+    '임무: 팬의 질문을 분석하여 더 깊이 있고 매력적인 답변을 제공할 수 있도록, 문맥에 맞춘 2-3개의 다정하고 흥미로운 탐색 질문을 한국어로 생성하세요.\n' +
+    '기계적인 정형화된 설문(매번 드라마vs음악, 시기 등)을 지양하고, 캐릭터 매력, 명장면, 음악 분위기 등 팬 맞춤형 포인트를 제시하세요.\n' +
+    '각 질문에는 2-4개의 간결한 선택지를 제공하고, JSON 배열만 출력하세요:\n' +
+    '[{"category": "fan_focus", "question": "질문 내용?", "options": ["선택지1", "선택지2", "선택지3"]}]'
 };
 
-// Shown when a model-generated question arrives without usable options.
 const FALLBACK_OPTIONS = {
   en: ['Yes', 'No', 'All'],
   th: ['ใช่', 'ไม่ใช่', 'ทั้งหมด'],
@@ -765,11 +841,8 @@ export async function generateClarifyingQuestions(query, lang = 'en', options =
       .filter(line => !line.startsWith('system:'))
       .join('\n');
 
-    const ambiguityAreas = detectedAmbiguities.map(a => a.category).join(', ');
-
     const systemPrompt = LLM_SYSTEM_PROMPTS[normalizedLang] || LLM_SYSTEM_PROMPTS.en;
-
-    const userPrompt = `User inquiry: "${cleanQuery}"\n${ambiguityAreas ? `Ambiguity cues: ${ambiguityAreas}\n` : ''}${recentHistory ? `Recent history:\n${recentHistory}` : ''}\n\nFormulate 3-4 targeted clarifying questions as JSON array:`;
+    const userPrompt = `User inquiry: "${cleanQuery}"\n${recentHistory ? `Recent conversation context:\n${recentHistory}\n` : ''}Formulate 2-3 creative, engaging, fan-centric follow-up questions tailored specifically to this inquiry as a JSON array:`;
 
     try {
       const controller = new AbortController();
@@ -795,7 +868,7 @@ export async function generateClarifyingQuestions(query, lang = 'en', options =
         const validated = rawQuestions
           .filter(q => q && typeof q.question === 'string' && q.question.trim().length > 0)
           .map((q, idx) => ({
-            category: String(q.category || `clarify_${idx + 1}`).toLowerCase().replace(/[^a-z0-9_]/g, '_'),
+            category: String(q.category || `fan_focus_${idx + 1}`).toLowerCase().replace(/[^a-z0-9_]/g, '_'),
             question: q.question.trim(),
             options: Array.isArray(q.options) && q.options.length > 0
               ? q.options.map(opt => String(opt).trim()).filter(Boolean).slice(0, 4)
@@ -807,7 +880,6 @@ export async function generateClarifyingQuestions(query, lang = 'en', options =
         }
       }
     } catch {
-      // Fast fallback to dynamic contextual synthesis if model call fails/times out
     }
   }
 
@@ -821,7 +893,6 @@ export function isQueryTooVague(query) {
 
   if (trimmed.length < 3) return true;
 
-  // Punctuation/symbols only — treat as vague (includes CJK punctuation).
   if (/^[^\w\u0E00-\u0E7F\u3040-\u30FF\u3400-\u9FFF\uAC00-\uD7AF]+$/.test(trimmed)) return true;
 
   const words = trimmed.split(/\s+/);
@@ -882,7 +953,6 @@ export function formatQuestionsForSSE(questions, lang = 'en') {
   };
 }
 
-// Words that mean "skip these questions" across the supported languages.
 const SKIP_WORDS = new Set([
   'skip', 'next', 'no', 'none', 'pass', 'proceed',
   'ข้าม', 'ไม่', 'ไม่ต้อง', 'ไม่ต้องถาม', 'ผ่าน',
@@ -948,33 +1018,33 @@ export function parseClarifyingAnswers(answersText, questions) {
   };
 }
 
+const ANSWER_SHORTHAND_MAP = Object.freeze({
+  'detailed': 'Very detailed (full analysis)',
+  'brief': 'Brief (quick summary)',
+  'quick': 'Brief (quick summary)',
+  'summary': 'Brief (quick summary)',
+  'comprehensive': 'Comprehensive overview',
+  'overview': 'Comprehensive overview',
+  'focused': 'Focused summary',
+  'highlights': 'Key highlights only',
+  '2026': '2026 (current year)',
+  'this year': '2026 (current year)',
+  '2025': '2025',
+  'last year': '2025',
+  'all': 'All types',
+  'everything': 'All types',
+  'skip': 'skip',
+  'proceed': 'skip',
+  'no': 'skip',
+  'english': 'English',
+  'thai': 'Thai',
+  'chinese': 'Chinese',
+});
+
 function interpretFreeTextAnswers(text, questions) {
   const answers = {};
   const lowerText = text.toLowerCase().trim();
 
-  const shorthandMap = {
-    'detailed': 'Very detailed (full analysis)',
-    'brief': 'Brief (quick summary)',
-    'quick': 'Brief (quick summary)',
-    'summary': 'Brief (quick summary)',
-    'comprehensive': 'Comprehensive overview',
-    'overview': 'Comprehensive overview',
-    'focused': 'Focused summary',
-    'highlights': 'Key highlights only',
-    '2026': '2026 (current year)',
-    'this year': '2026 (current year)',
-    '2025': '2025',
-    'last year': '2025',
-    'all': 'All types',
-    'everything': 'All types',
-    'skip': 'skip',
-    'proceed': 'skip',
-    'no': 'skip',
-    'english': 'English',
-    'thai': 'Thai',
-    'chinese': 'Chinese',
-  };
-
   for (const q of questions) {
     if (!q.options || q.options.length === 0) continue;
 
@@ -986,7 +1056,7 @@ function interpretFreeTextAnswers(text, questions) {
     }
 
     if (!answers[q.category]) {
-      for (const [key, value] of Object.entries(shorthandMap)) {
+      for (const [key, value] of Object.entries(ANSWER_SHORTHAND_MAP)) {
         if (lowerText.includes(key) && q.options.includes(value)) {
           answers[q.category] = value;
           break;
@@ -1050,7 +1120,6 @@ export function buildClarificationContext(clarifyingResult, originalQuery) {
   parts.push(`Clarifications provided:`);
 
   for (const [category, value] of Object.entries(answers)) {
-    // If the query is strictly about a drama but clarification was marked as Music, skip the contradictory field
     if (category === 'media_type' && isDramaQuery && !isMusicQuery && String(value).toLowerCase().includes('music')) {
       continue;
     }
@@ -1082,6 +1151,7 @@ export default {
   parseClarifyingAnswers,
   emitClarifyingQuestions,
   calculateConfidence,
+  cleanThinkingBlocks,
   generateClarifyingQuestions,
   buildClarificationContext,
   getAmbiguityPatterns,