kiku-agent 1.3.1 → 1.3.3

package/server/agent/tests/scenariosData.js

@@ -0,0 +1,378 @@
+export const TEST_SCENARIOS = Object.freeze([
+  {
+    id: 'drama_2026_veil_of_shadows',
+    category: 'works',
+    language: 'th',
+    query: 'จวีจิ้งอี มีผลงานซีรีส์เรื่องอะไรบ้างในปี 2026',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Veil of Shadows', 'The Eternal Fragrance', 'Wanhua Sin', '2026']
+  },
+  {
+    id: 'drama_eternal_fragrance_role',
+    category: 'works',
+    language: 'th',
+    query: 'ซีรีส์ พันกลิ่นรัญจวน (The Eternal Fragrance / 千香) จวีจิ้งอี รับบทเป็นใคร คู่กับใคร',
+    expectedTools: ['search_works', 'get_work_detail', 'get_character_roles'],
+    expectedKeywords: ['The Eternal Fragrance', '千香', 'Song Song', 'Jiang Li']
+  },
+  {
+    id: 'drama_wanhua_sin',
+    category: 'works',
+    language: 'zh',
+    query: '鞠婧祎新剧《万华世界》(Wanhua Sin) 的题材和角色',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Wanhua Sin', '万华世界']
+  },
+  {
+    id: 'drama_in_blossom_detail',
+    category: 'works',
+    language: 'th',
+    query: 'เล่าเรื่องย่อและบทบาทของจวีจิ้งอีในเรื่อง ฮวาเจียนลิ่ง (In Blossom) ให้ฟังหน่อย',
+    expectedTools: ['search_works', 'get_work_detail', 'get_character_roles'],
+    expectedKeywords: ['In Blossom', 'Yang Caiwei', 'Shangguan Zhi', 'ฮวาเจียนลิ่ง']
+  },
+  {
+    id: 'drama_legend_of_yunxi',
+    category: 'works',
+    language: 'zh',
+    query: '鞠婧祎在《芸汐传》中饰演什么角色？',
+    expectedTools: ['search_works', 'get_character_roles'],
+    expectedKeywords: ['韩芸汐', '芸汐传', 'Legend of Yun Xi']
+  },
+  {
+    id: 'drama_white_snake_en',
+    category: 'works',
+    language: 'en',
+    query: 'Tell me about Ju Jingyi role in The Legend of White Snake 2019',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Bai Suzhen', 'White Snake', '2019']
+  },
+  {
+    id: 'drama_sword_fairy_4',
+    category: 'works',
+    language: 'th',
+    query: 'ซีรีส์ เซียนกระบี่พิชิตมาร 4 (Sword and Fairy 4) จวีจิ้งอี รับบทเป็นใคร',
+    expectedTools: ['search_works', 'get_character_roles'],
+    expectedKeywords: ['Han Lingsha', 'หานหลิงซา', 'Sword and Fairy 4']
+  },
+  {
+    id: 'drama_ruyi_pavilion',
+    category: 'works',
+    language: 'th',
+    query: 'ซีรีส์ กรุ่นรักกลิ่นบุปผา (The Blooms at Ruyi Pavilion) จวีจิ้งอี แสดงร่วมกับใครและรับบทอะไร',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Fu Rong', 'Ruyi Pavilion', '如意芳霏']
+  },
+  {
+    id: 'drama_rebirth_for_you',
+    category: 'works',
+    language: 'th',
+    query: 'เจียหนานจ้วน (Rebirth For You) จวีจิ้งอี รับบทเป็นท่านหญิงชื่ออะไร',
+    expectedTools: ['search_works', 'get_character_roles'],
+    expectedKeywords: ['Jiang Baoning', 'Rebirth For You', '嘉南传']
+  },
+  {
+    id: 'drama_pair_of_wings',
+    category: 'works',
+    language: 'zh',
+    query: '民国悬疑剧《请赐我一双翅膀》鞠婧祎饰演的角色叫什么',
+    expectedTools: ['search_works', 'get_character_roles'],
+    expectedKeywords: ['林九歌', 'Lin Jiuge', 'Wings']
+  },
+  {
+    id: 'drama_love_full_moon',
+    category: 'works',
+    language: 'en',
+    query: 'What is the plot of modern fantasy romance drama Love Under the Full Moon starring Ju Jingyi?',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Lei Chuxia', 'Full Moon', 'Love Under the Full Moon']
+  },
+  {
+    id: 'drama_novoland_castle',
+    category: 'works',
+    language: 'th',
+    query: 'จวีจิ้งอี เคยเล่นเรื่อง ตำนานอาณาจักรเหนือเวหา (Novoland: The Castle in the Sky) รับบทเป็นใคร',
+    expectedTools: ['search_works', 'get_character_roles'],
+    expectedKeywords: ['Xue Feishuang', 'Novoland', 'องค์หญิงหิมะ']
+  },
+  {
+    id: 'music_ruyi_ost',
+    category: 'music',
+    language: 'th',
+    query: 'เพลงประกอบซีรีส์ กรุ่นรักกลิ่นบุปผา (The Blooms at Ruyi Pavilion) มีเพลงอะไรบ้าง',
+    expectedTools: ['search_discography', 'get_media_links'],
+    expectedKeywords: ['Fu Rong', 'Ruyi Pavilion', '如意芳霏']
+  },
+  {
+    id: 'music_ginkgo_play',
+    category: 'music',
+    language: 'th',
+    query: 'เปิดเพลง Rain of Ginkgo (银杏树下的雨) ให้หน่อย',
+    expectedTools: ['play_music', 'search_discography'],
+    expectedKeywords: ['Rain of Ginkgo', '银杏树下的雨']
+  },
+  {
+    id: 'music_solo_singles_en',
+    category: 'music',
+    language: 'en',
+    query: 'What are the top solo singles released by Ju Jingyi?',
+    expectedTools: ['search_discography', 'get_music_videos'],
+    expectedKeywords: ['Every Day', 'Rain of Ginkgo', 'Don\'t Touch', 'Single']
+  },
+  {
+    id: 'music_luohua_chengni',
+    category: 'music',
+    language: 'zh',
+    query: '《落花成泥》是哪部电视剧的主题曲？',
+    expectedTools: ['search_discography', 'get_work_detail'],
+    expectedKeywords: ['芸汐传', 'Legend of Yun Xi', '落花成泥']
+  },
+  {
+    id: 'music_qiannian_deng_yihui',
+    category: 'music',
+    language: 'th',
+    query: 'เพลง พันปีรอคอยหนึ่งหน (千年等一回) จากเรื่อง นางพญางูขาว จวีจิ้งอี ร้องเวอร์ชันไหน',
+    expectedTools: ['search_discography', 'get_media_links'],
+    expectedKeywords: ['千年等一回', 'White Snake', 'OST']
+  },
+  {
+    id: 'music_dont_touch_mv',
+    category: 'music',
+    language: 'en',
+    query: 'Tell me about Ju Jingyi iconic dance track Don\'t Touch and its music video',
+    expectedTools: ['search_discography', 'get_music_videos'],
+    expectedKeywords: ['Don\'t Touch', 'Dance', 'MV']
+  },
+  {
+    id: 'music_past_perfection',
+    category: 'music',
+    language: 'th',
+    query: 'เพลง Past Perfection (过去完成时) ของจวีจิ้งอี ปล่อยออกมาปีไหนและมีความหมายอย่างไร',
+    expectedTools: ['search_discography', 'get_media_links'],
+    expectedKeywords: ['过去完成时', 'Past Perfection']
+  },
+  {
+    id: 'music_stage_performances',
+    category: 'music',
+    language: 'th',
+    query: 'ขอดูคลิปการแสดงและ Music Video สเตจงาน Gala ของจวีจิ้งอี',
+    expectedTools: ['get_music_videos', 'get_media_links'],
+    expectedKeywords: ['Official MV', 'Stage Performance']
+  },
+  {
+    id: 'brand_global_ambassador_2026',
+    category: 'brand',
+    language: 'th',
+    query: 'จวีจิ้งอี เป็นแบรนด์แอมบาสเดอร์ระดับโลก (Global Ambassador) ของแบรนด์ใดบ้าง',
+    expectedTools: ['get_brand_endorsements'],
+    expectedKeywords: ['Global', 'Ambassador', 'Brand']
+  },
+  {
+    id: 'brand_versace_fragrance',
+    category: 'brand',
+    language: 'en',
+    query: 'When did Ju Jingyi become the Global Fragrance Ambassador for Versace?',
+    expectedTools: ['get_brand_endorsements'],
+    expectedKeywords: ['Versace', 'Fragrance', 'Global Ambassador']
+  },
+  {
+    id: 'brand_makeup_forever',
+    category: 'brand',
+    language: 'zh',
+    query: '鞠婧祎代言的法国彩妆品牌 MAKE UP FOR EVER 是什么级别的代言？',
+    expectedTools: ['get_brand_endorsements'],
+    expectedKeywords: ['MAKE UP FOR EVER', 'Ambassador', 'Brand']
+  },
+  {
+    id: 'brand_beauty_fashion_en',
+    category: 'brand',
+    language: 'en',
+    query: 'Which cosmetics and luxury fashion brands does Ju Jingyi endorse?',
+    expectedTools: ['get_brand_endorsements'],
+    expectedKeywords: ['Ambassador', 'Brand']
+  },
+  {
+    id: 'brand_ysl_mistine',
+    category: 'brand',
+    language: 'th',
+    query: 'แบรนด์ความงามและเครื่องสำอางที่จวีจิ้งอีร่วมงาน เช่น YSL หรือ Mistine มีอะไรบ้าง',
+    expectedTools: ['get_brand_endorsements'],
+    expectedKeywords: ['Mistine', 'Beauty', 'Brand']
+  },
+  {
+    id: 'brand_fashion_week_magazines',
+    category: 'brand',
+    language: 'th',
+    query: 'นิตยสารแฟชั่นชั้นนำที่จวีจิ้งอีเคยขึ้นปก เช่น Harper\'s Bazaar, Elle, L\'Officiel',
+    expectedTools: ['get_gallery_photos', 'get_brand_endorsements'],
+    expectedKeywords: ['Fashion', 'Magazine', 'Cover']
+  },
+  {
+    id: 'awards_history_th',
+    category: 'awards',
+    language: 'th',
+    query: 'จวีจิ้งอี เคยได้รับรางวัลเกียรติยศอะไรบ้างตลอดเส้นทางอาชีพ',
+    expectedTools: ['get_awards'],
+    expectedKeywords: ['Award', 'Honor', 'Weibo', 'SNH48']
+  },
+  {
+    id: 'awards_snh48_hall_of_fame',
+    category: 'awards',
+    language: 'en',
+    query: 'How many times did Ju Jingyi win 1st place in SNH48 General Elections before entering the Hall of Fame?',
+    expectedTools: ['get_awards', 'get_career_timeline'],
+    expectedKeywords: ['SNH48', 'Hall of Fame', 'Senbatsu', '1st']
+  },
+  {
+    id: 'awards_weibo_night',
+    category: 'awards',
+    language: 'zh',
+    query: '鞠婧祎在微博之夜（Weibo Night）获得过哪些年度荣誉奖项？',
+    expectedTools: ['get_awards'],
+    expectedKeywords: ['微博之夜', 'Weibo Night', 'Award']
+  },
+  {
+    id: 'awards_music_starlight',
+    category: 'awards',
+    language: 'th',
+    query: 'จวีจิ้งอีเคยได้รับรางวัลด้านดนตรี เช่น รางวัล Tencent Starlight Awards หรือ รางวัลเพลงยอดเยี่ยม ERC Chinese Top Ten อะไรบ้าง',
+    expectedTools: ['get_awards'],
+    expectedKeywords: ['Starlight', 'ERC', 'OST', 'Singer']
+  },
+  {
+    id: 'profile_bio_fandom_th',
+    category: 'profile',
+    language: 'th',
+    query: 'จวีจิ้งอีเกิดวันที่เท่าไหร่ แฟนคลับชื่ออะไร และสโลแกนคืออะไร',
+    expectedTools: ['get_profile_and_fandom'],
+    expectedKeywords: ['18 มิถุนายน', 'Miju', '蜜橘', '鞠世无双']
+  },
+  {
+    id: 'profile_social_links_en',
+    category: 'profile',
+    language: 'en',
+    query: 'What are Ju Jingyi official social media accounts on Weibo and Instagram?',
+    expectedTools: ['get_profile_and_fandom', 'get_social_feed'],
+    expectedKeywords: ['weibo', 'instagram', 'social']
+  },
+  {
+    id: 'profile_hometown_specialties',
+    category: 'profile',
+    language: 'zh',
+    query: '鞠婧祎的出生地、特长和精通乐器有哪些？',
+    expectedTools: ['get_profile_and_fandom'],
+    expectedKeywords: ['四川遂宁', '小提琴', '古筝', 'Suining']
+  },
+  {
+    id: 'timeline_snh48_to_solo',
+    category: 'timeline',
+    language: 'th',
+    query: 'เส้นทางประวัติการทำงานของจวีจิ้งอี ตั้งแต่ SNH48 จนถึงศิลปินเดี่ยว',
+    expectedTools: ['get_career_timeline'],
+    expectedKeywords: ['2013', 'SNH48', 'Studio', 'Solo']
+  },
+  {
+    id: 'timeline_studio_independence',
+    category: 'timeline',
+    language: 'en',
+    query: 'When did Ju Jingyi establish her personal independent studio?',
+    expectedTools: ['get_career_timeline', 'get_profile_and_fandom'],
+    expectedKeywords: ['2017', 'Studio', 'Independence', 'Solo']
+  },
+  {
+    id: 'quotes_famous_sayings',
+    category: 'profile',
+    language: 'th',
+    query: 'ขอคำพูดหรือ Quote ให้กำลังใจเด่นๆ ของจวีจิ้งอี',
+    expectedTools: ['get_quotes'],
+    expectedKeywords: ['Quote', 'คำพูด']
+  },
+  {
+    id: 'verify_contract_dispute',
+    category: 'research',
+    language: 'th',
+    query: 'ตรวจสอบข้อเท็จจริงเกี่ยวกับข้อพิพาทสัญญาระหว่าง จวีจิ้งอี กับ Star48',
+    expectedTools: ['verify_claim', 'web_search', 'run_subagent'],
+    expectedKeywords: ['Star48', 'Siba', 'Contract', 'Dispute']
+  },
+  {
+    id: 'verify_4000_year_idol_origin',
+    category: 'research',
+    language: 'en',
+    query: 'Verify the truth behind the 4000-year idol nickname origin in Japanese media',
+    expectedTools: ['verify_claim', 'get_profile_and_fandom'],
+    expectedKeywords: ['4000-year', 'Japanese', 'Translation', 'Mistranslation']
+  },
+  {
+    id: 'research_legal_portrait_rights',
+    category: 'research',
+    language: 'zh',
+    query: '查证鞠婧祎肖像权维权和胜诉判决的相关公开信息',
+    expectedTools: ['verify_claim', 'web_search', 'run_deep_research'],
+    expectedKeywords: ['肖像权', '维权', '判决', 'Court']
+  },
+  {
+    id: 'research_deep_investigation_en',
+    category: 'research',
+    language: 'en',
+    query: 'Investigate the latest updates regarding Ju Jingyi upcoming drama premiere licenses in 2026',
+    expectedTools: ['run_deep_research', 'web_search', 'web_extract'],
+    expectedKeywords: ['License', 'Drama', 'Broadcast']
+  },
+  {
+    id: 'multilingual_mixed_thai_chinese',
+    category: 'works',
+    language: 'th',
+    query: 'ผลงานของ 鞠婧祎 (Ju Jingyi) เรื่อง ฮวาเจียนลิ่ง (花间令) ฉายทางแพลตฟอร์มไหนคะ',
+    expectedTools: ['search_works', 'get_work_detail'],
+    expectedKeywords: ['Youku', 'In Blossom', '花间令']
+  },
+  {
+    id: 'multilingual_pinyin_search',
+    category: 'works',
+    language: 'en',
+    query: 'Find the drama Hua Jian Ling and Yun Xi Zhuan starring Ju Jingyi',
+    expectedTools: ['search_works', 'global_search'],
+    expectedKeywords: ['In Blossom', 'Legend of Yun Xi']
+  },
+  {
+    id: 'reasoning_compare_dramas',
+    category: 'works',
+    language: 'th',
+    query: 'เปรียบเทียบบทบาทของจวีจิ้งอี ระหว่างเรื่อง ตำนานยุ่นซี (Legend of Yunxi) กับ ฮวาเจียนลิ่ง (In Blossom)',
+    expectedTools: ['search_works', 'get_work_detail', 'get_character_roles'],
+    expectedKeywords: ['Han Yunxi', 'Yang Caiwei', 'In Blossom', 'Yunxi']
+  },
+  {
+    id: 'reasoning_all_self_sung_osts',
+    category: 'music',
+    language: 'th',
+    query: 'รวมเพลง OST ทั้งหมดที่จวีจิ้งอีร้องให้กับซีรีส์ที่ตัวเองแสดงนำ',
+    expectedTools: ['search_discography', 'search_works'],
+    expectedKeywords: ['OST', 'Luohua Chengni', 'Fu Rong', 'Qiannian']
+  },
+  {
+    id: 'system_stats_check',
+    category: 'system',
+    language: 'th',
+    query: 'ดูสถิติระบบและจำนวนผลงานทั้งหมดของ Kiku',
+    expectedTools: ['get_system_stats'],
+    expectedKeywords: ['totalWorks', 'totalUniqueSongs']
+  },
+  {
+    id: 'system_skill_learn',
+    category: 'system',
+    language: 'th',
+    query: 'สอน Kiku ว่าให้ตอบภาษาไทยอย่างสุภาพและลงท้ายด้วยค่ะเสมอ',
+    expectedTools: ['manage_skill'],
+    expectedKeywords: ['skill', 'learn']
+  },
+  {
+    id: 'system_doctor_check',
+    category: 'system',
+    language: 'en',
+    query: 'Show system doctor status, LM Studio connectivity, and runtime paths',
+    expectedTools: ['get_system_stats'],
+    expectedKeywords: ['stats', 'system']
+  }
+]);

package/server/agent/tests/schemaRouting.test.js

@@ -0,0 +1,54 @@
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { RoutingInterceptor } from '../routingInterceptor.js';
+import { compactToolsForPrompt } from '../contextCompactor.js';
+
+describe('Sprint 3: Schema Routing & Misrouting Elimination', () => {
+  let interceptor;
+
+  beforeEach(() => {
+    interceptor = new RoutingInterceptor();
+  });
+
+  it('w13 regression: should prevent global_search on Han Lingsha costume query', () => {
+    const call = {
+      name: 'global_search',
+      params: { query: '仙剑四 韩菱纱 服装颜色' }
+    };
+    const result = interceptor.interceptToolCall(call, 0);
+
+    assert.equal(result.rerouted, true);
+    assert.equal(result.replacement.name, 'search_works');
+  });
+
+  it('m02 regression: should prevent global_search for View From The Wall Chinese title', () => {
+    const call = {
+      name: 'global_search',
+      params: { query: 'View From The Wall Chinese title' }
+    };
+    const result = interceptor.interceptToolCall(call, 0);
+
+    assert.equal(result.rerouted, true);
+    assert.equal(result.replacement.name, 'search_discography');
+  });
+
+  it('r15 regression: should detect and abort duplicate queries in multi-turn loop', () => {
+    const call = { name: 'search_works', params: { query: '七星彩' } };
+
+    const firstAttempt = interceptor.interceptToolCall(call, 0);
+    assert.equal(firstAttempt.valid, true);
+
+  
+    const secondAttempt = interceptor.interceptToolCall(call, 1);
+    assert.equal(secondAttempt.aborted, true);
+  });
+
+  it('Dynamic Scoping: should isolate gallery tools for photoshoot queries', () => {
+    const query = 'According to the catalog, which jewelry collection from FRED was featured in PORT Magazine?';
+    const scoped = compactToolsForPrompt(query, { schemaStrategy: 'domain_grouped' });
+
+    const toolNames = scoped.map(t => t.schema?.name || t.function?.name || t.name);
+    assert.ok(toolNames.includes('get_gallery_photos'));
+    assert.equal(toolNames.includes('get_brand_endorsements'), false);
+  });
+});

package/server/agent/tests/searchQueryPlanner.test.js

@@ -0,0 +1,108 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { appendDomainFilters, planSearchRequest, rerankSearchResults } from '../searchQueryPlanner.js';
+import { prepareToolArguments, toolsSchema } from '../tools.js';
+
+test('search planner normalizes conversational Thai and romanized Chinese entities', () => {
+  const plan = planSearchRequest({
+    keywords: 'ช่วยอปเดตขาวกองถาย Wan hua sin jie ปี 2026 หน่อย',
+    target_language: 'zh',
+    domain_filter: ['https://www.weibo.com/search', 'bilibili.com'],
+  }, { kind: 'chinese' });
+
+  assert.match(plan.keywords, /万花世界/);
+  assert.match(plan.keywords, /电视剧/);
+  assert.match(plan.keywords, /拍摄进度/);
+  assert.match(plan.keywords, /2026/);
+  assert.deepEqual(plan.domains, ['weibo.com', 'bilibili.com']);
+});
+
+test('search planner resolves a romanized performer name to native script and qualifier', () => {
+  const plan = planSearchRequest('latest update for Song Xinran', { kind: 'news' });
+  assert.match(plan.keywords, /宋昕冉/);
+  assert.match(plan.keywords, /SNH48/);
+});
+
+test('post-retrieval reranker promotes intent and domain matches', () => {
+  const plan = planSearchRequest({ keywords: 'Song Xinran event', domain_filter: ['weibo.com'] });
+  const ranked = rerankSearchResults([
+    { title: 'Unrelated sports result', snippet: 'football table', url: 'https://example.com/a' },
+    { title: '宋昕冉 SNH48 event update', snippet: 'latest official schedule', url: 'https://weibo.com/a' },
+  ], plan);
+  assert.match(ranked[0].title, /宋昕冉/);
+  assert.ok(ranked.length === 1 || ranked[0].relevanceScore > ranked.at(-1).relevanceScore);
+});
+
+test('structured search fields pass through tool argument sanitation while legacy query remains accepted', () => {
+  const structured = prepareToolArguments('web_search', {
+    keywords: '万花世界 拍摄进度',
+    target_language: 'zh',
+    domain_filter: ['weibo.com'],
+  }, toolsSchema);
+  assert.equal(structured.safe, true);
+  assert.deepEqual(structured.args.domain_filter, ['weibo.com']);
+
+  const legacy = prepareToolArguments('web_search', { query: 'Ju Jingyi news' }, toolsSchema);
+  assert.equal(legacy.safe, true);
+  assert.equal(legacy.args.query, 'Ju Jingyi news');
+  assert.match(appendDomainFilters('鞠婧祎', ['weibo.com']), /site:weibo\.com/);
+});
+
+test('planner parity: bilibili, youtube, encyclopedia, and music tools accept canonical keywords', () => {
+  const bili = prepareToolArguments('search_bilibili', {
+    keywords: '宋昕冉 SNH48 舞台',
+    target_language: 'zh',
+  }, toolsSchema);
+  assert.equal(bili.safe, true);
+  assert.equal(bili.args.keywords, '宋昕冉 SNH48 舞台');
+
+  const biliLegacy = prepareToolArguments('search_bilibili', { keyword: '鞠婧祎 舞台' }, toolsSchema);
+  assert.equal(biliLegacy.safe, true);
+  assert.equal(biliLegacy.args.keyword, '鞠婧祎 舞台');
+
+  const yt = prepareToolArguments('search_youtube', { keywords: 'Ju Jingyi FIND THE WAY' }, toolsSchema);
+  assert.equal(yt.safe, true);
+  assert.equal(yt.args.keywords, 'Ju Jingyi FIND THE WAY');
+
+  const ytLegacy = prepareToolArguments('search_youtube', { query: 'Ju Jingyi live stage' }, toolsSchema);
+  assert.equal(ytLegacy.safe, true);
+
+  const baike = prepareToolArguments('search_encyclopedia', {
+    keywords: '宋昕冉 SNH48',
+    target_language: 'zh',
+  }, toolsSchema);
+  assert.equal(baike.safe, true);
+
+  const baikeLegacy = prepareToolArguments('search_encyclopedia', { term: '鞠婧祎', language: 'zh' }, toolsSchema);
+  assert.equal(baikeLegacy.safe, true);
+
+  const music = prepareToolArguments('search_music_platforms', { keywords: 'Ju Jingyi 叹云兮' }, toolsSchema);
+  assert.equal(music.safe, true);
+
+  const musicLegacy = prepareToolArguments('search_music_platforms', { term: 'Ju Jingyi' }, toolsSchema);
+  assert.equal(musicLegacy.safe, true);
+});
+
+test('planner parity: handlers reject empty input without touching the network', async () => {
+  const { toolHandlers } = await import('../tools.js');
+  const bili = await toolHandlers.search_bilibili({});
+  assert.equal(bili.status, 'error');
+  assert.match(bili.message, /keyword parameter is required/);
+
+  const enc = await toolHandlers.search_encyclopedia({});
+  assert.equal(enc.status, 'error');
+
+  const music = await toolHandlers.search_music_platforms({});
+  assert.equal(music.status, 'error');
+
+  const yt = await toolHandlers.search_youtube({});
+  assert.equal(yt.status, 'error');
+});
+
+test('planner resolves performer queries to entity-native terms for encyclopedia-style lookup', () => {
+  const plan = planSearchRequest({ keywords: 'ค้นหาข้อมูลของ Song Xinran SNH48 ให้หน่อย' });
+  const native = plan.entities[0]?.native;
+  assert.ok(native && /宋昕冉|SNH48/.test(`${native} ${plan.keywords}`));
+  assert.match(plan.keywords, /宋昕冉/);
+});