kiku-agent 1.0.11 → 1.2.0

package/server/agent/tools.js

@@ -8,10 +8,10 @@ import { galleryData } from '../../src/data/galleryData.js';
 import { awardsData } from '../../src/data/awardsData.js';
 import { timelineData } from '../../src/data/timelineData.js';
 import { searchWeb, fetchWebpage, fetchJson, screenshotWebpage, webExtract } from './webSearch.js';
-import { readFile, readdir, stat } from 'node:fs/promises';
+import { readFile, readdir, stat, realpath } from 'node:fs/promises';
 import { join, relative, extname, resolve } from 'node:path';
 import { audioPlayer } from './audioPlayer.js';
-import { sanitizeToolArgs } from './sanitizer.js';
+import { sanitizeToolArgs, sanitizeUrl } from './sanitizer.js';
 import { getGpuMetrics } from './gpuMetrics.js';
 
 export function buildYouTubeSearchUrl(query) {
@@ -30,16 +30,48 @@ export function buildQqMusicSearchUrl(query) {
   return `https://y.qq.com/n/ryqq/search?w=${encodeURIComponent(query)}`;
 }
 
-export function buildYoukuSearchUrl(query) {
-  return `https://so.youku.com/search_video/q_${encodeURIComponent(query)}`;
-}
-
-export function formatCatalogTitle(primary, secondary) {
-  const first = String(primary || secondary || '').trim();
-  const second = String(secondary || '').trim();
-  if (!second || first.toLocaleLowerCase().includes(second.toLocaleLowerCase())) return first;
-  return `${first} (${second})`;
-}
+export function buildYoukuSearchUrl(query) {
+  return `https://so.youku.com/search_video/q_${encodeURIComponent(query)}`;
+}
+
+export function formatCatalogTitle(primary, secondary) {
+  const first = String(primary || secondary || '').trim();
+  const second = String(secondary || '').trim();
+  if (!second || first.toLocaleLowerCase().includes(second.toLocaleLowerCase())) return first;
+  return `${first} (${second})`;
+}
+
+export function createCatalogMatcher(query) {
+  if (!query) return () => true;
+  const raw = String(query).toLowerCase().trim();
+  if (!raw) return () => true;
+
+  const stopWords = new Set([
+    'the', 'from', 'what', 'are', 'is', 'about', 'drama', 'series', 'ost', 'song', 'songs', 'soundtrack', 'music', 'single', 'album', 'stage',
+    'brand', 'brands', 'ambassador', 'endorsement', 'commercial', 'role', 'roles', 'character', 'characters', 'award', 'awards', 'category', 'video', 'mv', 'clip',
+    'ju', 'jingyi', 'jujingyi', 'kiku', 'kikuuu', 'จวีจิ้งอี', 'จวี', 'จิ้งอี', 'เสี่ยวจวี', 'เสี่ยว', '鞠婧祎', '小鞠', '鞠',
+    'เพลง', 'เพลงของ', 'ซีรีส์', 'ซีรีส์ของ', 'ละคร', 'เรื่อง', 'ผลงาน', 'อัลบั้ม', 'คอนเสิร์ต', 'บทบาท', 'ตัวละคร', 'แบรนด์', 'รางวัล', 'ผลงานล่าสุด', 'พรีเซนเตอร์'
+  ]);
+
+  const allTokens = raw.split(/[^\p{L}\p{M}\p{N}]+/u).filter(t => t.length >= 2);
+ 
+  const deDated = raw.replace(/ใหม่ล่าสุด|ล่าสุด|最新|latest|newest|recent/gi, ' ');
+  const datedTokens = deDated.split(/[^\p{L}\p{M}\p{N}]+/u).filter(t => t.length >= 2);
+  const coreTokens = datedTokens.filter(t => !stopWords.has(t));
+ 
+  if (coreTokens.length === 0) return () => true;
+  const effectiveTokens = coreTokens;
+
+  return (...fields) => {
+    const haystack = fields.filter(Boolean).join(' ').toLowerCase();
+    if (haystack.includes(raw)) return true;
+    if (effectiveTokens.length > 0) {
+      const matchCount = effectiveTokens.filter(term => haystack.includes(term)).length;
+      return matchCount > 0 && (matchCount / effectiveTokens.length >= 0.5);
+    }
+    return false;
+  };
+}
 
 export class ToolCache {
   constructor(maxSize = 300, defaultTtlMs = 600_000) {
@@ -100,6 +132,17 @@ const WEB_CACHE_TOOLS = new Set([
   'fetch_json',
 ]);
 
+
+const LIVE_DATA_TOOLS = new Set([
+  'get_social_feed',
+  'get_gallery_photos',
+  'get_awards',
+  'get_career_timeline',
+  'get_brand_endorsements',
+  'get_music_videos',
+  'get_media_links',
+]);
+
 const CACHED_DISCOGRAPHY = (() => {
   const map = new Map();
   const allTracks = [
@@ -183,7 +226,7 @@ export const toolsSchema = [
     type: "function",
     function: {
       name: "search_works",
-      description: "Search Ju Jingyi's filmography (TV dramas, web series, movies, and 2026/2025 upcoming projects) with official streaming links and YouTube trailer search links.",
+      description: "Search Ju Jingyi's filmography (TV dramas, web series, movies, and upcoming projects). Returns grounded role context, synopsis, highlights, catalog platform, and trailer search links; use these fields instead of inferring plot or acting claims.",
       parameters: {
         type: "object",
         properties: {
@@ -309,11 +352,11 @@ export const toolsSchema = [
       description: "Query awards and honors received by Ju Jingyi across music, television, and cultural influence.",
       parameters: {
         type: "object",
-        properties: {
-          category: { type: "string", description: "Category (Acting, Music, Honor)" },
-          year: { type: "number", description: "Year filter" },
-          query: { type: "string", description: "Award title, ceremony, or category keyword" },
-          limit: { type: "number", description: "Maximum results from 1 to 20" }
+        properties: {
+          category: { type: "string", description: "Category (Acting, Music, Honor)" },
+          year: { type: "number", description: "Year filter" },
+          query: { type: "string", description: "Award title, ceremony, or category keyword" },
+          limit: { type: "number", description: "Maximum results from 1 to 20" }
         },
         required: []
       }
@@ -341,11 +384,11 @@ export const toolsSchema = [
       description: "Search visual photo gallery of Ju Jingyi (red carpet, photoshoot, drama stills).",
       parameters: {
         type: "object",
-        properties: {
-          category: { type: "string", description: "Category (fashion-magazine, red-carpet, drama-stills)" },
-          query: { type: "string", description: "Photo title or category keyword" },
-          year: { type: "number", description: "Year filter" },
-          limit: { type: "number", description: "Number of photos from 1 to 20" }
+        properties: {
+          category: { type: "string", description: "Category (fashion-magazine, red-carpet, drama-stills)" },
+          query: { type: "string", description: "Photo title or category keyword" },
+          year: { type: "number", description: "Year filter" },
+          limit: { type: "number", description: "Number of photos from 1 to 20" }
         },
         required: []
       }
@@ -707,7 +750,8 @@ export const toolsSchema = [
         type: "object",
         properties: {
           topic: { type: "string", description: "Optional topic or category focus (e.g. 'drama', 'music', 'fashion', '2026')." },
-          limit: { type: "number", description: "Number of suggestions to generate (default: 5)." }
+          limit: { type: "number", description: "Number of suggestions to generate (default: 5)." },
+          lang: { type: "string", description: "UI language for the questions: th, zh, en, ja, ko (default: en)." }
         }
       }
     }
@@ -764,6 +808,50 @@ export const toolsSchema = [
   }
 ];
 
+
+const TOOL_DEFAULT_TIMEOUTS = {
+  run_subagent: 180_000,
+  run_deep_research: 300_000,
+  verify_claim: 300_000,
+  suggest_topics: 120_000,
+  web_extract: 90_000,
+  screenshot_webpage: 90_000,
+  search_youtube: 60_000,
+  play_music: 60_000,
+};
+
+async function ensureLlmAvailable(client) {
+  if (!client || typeof client.checkConnection !== 'function') return null;
+  try {
+    const status = await client.checkConnection();
+    if (status && status.connected === false) {
+      const provider = client.providerName || client.provider || 'LLM';
+      return {
+        status: 'error',
+        message: `AI provider offline (${provider}): ${status.error || 'connection failed'}. Start LM Studio or configure a cloud provider key, or answer from local catalog tools instead.`
+      };
+    }
+  } catch {
+
+  }
+  return null;
+}
+
+export const RUMORED_OR_EXTERNAL_PROJECTS = [
+  {
+    keywords: ['七星彩', 'qi xiang cai', 'qi xing cai', 'ชีซิงไฉ่', 'seven star color'],
+    titleCn: '七星彩',
+    titleEn: 'Qi Xing Cai (Seven Star Color)',
+    status: 'rumored_casting',
+    producer: 'Youku (优酷) x Stellar Media (恒星引力传媒)',
+    originalNovel: '《七星彩》 by 明月珰 (Mingyue Dang)',
+    leads: '纪澄 (Ji Cheng) & 沈彻 (Shen Che)',
+    details: 'โปรเจกต์ซีรีส์จีนโบราณฟอร์มยักษ์ของ Youku ร่วมกับค่ายเหิงซิงอิ่นลี่ (ผู้สร้างของรักของข้า Love Between Fairy and Devil) ดัดแปลงจากนิยายของหมิงเยว่ตัง เล่าเรื่องราวของจี้เฉิง บุตรสาวตระกูลพ่อค้าที่ใช้ปฏิภาณไหวพริบเอาตัวรอดจนได้พบกับแม่ทัพเสิ่นเช่อ',
+    buzzReason: 'เหตุผลที่ชาวเน็ตให้ความสนใจอย่างมากคือ กระแสข่าวลือแคสติ้งนักแสดงนำ (Casting Rumors / 选角瓜) โดยมีการลือชื่อนักแสดงหญิงแถวหน้าหลายคนรวมถึง จวีจิ้งอี, หลูอวี้เสี่ยว ฯลฯ แต่ปัจจุบันยังไม่มีการประกาศยืนยันนักแสดงทางการจากทางค่ายหรือสตูดิโอ',
+    disambiguation: 'คนละผลงานกับซีรีส์ 《千香》 (The Eternal Fragrance / พันกลิ่นบุปผา) ที่จวีจิ้งอีนำแสดงร่วมกับ ซ่งเวยหลง'
+  }
+];
+
 export const toolHandlers = {
   get_profile_and_fandom: async () => {
     const d = profileData.details || {};
@@ -786,6 +874,8 @@ export const toolHandlers = {
         hobbies: d.hobbies,
         favoriteFoods: d.favoriteFoods,
         talentsSummary: d.talentsSummary,
+        petsSummary: d.petsSummary,
+        cats: profileData.cats || [],
         fandomName: d.fandomName || "มี่จวี (Miju / 蜜橘)",
         fandomColor: d.fandomColorName || "ฟ้าคริสตัล & ชมพูซากุระ",
         slogan: profileData.motto || "保持热爱，奔赴山海",
@@ -822,24 +912,29 @@ export const toolHandlers = {
     if (year) results = results.filter(w => w.year === Number(year));
     if (category && category !== 'all') results = results.filter(w => w.category === category);
 
-    const genericArtistKeywords = ['ju jingyi', 'jujingyi', 'จวีจิ้งอี', 'kiku', 'เสี่ยวจวี', 'kikuuu', 'ศิลปิน', 'ดารา', 'งานล่าสุด', 'ผลงานล่าสุด', 'ล่าสุด', 'latest', 'newest', 'recent', 'upcoming', 'ละคร'];
-    const isGenericArtistQuery = query && genericArtistKeywords.some(k => query.toLowerCase().trim() === k);
-
-    if (query && !isGenericArtistQuery) {
-      const q = query.toLowerCase().trim();
-      results = results.filter(w => 
-        (w.titleTh && w.titleTh.toLowerCase().includes(q)) ||
-        (w.titleEn && w.titleEn.toLowerCase().includes(q)) ||
-        (w.titleCn && w.titleCn.includes(query)) ||
-        (w.role && w.role.toLowerCase().includes(q)) ||
-        (w.roleCn && w.roleCn.includes(query))
-      );
+    if (query) {
+      const matcher = createCatalogMatcher(query);
+      results = results.filter(w => matcher(w.titleTh, w.titleEn, w.titleCn, w.role, w.roleCn, w.synopsis));
     }
 
     if (featuredOnly && results.some(w => !!w.featured)) {
       results = results.filter(w => !!w.featured);
     }
 
+    if (results.length === 0 && query) {
+      const qLower = String(query).toLowerCase().trim();
+      const rumored = RUMORED_OR_EXTERNAL_PROJECTS.find(p => p.keywords.some(k => qLower.includes(k)));
+      if (rumored) {
+        return {
+          status: "rumored_project_info",
+          count: 0,
+          works: [],
+          rumoredProject: rumored,
+          message: `"${rumored.titleCn}" (${rumored.titleEn}) เป็นโปรเจกต์ข่าวลือแคสติ้ง/ยังไม่ยืนยัน: ${rumored.details}. จุดที่ชาวเน็ตสนใจ: ${rumored.buzzReason}. ข้อควรระวัง: ${rumored.disambiguation}.`
+        };
+      }
+    }
+
     results.sort((a, b) => (b.year || 0) - (a.year || 0));
 
     return {
@@ -855,17 +950,21 @@ export const toolHandlers = {
           titleEn: w.titleEn,
           year: w.year,
           category: w.category,
-          role: w.role,
-          roleCn: w.roleCn,
+          role: w.role,
+          roleCn: w.roleCn,
+          synopsis: w.synopsis || null,
+          highlights: (w.highlights || []).slice(0, 3),
           episodes: w.episodes,
           rating: w.rating,
           platform: w.streamPlatform,
           streamUrl: w.streamUrl || null,
           youtubeTrailerSearch: buildYouTubeSearchUrl(`${titleSearch} Trailer Official`),
+          youtubeTrailerIsDirectLink: false,
           youkuSearchUrl: buildYoukuSearchUrl(w.titleCn || w.titleEn),
           themeSong: w.themeSong ? {
-            title: formatCatalogTitle(w.themeSong.titleTh, w.themeSong.titleCn),
+            title: formatCatalogTitle(w.themeSong.titleTh, w.themeSong.titleCn),
             youtubeUrl: themeSongYtId ? buildYouTubeWatchUrl(themeSongYtId) : null,
+            isDirectLink: Boolean(themeSongYtId),
             youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${w.themeSong.titleCn || w.themeSong.titleTh} OST`)
           } : null
         };
@@ -876,12 +975,20 @@ export const toolHandlers = {
   get_work_detail: async ({ workIdOrTitle }) => {
     if (!workIdOrTitle) return { status: "error", message: "workIdOrTitle parameter is required." };
     const q = workIdOrTitle.toLowerCase().trim();
-    const work = worksData.find(w => 
-      w.id.toLowerCase() === q ||
+   
+    const normId = (value) => String(value || '').toLowerCase().trim().replace(/[_\s]+/g, '-');
+    const qId = normId(workIdOrTitle);
+    let work = worksData.find(w =>
+      normId(w.id) === qId ||
       w.titleTh.toLowerCase().includes(q) ||
       (w.titleEn && w.titleEn.toLowerCase().includes(q)) ||
       (w.titleCn && w.titleCn.includes(workIdOrTitle))
     );
+    if (!work) {
+
+      const matcher = createCatalogMatcher(workIdOrTitle);
+      work = worksData.find(w => matcher(w.titleTh, w.titleEn, w.titleCn, w.role, w.roleCn));
+    }
 
     if (!work) {
       return { status: "not_found", message: `No work found for "${workIdOrTitle}".` };
@@ -899,19 +1006,22 @@ export const toolHandlers = {
         titleEn: work.titleEn,
         year: work.year,
         category: work.category,
-        role: work.role,
+        role: work.role,
+        roleCn: work.roleCn,
         episodes: work.episodes,
         rating: work.rating,
         platform: work.streamPlatform,
         streamUrl: work.streamUrl || null,
         youtubeTrailerSearch: buildYouTubeSearchUrl(`${titleSearch} Trailer Official`),
+        youtubeTrailerIsDirectLink: false,
         youkuSearchUrl: buildYoukuSearchUrl(work.titleCn || work.titleEn),
         bilibiliSearchUrl: buildBilibiliSearchUrl(`鞠婧祎 ${work.titleCn}`),
-        synopsis: work.synopsis?.slice(0, 250) + (work.synopsis?.length > 250 ? '...' : ''),
+        synopsis: work.synopsis || null,
         highlights: (work.highlights || []).slice(0, 3),
         themeSong: work.themeSong ? {
-          title: formatCatalogTitle(work.themeSong.titleTh, work.themeSong.titleCn),
+          title: formatCatalogTitle(work.themeSong.titleTh, work.themeSong.titleCn),
           youtubeUrl: themeSongYtId ? buildYouTubeWatchUrl(themeSongYtId) : null,
+          isDirectLink: Boolean(themeSongYtId),
           youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${work.themeSong.titleCn || work.themeSong.titleTh} OST`)
         } : null
       }
@@ -920,7 +1030,7 @@ export const toolHandlers = {
 
   get_character_roles: async ({ query } = {}) => {
     const roles = worksData.map(w => ({
-      workTitle: formatCatalogTitle(w.titleTh, w.titleCn),
+      workTitle: formatCatalogTitle(w.titleTh, w.titleCn),
       year: w.year,
       role: w.role,
       roleCn: w.roleCn,
@@ -928,16 +1038,9 @@ export const toolHandlers = {
     }));
 
     let filtered = roles;
-    const genericArtistKeywords = ['ju jingyi', 'jujingyi', 'จวีจิ้งอี', 'kiku', 'เสี่ยวจวี', 'kikuuu'];
-    const isGeneric = query && genericArtistKeywords.some(k => query.toLowerCase().trim() === k);
-
-    if (query && !isGeneric) {
-      const q = query.toLowerCase().trim();
-      filtered = roles.filter(r => 
-        (r.role && r.role.toLowerCase().includes(q)) ||
-        (r.roleCn && r.roleCn.includes(query)) ||
-        (r.workTitle && r.workTitle.toLowerCase().includes(q))
-      );
+    if (query) {
+      const matcher = createCatalogMatcher(query);
+      filtered = roles.filter(r => matcher(r.role, r.roleCn, r.workTitle));
     }
 
     filtered.sort((a, b) => (b.year || 0) - (a.year || 0));
@@ -956,17 +1059,19 @@ export const toolHandlers = {
     if (type === 'ost') list = list.filter(s => s.work && s.work !== "Solo Single");
     if (type === 'single') list = list.filter(s => !s.work || s.work === "Solo Single");
 
-    const genericArtistKeywords = ['ju jingyi', 'jujingyi', 'จวีจิ้งอี', 'kiku', 'เสี่ยวจวี', 'kikuuu', 'เพลง', 'เพลงทั้งหมด', 'เพลงใหม่', 'music', 'song', 'songs'];
-    const isGeneric = query && genericArtistKeywords.some(k => query.toLowerCase().trim() === k);
-
-    if (query && !isGeneric) {
-      const q = query.toLowerCase().trim();
-      list = list.filter(s => 
-        (s.titleTh && s.titleTh.toLowerCase().includes(q)) ||
-        (s.titleCn && s.titleCn.includes(query)) ||
-        (s.titleEn && s.titleEn.toLowerCase().includes(q)) ||
-        (s.work && s.work.toLowerCase().includes(q))
-      );
+    if (query) {
+      const qLower = String(query).toLowerCase().trim();
+      const rumored = RUMORED_OR_EXTERNAL_PROJECTS.find(p => p.keywords.some(k => qLower.includes(k)));
+      if (rumored) {
+        return {
+          status: "not_found",
+          count: 0,
+          songs: [],
+          message: `"${rumored.titleCn}" (${rumored.titleEn}) เป็นโปรเจกต์ซีรีส์ที่มีข่าวลือแคสติ้ง ไม่ใช่เพลงหรือ OST ของจวีจิ้งอีในคลังผลงาน และคนละเรื่องกับเพลง 《千香》 (The Eternal Fragrance).`
+        };
+      }
+      const matcher = createCatalogMatcher(query);
+      list = list.filter(s => matcher(s.titleTh, s.titleCn, s.titleEn, s.work, s.role, s.description));
     }
 
     return {
@@ -975,12 +1080,13 @@ export const toolHandlers = {
       count: list.length,
       songs: list.slice(0, 8).map(s => ({
         id: s.id,
-        title: formatCatalogTitle(s.titleTh, s.titleCn),
+        title: formatCatalogTitle(s.titleTh, s.titleCn),
         titleEn: s.titleEn,
         year: s.year,
         type: s.work,
         duration: s.duration,
         youtubeUrl: s.youtubeUrl || (s.youtubeId ? buildYouTubeWatchUrl(s.youtubeId) : null),
+        isDirectLink: Boolean(s.youtubeUrl || s.youtubeId),
         youtubeSearchUrl: s.youtubeSearchUrl || buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${s.titleCn || s.titleTh}`),
         qqMusicSearchUrl: s.qqMusicSearchUrl || buildQqMusicSearchUrl(`鞠婧祎 ${s.titleCn || s.titleTh}`),
         bilibiliSearchUrl: s.bilibiliSearchUrl || buildBilibiliSearchUrl(`鞠婧祎 ${s.titleCn || s.titleTh}`)
@@ -1004,18 +1110,9 @@ export const toolHandlers = {
       });
     }
     
-    const genericArtistKeywords = ['ju jingyi', 'jujingyi', 'จวีจิ้งอี', 'kiku', 'เสี่ยวจวี', 'kikuuu', 'mv', 'music video', 'วิดีโอ', 'คลิป'];
-    const isGeneric = query && genericArtistKeywords.some(k => query.toLowerCase().trim() === k);
-    
-    if (query && !isGeneric) {
-      const q = query.toLowerCase().trim();
-      results = results.filter(m => 
-        (m.titleTh && m.titleTh.toLowerCase().includes(q)) || 
-        (m.titleCn && m.titleCn.includes(query)) ||
-        (m.titlePinyin && m.titlePinyin.toLowerCase().includes(q)) ||
-        (m.dramaName && m.dramaName.toLowerCase().includes(q)) ||
-        (m.description && m.description.toLowerCase().includes(q))
-      );
+    if (query) {
+      const matcher = createCatalogMatcher(query);
+      results = results.filter(m => matcher(m.titleTh, m.titleCn, m.titlePinyin, m.dramaName, m.description));
     }
 
     return {
@@ -1026,7 +1123,7 @@ export const toolHandlers = {
         const searchTitle = `Ju Jingyi 鞠婧祎 ${m.titleCn || m.titleTh} ${m.category === 'Stage-Performance' ? 'Stage Live' : 'Official MV'}`;
         return {
           id: m.id,
-          title: formatCatalogTitle(m.titleTh, m.titleCn),
+          title: formatCatalogTitle(m.titleTh, m.titleCn),
           category: m.category,
           year: m.releaseYear || m.year,
           drama: m.dramaName || null,
@@ -1034,6 +1131,7 @@ export const toolHandlers = {
           description: m.description || null,
           isFeatured: !!m.isFeatured,
           youtubeUrl: ytId ? buildYouTubeWatchUrl(ytId) : null,
+          isDirectLink: Boolean(ytId),
           youtubeSearchUrl: buildYouTubeSearchUrl(searchTitle),
           bilibiliSearchUrl: buildBilibiliSearchUrl(`鞠婧祎 ${m.titleCn || m.titleTh}`)
         };
@@ -1056,7 +1154,7 @@ export const toolHandlers = {
       (m.dramaName && m.dramaName.toLowerCase().includes(q))
     ).map(m => ({
       type: m.category || 'MV',
-      title: formatCatalogTitle(m.titleTh, m.titleCn),
+      title: formatCatalogTitle(m.titleTh, m.titleCn),
       year: m.releaseYear || m.year,
       duration: m.duration,
       youtubeUrl: m.youtubeId ? buildYouTubeWatchUrl(m.youtubeId) : null,
@@ -1071,7 +1169,7 @@ export const toolHandlers = {
       (s.work && s.work.toLowerCase().includes(q))
     ).map(s => ({
       type: s.work || 'Song',
-      title: formatCatalogTitle(s.titleTh, s.titleCn),
+      title: formatCatalogTitle(s.titleTh, s.titleCn),
       year: s.year,
       duration: s.duration,
       youtubeUrl: s.youtubeUrl || (s.youtubeId ? buildYouTubeWatchUrl(s.youtubeId) : null),
@@ -1086,14 +1184,14 @@ export const toolHandlers = {
       (w.titleEn && w.titleEn.toLowerCase().includes(q))
     ).map(w => ({
       type: 'Drama / Series',
-      title: formatCatalogTitle(w.titleTh, w.titleCn),
+      title: formatCatalogTitle(w.titleTh, w.titleCn),
       year: w.year,
       platform: w.streamPlatform,
       streamUrl: w.streamUrl || null,
       youtubeTrailerSearch: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${w.titleCn || w.titleEn} Trailer Official`),
       youkuSearchUrl: buildYoukuSearchUrl(w.titleCn || w.titleEn),
       themeSong: w.themeSong ? {
-        title: formatCatalogTitle(w.themeSong.titleTh, w.themeSong.titleCn),
+        title: formatCatalogTitle(w.themeSong.titleTh, w.themeSong.titleCn),
         youtubeUrl: w.themeSong.youtubeId ? buildYouTubeWatchUrl(w.themeSong.youtubeId) : null,
         youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${w.themeSong.titleCn || w.themeSong.titleTh} OST`)
       } : null
@@ -1122,24 +1220,13 @@ export const toolHandlers = {
     if (year) list = list.filter(b => b.year === Number(year));
     if (category) list = list.filter(b => (b.category && b.category.toLowerCase().includes(category.toLowerCase())) || (b.tier && b.tier.toLowerCase().includes(category.toLowerCase())));
 
-    const genericArtistKeywords = ['ju jingyi', 'jujingyi', 'จวีจิ้งอี', 'kiku', 'เสี่ยวจวี', 'kikuuu', 'แบรนด์', 'พรีเซนเตอร์', 'brand', 'ambassador', 'endorsement', 'commercial'];
-    const isGeneric = query && genericArtistKeywords.some(k => query.toLowerCase().trim() === k);
-
-    if (query && !isGeneric) {
-      const q = query.toLowerCase().trim();
-      const numYear = Number(q);
+    if (query) {
+      const numYear = Number(String(query).trim());
       if (!isNaN(numYear) && numYear >= 2013 && numYear <= 2030) {
         list = list.filter(b => b.year === numYear);
       } else {
-        list = list.filter(b => 
-          (b.brandNameEn && b.brandNameEn.toLowerCase().includes(q)) ||
-          (b.brandNameCn && b.brandNameCn.includes(query)) ||
-          (b.title && b.title.toLowerCase().includes(q)) ||
-          (b.category && b.category.toLowerCase().includes(q)) ||
-          (b.highlight && b.highlight.toLowerCase().includes(q)) ||
-          (b.tier && b.tier.toLowerCase().includes(q)) ||
-          (b.name && b.name.toLowerCase().includes(q))
-        );
+        const matcher = createCatalogMatcher(query);
+        list = list.filter(b => matcher(b.brandNameEn, b.brandNameCn, b.name, b.title, b.category, b.highlight, b.tier));
       }
     }
 
@@ -1170,39 +1257,61 @@ export const toolHandlers = {
       count: eras.length,
       milestones: eras.slice(0, 6).map(e => ({
         period: e.period || e.year,
-        title: formatCatalogTitle(e.title, e.titleCn),
+        title: formatCatalogTitle(e.title, e.titleCn),
         summary: e.summary?.slice(0, 150),
         youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${e.titleCn || e.title}`)
       }))
     };
   },
 
-  get_awards: async ({ category, year, query, limit = 8 } = {}) => {
-    let list = Array.isArray(awardsData) ? awardsData : (awardsData.awards || []);
-    if (year) list = list.filter(a => a.year === Number(year));
-    if (category && category !== 'all') list = list.filter(a => a.category?.toLowerCase().includes(category.toLowerCase()));
-    if (query) {
-      const q = String(query).toLowerCase().trim();
-      list = list.filter(a => [a.titleTh, a.titleCn, a.titleEn, a.ceremony, a.category].filter(Boolean).join(' ').toLowerCase().includes(q));
-    }
-    const safeLimit = Math.min(Math.max(Number(limit) || 8, 1), 20);
-
-    return {
-      status: "success",
-      count: list.length,
-      awards: list.slice(0, safeLimit).map((a, index) => ({
-        id: a.id || `award-${a.year || 'unknown'}-${index + 1}`,
-        year: a.year,
-        title: `${a.titleTh || a.titleEn || a.titleCn || 'Award'}${a.titleCn && a.titleCn !== a.titleTh ? ` (${a.titleCn})` : ''}`,
-        ceremony: a.ceremony,
-        category: a.category,
-        youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${a.titleCn || a.ceremony}`)
-      }))
+  get_awards: async ({ category, year, query, limit = 8 } = {}) => {
+    let list = Array.isArray(awardsData) ? awardsData : (awardsData.awards || []);
+    if (year) list = list.filter(a => a.year === Number(year));
+    if (category && category !== 'all') list = list.filter(a => a.category?.toLowerCase().includes(category.toLowerCase()));
+
+    let usedQueryFilter = false;
+    if (query) {
+      const q = String(query).toLowerCase().trim();
+    
+      const generic = /(ju jingyi|jujingyi|จวีจิ้งอี|จิ้งอี|จวี|鞠婧祎|小鞠|kiku|kikuuu|ju jing yi|蜜橘)/i.test(q);
+      if (!generic) {
+        const filtered = list.filter(a => [a.titleTh, a.titleCn, a.titleEn, a.ceremony, a.category, a.work].filter(Boolean).join(' ').toLowerCase().includes(q));
+        if (filtered.length > 0) {
+          list = filtered;
+          usedQueryFilter = true;
+        }
+       
+      }
+    }
+
+    list.sort((a, b) => (b.year || 0) - (a.year || 0));
+    const safeLimit = Math.min(Math.max(Number(limit) || 8, 1), 20);
+    const awards = list.slice(0, safeLimit).map((a, index) => ({
+      id: a.id || `award-${a.year || 'unknown'}-${index + 1}`,
+      year: a.year,
+      title: `${a.titleTh || a.titleEn || a.titleCn || 'Award'}${a.titleCn && a.titleCn !== a.titleTh ? ` (${a.titleCn})` : ''}`,
+      ceremony: a.ceremony,
+      category: a.category,
+      work: a.work || null,
+      youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${a.titleCn || a.ceremony}`)
+    }));
+
+    const result = {
+      status: awards.length > 0 ? "success" : "not_found",
+      count: awards.length,
+      awards
     };
+    if (usedQueryFilter === false && query) {
+      result.message = `Showing all ${awards.length} awards (broad query " ${query} " applied to full list).`;
+    }
+    return result;
   },
 
   get_social_feed: async ({ platform, limit = 4 } = {}) => {
-    let posts = socialUpdatesData.cards || [];
+  
+    const douyinCards = socialUpdatesData?.douyin?.cards || [];
+    const weiboCards = socialUpdatesData?.weibo?.cards || [];
+    let posts = [...douyinCards, ...weiboCards];
     if (platform && platform !== 'all') posts = posts.filter(p => p.platform?.toLowerCase() === platform.toLowerCase());
 
     return {
@@ -1211,46 +1320,55 @@ export const toolHandlers = {
       posts: posts.slice(0, Number(limit) || 4).map(p => ({
         platform: p.platform,
         date: p.date,
-        content: p.content?.slice(0, 120) + '...',
+        content: String(p.content || p.captionTh || p.captionCn || p.title || p.titleCn || '').slice(0, 120) + '...',
         likes: p.likes
       }))
     };
   },
 
-  get_gallery_photos: async ({ category, query, year, limit = 4 } = {}) => {
-    let photos = Array.isArray(galleryData) ? galleryData : (galleryData.photos || []);
-    if (category && category !== 'all') photos = photos.filter(p => p.category?.toLowerCase().includes(category.toLowerCase()));
-    if (query) {
-      const q = String(query).toLowerCase().trim();
-      photos = photos.filter(p => [p.titleTh, p.titleCn, p.titleEn, p.category, p.description].filter(Boolean).join(' ').toLowerCase().includes(q));
-    }
-    if (year) photos = photos.filter(p => Number(p.era || p.year) === Number(year));
-    const safeLimit = Math.min(Math.max(Number(limit) || 4, 1), 20);
-
-    return {
-      status: "success",
-      count: Math.min(photos.length, safeLimit),
-      photos: photos.slice(0, safeLimit).map((p, index) => ({
-        id: p.id || `photo-${p.era || p.year || 'unknown'}-${index + 1}`,
-        title: p.titleTh || p.titleCn,
+  get_gallery_photos: async ({ category, query, year, limit = 4 } = {}) => {
+    let photos = Array.isArray(galleryData) ? galleryData : (galleryData.photos || []);
+    if (category && category !== 'all') photos = photos.filter(p => p.category?.toLowerCase().includes(category.toLowerCase()));
+    let usedQueryFilter = false;
+    if (query) {
+      const q = String(query).toLowerCase().trim();
+    
+      const generic = /(ju jingyi|jujingyi|จวีจิ้งอี|จิ้งอี|จวี|鞠婧祎|小鞠|kiku|kikuuu|ju jing yi|蜜橘)/i.test(q);
+      if (!generic) {
+        const filtered = photos.filter(p => [p.titleTh, p.titleCn, p.titleEn, p.category, p.description].filter(Boolean).join(' ').toLowerCase().includes(q));
+        if (filtered.length > 0) {
+          photos = filtered;
+          usedQueryFilter = true;
+        }
+       
+      }
+    }
+    if (year) photos = photos.filter(p => Number(p.era || p.year) === Number(year));
+    const safeLimit = Math.min(Math.max(Number(limit) || 4, 1), 20);
+    const shown = photos.slice(0, safeLimit);
+
+    const result = {
+      status: "success",
+      count: Math.min(photos.length, safeLimit),
+      photos: shown.map((p, index) => ({
+        id: p.id || `photo-${p.era || p.year || 'unknown'}-${index + 1}`,
+        title: p.titleTh || p.titleCn,
         category: p.category,
         year: p.era || p.year
       }))
     };
+    if (usedQueryFilter === false && query) {
+      result.message = `Showing all ${result.count} photos (broad query "${query}" applied to full list).`;
+    }
+    return result;
   },
 
   global_search: async ({ query }) => {
     if (!query) return { status: "error", message: "Query parameter is required." };
-    const q = query.toLowerCase();
-    const ignoredTerms = new Set(['the', 'from', 'what', 'are', 'drama', 'ost', 'song', 'songs', 'soundtrack', 'music']);
-    const terms = q.split(/[^\p{L}\p{N}]+/u).filter(term => term.length > 2 && !ignoredTerms.has(term));
-    const matchesQuery = (...values) => {
-      const haystack = values.filter(Boolean).join(' ').toLowerCase();
-      return haystack.includes(q) || (terms.length > 0 && terms.every(term => haystack.includes(term)));
-    };
+    const matcher = createCatalogMatcher(query);
 
     const matchedWorks = worksData.filter(w =>
-      matchesQuery(w.titleTh, w.titleEn, w.titleCn, w.role, w.roleCn)
+      matcher(w.titleTh, w.titleEn, w.titleCn, w.role, w.roleCn)
     ).slice(0, 4).map(w => ({
       title: `${w.titleTh} (${w.year}) - Role: ${w.role}`,
       trailerYouTubeSearch: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${w.titleCn || w.titleEn} Trailer`)
@@ -1258,24 +1376,26 @@ export const toolHandlers = {
 
     const disc = getCleanDiscography();
     const matchedSongs = disc.filter(s =>
-      matchesQuery(s.titleTh, s.titleEn, s.titleCn, s.work, s.role)
+      matcher(s.titleTh, s.titleEn, s.titleCn, s.work, s.role, s.description)
     ).slice(0, 4).map(s => ({
       title: `${s.titleTh} (${s.year})`,
       youtubeUrl: s.youtubeUrl || null,
+      isDirectLink: Boolean(s.youtubeUrl),
       youtubeSearchUrl: s.youtubeSearchUrl
     }));
 
     const mvs = getAllMusicVideos().filter(m =>
-      matchesQuery(m.titleTh, m.titleCn, m.titlePinyin, m.dramaName, m.description)
+      matcher(m.titleTh, m.titleCn, m.titlePinyin, m.dramaName, m.description)
     ).slice(0, 4).map(m => ({
-      title: `${formatCatalogTitle(m.titleTh, m.titleCn)} [${m.category}]`,
+      title: `${formatCatalogTitle(m.titleTh, m.titleCn)} [${m.category}]`,
       youtubeUrl: m.youtubeId ? buildYouTubeWatchUrl(m.youtubeId) : null,
+      isDirectLink: Boolean(m.youtubeId),
       youtubeSearchUrl: buildYouTubeSearchUrl(`Ju Jingyi 鞠婧祎 ${m.titleCn || m.titleTh}`)
     }));
 
-    const brands = Array.isArray(brandsData) ? (brandsData.brandList || []) : (brandsData.brands || []);
+    const brands = Array.isArray(brandsData) ? brandsData : (brandsData.brandList || brandsData.brands || []);
     const matchedBrands = brands.filter(b =>
-      matchesQuery(b.brandNameEn, b.brandNameCn, b.name, b.title)
+      matcher(b.brandNameEn, b.brandNameCn, b.name, b.title, b.category, b.highlight)
     ).slice(0, 4).map(b => `${b.brandNameEn || b.name} (${b.year}) - ${b.title}`);
 
     const count = matchedWorks.length + matchedSongs.length + mvs.length + matchedBrands.length;
@@ -1302,32 +1422,35 @@ export const toolHandlers = {
     return await fetchWebpage(url);
   },
 
-  fetch_api: async ({ endpoint, query, baseUrl } = {}) => {
-    if (!endpoint) return { status: "error", message: "endpoint parameter is required (e.g. 'profile', 'works', 'search')" };
-    const base = (baseUrl || 'https://jujingyi-kikuuu.vercel.app/api/v1').replace(/\/$/, '');
-    const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;
-    let url = `${base}${path}`;
-    if (query) url += `?q=${encodeURIComponent(query)}`;
-
-    try {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), 10000);
-      const res = await fetch(url, {
-        headers: { 'Accept': 'application/json', 'User-Agent': 'KikuAgent/1.0' },
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-
-      if (!res.ok) {
-        return { status: "error", message: `HTTP ${res.status} from ${url}` };
-      }
-
-      const json = await res.json();
-
-      const data = json.data || json;
-      return {
-        status: "success",
-        endpoint: path,
+  fetch_api: async ({ endpoint, query, baseUrl } = {}) => {
+    if (!endpoint) return { status: "error", message: "endpoint parameter is required (e.g. 'profile', 'works', 'search')" };
+    const base = (baseUrl || 'https://jujingyi-kikuuu.vercel.app/api/v1').replace(/\/$/, '');
+    const originCheck = sanitizeUrl(base);
+    if (!originCheck.safe) {
+      return { status: "error", message: `Unsafe API base URL: ${originCheck.reason}` };
+    }
+    const allowedOrigins = new Set([
+      'https://jujingyi-kikuuu.vercel.app',
+      ...(process.env.KIKU_API_ALLOWED_ORIGINS || '').split(',').map(value => value.trim()).filter(Boolean)
+    ]);
+    if (!originCheck.url || !allowedOrigins.has(originCheck.url.origin)) {
+      return { status: 'error', message: 'API base origin is not allowlisted.' };
+    }
+    const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;
+    const target = new URL(`${base}/${endpoint.replace(/^\/+/, '')}`);
+    if (target.origin !== originCheck.url.origin || !target.pathname.startsWith('/api/v1/')) {
+      return { status: 'error', message: 'API endpoint must remain under /api/v1/.' };
+    }
+    if (query) target.searchParams.set('q', query);
+
+    try {
+      const result = await fetchJson(target.href, { timeoutMs: 10000, maxResponseLength: 100000 });
+      if (result.status !== 'success') return result;
+      const json = result.data;
+      const data = json?.data || json;
+      return {
+        status: "success",
+        endpoint: path,
         count: Array.isArray(data) ? data.length : undefined,
         data
       };
@@ -1335,7 +1458,7 @@ export const toolHandlers = {
       return {
         status: "error",
         endpoint: path,
-        message: err.name === 'AbortError' ? 'API request timed out' : err.message
+        message: err.name === 'AbortError' ? 'API request timed out' : err.message
       };
     }
   },
@@ -1347,15 +1470,21 @@ export const toolHandlers = {
   read_local_file: async ({ path: filePath, maxLines = 200 } = {}) => {
     if (!filePath) return { status: 'error', message: 'path parameter is required.' };
     try {
-      const projectRoot = process.cwd();
-      const resolved = resolve(projectRoot, filePath);
-      const relativePath = relative(projectRoot, resolved);
-
-      if (relativePath.startsWith('..') || relativePath.includes('..')) {
-        return { status: 'error', message: 'Path must be within the project directory.' };
-      }
-
-      const fileStat = await stat(resolved);
+      const projectRoot = await realpath(process.cwd());
+      const resolved = resolve(projectRoot, filePath);
+      const realResolved = await realpath(resolved);
+      const relativePath = relative(projectRoot, realResolved);
+
+      if (relativePath === '..' || relativePath.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`)) {
+        return { status: 'error', message: 'Path must be within the project directory.' };
+      }
+
+      if (/(^|[\\/])\.env(?:\.|$)/i.test(relativePath) || /(^|[\\/])cookies\.txt$/i.test(relativePath) ||
+          /\.(pem|key|p12|pfx)$/i.test(relativePath) || /(^|[\\/])\.(git|npmrc|netrc|ssh)([\\/]|$)/i.test(relativePath)) {
+        return { status: 'error', message: 'Reading this file is not permitted (sensitive file).' };
+      }
+
+      const fileStat = await stat(realResolved);
       if (!fileStat.isFile()) {
         return { status: 'error', message: `"${filePath}" is not a file.` };
       }
@@ -1364,7 +1493,7 @@ export const toolHandlers = {
         return { status: 'error', message: `File too large (${Math.round(fileStat.size / 1024)}KB). Use maxLines to read a portion.` };
       }
 
-      const content = await readFile(resolved, 'utf-8');
+      const content = await readFile(realResolved, 'utf-8');
       const lines = content.split('\n');
       const totalLines = lines.length;
       const truncated = totalLines > maxLines;
@@ -1389,13 +1518,14 @@ export const toolHandlers = {
 
   list_directory: async ({ path: dirPath = '.', recursive = false } = {}) => {
     try {
-      const projectRoot = process.cwd();
-      const resolved = resolve(projectRoot, dirPath);
-      const relativePath = relative(projectRoot, resolved);
-
-      if (relativePath.startsWith('..') || relativePath.includes('..')) {
-        return { status: 'error', message: 'Path must be within the project directory.' };
-      }
+      const projectRoot = await realpath(process.cwd());
+      const resolved = resolve(projectRoot, dirPath);
+      const realResolved = await realpath(resolved);
+      const relativePath = relative(projectRoot, realResolved);
+
+      if (relativePath === '..' || relativePath.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`)) {
+        return { status: 'error', message: 'Path must be within the project directory.' };
+      }
 
       async function listDir(dir, depth = 0) {
         if (depth > (recursive ? 3 : 0)) return [];
@@ -1435,7 +1565,7 @@ export const toolHandlers = {
         return items;
       }
 
-      const items = await listDir(resolved);
+      const items = await listDir(realResolved);
       return {
         status: 'success',
         path: relativePath || '.',
@@ -1466,8 +1596,20 @@ export const toolHandlers = {
     const mvs = getAllMusicVideos();
     const gpu = await getGpuMetrics().catch(() => ({ available: false }));
 
+    const debutMatch = profileData.details?.debutDate?.match(/\b(19\d\d|20\d\d)\b/);
+    const debutYear = debutMatch ? Number(debutMatch[1]) : 2013;
+    const years = worksData.map(w => w.year).filter(y => typeof y === 'number' && !isNaN(y));
+    const maxYear = years.length > 0 ? Math.max(...years, new Date().getFullYear()) : new Date().getFullYear();
+    const activeYears = `${debutYear} - Present (${maxYear})`;
+    const latestWorks = worksData.filter(w => w.year === maxYear);
+    const featuredWorks = latestWorks.length > 0
+      ? latestWorks.map(w => formatCatalogTitle(w.titleTh, w.titleCn))
+      : ["Veil of Shadows (月鳞绮纪)", "The Eternal Fragrance (千香)", "Wanhua Sin (万华世界)"];
+
     return {
       status: "success",
+      sourceType: "local_database",
+      dataFreshness: "2026-09-02",
       stats: {
         artistName: profileData.nameTh,
         artistNameCn: profileData.nameCn,
@@ -1477,8 +1619,8 @@ export const toolHandlers = {
         brandEndorsements: brands.length,
         totalAwards: awards.length,
         timelineMilestones: timeline.length,
-        activeYears: "2013 - Present (2026)",
-        featured2026Works: ["Veil of Shadows (月鳞绮纪)", "The Eternal Fragrance (千香)", "Wanhua Sin (万华世界)"],
+        activeYears,
+        featured2026Works: featuredWorks,
         youtubeOfficialHub: buildYouTubeSearchUrl("Ju Jingyi 鞠婧祎"),
         gpu: gpu.available ? gpu.primary : { available: false }
       }
@@ -1540,7 +1682,12 @@ export const toolHandlers = {
   },
 
   remove_from_queue: async (args) => {
-    const result = await audioPlayer.removeFromQueue(args.index);
+    const queue = audioPlayer.getQueue();
+    const index = Number(args.index);
+    if (!Number.isInteger(index) || index < 0 || index >= queue.length) {
+      return { status: 'error', message: `Invalid queue index ${args.index} (queue has ${queue.length} item(s)).` };
+    }
+    const result = await audioPlayer.removeFromQueue(index);
     return { status: 'success', message: result };
   },
 
@@ -1574,54 +1721,100 @@ export const toolHandlers = {
   },
 
   run_subagent: async ({ task }, options = {}) => {
+    const forwardProgress = (event) => options?.onSubagentProgress?.({ source: 'subagent', task, ...event });
+    forwardProgress({ type: 'start' });
     if (options?.agent?.runSubagent) {
-      const result = await options.agent.runSubagent(task, { signal: options.signal });
+      const result = await options.agent.runSubagent(task, { signal: options.signal, onProgress: forwardProgress });
       return { status: "success", task, answer: result.answer, toolCalls: result.toolCalls, iterations: result.iterations };
     }
     const { LMStudioClient } = await import('./llmClient.js');
     const { ResearchSubagent } = await import('./subagent.js');
     const client = options?.client || new LMStudioClient();
+    const offline = await ensureLlmAvailable(client);
+    if (offline) return { ...offline, task };
     const subagent = new ResearchSubagent({ client });
-    const result = await subagent.run(task, { signal: options?.signal });
+    const result = await subagent.run(task, { signal: options?.signal, onProgress: forwardProgress });
     return { status: "success", task, answer: result.answer, toolCalls: result.toolCalls, iterations: result.iterations };
   },
 
   run_deep_research: async ({ question }, options = {}) => {
-    if (options?.agent?.runResearch) {
-      const result = await options.agent.runResearch(question, { signal: options.signal });
+    const forwardProgress = (event) => options?.onSubagentProgress?.({ source: 'research', question, ...event });
+    forwardProgress({ type: 'start' });
+    try {
+      if (options?.agent?.runResearch) {
+        const result = await options.agent.runResearch(question, { signal: options.signal, onProgress: forwardProgress });
+        return { status: "success", question, answer: result.answer, sources: result.sources, reports: result.reports };
+      }
+      const { LMStudioClient } = await import('./llmClient.js');
+      const { ResearchOrchestrator } = await import('./research.js');
+      const client = options?.client || options?.agent?.client || new LMStudioClient();
+      const offlineResearch = await ensureLlmAvailable(client);
+      if (offlineResearch) throw new Error(offlineResearch.message);
+      const orchestrator = options?.agent?.research || new ResearchOrchestrator({ client });
+      const result = await orchestrator.run(question, { signal: options?.signal, onProgress: forwardProgress });
       return { status: "success", question, answer: result.answer, sources: result.sources, reports: result.reports };
+    } catch (err) {
+      try {
+        const { webExtract } = await import('./webSearch.js');
+        const extractRes = await webExtract(question);
+        return {
+          status: "success",
+          question,
+          answer: extractRes.text || extractRes.summary || "Retrieved live web intelligence.",
+          sources: extractRes.sources || [],
+          fallbackUsed: true
+        };
+      } catch {
+        return { status: "error", question, message: err.message || "Deep research failed." };
+      }
     }
-    const { LMStudioClient } = await import('./llmClient.js');
-    const { ResearchOrchestrator } = await import('./research.js');
-    const client = options?.client || new LMStudioClient();
-    const orchestrator = new ResearchOrchestrator({ client });
-    const result = await orchestrator.run(question, { signal: options?.signal });
-    return { status: "success", question, answer: result.answer, sources: result.sources, reports: result.reports };
   },
 
   verify_claim: async ({ claim }, options = {}) => {
-    if (options?.agent?.runResearch) {
-      const result = await options.agent.runResearch(claim, { mode: 'verify', signal: options.signal });
+    const forwardProgress = (event) => options?.onSubagentProgress?.({ source: 'verify', claim, ...event });
+    forwardProgress({ type: 'start' });
+    try {
+      if (options?.agent?.runResearch) {
+        const result = await options.agent.runResearch(claim, { mode: 'verify', signal: options.signal, onProgress: forwardProgress });
+        return { status: "success", claim, answer: result.answer, sources: result.sources, reports: result.reports };
+      }
+      const { LMStudioClient } = await import('./llmClient.js');
+      const { ResearchOrchestrator } = await import('./research.js');
+      const client = options?.client || options?.agent?.client || new LMStudioClient();
+      const offlineVerify = await ensureLlmAvailable(client);
+      if (offlineVerify) throw new Error(offlineVerify.message);
+      const orchestrator = options?.agent?.research || new ResearchOrchestrator({ client });
+      const result = await orchestrator.run(claim, { mode: 'verify', signal: options?.signal, onProgress: forwardProgress });
       return { status: "success", claim, answer: result.answer, sources: result.sources, reports: result.reports };
+    } catch (err) {
+      try {
+        const { webExtract } = await import('./webSearch.js');
+        const extractRes = await webExtract(claim);
+        return {
+          status: "success",
+          claim,
+          answer: extractRes.text || extractRes.summary || "Retrieved live web verification intelligence.",
+          sources: extractRes.sources || [],
+          fallbackUsed: true
+        };
+      } catch {
+        return { status: "error", claim, message: err.message || "Verification failed." };
+      }
     }
-    const { LMStudioClient } = await import('./llmClient.js');
-    const { ResearchOrchestrator } = await import('./research.js');
-    const client = options?.client || new LMStudioClient();
-    const orchestrator = new ResearchOrchestrator({ client });
-    const result = await orchestrator.run(claim, { mode: 'verify', signal: options?.signal });
-    return { status: "success", claim, answer: result.answer, sources: result.sources, reports: result.reports };
   },
 
-  suggest_topics: async ({ topic, limit }, options = {}) => {
+  suggest_topics: async ({ topic, limit, lang }, options = {}) => {
     if (options?.agent?.generateSuggestions) {
-      const suggestions = await options.agent.generateSuggestions({ topic, limit, signal: options.signal });
+      const suggestions = await options.agent.generateSuggestions({ topic, limit, lang, signal: options.signal });
       return { status: "success", topic, suggestions };
     }
     const { SuggestionEngine } = await import('./suggestions.js');
     const { LMStudioClient } = await import('./llmClient.js');
     const client = options?.client || new LMStudioClient();
+    const offline = await ensureLlmAvailable(client);
+    if (offline) return { ...offline, topic };
     const engine = new SuggestionEngine({ client });
-    const suggestions = await engine.generateSuggestions({ topic, limit, signal: options?.signal });
+    const suggestions = await engine.generateSuggestions({ topic, limit, lang, signal: options?.signal });
     return { status: "success", topic, suggestions };
   },
 
@@ -1839,6 +2032,10 @@ export function normalizeToolResult(toolName, result) {
   return normalized;
 }
 
+export function isBuiltinTool(toolName) {
+  return Boolean(toolHandlers && toolHandlers[toolName]);
+}
+
 export async function executeTool(toolName, args = {}, options = {}) {
   const handler = toolHandlers[toolName];
   if (!handler) {
@@ -1860,14 +2057,16 @@ export async function executeTool(toolName, args = {}, options = {}) {
 
     const isStatic = STATIC_CATALOG_TOOLS.has(toolName);
     const isWeb = WEB_CACHE_TOOLS.has(toolName);
-    const cacheKey = (isStatic || isWeb) ? `${toolName}:${JSON.stringify(prepared.args)}` : null;
+    const isLive = LIVE_DATA_TOOLS.has(toolName);
+    const cacheable = (isStatic || isWeb) && !isLive;
+    const cacheKey = cacheable ? `${toolName}:${JSON.stringify(prepared.args)}` : null;
 
     if (cacheKey && !options.noCache) {
       const cached = globalToolCache.get(cacheKey);
       if (cached) return cached;
     }
 
-    const configuredTimeout = Number(options.timeoutMs ?? process.env.KIKU_TOOL_TIMEOUT_MS ?? 45_000);
+    const configuredTimeout = Number(options.timeoutMs ?? TOOL_DEFAULT_TIMEOUTS[toolName] ?? process.env.KIKU_TOOL_TIMEOUT_MS ?? 45_000);
     const timeoutMs = Number.isFinite(configuredTimeout) && configuredTimeout > 0 ? configuredTimeout : 45_000;
     let timeoutId;
     const timeoutPromise = new Promise((_, reject) => {
@@ -1885,8 +2084,8 @@ export async function executeTool(toolName, args = {}, options = {}) {
       normalized.validationWarnings = prepared.warnings;
     }
 
-    if (cacheKey && normalized.status !== 'error') {
-      const ttl = isStatic ? 3600_000 : 900_000;
+    if (cacheKey && normalized.status === 'success' && (normalized.count === undefined || normalized.count > 0)) {
+      const ttl = isStatic ? 600_000 : 300_000;
       globalToolCache.set(cacheKey, normalized, ttl);
     }