kiku-agent 1.3.2 → 1.3.4

package/server/web-chat/routes/chatRoute.js

@@ -1,488 +1,885 @@
-import { randomUUID } from 'node:crypto';
-import { resolveAgentConnection } from '../core/connection.js';
-import { executeDirectCatalogKnowledge } from '../core/directCatalogEngine.js';
-import { makeInspectableToolPayload } from '../core/toolInspector.js';
-import { getAgentMemorySnapshot } from '../core/memorySnapshot.js';
-import { parseJsonBody, sendJson, sendError } from '../core/errorHandler.js';
-import { registerClarificationResolver } from './clarifyRoute.js';
-import { extractAgentFollowUpQuestions, generateDynamicFollowUps, dedupeSuggestions, normalizeSuggestionKey } from '../core/followUpEngine.js';
-import { resolveConversationContext } from '../core/conversationContext.js';
-import { applyFutureEventGuard } from '../core/futureEventGuard.js';
-import { extractApiKey } from '../core/security.js';
-import { assessDramaAnswerQuality } from '../core/dramaKnowledge.js';
-
-function stripInvalidYouTubeLinks(text) {
-  if (!text || typeof text !== 'string') return text || '';
-  return text.replace(/(?:https?:\/\/)?(?:www\.)?(?:youtube\.com\/watch\?v=|youtu\.be\/)([a-zA-Z0-9_-]{1,20})/gi, (m, id) => (id.length === 11 ? m : ''));
-}
-
-async function replaceLowQualityDramaAnswer({ query, answer, persona, conversationContext, toolsUsed }) {
-  const assessment = assessDramaAnswerQuality(query, answer);
-  if (!assessment.applicable || assessment.valid) return null;
-
-  const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-  if (Array.isArray(toolsUsed)) toolsUsed.push(...fallback.tools);
-  return {
-    answer: fallback.answer,
-    suggestions: fallback.suggestions || [],
-    issues: assessment.issues
-  };
-}
-
-export function extractSearchImagesFromTools(tools = [], query = '') {
-  const images = [];
-  const seen = new Set();
-  const add = (img) => {
-    const url = img?.imageUrl || img?.thumbUrl || img?.url || img?.src || img?.image;
-    if (!url || typeof url !== 'string' || seen.has(url)) return;
-    seen.add(url);
-    images.push({
-      title: img.title || img.alt || query || 'Ju Jingyi',
-      imageUrl: url,
-      thumbUrl: img.thumbUrl || img.imageUrl || url,
-      source: img.source || 'Search'
-    });
-  };
-
-  for (const t of tools) {
-    const res = t?.result;
-    if (!res) continue;
-    if (Array.isArray(res.images)) res.images.forEach(add);
-    if (Array.isArray(res.photos)) res.photos.forEach(add);
-    if (t.name === 'search_web_images' && Array.isArray(res.results)) res.results.forEach(add);
-    if (Array.isArray(res.works)) {
-      res.works.forEach(w => {
-        if (w.poster) add({ title: w.titleTh || w.titleCn || w.titleEn, imageUrl: w.poster, source: 'Series Poster' });
-      });
-    }
-  }
-
-  const rowAlignedCount = Math.floor(images.length / 3) * 3;
-  if (rowAlignedCount >= 3) {
-    return images.slice(0, Math.min(rowAlignedCount, 9));
-  }
-  return images.slice(0, 6);
-}
-
-
-export function sanitizeSubagentProgress(event = {}) {
-  const text = (value, max = 200) => String(value ?? '').slice(0, max);
-  const num = (value) => (Number.isFinite(Number(value)) ? Number(value) : undefined);
-  const out = { type: 'subagent_progress' };
-  if (['subagent', 'research', 'verify'].includes(event.source)) out.source = event.source;
-  else out.source = 'subagent';
-  if (['start', 'iteration', 'tool', 'worker-start', 'worker-complete', 'complete'].includes(event.type)) out.kind = event.type;
-  else out.kind = 'tool';
-  const subject = event.task ?? event.question ?? event.claim ?? '';
-  if (subject) out.subject = text(subject);
-  if (event.iteration !== undefined) out.iteration = num(event.iteration);
-  if (event.maxIterations !== undefined) out.maxIterations = num(event.maxIterations);
-  if (event.name) out.tool = text(event.name, 80);
-  if (event.label) out.label = text(event.label, 120);
-  if (event.id) out.workerId = text(event.id, 80);
-  if (event.workerId) out.workerId = text(event.workerId, 80);
-  if (event.sources !== undefined) out.sources = num(event.sources);
-  return out;
-}
-
-
-const recentSuggestionKeys = new Map();
-
-function getRecentSuggestionSet(sessionKey) {
-  let set = recentSuggestionKeys.get(sessionKey);
-  if (!set) {
-    set = new Set();
-    recentSuggestionKeys.set(sessionKey, set);
-    if (recentSuggestionKeys.size > 200) {
-      const oldest = recentSuggestionKeys.keys().next().value;
-      recentSuggestionKeys.delete(oldest);
-    }
-  }
-  return set;
-}
-
-function finalizeSuggestions(sessionKey, baseSuggestions, { query, answer, tools }) {
-  const recentKeys = getRecentSuggestionSet(sessionKey);
-  let out = dedupeSuggestions(Array.isArray(baseSuggestions) ? baseSuggestions : [], recentKeys);
-  if (out.length < 3) {
-    const dynamic = generateDynamicFollowUps({ query, answer, tools, recentKeys });
-    const localSeen = new Set(recentKeys);
-    for (const s of out) localSeen.add(normalizeSuggestionKey(s.query || s.label));
-    out = [...out, ...dedupeSuggestions(dynamic, localSeen)].slice(0, 3);
-  }
-  if (out.length) {
-    const set = getRecentSuggestionSet(sessionKey);
-    for (const s of out) {
-      set.add(normalizeSuggestionKey(s.query || s.label));
-      if (set.size > 60) {
-        const oldest = set.values().next().value;
-        set.delete(oldest);
-      }
-    }
-  }
-  return out;
-}
-
-export async function handleChatRoute(req, res, urlObj) {
-  let body;
-  try {
-    body = await parseJsonBody(req);
-  } catch (err) {
-    return sendError(res, 400, `Invalid JSON body: ${err.message}`);
-  }
-
-  const query = String(body.query || '').trim();
-
-  const persona = 'default';
-  const sessionKey = String(body.sessionId || 'global');
-  const wantsStream = body.stream === true || (req.headers.accept && req.headers.accept.includes('text/event-stream'));
-
-  if (!query) {
-    return sendError(res, 400, 'Query is required');
-  }
-
-  const apiKey = extractApiKey(req);
-  const abortController = new AbortController();
-  req.on('close', () => {
-    if (!res.writableEnded) {
-      abortController.abort();
-    }
-  });
-
-  const startTime = Date.now();
-  const clarificationIds = new Map();
-  const externalClarificationId = (internalId) => {
-    if (!clarificationIds.has(internalId)) clarificationIds.set(internalId, randomUUID());
-    return clarificationIds.get(internalId);
-  };
-  const conversationContext = resolveConversationContext(query, body.history);
-  const publicContext = {
-    contextual: conversationContext.contextual,
-    domain: conversationContext.domain
-  };
-
-  try {
-    const conn = await resolveAgentConnection({
-      provider: body.provider,
-      model: body.model,
-      thinking: body.thinking,
-      apiKey,
-      sessionId: body.sessionId,
-      history: body.history,
-      baseUrl: typeof body.baseUrl === 'string' && body.baseUrl.trim() ? body.baseUrl.trim() : undefined,
-    }, { signal: abortController.signal });
-
-  
-    const queryForAgent = conversationContext.resolvedQuery;
-    const systemDirectives = [
-      `[SYSTEM DIRECTIVE (Fact Grounding & Multi-Domain Retrieval):
-1. อ้างอิงเฉพาะเพลง ซีรีส์ แบรนด์พรีเซนเตอร์ และข้อมูลจริงที่ได้จากผลลัพธ์เครื่องมือ (search_works, search_discography, get_brand_endorsements, get_character_roles, get_awards, get_career_timeline, search_bilibili, search_chinese_web, web_search, get_media_links) เท่านั้น ห้ามแต่งชื่อผลงาน ชื่อแบรนด์ ตัวเลข หรือลิงก์สื่อขึ้นเอง หากตรวจสอบเครื่องมือที่เกี่ยวข้องแล้วไม่พบ จึงแจ้งผู้ใช้ตามหลักฐานจริง
-2. เมื่อพูดถึงเพลงหรือแบรนด์ใด ให้ระบุ "ชื่อจริง" จากคลังข้อมูลกำกับในประโยคเสมอ (เช่น "เพลง 千年等一回", "แบรนด์ PRSR (帕莎眼镜)") และห้ามแนบ URL ที่ไม่ได้มาจากผลลัพธ์เครื่องมือโดยเด็ดขาด
-3. เงื่อนไขการเสนอเปิดเพลงใน Mini Player: ให้เสนอเปิดเพลงเฉพาะเมื่อผู้ใช้ถามเรื่องบทเพลง การฟังเพลง หรือ OST โดยตรงเท่านั้น และต้องระบุชื่อเพลงที่เจาะจงในประโยคเดียวกัน ห้ามเสนอเปิดเพลงหรือถามชวนเปิดเพลงเมื่อผู้ใช้ถามเรื่องซีรีส์ แบรนด์ ข่าวลือ หรือเนื้อหาทั่วไป
-4. การแยกแยะชื่อเรื่อง แบรนด์ และข่าวลือ (Entity Disambiguation & Anti-Hallucination): ตรวจสอบชื่อเฉพาะให้ตรงกับเอนทิตีที่ถูกต้อง (เช่น เมื่อค้นหาแคมเปญโฆษณาหรือแบรนด์ ให้ตรวจสอบด้วย get_brand_endorsements และค้นหาคลิปบน Bilibili ควบคู่กับชื่อภาษาจีนของแบรนด์ เช่น 帕莎/PRSR เสมอ; และห้ามเดาหรือจับคู่คำค้นหาที่ออกเสียงคล้ายกันเข้ากับผลงานอื่นในคลังโดยไม่มีหลักฐานเด็ดขาด)
-5. หากผู้ใช้ส่งคำว่า "ดำเนินการต่อ" หรือตอบตกลงต่อคำถามก่อนหน้า ให้ลงมือทำสิ่งที่เสนอไว้ทันทีด้วยข้อมูลจริงจากเครื่องมือ อย่าถามคำถามเดิมซ้ำอีก
-6. ข้อมูลที่เกี่ยวกับแบรนด์ สินค้า แคมเปญโฆษณา และสื่อบนแพลตฟอร์มโซเชียล (Bilibili, YouTube, Weibo): ให้ใช้ get_brand_endorsements ควบคู่กับ search_bilibili หรือ get_media_links เสมอ โดยระบุคำค้นภาษาจีนของศิลปินและแบรนด์อย่างครบถ้วน]`,
-
-      `[SYSTEM DIRECTIVE (Answer Quality for Drama Analysis):
-1. แยก "ข้อเท็จจริงจากเครื่องมือ" ออกจาก "บทวิเคราะห์" ให้ชัดเจน ห้ามนำเรื่องย่อไปสรุปเป็นเสียงวิจารณ์หรือการยอมรับของวงการ
-2. ห้ามเหมารวมว่าผลงานใหม่กว่าแปลว่าลึกกว่า สมจริงกว่า หรือแสดงดีกว่า ให้เทียบจากภาระของบท แรงขับของตัวละคร แนวเรื่อง และฉากที่มีหลักฐานเท่านั้น
-3. ห้ามใช้คำยกย่องแบบไม่มีหลักฐาน เช่น "ระดับแนวหน้า", "ไม่มีใครเทียบได้", "ก้าวข้ามไอดอลอย่างสมบูรณ์" หรือ "ได้รับรางวัลมากมาย"
-4. คะแนนในแคตตาล็อกที่ไม่มีชื่อแหล่งและเกณฑ์คะแนนเป็นเพียง metadata ภายใน ห้ามใช้ยืนยันคุณภาพและไม่ต้องแสดงในบทวิเคราะห์
-5. In Blossom: จวีจิ้งอีแสดงตัวตนของหยางไฉ่เวยภายใต้รูปลักษณ์ซ่างกวนจื่อหลัง premise การเปลี่ยนใบหน้า ไม่ใช่สองตัวละครอิสระที่สลับเล่นตลอดเรื่อง
-6. The Legend of White Snake: ไป๋ซู่เจินคือวิญญาณ/ปีศาจงูขาวที่แปลงเป็นหญิงมนุษย์ ส่วนสวี่เซียนคือมนุษย์ชาย ห้ามสลับเพศหรือเผ่าพันธุ์
-7. หากเป็นคำสั่ง "ดำเนินการต่อ" ให้ตอบเฉพาะมุมใหม่ที่ผู้ใช้ขอ ห้ามคัดลอกคำตอบก่อนหน้ามาตอบซ้ำ]`,
-
-      `[SYSTEM DIRECTIVE (Topic & Future-event Safety):
-1. คำถามสั้นที่มีสรรพนามหรืออ้างถึง "เรื่องนี้/งานนี้/ทำไม/น่าจับตามอง" ต้องยึดหัวข้อหลักล่าสุดในบทสนทนาก่อน ห้ามเปลี่ยนไปตอบเรื่องศิลปินเพียงเพราะ Persona หรือฐานข้อมูลเน้นศิลปิน
-2. วันนี้คือ ${conversationContext.today}. เหตุการณ์หลังวันนี้เป็นข้อมูลอนาคต: ใช้คำว่า "มีกำหนด", "มีรายงาน", หรือ "ยังไม่ยืนยัน" ตามหลักฐาน ห้ามฟันธงว่าได้รับเชิญหรือจะเข้าร่วมแน่นอนโดยไม่มีแหล่งทางการที่เป็นปัจจุบัน
-3. ห้ามนำวัน เดือน รายชื่อแขก หรือสถานะการเข้าร่วมจากงานคนละปีมาใช้กับฉบับปีปัจจุบัน หากต้องระบุวันที่แน่นอนหรือผู้เข้าร่วมงานอนาคต ให้ตรวจสอบด้วยเครื่องมือเว็บก่อน]`,
-
-      `[SYSTEM DIRECTIVE: After completing your answer, proactively formulate and suggest 2-3 engaging, creative, and relevant follow-up questions tailored specifically to what you just discussed for the user to explore deeper. Place them at the very end of your response strictly formatted as:
-[SUGGESTED_FOLLOW_UPS]
-- [คำถามแนะนำที่ 1 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
-- [คำถามแนะนำที่ 2 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
-- [คำถามแนะนำที่ 3 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
-[/SUGGESTED_FOLLOW_UPS]
-Rules for the block: one question per line, plain text only — no markdown bold/italic, no extra headers, no lead-in sentences, no numbering inside the block.]`,
-    ];
-
-    if (wantsStream) {
-      res.writeHead(200, {
-        'Content-Type': 'text/event-stream',
-        'Cache-Control': 'no-cache, no-transform',
-        'Connection': 'keep-alive',
-        'X-Accel-Buffering': 'no'
-      });
-
-      const sendSse = (eventObj) => {
-        res.write(`data: ${JSON.stringify(eventObj)}\n\n`);
-      };
-
-      if (conn.ready && conn.agent) {
-        try {
-          const toolsUsed = [];
-          let reasoningStarted = false;
-          const runRes = await conn.agent.run(queryForAgent, {
-            signal: abortController.signal,
-            systemDirectives,
-            onReasoningDelta: () => {
-              if (reasoningStarted) return;
-              reasoningStarted = true;
-              sendSse({ type: 'reasoning', chunk: 'กำลังวิเคราะห์บริบทและวางแผนคำตอบ' });
-            },
-            onToolStart: (name, input) => {
-              toolsUsed.push({ name, input });
-              sendSse({ type: 'tool_start', name, input: makeInspectableToolPayload(input) });
-            },
-            onToolResult: (name, result, durationMs) => {
-              const existing = toolsUsed.find(t => t.name === name);
-              if (existing) { existing.result = result; existing.durationMs = durationMs; }
-              sendSse({
-                type: 'tool_result',
-                name,
-                durationMs,
-                resultCount: result?.count ?? 0,
-                result: makeInspectableToolPayload(result)
-              });
-            },
-            onSubagentProgress: (event) => {
-              sendSse(sanitizeSubagentProgress(event));
-            },
-            onTokenDelta: (chunk) => {
-              sendSse({ type: 'token', chunk });
-            },
-            ...(conversationContext.contextual ? {} : {
-              onClarifyingQuestions: (questions, queryId) => {
-                sendSse({ type: 'clarifying_questions', questions, queryId: externalClarificationId(queryId) });
-              },
-              onClarifyingAnswer: (queryId) => {
-                return new Promise((resolve) => {
-                  registerClarificationResolver(externalClarificationId(queryId), resolve);
-                });
-              }
-            })
-          });
-
-          let finalAnswer = runRes?.answer || String(runRes || '');
-          finalAnswer = finalAnswer.replace(/The user has provided a complex instruction set:[\s\S]*?(?=\n\n|\n[A-Zก-๙]|$)/i, '').trim();
-          finalAnswer = finalAnswer.replace(/^\[SYSTEM (?:INSTRUCTION|DIRECTIVE):[\s\S]*?\]\s*/i, '').trim();
-
-          let suggestions = [];
-          const extracted = extractAgentFollowUpQuestions(finalAnswer);
-          finalAnswer = stripInvalidYouTubeLinks(extracted.cleanText);
-          finalAnswer = applyFutureEventGuard(finalAnswer, { tools: toolsUsed });
-          suggestions = extracted.suggestions;
-
-          if (!finalAnswer.trim()) {
-            const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-            finalAnswer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
-            if (!suggestions.length) suggestions = fallback.suggestions || [];
-          }
-
-          const qualityFallback = await replaceLowQualityDramaAnswer({
-            query,
-            answer: finalAnswer,
-            persona,
-            conversationContext,
-            toolsUsed
-          });
-          if (qualityFallback) {
-            finalAnswer = applyFutureEventGuard(qualityFallback.answer, { tools: toolsUsed });
-            suggestions = qualityFallback.suggestions;
-          }
-
-          suggestions = finalizeSuggestions(sessionKey, suggestions, { query, answer: finalAnswer, tools: toolsUsed });
-
-          const searchImages = extractSearchImagesFromTools(toolsUsed, query);
-
-          sendSse({
-            type: 'final',
-            answer: finalAnswer,
-            suggestions,
-            searchImages,
-            durationMs: Date.now() - startTime,
-            tokens: conn.agent?.lastTelemetry?.tokens || conn.agent?.session?.lastQueryTokens || null,
-            metrics: conn.agent?.lastQueryMetrics || null,
-            costUsd: conn.agent?.lastTelemetry?.costUsd ?? conn.agent?.session?.lastQueryCostUsd ?? 0,
-            citations: conn.agent?.lastCitations || [],
-            context: publicContext,
-            memory: getAgentMemorySnapshot(conn.agent, body.sessionId)
-          });
-          res.write('data: [DONE]\n\n');
-          res.end();
-          return;
-        } catch (streamErr) {
-          if (abortController.signal.aborted || streamErr?.name === 'AbortError') {
-            if (!res.writableEnded) {
-              res.write('data: [DONE]\n\n');
-              res.end();
-            }
-            return;
-          }
-          const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-          const fallbackImages = extractSearchImagesFromTools(fallback.tools, query);
-          sendSse({
-            type: 'final',
-            answer: applyFutureEventGuard(fallback.answer, { tools: fallback.tools }),
-            suggestions: finalizeSuggestions(sessionKey, fallback.suggestions || [], { query, answer: fallback.answer, tools: fallback.tools }),
-            searchImages: fallbackImages,
-            durationMs: Date.now() - startTime,
-            citations: [],
-            context: publicContext,
-            memory: { sessionId: body.sessionId || null, messageCount: body.history?.length || 0, persistent: false }
-          });
-          res.write('data: [DONE]\n\n');
-          res.end();
-          return;
-        }
-      }
-
-      sendSse({ type: 'reasoning', chunk: '⚡ ตรวจพบ LM Studio ออฟไลน์ -> เปิดใช้งาน Auto Direct Catalog Knowledge Engine...' });
-
-      const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-      const guardedFallbackAnswer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
-      const fallbackImages = extractSearchImagesFromTools(fallback.tools, query);
-      for (const t of fallback.tools) {
-        sendSse({ type: 'tool_start', name: t.name, input: t.input });
-        sendSse({ type: 'tool_result', name: t.name, durationMs: t.durationMs, resultCount: t.resultCount, result: t.result });
-      }
-      sendSse({ type: 'token', chunk: guardedFallbackAnswer });
-      sendSse({
-        type: 'final',
-        answer: guardedFallbackAnswer,
-        suggestions: finalizeSuggestions(sessionKey, fallback.suggestions || [], { query, answer: guardedFallbackAnswer, tools: fallback.tools }),
-        searchImages: fallbackImages,
-        durationMs: Date.now() - startTime,
-        citations: [],
-        context: publicContext,
-        memory: { sessionId: body.sessionId || null, messageCount: body.history?.length || 0, persistent: false }
-      });
-      res.write('data: [DONE]\n\n');
-      res.end();
-      return;
-    }
-
-    if (conn.ready && conn.agent) {
-      let answer = '';
-      let thinking = '';
-      let thinkingDurationMs = 0;
-      const toolsUsed = [];
-      const subagentActivity = [];
-
-      let runRes;
-      try {
-        runRes = await conn.agent.run(queryForAgent, {
-          signal: abortController.signal,
-          systemDirectives,
-        onReasoningDelta: () => { thinking = 'วิเคราะห์บริบทและวางแผนคำตอบแล้ว'; },
-        onReasoningEnd: () => { thinkingDurationMs = Date.now() - startTime; },
-        onSubagentProgress: (event) => {
-          subagentActivity.push(sanitizeSubagentProgress(event));
-        },
-        onToolStart: (name, input) => {
-          toolsUsed.push({ name, input: makeInspectableToolPayload(input), status: 'running' });
-        },
-        onToolResult: (name, result, dur) => {
-          let tool = null;
-          for (let index = toolsUsed.length - 1; index >= 0; index--) {
-            if (toolsUsed[index].name === name && toolsUsed[index].status === 'running') {
-              tool = toolsUsed[index];
-              break;
-            }
-          }
-          if (!tool) {
-            tool = { name };
-            toolsUsed.push(tool);
-          }
-          Object.assign(tool, {
-            status: 'done',
-            result: makeInspectableToolPayload(result),
-            resultCount: result?.count ?? 0,
-            durationMs: dur
-          });
-        }
-      });
-      } catch (agentErr) {
-        if (abortController.signal.aborted || agentErr?.name === 'AbortError') {
-          if (!res.writableEnded) {
-            return sendError(res, 499, 'Request aborted by client');
-          }
-          return;
-        }
-        throw agentErr;
-      }
-
-      answer = runRes?.answer || String(runRes || '');
-      let suggestions = [];
-      const extracted = extractAgentFollowUpQuestions(answer);
-      answer = stripInvalidYouTubeLinks(extracted.cleanText);
-      answer = applyFutureEventGuard(answer, { tools: toolsUsed });
-      suggestions = extracted.suggestions;
-
-      if (!answer.trim()) {
-        const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-        answer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
-        if (!suggestions.length) suggestions = fallback.suggestions || [];
-      }
-
-      const qualityFallback = await replaceLowQualityDramaAnswer({
-        query,
-        answer,
-        persona,
-        conversationContext,
-        toolsUsed
-      });
-      if (qualityFallback) {
-        answer = applyFutureEventGuard(qualityFallback.answer, { tools: toolsUsed });
-        suggestions = qualityFallback.suggestions;
-      }
-
-      if (!suggestions.length) {
-        suggestions = finalizeSuggestions(sessionKey, suggestions, { query, answer, tools: toolsUsed });
-      }
-
-      const searchImages = extractSearchImagesFromTools(toolsUsed, query);
-
-      return sendJson(res, 200, {
-        status: 'ok',
-        query,
-        persona,
-        answer,
-        suggestions,
-        searchImages,
-        thinking,
-        thinkingDurationMs,
-        tools: toolsUsed,
-        subagents: subagentActivity,
-        tokens: conn.agent?.lastTelemetry?.tokens || conn.agent?.session?.lastQueryTokens || null,
-        metrics: conn.agent?.lastQueryMetrics || null,
-        costUsd: conn.agent?.lastTelemetry?.costUsd ?? conn.agent?.session?.lastQueryCostUsd ?? 0,
-        citations: conn.agent?.lastCitations || [],
-        context: publicContext,
-        memory: getAgentMemorySnapshot(conn.agent, body.sessionId),
-        durationMs: Date.now() - startTime
-      });
-    }
-
-    const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
-    const searchImages = extractSearchImagesFromTools(fallback.tools, query);
-    return sendJson(res, 200, {
-      status: 'ok',
-      query,
-      persona,
-      answer: applyFutureEventGuard(fallback.answer, { tools: fallback.tools }),
-      suggestions: finalizeSuggestions(sessionKey, fallback.suggestions || [], { query, answer: fallback.answer, tools: fallback.tools }),
-      searchImages,
-      thinking: fallback.thinking,
-      thinkingDurationMs: Date.now() - startTime,
-      tools: fallback.tools,
-      citations: [],
-      context: publicContext,
-      memory: { sessionId: body.sessionId || null, messageCount: body.history?.length || 0, persistent: false },
-      durationMs: Date.now() - startTime
-    });
-
-  } catch (err) {
-    return sendError(res, 500, err.message);
-  }
-}
+import { randomUUID } from 'node:crypto';
+import { resolveAgentConnection, currentAgent } from '../core/connection.js';
+import { config, getProvider, normalizeInferenceSettings, getPersistedInferenceSettings } from '../../agent/config.js';
+import { executeDirectCatalogKnowledge } from '../core/directCatalogEngine.js';
+import { makeInspectableToolPayload } from '../core/toolInspector.js';
+import { getAgentMemorySnapshot } from '../core/memorySnapshot.js';
+import { parseJsonBody, sendJson, sendError } from '../core/errorHandler.js';
+import { registerClarificationResolver } from './clarifyRoute.js';
+import { extractAgentFollowUpQuestions, generateDynamicFollowUps, dedupeSuggestions, normalizeSuggestionKey } from '../core/followUpEngine.js';
+import { resolveConversationContext } from '../core/conversationContext.js';
+import { applyFutureEventGuard } from '../core/futureEventGuard.js';
+import { extractApiKey, isWebChatAdmin } from '../core/security.js';
+import { validateInferenceBaseUrl, isTrustedRequest, sanitizeInferenceError } from '../core/urlGuard.js';
+import { assessDramaAnswerQuality } from '../core/dramaKnowledge.js';
+import { isLowValueImageUrl, imageHostKey } from '../../agent/webSearch.js';
+import { collectMusicControlActions, createMusicControlAction } from '../core/musicControlAction.js';
+import { resolveQueryEntities } from '../../agent/catalogEntityResolver.js';
+
+const MAX_QUERY_LENGTH = 32_000;
+const MAX_CONTEXT_LIMIT = 131_072;
+
+function stripInvalidYouTubeLinks(text) {
+  if (!text || typeof text !== 'string') return text || '';
+  return text.replace(/(?:https?:\/\/)?(?:www\.)?(?:youtube\.com\/watch\?v=|youtu\.be\/)([a-zA-Z0-9_-]{1,20})/gi, (m, id) => (id.length === 11 ? m : ''));
+}
+
+async function replaceLowQualityDramaAnswer({ query, answer, persona, conversationContext, toolsUsed }) {
+  const assessment = assessDramaAnswerQuality(query, answer);
+  if (!assessment.applicable || assessment.valid) return null;
+
+  const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
+  if (Array.isArray(toolsUsed)) toolsUsed.push(...fallback.tools);
+  return {
+    answer: fallback.answer,
+    suggestions: fallback.suggestions || [],
+    issues: assessment.issues
+  };
+}
+
+const CURATED_IMAGE_TOOL_NAMES = new Set(['search_news', 'search_chinese_web', 'web_search', 'get_gallery_photos']);
+
+export function extractSearchImagesFromTools(tools = [], query = '') {
+  const images = [];
+  const seenUrls = new Set();
+  const seenKeys = new Set();
+  const add = (img, { trusted = false } = {}) => {
+    const url = img?.imageUrl || img?.thumbUrl || img?.url || img?.src || img?.image;
+    if (!url || typeof url !== 'string' || seenUrls.has(url)) return;
+    if (isLowValueImageUrl(url)) return;
+    const key = imageHostKey(url);
+    if (seenKeys.has(key)) return;
+    if (!trusted && img?.width && img.width < 200) return;
+    seenUrls.add(url);
+    seenKeys.add(key);
+    images.push({
+      title: img.title || img.alt || query || 'Ju Jingyi',
+      imageUrl: url,
+      thumbUrl: img.thumbUrl || img.imageUrl || url,
+      source: img.source || 'Search'
+    });
+  };
+
+
+  const orderedTools = [...tools].sort((a, b) =>
+    (a?.name === 'search_web_images' ? 0 : 1) - (b?.name === 'search_web_images' ? 0 : 1));
+
+  for (const t of orderedTools) {
+    const res = t?.result;
+    if (!res) continue;
+    const isDedicated = t.name === 'search_web_images';
+    if (!isDedicated && !CURATED_IMAGE_TOOL_NAMES.has(t.name)) continue;
+
+    if (isDedicated && Array.isArray(res.results)) {
+      res.results.forEach(img => add(img, { trusted: true }));
+    }
+    const curated = isDedicated || t.name === 'get_gallery_photos';
+    if (Array.isArray(res.images)) res.images.forEach(img => add(img, { trusted: curated }));
+    if (Array.isArray(res.photos)) res.photos.forEach(img => add(img, { trusted: curated }));
+    if (Array.isArray(res.works)) {
+      res.works.forEach(w => {
+        if (w.poster) add({ title: w.titleTh || w.titleCn || w.titleEn, imageUrl: w.poster, source: 'Series Poster' }, { trusted: true });
+      });
+    }
+  }
+
+  const rowAlignedCount = Math.floor(images.length / 3) * 3;
+  if (rowAlignedCount >= 3) {
+    return images.slice(0, Math.min(rowAlignedCount, 9));
+  }
+  return images.slice(0, 6);
+}
+
+
+export function sanitizeSubagentProgress(event = {}) {
+  const text = (value, max = 200) => String(value ?? '').slice(0, max);
+  const num = (value) => (Number.isFinite(Number(value)) ? Number(value) : undefined);
+  const out = { type: 'subagent_progress' };
+  if (['subagent', 'research', 'verify'].includes(event.source)) out.source = event.source;
+  else out.source = 'subagent';
+  if (['start', 'iteration', 'tool', 'worker-start', 'worker-complete', 'complete'].includes(event.type)) out.kind = event.type;
+  else out.kind = 'tool';
+  const subject = event.task ?? event.question ?? event.claim ?? '';
+  if (subject) out.subject = text(subject);
+  if (event.iteration !== undefined) out.iteration = num(event.iteration);
+  if (event.maxIterations !== undefined) out.maxIterations = num(event.maxIterations);
+  if (event.name) out.tool = text(event.name, 80);
+  if (event.label) out.label = text(event.label, 120);
+  if (event.id) out.workerId = text(event.id, 80);
+  if (event.workerId) out.workerId = text(event.workerId, 80);
+  if (event.sources !== undefined) out.sources = num(event.sources);
+  return out;
+}
+
+
+const CHAT_PERSONAS = new Set(['official', 'fan', 'researcher', 'default']);
+
+const PERSONA_TONE_DIRECTIVES = {
+  official: `[SYSTEM DIRECTIVE (Agent Tone — Official Assistant): ตอบด้วยน้ำเสียงสุภาพ อบอุ่น เป็นกันเองแบบมืออาชีพ เน้นความถูกต้องของข้อเท็จจริง กระชับแต่ครบถ้วน เรียกผู้ใช้อย่างเป็นกันเองในฐานะเพื่อนแฟนคลับ]`,
+  fan: `[SYSTEM DIRECTIVE (Agent Tone — Miju Companion): ตอบด้วยน้ำเสียงสดใส สนุก เป็นกันเองเหมือนเพื่อนมี่จวี ใช้ภาษากันเองและอีโมจิได้พอประมาณ แต่ต้องรักษาความถูกต้องของข้อเท็จจริงจากผลลัพธ์เครื่องมือ ห้ามแต่งข้อมูลเพื่อให้สนุก]`,
+  researcher: `[SYSTEM DIRECTIVE (Agent Tone — Analytical Researcher): ตอบเชิงวิเคราะห์อย่างเป็นระบบ ใช้หัวข้อและโครงสร้างชัดเจน แยกข้อเท็จจริงจากบทวิเคราะห์ ให้ความลึกเชิงบริบทและเปรียบเทียบเมื่อเหมาะสม แต่ยังคงอ้างอิงเฉพาะข้อมูลที่มีหลักฐานจากเครื่องมือ]`,
+};
+
+const recentSuggestionKeys = new Map();
+
+function getRecentSuggestionSet(sessionKey) {
+  let set = recentSuggestionKeys.get(sessionKey);
+  if (!set) {
+    set = new Set();
+    recentSuggestionKeys.set(sessionKey, set);
+    if (recentSuggestionKeys.size > 200) {
+      const oldest = recentSuggestionKeys.keys().next().value;
+      recentSuggestionKeys.delete(oldest);
+    }
+  }
+  return set;
+}
+
+function finalizeSuggestions(sessionKey, baseSuggestions, { query, answer, tools }) {
+  const recentKeys = getRecentSuggestionSet(sessionKey);
+  let out = dedupeSuggestions(Array.isArray(baseSuggestions) ? baseSuggestions : [], recentKeys);
+  if (out.length < 3) {
+    const dynamic = generateDynamicFollowUps({ query, answer, tools, recentKeys });
+    const localSeen = new Set(recentKeys);
+    for (const s of out) localSeen.add(normalizeSuggestionKey(s.query || s.label));
+    out = [...out, ...dedupeSuggestions(dynamic, localSeen)].slice(0, 3);
+  }
+  if (out.length) {
+    const set = getRecentSuggestionSet(sessionKey);
+    for (const s of out) {
+      set.add(normalizeSuggestionKey(s.query || s.label));
+      if (set.size > 60) {
+        const oldest = set.values().next().value;
+        set.delete(oldest);
+      }
+    }
+  }
+  return out;
+}
+
+export async function handleChatRoute(req, res, urlObj, { resolveConnection = resolveAgentConnection } = {}) {
+  let body;
+  try {
+    body = await parseJsonBody(req, 15 * 1024 * 1024);
+  } catch (err) {
+    return sendError(res, 400, `Invalid JSON body: ${err.message}`);
+  }
+
+  const rawAttachments = Array.isArray(body.attachments) ? body.attachments : [];
+  const attachments = rawAttachments.slice(0, 4).map(att => {
+    if (!att || typeof att !== 'object') return null;
+    const name = String(att.name || 'file').slice(0, 120);
+    const type = String(att.type || '').slice(0, 80);
+    const isImage = Boolean(att.isImage || type.startsWith('image/'));
+    const dataUrl = typeof att.dataUrl === 'string' && (att.dataUrl.startsWith('data:') || att.dataUrl.startsWith('http') || att.dataUrl.startsWith('blob:'))
+      ? att.dataUrl
+      : null;
+    return { name, size: Number(att.size) || 0, type, isImage, dataUrl };
+  }).filter(Boolean);
+
+  let query = String(body.query || '').trim();
+  if (!query && attachments.length > 0) {
+    query = 'ช่วยตรวจสอบและวิเคราะห์รูปภาพที่แนบมานี้ให้หน่อยค่ะ';
+  }
+  if (!query) {
+    return sendError(res, 400, 'Query is required');
+  }
+  if (query.length > MAX_QUERY_LENGTH) {
+    return sendError(res, 400, `Query too long (${query.length} chars, max ${MAX_QUERY_LENGTH})`);
+  }
+
+  const inference = normalizeInferenceSettings({ ...body, topP: body.topP ?? body.top_p, contextLimit: body.contextLimit ?? body.context_limit }, getPersistedInferenceSettings());
+  const rawPersona = inference.persona;
+  const persona = CHAT_PERSONAS.has(rawPersona) ? rawPersona : 'default';
+
+ 
+  const runTemperature = inference.temperature;
+  const runTopP = inference.topP;
+  const runContextLimit = inference.contextLimit;
+  const runMinP = inference.minP;
+  const runRepeatPenalty = inference.repeatPenalty;
+  const sessionKey = String(body.sessionId || 'global');
+  const wantsStream = inference.stream === true || (req.headers.accept && req.headers.accept.includes('text/event-stream'));
+
+  const apiKey = extractApiKey(req);
+
+ 
+  const rawBaseUrl = typeof body.baseUrl === 'string' && body.baseUrl.trim() ? body.baseUrl.trim() : null;
+  let guardedBaseUrl = null;
+  if (rawBaseUrl) {
+    const guard = await validateInferenceBaseUrl(rawBaseUrl, { trusted: isTrustedRequest(req) });
+    if (!guard.ok) {
+      return sendError(res, 400, `Invalid baseUrl: ${guard.reason}`);
+    }
+    guardedBaseUrl = guard.normalized;
+  }
+
+  const requestedProvider = String(body.provider || '').toLowerCase().trim();
+  const effectiveProvider = (requestedProvider && requestedProvider !== 'auto')
+    ? requestedProvider
+    : (currentAgent?.client?.provider || config.activeProvider || 'lmstudio');
+  if (!getProvider(effectiveProvider)) return sendError(res, 400, 'Unknown provider');
+  if (!['lmstudio', 'vllm', 'custom'].includes(effectiveProvider) && !isTrustedRequest(req)) {
+    return sendError(res, 403, 'Cloud inference requires local access or a valid WEBCHAT_ADMIN_KEY');
+  }
+
+  const abortController = new AbortController();
+  let heartbeat = null;
+  const cleanupHeartbeat = () => {
+    if (heartbeat) {
+      clearInterval(heartbeat);
+      heartbeat = null;
+    }
+  };
+  res.on('close', () => {
+    cleanupHeartbeat();
+    if (!res.writableEnded) {
+      abortController.abort();
+    }
+  });
+  const startTime = Date.now();
+  const clarificationIds = new Map();
+  const externalClarificationId = (internalId) => {
+    if (!clarificationIds.has(internalId)) clarificationIds.set(internalId, randomUUID());
+    return clarificationIds.get(internalId);
+  };
+  const conversationContext = resolveConversationContext(query, body.history);
+  const publicContext = {
+    contextual: conversationContext.contextual,
+    domain: conversationContext.domain
+  };
+
+  try {
+    const conn = await resolveConnection({
+      provider: body.provider,
+      model: body.model,
+      thinking: inference.thinking,
+      apiKey: isWebChatAdmin(req) ? undefined : apiKey,
+      callerIsTrusted: isTrustedRequest(req),
+      allowAutoStart: isTrustedRequest(req),
+      sessionId: body.sessionId,
+      history: body.history,
+      baseUrl: guardedBaseUrl || undefined,
+    }, { signal: abortController.signal });
+
+  
+    let queryForAgent = conversationContext.resolvedQuery;
+    const imageAttachments = attachments.filter(a => a.isImage);
+    const otherAttachments = attachments.filter(a => !a.isImage);
+
+    if (imageAttachments.length > 0) {
+      const imgInfo = imageAttachments.map(img => `"${img.name}" (${img.type || 'image'})`).join(', ');
+      const imageContextHints = [];
+      for (const img of imageAttachments) {
+        const cleanName = (img.name || '').replace(/\.[^.]+$/, '').replace(/[_-]+/g, ' ').trim();
+        if (cleanName) {
+          const res = resolveQueryEntities(cleanName);
+          if (res.primaryWork) {
+            imageContextHints.push(`ชื่อไฟล์ภาพ "${img.name}" สอดคล้องกับผลงานในแคตตาล็อก: "${res.primaryWork.nameCn || res.primaryWork.nameTh}"`);
+          } else if (res.primarySong) {
+            imageContextHints.push(`ชื่อไฟล์ภาพ "${img.name}" สอดคล้องกับบทเพลงในแคตตาล็อก: "${res.primarySong.nameCn || res.primarySong.titleEn}"`);
+          } else if (res.primaryBrand) {
+            imageContextHints.push(`ชื่อไฟล์ภาพ "${img.name}" สอดคล้องกับแบรนด์ในแคตตาล็อก: "${res.primaryBrand.nameCn || res.primaryBrand.nameEn}"`);
+          }
+        }
+      }
+      const hintText = imageContextHints.length > 0 ? `\n[IMAGE RECOGNITION HINTS: ${imageContextHints.join('; ')}]` : '';
+      queryForAgent = `${queryForAgent}\n\n[USER ATTACHMENT: ผู้ใช้ได้แนบรูปภาพจำนวน ${imageAttachments.length} รูป: ${imgInfo}]${hintText}`;
+    }
+    if (otherAttachments.length > 0) {
+      const fileInfo = otherAttachments.map(f => `"${f.name}" (${f.type || 'file'})`).join(', ');
+      const textFileSnippets = [];
+      for (const f of otherAttachments) {
+        const isText = (f.type && (f.type.startsWith('text/') || f.type.includes('json') || f.type.includes('javascript') || f.type.includes('csv') || f.type.includes('xml'))) ||
+          /\.(txt|json|csv|tsv|md|markdown|js|mjs|jsx|ts|tsx|py|html|xml|yaml|yml|log|css|sql|sh)$/i.test(f.name || '');
+        if (isText && f.dataUrl && typeof f.dataUrl === 'string') {
+          try {
+            const base64Part = f.dataUrl.replace(/^data:[^;]+;base64,/, '');
+            if (base64Part) {
+              const decoded = Buffer.from(base64Part, 'base64').toString('utf8');
+              const maxLen = 6000;
+              const content = decoded.length > maxLen
+                ? decoded.slice(0, maxLen) + `\n... [เนื้อหาไฟล์ถูกตัดทอนเนื่องจากยาวเกิน ${maxLen} ตัวอักษร]`
+                : decoded;
+              textFileSnippets.push(`\n[ATTACHED FILE CONTENT: "${f.name}"]:\n\`\`\`\n${content.trim()}\n\`\`\``);
+            }
+          } catch {}
+        }
+      }
+      const snippetText = textFileSnippets.join('\n');
+      queryForAgent = `${queryForAgent}\n\n[USER ATTACHMENT: ผู้ใช้ได้แนบไฟล์ข้อมูล: ${fileInfo}]${snippetText}`;
+    }
+
+    const systemDirectives = [
+      `[SYSTEM DIRECTIVE (Fact Grounding & Multi-Domain Retrieval):
+1. อ้างอิงเฉพาะเพลง ซีรีส์ แบรนด์พรีเซนเตอร์ และข้อมูลจริงที่ได้จากผลลัพธ์เครื่องมือ (search_works, search_discography, get_brand_endorsements, get_character_roles, get_awards, get_career_timeline, search_bilibili, search_chinese_web, web_search, get_media_links) เท่านั้น ห้ามแต่งชื่อผลงาน ชื่อแบรนด์ ตัวเลข หรือลิงก์สื่อขึ้นเอง หากตรวจสอบเครื่องมือที่เกี่ยวข้องแล้วไม่พบ จึงแจ้งผู้ใช้ตามหลักฐานจริง
+2. เมื่อพูดถึงเพลงหรือแบรนด์ใด ให้ระบุ "ชื่อจริง" จากคลังข้อมูลกำกับในประโยคเสมอ (เช่น "เพลง 千年等一回", "แบรนด์ PRSR (帕莎眼镜)") และห้ามแนบ URL ที่ไม่ได้มาจากผลลัพธ์เครื่องมือโดยเด็ดขาด
+3. เงื่อนไขการเสนอเปิดเพลงใน Mini Player: ให้เสนอเปิดเพลงเฉพาะเมื่อผู้ใช้ถามเรื่องบทเพลง การฟังเพลง หรือ OST โดยตรงเท่านั้น และต้องระบุชื่อเพลงที่เจาะจงในประโยคเดียวกัน ห้ามเสนอเปิดเพลงหรือถามชวนเปิดเพลงเมื่อผู้ใช้ถามเรื่องซีรีส์ แบรนด์ ข่าวลือ หรือเนื้อหาทั่วไป
+4. การแยกแยะชื่อเรื่อง แบรนด์ และข่าวลือ (Entity Disambiguation & Anti-Hallucination): ตรวจสอบชื่อเฉพาะให้ตรงกับเอนทิตีที่ถูกต้อง (เช่น เมื่อค้นหาแคมเปญโฆษณาหรือแบรนด์ ให้ตรวจสอบด้วย get_brand_endorsements และค้นหาคลิปบน Bilibili ควบคู่กับชื่อภาษาจีนของแบรนด์ เช่น 帕莎/PRSR เสมอ; และห้ามเดาหรือจับคู่คำค้นหาที่ออกเสียงคล้ายกันเข้ากับผลงานอื่นในคลังโดยไม่มีหลักฐานเด็ดขาด)
+5. หากผู้ใช้ส่งคำว่า "ดำเนินการต่อ" หรือตอบตกลงต่อคำถามก่อนหน้า ให้ลงมือทำสิ่งที่เสนอไว้ทันทีด้วยข้อมูลจริงจากเครื่องมือ อย่าถามคำถามเดิมซ้ำอีก
+6. ข้อมูลที่เกี่ยวกับแบรนด์ สินค้า แคมเปญโฆษณา และสื่อบนแพลตฟอร์มโซเชียล (Bilibili, YouTube, Weibo): ให้ใช้ get_brand_endorsements ควบคู่กับ search_bilibili หรือ get_media_links เสมอ โดยระบุคำค้นภาษาจีนของศิลปินและแบรนด์อย่างครบถ้วน
+7. การควบคุมเครื่องเล่นเพลงผ่านคำสั่ง (Agent Music Playback Control): เมื่อผู้ใช้สั่งให้เปิดเพลง, หยุดเพลง, เล่นต่อ, ปิดเพลง, ข้ามเพลง, ย้อนเพลง, ปรับระดับเสียง, ปิด/เปิดเสียง, เลื่อนตำแหน่งวินาที/นาที, ตั้งค่าเล่นซ้ำ, สลับโหมดสุ่มเพลง หรือเปิด/ปิดวิดีโอ MV ให้เรียกใช้เครื่องมือควบคุมเพลงที่เกี่ยวข้อง (play_music, pause_music, resume_music, stop_music, next_track, prev_track, set_volume, mute_music, unmute_music, seek_music, set_repeat_mode, set_shuffle_mode, toggle_video_mode) ทันทีในเทิร์นนี้
+8. คำถามนอกเรื่อง (Open-Domain): หากคำถามไม่เกี่ยวกับจวีจิ้งอี ผลงาน เพลง แบรนด์ หรือแฟนด้อมเลย ให้ค้นหาด้วยเครื่องมือเว็บ (web_search, web_extract, fetch_webpage, search_encyclopedia, search_news) เท่านั้น ห้ามใช้เครื่องมือแคตตาล็อกของศิลปิน (search_works, search_discography, get_profile_and_fandom ฯลฯ) และตอบเฉพาะจากผลลัพธ์เว็บเท่านั้น]`,
+
+      `[SYSTEM DIRECTIVE (Answer Quality for Drama Analysis):
+1. แยก "ข้อเท็จจริงจากเครื่องมือ" ออกจาก "บทวิเคราะห์" ให้ชัดเจน ห้ามนำเรื่องย่อไปสรุปเป็นเสียงวิจารณ์หรือการยอมรับของวงการ
+2. ห้ามเหมารวมว่าผลงานใหม่กว่าแปลว่าลึกกว่า สมจริงกว่า หรือแสดงดีกว่า ให้เทียบจากภาระของบท แรงขับของตัวละคร แนวเรื่อง และฉากที่มีหลักฐานเท่านั้น
+3. ห้ามใช้คำยกย่องแบบไม่มีหลักฐาน เช่น "ระดับแนวหน้า", "ไม่มีใครเทียบได้", "ก้าวข้ามไอดอลอย่างสมบูรณ์" หรือ "ได้รับรางวัลมากมาย"
+4. คะแนนในแคตตาล็อกที่ไม่มีชื่อแหล่งและเกณฑ์คะแนนเป็นเพียง metadata ภายใน ห้ามใช้ยืนยันคุณภาพและไม่ต้องแสดงในบทวิเคราะห์
+5. In Blossom: จวีจิ้งอีแสดงตัวตนของหยางไฉ่เวยภายใต้รูปลักษณ์ซ่างกวนจื่อหลัง premise การเปลี่ยนใบหน้า ไม่ใช่สองตัวละครอิสระที่สลับเล่นตลอดเรื่อง
+6. The Legend of White Snake: ไป๋ซู่เจินคือวิญญาณ/ปีศาจงูขาวที่แปลงเป็นหญิงมนุษย์ ส่วนสวี่เซียนคือมนุษย์ชาย ห้ามสลับเพศหรือเผ่าพันธุ์
+7. หากเป็นคำสั่ง "ดำเนินการต่อ" ให้ตอบเฉพาะมุมใหม่ที่ผู้ใช้ขอ ห้ามคัดลอกคำตอบก่อนหน้ามาตอบซ้ำ
+8. การวิเคราะห์เชิงลึกและเจาะลึก (Deep-dive Analysis): สำหรับคำถามที่ต้องการการเจาะลึก วิเคราะห์การแสดง บทบาท หรือเนื้อหาเรื่องราว ให้ใช้ search_works, get_work_detail, get_character_roles, get_career_timeline หรือ web_search ห้ามเรียกใช้ get_gallery_photos เว้นแต่ผู้ใช้จะระบุอย่างชัดเจนว่าต้องการดูรูปภาพ ภาพนิ่ง หรือแฟชั่นเซ็ตประกอบ]`,
+
+      `[SYSTEM DIRECTIVE (Topic & Future-event Safety):
+1. คำถามสั้นที่มีสรรพนามหรืออ้างถึง "เรื่องนี้/งานนี้/ทำไม/น่าจับตามอง" ต้องยึดหัวข้อหลักล่าสุดในบทสนทนาก่อน ห้ามเปลี่ยนไปตอบเรื่องศิลปินเพียงเพราะ Persona หรือฐานข้อมูลเน้นศิลปิน
+2. วันนี้คือ ${conversationContext.today}. เหตุการณ์หลังวันนี้เป็นข้อมูลอนาคต: ใช้คำว่า "มีกำหนด", "มีรายงาน", หรือ "ยังไม่ยืนยัน" ตามหลักฐาน ห้ามฟันธงว่าได้รับเชิญหรือจะเข้าร่วมแน่นอนโดยไม่มีแหล่งทางการที่เป็นปัจจุบัน
+3. ห้ามนำวัน เดือน รายชื่อแขก หรือสถานะการเข้าร่วมจากงานคนละปีมาใช้กับฉบับปีปัจจุบัน หากต้องระบุวันที่แน่นอนหรือผู้เข้าร่วมงานอนาคต ให้ตรวจสอบด้วยเครื่องมือเว็บก่อน]`,
+
+      `[SYSTEM DIRECTIVE: After completing your answer, proactively formulate and suggest 2-3 engaging, creative, and relevant follow-up questions tailored specifically to what you just discussed for the user to explore deeper. Place them at the very end of your response strictly formatted as:
+[SUGGESTED_FOLLOW_UPS]
+- [คำถามแนะนำที่ 1 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
+- [คำถามแนะนำที่ 2 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
+- [คำถามแนะนำที่ 3 ที่เชื่อมโยงกับเรื่องที่เพิ่งเล่า]
+[/SUGGESTED_FOLLOW_UPS]
+Rules for the block: one question per line, plain text only — no markdown bold/italic, no extra headers, no lead-in sentences, no numbering inside the block.
+Topic fidelity rule: if the user's question is NOT about Ju Jingyi, her works, music, brands, or fandom, the follow-up questions MUST stay on the user's actual topic — do NOT redirect or steer the user back to Ju Jingyi topics.]`,
+    ];
+
+    if (imageAttachments.length > 0) {
+      const imgNames = imageAttachments.map(img => `"${img.name}"`).join(', ');
+      systemDirectives.push(`[SYSTEM DIRECTIVE (User Image Attachments Received):
+1. ผู้ใช้ได้แนบรูปภาพเข้ามาในการสนทนานี้: ${imgNames}
+2. ระบบได้รับรูปภาพของผู้ใช้เรียบร้อยแล้วอย่างสมบูรณ์
+3. หากชื่อไฟล์ คำถาม หรือบริบทสอดคล้องกับผลงาน ละคร เพลง ลุคงานอีเวนต์ หรือแบรนด์ในแคตตาล็อก ให้เชื่อมโยงและนำเสนอข้อมูลหรือเรียกใช้เครื่องมือค้นหาผลงาน (search_works), รูปภาพแกลเลอรี (get_gallery_photos), หรือค้นหาบทบาท (get_character_roles) มาสนับสนุนคำตอบอย่างเป็นมิตร
+4. หากชื่อไฟล์และคำถามไม่มีบริบทเฉพาะเจาะจง ให้ทักทายตอบรับรูปภาพอย่างอบอุ่น ชี้แจงอย่างสุภาพว่าปัจจุบันระบบเน้นการวิเคราะห์ข้อมูลและแคตตาล็อก จึงแนะนำให้ผู้ใช้ระบุชื่อเรื่อง บทบาท หรือสิ่งที่ต้องการค้นหาเกี่ยวกับรูปภาพนี้ เพื่อที่ระบบจะได้ช่วยดึงข้อมูลและภาพจากแกลเลอรีมาให้ชมได้ตรงจุด]`);
+    }
+
+   
+    if (persona !== 'default' && PERSONA_TONE_DIRECTIVES[persona]) {
+      systemDirectives.push(PERSONA_TONE_DIRECTIVES[persona]);
+    }
+
+    if (wantsStream) {
+      res.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache, no-transform',
+        'Connection': 'keep-alive',
+        'X-Accel-Buffering': 'no'
+      });
+
+      heartbeat = setInterval(() => {
+        if (res.writableEnded || res.destroyed) {
+          cleanupHeartbeat();
+          return;
+        }
+        try {
+          res.write(': ping\n\n');
+        } catch {
+          cleanupHeartbeat();
+        }
+      }, 15_000);
+      heartbeat.unref?.();
+      res.once('close', cleanupHeartbeat);
+      res.once('finish', cleanupHeartbeat);
+      const sendSse = (eventObj) => {
+        if (res.writableEnded || res.destroyed) return;
+        try { res.write(`data: ${JSON.stringify(eventObj)}\n\n`); } catch { cleanupHeartbeat(); }
+      };
+
+      if (conn.ready && conn.agent) {
+        try {
+          const isResearch = /^\/research(?:\s|$)/i.test(query.trim());
+          const isVerify = /^\/verify(?:\s|$)/i.test(query.trim());
+          if (isResearch || isVerify) {
+            const researchTarget = query.trim().replace(/^\/(?:research|verify)\s*/i, '').trim();
+            if (!researchTarget) {
+              const guideMessage = isVerify
+                ? `⚖️ **ระบบตรวจสอบข้อเท็จจริง (Fact-Check & Verify)**\n\nกรุณาระบุข้อกล่าวอ้างหรือข่าวลือที่ต้องการให้ AI ตรวจสอบ เช่น:\n- \`/verify จวีจิ้งอีเป็น Brand Ambassador ของ FRED Paris ในปี 2024-2026 จริงหรือไม่\`\n- \`/verify เพลง 0.2s เป็นซิงเกิลวันเกิดที่ปล่อยเมื่อวันที่ 18 มิถุนายน 2024\`\n\nระบบจะกระจายงานไปยัง 3 Subagent Workers เพื่อตรวจสอบข้ามแคตตาล็อกทางการ ข่าวสื่อออนไลน์ และวิเคราะห์ข้อขัดแย้งเพื่อสรุปคำตัดสิน (VERIFIED / FALSE / CONFLICTING) พร้อมระบุแหล่งอ้างอิงค่ะ`
+                : `🔍 **ระบบวิจัยเชิงลึก (Deep Research Engine)**\n\nกรุณาระบุคำถามหรือหัวข้อที่ต้องการให้วิจัย เช่น:\n- \`/research รางวัลและเกียรติยศทั้งหมดที่จวีจิ้งอีได้รับในระดับประเทศและสากล\`\n- \`/research วิเคราะห์บทบาทหยางไฉ่เวยและซ่างกวนจื่อในซีรีส์ In Blossom\`\n\nระบบจะกระจายงานไปยัง 3 Subagent Workers ทำงานคู่ขนานกันเพื่อสำรวจคลังผลงาน ข่าวสาร และสังเคราะห์รายงานเจาะลึกค่ะ`;
+
+              sendSse({ type: 'token', chunk: guideMessage });
+              sendSse({
+                type: 'final',
+                answer: guideMessage,
+                suggestions: isVerify ? [
+                  { label: '💎 ตรวจสอบ: แอมบาสเดอร์ FRED Paris', query: '/verify จวีจิ้งอีเป็น Brand Ambassador ของ FRED Paris ในปี 2024-2026 จริงหรือไม่' },
+                  { label: '🎂 ตรวจสอบ: ซิงเกิลวันเกิด 0.2s', query: '/verify เพลง 0.2s เป็นซิงเกิลวันเกิดที่ปล่อยเมื่อวันที่ 18 มิถุนายน 2024' },
+                  { label: '🐰 ตรวจสอบ: พรีเซนเตอร์ TuTuCare', query: '/verify จวีจิ้งอีเคยเป็นพรีเซนเตอร์ของแบรนด์ TuTuCare และ Lafang' }
+                ] : [
+                  { label: '🏆 วิจัย: รางวัลและเกียรติยศสากล', query: '/research รางวัลและเกียรติยศทั้งหมดที่จวีจิ้งอีได้รับในระดับประเทศและสากล' },
+                  { label: '🎭 วิจัย: พัฒนาการด้านการแสดง', query: '/research วิเคราะห์พัฒนาการด้านการแสดงและบทบาทเด่นของจวีจิ้งอี' },
+                  { label: '🌸 วิจัย: เจาะลึก In Blossom', query: '/research บทบาทหยางไฉ่เวยและซ่างกวนจื่อในซีรีส์ฮวาเจียนเลิ่ง (In Blossom)' }
+                ],
+                searchImages: [],
+                attachments: attachments.map(a => ({ name: a.name, size: a.size, type: a.type, isImage: a.isImage })),
+                durationMs: Date.now() - startTime,
+                citations: [],
+                context: publicContext,
+                memory: getAgentMemorySnapshot(conn.agent, body.sessionId)
+              });
+              cleanupHeartbeat();
+              res.write('data: [DONE]\n\n');
+              res.end();
+              return;
+            }
+
+            const toolsUsed = [];
+            sendSse({
+              type: 'subagent_progress',
+              source: isVerify ? 'verify' : 'research',
+              kind: 'start',
+              subject: researchTarget,
+              workers: 3
+            });
+
+            const forwardProgress = (event) => {
+              sendSse(sanitizeSubagentProgress({
+                source: isVerify ? 'verify' : 'research',
+                subject: researchTarget,
+                ...event
+              }));
+            };
+
+            const researchResult = await conn.agent.runResearch(researchTarget, {
+              mode: isVerify ? 'verify' : 'research',
+              signal: abortController.signal,
+              onProgress: forwardProgress,
+            });
+
+            const allWorkerTools = (researchResult.reports || []).flatMap(r => r.toolCalls || []).map(tc => {
+              const name = typeof tc === 'string' ? tc : (tc.name || 'tool');
+              const input = typeof tc === 'object' && tc.args ? tc.args : {};
+              const result = typeof tc === 'object' && tc.result ? tc.result : { status: 'ok' };
+              const durationMs = typeof tc === 'object' && tc.duration ? tc.duration : 0;
+              return { name, input, result, durationMs, status: 'done' };
+            });
+            toolsUsed.push(...allWorkerTools);
+
+            let finalAnswer = researchResult.answer || '';
+            if (!finalAnswer.trim()) {
+              finalAnswer = 'ไม่พบข้อมูลเพียงพอสำหรับการวิจัยในหัวข้อนี้ค่ะ';
+            }
+
+            sendSse({ type: 'token', chunk: finalAnswer });
+
+            let suggestions = [];
+            const extracted = extractAgentFollowUpQuestions(finalAnswer);
+            finalAnswer = stripInvalidYouTubeLinks(extracted.cleanText);
+            suggestions = extracted.suggestions;
+            suggestions = finalizeSuggestions(sessionKey, suggestions, { query, answer: finalAnswer, tools: toolsUsed });
+
+            const searchImages = extractSearchImagesFromTools(toolsUsed, researchTarget);
+
+            try {
+              if (conn.agent.session?.createUserMessage) {
+                conn.agent.session.createUserMessage(query);
+              }
+              if (conn.agent.session?.createAssistantMessage) {
+                conn.agent.session.createAssistantMessage({ content: finalAnswer });
+              }
+              if (Array.isArray(conn.agent.conversationHistory)) {
+                conn.agent.conversationHistory.push({ role: 'user', content: query });
+                conn.agent.conversationHistory.push({ role: 'assistant', content: finalAnswer });
+              }
+            } catch {}
+
+            sendSse({
+              type: 'final',
+              answer: finalAnswer,
+              suggestions,
+              searchImages,
+              attachments: attachments.map(a => ({ name: a.name, size: a.size, type: a.type, isImage: a.isImage })),
+              durationMs: Date.now() - startTime,
+              citations: (researchResult.sources || []).map((s, i) => ({ id: i + 1, url: s, title: s })),
+              context: publicContext,
+              memory: getAgentMemorySnapshot(conn.agent, body.sessionId)
+            });
+            cleanupHeartbeat();
+            res.write('data: [DONE]\n\n');
+            res.end();
+            return;
+          }
+
+          const toolsUsed = [];
+          let reasoningStarted = false;
+          const runRes = await conn.agent.run(queryForAgent, {
+            signal: abortController.signal,
+            clientLocation: body.clientLocation,
+            systemDirectives,
+            temperature: runTemperature,
+            topP: runTopP,
+            contextLimit: runContextLimit,
+            minP: runMinP,
+            repeatPenalty: runRepeatPenalty,
+            onReasoningDelta: () => {
+              if (reasoningStarted) return;
+              reasoningStarted = true;
+              sendSse({ type: 'reasoning', chunk: 'กำลังวิเคราะห์บริบทและวางแผนคำตอบ' });
+            },
+            onToolStart: (name, input) => {
+              toolsUsed.push({ name, input });
+              sendSse({ type: 'tool_start', name, input: makeInspectableToolPayload(input) });
+            },
+            onToolRemove: (name) => {
+              const idx = toolsUsed.findIndex(t => t.name === name);
+              if (idx !== -1) toolsUsed.splice(idx, 1);
+              sendSse({ type: 'tool_remove', name });
+            },
+            onToolResult: (name, result, durationMs) => {
+              const existing = (toolsUsed.findLast ? toolsUsed.findLast(t => t.name === name && t.result === undefined) : [...toolsUsed].reverse().find(t => t.name === name && t.result === undefined)) || toolsUsed.find(t => t.name === name);
+              if (existing) { existing.result = result; existing.durationMs = durationMs; }
+              sendSse({
+                type: 'tool_result',
+                name,
+                durationMs,
+                resultCount: result?.count ?? 0,
+                result: makeInspectableToolPayload(result)
+              });
+              const uiAction = createMusicControlAction(name, result);
+              if (uiAction) sendSse(uiAction);
+              if (name === 'get_user_location' && (result?.prompt_client_permission || result?.requires_client_permission)) {
+                sendSse({
+                  type: 'location_permission_request',
+                  reason: result.reason || 'weather_forecast',
+                  estimatedLocation: result.estimatedLocation || null,
+                  quickCityChoices: result.quickCityChoices || []
+                });
+              }
+            },
+            onSubagentProgress: (event) => {
+              sendSse(sanitizeSubagentProgress(event));
+            },
+            onTokenDelta: (chunk) => {
+              sendSse({ type: 'token', chunk });
+            },
+            ...(conversationContext.contextual ? {} : {
+              onClarifyingQuestions: (questions, queryId) => {
+                sendSse({ type: 'clarifying_questions', questions, queryId: externalClarificationId(queryId) });
+              },
+              onClarifyingAnswer: (queryId) => {
+                return new Promise((resolve) => {
+                  registerClarificationResolver(externalClarificationId(queryId), resolve);
+                });
+              }
+            })
+          });
+
+          let finalAnswer = runRes?.answer || String(runRes || '');
+          finalAnswer = finalAnswer.replace(/The user has provided a complex instruction set:[\s\S]*?(?=\n\n|\n[A-Zก-๙]|$)/i, '').trim();
+          finalAnswer = finalAnswer.replace(/^\[SYSTEM (?:INSTRUCTION|DIRECTIVE):[\s\S]*?\]\s*/i, '').trim();
+
+          let suggestions = [];
+          const extracted = extractAgentFollowUpQuestions(finalAnswer);
+          finalAnswer = stripInvalidYouTubeLinks(extracted.cleanText);
+          finalAnswer = applyFutureEventGuard(finalAnswer, { tools: toolsUsed });
+          suggestions = extracted.suggestions;
+
+          if (!finalAnswer.trim() || (imageAttachments.length > 0 && finalAnswer.includes('ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้'))) {
+            if (imageAttachments.length > 0) {
+              finalAnswer = 'ได้รับรูปภาพเรียบร้อยแล้วค่ะ แต่เนื่องจากระบบปัจจุบันเน้นการวิเคราะห์ข้อมูลและแคตตาล็อกเป็นหลัก จึงยังไม่รองรับการวิเคราะห์พิกเซลภาพโดยตรง คุณสามารถพิมพ์บอกชื่อผลงาน ละคร ลุคงาน หรือสิ่งที่ต้องการค้นหาเกี่ยวกับภาพนี้ เพื่อให้ฉันช่วยค้นหาข้อมูลและรูปภาพจากคลังข้อมูลได้เลยนะคะ';
+            } else {
+              const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
+              finalAnswer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
+              if (!suggestions.length) suggestions = fallback.suggestions || [];
+            }
+          }
+
+          const qualityFallback = await replaceLowQualityDramaAnswer({
+            query,
+            answer: finalAnswer,
+            persona,
+            conversationContext,
+            toolsUsed
+          });
+          if (qualityFallback) {
+            finalAnswer = applyFutureEventGuard(qualityFallback.answer, { tools: toolsUsed });
+            suggestions = qualityFallback.suggestions;
+          }
+
+          suggestions = finalizeSuggestions(sessionKey, suggestions, { query, answer: finalAnswer, tools: toolsUsed });
+
+          const searchImages = extractSearchImagesFromTools(toolsUsed, query);
+
+          sendSse({
+            type: 'final',
+            answer: finalAnswer,
+            suggestions,
+            searchImages,
+            attachments: attachments.map(a => ({ name: a.name, size: a.size, type: a.type, isImage: a.isImage })),
+            durationMs: Date.now() - startTime,
+            tokens: conn.agent?.lastTelemetry?.tokens || conn.agent?.session?.lastQueryTokens || null,
+            metrics: conn.agent?.lastQueryMetrics || null,
+            costUsd: conn.agent?.lastTelemetry?.costUsd ?? conn.agent?.session?.lastQueryCostUsd ?? 0,
+            citations: conn.agent?.lastCitations || [],
+            context: publicContext,
+            memory: getAgentMemorySnapshot(conn.agent, body.sessionId)
+          });
+          cleanupHeartbeat();
+          res.write('data: [DONE]\n\n');
+          res.end();
+          return;
+        } catch (streamErr) {
+          if (abortController.signal.aborted || streamErr?.name === 'AbortError') {
+            cleanupHeartbeat();
+            if (!res.writableEnded) {
+              res.write('data: [DONE]\n\n');
+              res.end();
+            }
+            return;
+          }
+          sendSse({ type: 'error', message: sanitizeInferenceError(streamErr, isTrustedRequest(req)), fallback: true });
+          const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
+          const fallbackImages = extractSearchImagesFromTools(fallback.tools, query);
+          sendSse({
+            type: 'final',
+            answer: applyFutureEventGuard(fallback.answer, { tools: fallback.tools }),
+            suggestions: finalizeSuggestions(sessionKey, fallback.suggestions || [], { query, answer: fallback.answer, tools: fallback.tools }),
+            searchImages: fallbackImages,
+            durationMs: Date.now() - startTime,
+            citations: [],
+            context: publicContext,
+            memory: { sessionId: body.sessionId || null, messageCount: body.history?.length || 0, persistent: false }
+          });
+          cleanupHeartbeat();
+          res.write('data: [DONE]\n\n');
+          res.end();
+          return;
+        }
+      }
+
+      sendSse({ type: 'error', message: sanitizeInferenceError(conn.error, isTrustedRequest(req)), fallback: true });
+
+      const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
+      const guardedFallbackAnswer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
+      const fallbackImages = extractSearchImagesFromTools(fallback.tools, query);
+      for (const t of fallback.tools) {
+        sendSse({ type: 'tool_start', name: t.name, input: t.input });
+        sendSse({ type: 'tool_result', name: t.name, durationMs: t.durationMs, resultCount: t.resultCount, result: t.result });
+      }
+      sendSse({ type: 'token', chunk: guardedFallbackAnswer });
+      sendSse({
+        type: 'final',
+        answer: guardedFallbackAnswer,
+        suggestions: finalizeSuggestions(sessionKey, fallback.suggestions || [], { query, answer: guardedFallbackAnswer, tools: fallback.tools }),
+        searchImages: fallbackImages,
+        durationMs: Date.now() - startTime,
+        citations: [],
+        context: publicContext,
+        memory: { sessionId: body.sessionId || null, messageCount: body.history?.length || 0, persistent: false }
+      });
+      cleanupHeartbeat();
+      res.write('data: [DONE]\n\n');
+      res.end();
+      return;
+    }
+
+    if (conn.ready && conn.agent) {
+      const isResearch = /^\/research(?:\s|$)/i.test(query.trim());
+      const isVerify = /^\/verify(?:\s|$)/i.test(query.trim());
+      if (isResearch || isVerify) {
+        const researchTarget = query.trim().replace(/^\/(?:research|verify)\s*/i, '').trim();
+        if (!researchTarget) {
+          const guideMessage = isVerify
+            ? `⚖️ กรุณาระบุข้อกล่าวอ้างหรือข่าวลือที่ต้องการให้ AI ตรวจสอบ เช่น: /verify จวีจิ้งอีเป็น Brand Ambassador ของ FRED Paris`
+            : `🔍 กรุณาระบุคำถามหรือหัวข้อที่ต้องการให้วิจัย เช่น: /research รางวัลและเกียรติยศทั้งหมดของจวีจิ้งอี`;
+          return sendJson(res, 200, {
+            status: 'success',
+            answer: guideMessage,
+            suggestions: [],
+            sources: [],
+            subagents: [],
+            tools: [],
+            durationMs: Date.now() - startTime
+          });
+        }
+
+        try {
+          const subagentActivity = [];
+          const forwardProgress = (event) => {
+            subagentActivity.push(sanitizeSubagentProgress({
+              source: isVerify ? 'verify' : 'research',
+              subject: researchTarget,
+              ...event
+            }));
+          };
+
+          const researchResult = await conn.agent.runResearch(researchTarget, {
+            mode: isVerify ? 'verify' : 'research',
+            signal: abortController.signal,
+            onProgress: forwardProgress,
+          });
+
+          let finalAnswer = researchResult?.answer || '';
+          if (!finalAnswer.trim()) {
+            finalAnswer = isVerify
+              ? 'ไม่สามารถตรวจสอบข้อเท็จจริงในประเด็นนี้ได้แน่ชัดค่ะ'
+              : 'ไม่พบข้อมูลเพียงพอสำหรับการวิจัยในหัวข้อนี้ค่ะ';
+          }
+
+          try {
+            if (conn.agent.session?.createUserMessage) {
+              conn.agent.session.createUserMessage(query);
+            }
+            if (conn.agent.session?.createAssistantMessage) {
+              conn.agent.session.createAssistantMessage({ content: finalAnswer });
+            }
+            if (Array.isArray(conn.agent.conversationHistory)) {
+              conn.agent.conversationHistory.push({ role: 'user', content: query });
+              conn.agent.conversationHistory.push({ role: 'assistant', content: finalAnswer });
+            }
+          } catch {}
+
+          const allWorkerTools = (researchResult.reports || []).flatMap(r => r.toolCalls || []).map(tc => {
+            const name = typeof tc === 'string' ? tc : (tc.name || 'tool');
+            const input = typeof tc === 'object' && tc.args ? tc.args : {};
+            const result = typeof tc === 'object' && tc.result ? tc.result : { status: 'ok' };
+            return { name, input, result, status: 'done' };
+          });
+
+          return sendJson(res, 200, {
+            status: 'success',
+            answer: finalAnswer,
+            sources: researchResult.sources || [],
+            subagents: subagentActivity,
+            tools: allWorkerTools,
+            durationMs: Date.now() - startTime
+          });
+        } catch (researchErr) {
+          if (abortController.signal.aborted || researchErr?.name === 'AbortError') return;
+          return sendJson(res, 200, {
+            status: 'error',
+            answer: sanitizeInferenceError(researchErr, isTrustedRequest(req)),
+            sources: [],
+            subagents: [],
+            tools: [],
+            durationMs: Date.now() - startTime
+          });
+        }
+      }
+
+      let answer = '';
+      let thinking = '';
+      let thinkingDurationMs = 0;
+      const toolsUsed = [];
+      const subagentActivity = [];
+
+      let runRes;
+      try {
+        runRes = await conn.agent.run(queryForAgent, {
+          signal: abortController.signal,
+          systemDirectives,
+          temperature: runTemperature,
+          topP: runTopP,
+          contextLimit: runContextLimit,
+          minP: runMinP,
+          repeatPenalty: runRepeatPenalty,
+        onReasoningDelta: () => { thinking = 'วิเคราะห์บริบทและวางแผนคำตอบแล้ว'; },
+        onReasoningEnd: () => { thinkingDurationMs = Date.now() - startTime; },
+        onSubagentProgress: (event) => {
+          subagentActivity.push(sanitizeSubagentProgress(event));
+        },
+        onToolStart: (name, input) => {
+          toolsUsed.push({ name, input: makeInspectableToolPayload(input), status: 'running' });
+        },
+        onToolResult: (name, result, dur) => {
+          let tool = null;
+          for (let index = toolsUsed.length - 1; index >= 0; index--) {
+            if (toolsUsed[index].name === name && toolsUsed[index].status === 'running') {
+              tool = toolsUsed[index];
+              break;
+            }
+          }
+          if (!tool) {
+            tool = { name };
+            toolsUsed.push(tool);
+          }
+          Object.assign(tool, {
+            status: 'done',
+            result: makeInspectableToolPayload(result),
+            resultCount: result?.count ?? 0,
+            durationMs: dur
+          });
+        }
+      });
+      } catch (agentErr) {
+        if (abortController.signal.aborted || agentErr?.name === 'AbortError') {
+          if (!res.writableEnded) {
+            return sendError(res, 499, 'Request aborted by client');
+          }
+          return;
+        }
+        throw agentErr;
+      }
+
+      answer = runRes?.answer || String(runRes || '');
+      let suggestions = [];
+      const extracted = extractAgentFollowUpQuestions(answer);
+      answer = stripInvalidYouTubeLinks(extracted.cleanText);
+      answer = applyFutureEventGuard(answer, { tools: toolsUsed });
+      suggestions = extracted.suggestions;
+
+      if (!answer.trim() || (imageAttachments.length > 0 && answer.includes('ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้'))) {
+        if (imageAttachments.length > 0) {
+          answer = 'ได้รับรูปภาพเรียบร้อยแล้วค่ะ แต่เนื่องจากระบบปัจจุบันเน้นการวิเคราะห์ข้อมูลและแคตตาล็อกเป็นหลัก จึงยังไม่รองรับการวิเคราะห์พิกเซลภาพโดยตรง คุณสามารถพิมพ์บอกชื่อผลงาน ละคร ลุคงาน หรือสิ่งที่ต้องการค้นหาเกี่ยวกับภาพนี้ เพื่อให้ฉันช่วยค้นหาข้อมูลและรูปภาพจากคลังข้อมูลได้เลยนะคะ';
+        } else {
+          const fallback = await executeDirectCatalogKnowledge(query, persona, { conversationContext });
+          answer = applyFutureEventGuard(fallback.answer, { tools: fallback.tools });
+          if (!suggestions.length) suggestions = fallback.suggestions || [];
+        }
+      }
+
+      const qualityFallback = await replaceLowQualityDramaAnswer({
+        query,
+        answer,
+        persona,
+        conversationContext,
+        toolsUsed
+      });
+      if (qualityFallback) {
+        answer = applyFutureEventGuard(qualityFallback.answer, { tools: toolsUsed });
+        suggestions = qualityFallback.suggestions;
+      }
+
+      suggestions = finalizeSuggestions(sessionKey, suggestions, { query, answer, tools: toolsUsed });
+
+      const searchImages = extractSearchImagesFromTools(toolsUsed, query);
+
+      return sendJson(res, 200, {
+        status: 'ok',
+        query,
+        persona,
+        answer,
+        suggestions,
+        searchImages,
+        attachments: attachments.map(a => ({ name: a.name, size: a.size, type: a.type, isImage: a.isImage })),
+        thinking,
+        thinkingDurationMs,
+        tools: toolsUsed,
+        subagents: subagentActivity,
+        tokens: conn.agent?.lastTelemetry?.tokens || conn.agent?.session?.lastQueryTokens || null,
+        metrics: conn.agent?.lastQueryMetrics || null,
+        costUsd: conn.agent?.lastTelemetry?.costUsd ?? conn.agent?.session?.lastQueryCostUsd ?? 0,
+        citations: conn.agent?.lastCitations || [],
+        context: publicContext,
+        memory: getAgentMemorySnapshot(conn.agent, body.sessionId),
+        uiActions: collectMusicControlActions(toolsUsed),
+        durationMs: Date.now() - startTime
+      });
+    }
+
+    return sendError(res, 502, sanitizeInferenceError(conn.error, isTrustedRequest(req)));
+
+  } catch (err) {
+    if (res.headersSent) {
+      if (!res.writableEnded && !res.destroyed) {
+        res.write('data: ' + JSON.stringify({ type: 'error', message: sanitizeInferenceError(err, isTrustedRequest(req)) }) + '\n\n');
+        res.end('data: [DONE]\n\n');
+      }
+      return;
+    }
+    return sendError(res, err.statusCode || 502, sanitizeInferenceError(err, isTrustedRequest(req)));
+  } finally {
+    if (heartbeat) clearInterval(heartbeat);
+  }
+}