kiku-agent 1.3.0 → 1.3.2

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

@@ -0,0 +1,117 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { mapConcurrent } from '../suggestions.js';
+import { LLMClient } from '../llmClient.js';
+import { routeCommand } from '../commands.js';
+
+test('mapConcurrent limits active concurrency strictly to specified limit', async () => {
+  const items = [1, 2, 3, 4, 5, 6];
+  let activeWorkers = 0;
+  let maxObservedActive = 0;
+  const executionOrder = [];
+
+  const results = await mapConcurrent(items, 2, async (item) => {
+    activeWorkers++;
+    maxObservedActive = Math.max(maxObservedActive, activeWorkers);
+    await new Promise((r) => setTimeout(r, 25));
+    executionOrder.push(item);
+    activeWorkers--;
+    return item * 10;
+  });
+
+  assert.equal(maxObservedActive, 2, 'Max active concurrent workers must not exceed limit 2');
+  assert.equal(results.length, 6);
+  assert.deepEqual(results.map(r => r.value), [10, 20, 30, 40, 50, 60]);
+});
+
+test('mapConcurrent with limit 1 processes strictly sequentially for local models', async () => {
+  const items = ['task1', 'task2', 'task3'];
+  let activeWorkers = 0;
+  let maxObservedActive = 0;
+
+  const results = await mapConcurrent(items, 1, async (item) => {
+    activeWorkers++;
+    maxObservedActive = Math.max(maxObservedActive, activeWorkers);
+    await new Promise((r) => setTimeout(r, 15));
+    activeWorkers--;
+    return `${item}_done`;
+  });
+
+  assert.equal(maxObservedActive, 1, 'Local inference concurrency must stay strictly 1');
+  assert.deepEqual(results.map(r => r.value), ['task1_done', 'task2_done', 'task3_done']);
+});
+
+test('LLMClient retries on transient 500 error and recovers', async () => {
+  let callCount = 0;
+  const originalFetch = globalThis.fetch;
+
+  try {
+    globalThis.fetch = async () => {
+      callCount++;
+      if (callCount === 1) {
+        return {
+          ok: false,
+          status: 500,
+          text: async () => 'Internal Server Error',
+        };
+      }
+      return {
+        ok: true,
+        status: 200,
+        json: async () => ({
+          choices: [
+            {
+              message: {
+                role: 'assistant',
+                content: 'Recovered after retry',
+              },
+            },
+          ],
+        }),
+      };
+    };
+
+    const client = new LLMClient({
+      provider: 'openai',
+      apiKey: 'test-key',
+      model: 'gpt-4o-mini',
+    });
+
+    const response = await client.chat({
+      messages: [{ role: 'user', content: 'Hello' }],
+      stream: false,
+    });
+    assert.equal(response.content, 'Recovered after retry');
+    assert.equal(callCount, 2, 'Should have retried once after 500 error');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+test('Commands populate recordQueryDiagnostics for inspection via /details', async () => {
+  let recorded = null;
+  const ctx = {
+    sub: 'Ju Jingyi 2026',
+    agent: {
+      runSubagent: async (task) => ({
+        answer: 'Ju Jingyi is starring in upcoming 2026 drama.',
+        thinking: 'Gathering drama data.',
+        toolCalls: [{ name: 'search_catalog', args: { query: '2026' }, result: { count: 2 }, duration: 120 }],
+        iterations: 1,
+      }),
+    },
+    setIsProcessing: () => {},
+    recordQueryDiagnostics: (details) => {
+      recorded = details;
+    },
+  };
+
+  const res = await routeCommand('/subagent Ju Jingyi 2026', ctx);
+  assert.equal(res, 'HANDLED');
+  assert.ok(recorded, 'Diagnostics should have been recorded for subagent run');
+  assert.equal(recorded.prompt, 'Ju Jingyi 2026');
+  assert.equal(recorded.answer, 'Ju Jingyi is starring in upcoming 2026 drama.');
+  assert.equal(recorded.tools.length, 1);
+  assert.equal(recorded.tools[0].name, 'search_catalog');
+});

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

@@ -0,0 +1,32 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { RuntimeWatchdog } from '../telemetry/runtimeWatchdog.js';
+
+test('RuntimeWatchdog: samples telemetry and tracks spillover thresholds', async () => {
+  const watchdog = new RuntimeWatchdog({ spilloverThresholdMb: 10.0 });
+  const sample = await watchdog.sampleTelemetry();
+
+  assert.ok(typeof sample.sharedMemoryUsedMb === 'number');
+  assert.ok(typeof sample.hasSpillover === 'boolean');
+  assert.equal(watchdog.metricsHistory.length, 1);
+});
+
+test('RuntimeWatchdog: triggers self-healing context eviction of 50% older messages', () => {
+  const watchdog = new RuntimeWatchdog();
+  const fakeAgent = {
+    conversationHistory: [
+      { role: 'system', content: 'system persona' },
+      { role: 'user', content: 'q1' },
+      { role: 'assistant', content: 'a1' },
+      { role: 'user', content: 'q2' },
+      { role: 'assistant', content: 'a2' },
+      { role: 'user', content: 'q3' },
+      { role: 'assistant', content: 'a3' },
+    ]
+  };
+
+  const evicted = watchdog.selfHealContext(fakeAgent);
+  assert.ok(evicted >= 3);
+  assert.equal(fakeAgent.conversationHistory[0].role, 'system');
+  assert.ok(fakeAgent.conversationHistory.some(m => m.content?.includes('WATCHDOG SELF-HEALING')));
+});

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

@@ -0,0 +1,37 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+
+import { sanitizeFilePath, sanitizeToolArgs, sanitizeUrl } from '../sanitizer.js';
+
+const projectRoot = path.resolve('C:/workspace/project');
+
+test('dangerous file extensions are rejected case-insensitively', () => {
+  const executable = sanitizeFilePath('scripts/launch.EXE', projectRoot);
+  const script = sanitizeFilePath('scripts/setup.sh', projectRoot);
+  const text = sanitizeFilePath('notes/readme.txt', projectRoot);
+
+  assert.equal(executable.safe, false);
+  assert.match(executable.reason, /dangerous file extension/i);
+  assert.equal(script.safe, false);
+  assert.equal(text.safe, true);
+});
+
+test('directory validation does not reject a directory name that resembles a script', () => {
+  const result = sanitizeToolArgs('list_directory', { path: 'fixtures.js' });
+  assert.equal(result.safe, true);
+});
+
+test('IPv6 loopback and private literals are rejected after bracket normalization', () => {
+  for (const url of [
+    'http://[::1]/admin',
+    'http://[0:0:0:0:0:0:0:1]/admin',
+    'http://[::ffff:127.0.0.1]/admin',
+    'http://[fd00::1]/admin',
+  ]) {
+    const result = sanitizeUrl(url);
+    assert.equal(result.safe, false, `${url} should be blocked`);
+  }
+
+  assert.equal(sanitizeUrl('https://[2606:4700:4700::1111]/').safe, true);
+});

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);
+  });
+});