kiku-agent 1.3.0 → 1.3.2

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

@@ -0,0 +1,135 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { executeTool } from '../tools.js';
+import { compactToolResultForContext } from '../contextCompactor.js';
+import { scoreCoverage } from '../eval/modules/evaluation/scoring.js';
+import { dynamicToolRouter } from '../toolRouter.js';
+import { buildCatalogIndex, CATEGORY_ALIASES, resolveQueryEntities } from '../catalogEntityResolver.js';
+
+test('get_brand_endorsements resolves French high jewelry and commercial aliases', async () => {
+  const fredRes = await executeTool('get_brand_endorsements', { query: 'French high jewelry' }, { noCache: true });
+  assert.equal(fredRes.status, 'success');
+  assert.ok(fredRes.count > 0);
+  assert.ok(fredRes.brands.some(b => b.brand.toLowerCase().includes('fred')));
+
+  const tutuRes = await executeTool('get_brand_endorsements', { query: 'TuTuCare' }, { noCache: true });
+  assert.equal(tutuRes.status, 'success');
+  assert.ok(tutuRes.count > 0);
+  assert.ok(tutuRes.brands.some(b => b.brand.toLowerCase().includes('tutu') || b.brand.includes('凸凸棉')));
+
+  const lafangRes = await executeTool('get_brand_endorsements', { query: 'Lafang' }, { noCache: true });
+  assert.equal(lafangRes.status, 'success');
+  assert.ok(lafangRes.count > 0);
+  assert.ok(lafangRes.brands.some(b => b.brand.toLowerCase().includes('lafang') || b.brand.includes('拉芳')));
+});
+
+test('search_discography and get_music_videos resolve 0.2s and Dewdrops without numeric confusion', async () => {
+  const zeroTwoRes = await executeTool('search_discography', { query: '0.2s' }, { noCache: true });
+  assert.equal(zeroTwoRes.status, 'success');
+  assert.ok(zeroTwoRes.count > 0);
+  assert.ok(zeroTwoRes.songs.some(s => s.titleEn === '0.2s' || s.titleCn === '0.2s' || s.title?.includes('0.2s')));
+
+  const dewdropsRes = await executeTool('search_discography', { query: 'Dewdrops' }, { noCache: true });
+  assert.equal(dewdropsRes.status, 'success');
+  assert.ok(dewdropsRes.count > 0);
+  assert.ok(dewdropsRes.songs.some(s => s.id?.includes('dewdrop') || s.titleEn?.toLowerCase().includes('dew') || s.title?.includes('露珠')));
+
+  const dewdropsMv = await executeTool('get_music_videos', { query: 'Dewdrops' }, { noCache: true });
+  assert.equal(dewdropsMv.status, 'success');
+  assert.ok(dewdropsMv.count > 0);
+  assert.ok(dewdropsMv.videos.some(v => v.youtubeId === 'D-vEPdasbLo' || v.titleCn?.includes('露珠')));
+});
+
+test('compactToolResultForContext projects essential keys and eliminates decorative URLs', () => {
+  const brandResult = {
+    status: 'success',
+    count: 1,
+    brands: [
+      {
+        brand: 'FRED Paris (斐登珠宝)',
+        brandNameEn: 'FRED Paris',
+        brandNameCn: '斐登珠宝',
+        year: 2025,
+        title: 'China Brand Ambassador',
+        category: 'French High Jewelry',
+        isGlobal: false,
+        highlight: 'Force 10 High Jewelry editorial for PORT Magazine',
+        tier: 'LVMH High Jewelry',
+        youtubeCommercialSearch: 'https://youtube.com/results?search_query=FRED',
+        bilibiliSearchUrl: 'https://search.bilibili.com/all?keyword=FRED'
+      }
+    ]
+  };
+
+  const compacted = compactToolResultForContext(brandResult, { maxTokens: 800 });
+  assert.equal(compacted.brands.length, 1);
+  const b = compacted.brands[0];
+  assert.equal(b.brandNameEn, 'FRED Paris');
+  assert.equal(b.year, 2025);
+  assert.equal(b.youtubeCommercialSearch, undefined);
+  assert.equal(b.bilibiliSearchUrl, undefined);
+});
+
+test('scoreCoverage normalizes Buddhist Era years and minute-second durations', () => {
+  const caseBe = {
+    groups: [
+      ['2017', 'ค.ศ. 2017']
+    ]
+  };
+  const answerBe = 'จวีจิ้งอีจัดงานคอนเสิร์ตเดี่ยวครั้งสำคัญใน พ.ศ. 2560 อย่างยิ่งใหญ่';
+  const scoreBeResult = scoreCoverage(caseBe, answerBe);
+  assert.equal(scoreBeResult.allMatched, true, 'พ.ศ. 2560 should cover 2017');
+
+  const caseDuration = {
+    groups: [
+      ['5:01', '05:01']
+    ]
+  };
+  const answerDuration = 'เพลง Still Searching (仍寻) มีความยาว 5 minutes and 1 second พอดี';
+  const scoreDurationResult = scoreCoverage(caseDuration, answerDuration);
+  assert.equal(scoreDurationResult.allMatched, true, '5 minutes and 1 second should cover 5:01');
+});
+
+test('tool router routes timeline era queries to get_career_timeline', () => {
+  const tools = dynamicToolRouter.routeToolsForQuery('Ju Jingyi career journey and variety show milestones in 2015-2016');
+  const toolNames = tools.map(t => t.function?.name || t.name);
+  assert.ok(toolNames.includes('get_career_timeline'), 'should route to get_career_timeline');
+});
+
+test('refusal regex intercepts premature commercial secret and mindset refusals', () => {
+  const refusalRegex = /(ไม่มี(การ)?บันทึก|ไม่มี(อยู่ใน)?ระบบ|ไม่มีข้อมูล|ไม่มีรายละเอียด|ไม่พบ|ข้อมูลทางธุรกิจ|ข้อมูลธุรกิจ|ข้อมูลเชิงพาณิชย์|ความลับทางการค้า|ความลับ|ความลับเชิงพาณิชย์|ปรัชญาการทำงาน|ตัวตนของฉัน|นอกเหนือขอบเขต|ไม่สามารถระบุ|ไม่ได้ระบุ|not found|no verified record|no record|could not find|unable to find|outside the scope|confidential|internal business|trade secret|business secret|commercial secret|proprietary|internal statistics?|operational philosophy|my own mindset|without querying|没有找到|未找到|暂无|没有记录|无法查询|商业机密|内部数据|机密)/i;
+
+  assert.ok(refusalRegex.test('ข้อมูลยอดขายของ TuTuCare เป็นความลับเชิงพาณิชย์'));
+  assert.ok(refusalRegex.test('This is confidential commercial secret information.'));
+  assert.ok(refusalRegex.test('This is internal business statistics not publicly shared.'));
+  assert.ok(refusalRegex.test('I do not have access to internal trade secrets.'));
+  assert.ok(refusalRegex.test('นี่เป็นปรัชญาการทำงานและตัวตนของฉันเอง'));
+  assert.ok(refusalRegex.test('This is outside the scope of public records.'));
+});
+
+test('resolveQueryEntities detects timeline and brand intents with recommendedTools', () => {
+  const timelineQuery = resolveQueryEntities('ในปี 2018 ละครเรื่องอะไรที่จวีจิ้งอีแสดงร่วมกับ ไมค์ พิรัชต์');
+  assert.equal(timelineQuery.isTimelineIntent, true);
+  assert.ok(timelineQuery.recommendedTools.includes('get_career_timeline'));
+
+  const brandQuery = resolveQueryEntities('ยอดขายกล่องของขวัญ TuTuCare ของจวีจิ้งอีเป็นอย่างไร');
+  assert.equal(brandQuery.isBrandIntent, true);
+  assert.ok(brandQuery.recommendedTools.includes('get_brand_endorsements'));
+});
+
+test('compactToolResultForContext preserves salesHighlights in brands data', () => {
+  const brandPayload = {
+    brands: [
+      { id: 'tutucare', brand: 'TuTuCare', brandNameEn: 'TuTuCare', year: 2026, title: 'Global Ambassador' }
+    ],
+    salesHighlights: [
+      { brand: 'TuTuCare (凸凸棉)', brandId: 'tutucare', stat: '20,000 ชุด หมดใน 1 วินาที!', revenue: 'GMV เกิน 10.3 ล้านหยวนใน 1 ชั่วโมง', detail: 'กล่องของขวัญลิมิเต็ด' }
+    ]
+  };
+
+  const compacted = compactToolResultForContext(brandPayload);
+  assert.ok(compacted.salesHighlights, 'salesHighlights should be preserved');
+  assert.equal(compacted.salesHighlights.length, 1);
+  assert.equal(compacted.salesHighlights[0].stat, '20,000 ชุด หมดใน 1 วินาที!');
+});

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

@@ -0,0 +1,73 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { executeTool } from '../tools.js';
+import { resolveConversationContext } from '../../web-chat/core/conversationContext.js';
+import { executeDirectCatalogKnowledge } from '../../web-chat/core/directCatalogEngine.js';
+import { assessDramaAnswerQuality } from '../../web-chat/core/dramaKnowledge.js';
+
+test('2024-versus-past analysis compares concrete role demands without unsupported rankings', async () => {
+  const query = 'ดำเนินการต่อ: อยากให้วิเคราะห์เปรียบเทียบบทบาทของเธอในซีรีส์ยุคใหม่ (2024) กับผลงานไอดอลในอดีต ว่ามีจุดเปลี่ยนด้านการแสดงอย่างไรบ้างคะ?';
+  const result = await executeDirectCatalogKnowledge(query);
+
+  assert.match(result.answer, /วิวัฒนาการต่อเนื่อง/);
+  assert.match(result.answer, /ตัวตนหยางไฉ่เวย.*รูปลักษณ์.*ซ่างกวนจื่อ/s);
+  assert.match(result.answer, /Sword and Fairy 4/);
+  assert.match(result.answer, /Novoland: The Castle in the Sky/);
+  assert.doesNotMatch(result.answer, /★\s*9\.|ระดับแนวหน้า|ไม่มีใครเทียบได้/);
+  assert.doesNotMatch(result.answer, /ประวัติและข้อมูลส่วนตัว/);
+  assert.ok(result.tools.every(tool => tool.name === 'get_work_detail'));
+});
+
+test('White Snake story keeps Bai Suzhen and Xu Xian species and genders correct', async () => {
+  const result = await executeDirectCatalogKnowledge('เล่าเรื่องราวและเกร็ดของ ตำนานนางพญางูขาว (The Legend of White Snake) ให้ฟังหน่อย');
+
+  assert.match(result.answer, /ไป๋ซู่เจินเป็นวิญญาณ\/ปีศาจงูขาว/);
+  assert.match(result.answer, /สวี่เซียนเป็นมนุษย์ชาย/);
+  assert.match(result.answer, /iQIYI \/ WeTV/);
+  assert.doesNotMatch(result.answer, /มนุษย์สาวผู้มีความงดงาม.*พญางูขาว/s);
+  assert.doesNotMatch(result.answer, /ไม่มีใครเทียบได้|ระดับแนวหน้า/);
+  assert.equal(result.tools[0]?.name, 'get_work_detail');
+});
+
+test('explicit long continuation keeps the previous topic and forbids repetition', () => {
+  const query = 'ดำเนินการต่อ: อยากให้วิเคราะห์เปรียบเทียบบทบาทของเธอในซีรีส์ยุคใหม่ปี 2024 กับผลงานไอดอลในอดีต โดยเน้นเฉพาะสิ่งที่ต่างจากคำตอบก่อนหน้า';
+  const context = resolveConversationContext(query, [
+    { role: 'user', text: 'ช่วยวิเคราะห์ซีรีส์ปี 2024 กับอดีตของจวีจิ้งอี' },
+    { role: 'assistant', text: 'คำตอบก่อนหน้ากล่าวถึง In Blossom และ The Legend of White Snake' }
+  ]);
+
+  assert.equal(context.contextual, true);
+  assert.match(context.resolvedQuery, /do not copy or restate/i);
+});
+
+test('search_works exposes synopsis and highlights needed for grounded synthesis', async () => {
+  const result = await executeTool('search_works', { query: 'The Legend of White Snake' });
+  const work = result.works[0];
+
+  assert.match(work.synopsis, /ปีศาจงูขาว/);
+  assert.ok(Array.isArray(work.highlights));
+  assert.ok(work.highlights.length > 0);
+});
+
+test('quality assessment rejects the observed hallucinated White Snake answer', () => {
+  const answer = 'ตัวละครเอกเป็นมนุษย์สาวผู้มีความงดงาม และเธอได้พบกับสิ่งมีชีวิตลึกลับ ซึ่งในตำนานคือพญางูขาว';
+  const assessment = assessDramaAnswerQuality('เล่าเรื่องราวและเกร็ดของ The Legend of White Snake', answer);
+
+  assert.equal(assessment.applicable, true);
+  assert.equal(assessment.valid, false);
+  assert.ok(assessment.issues.includes('reversed-species-or-gender'));
+});
+
+test('quality assessment rejects repeated generic comparison and false dual-role framing', () => {
+  const answer = 'In Blossom แสดงพัฒนาการสลับเล่น 2 คาแรคเตอร์ได้อย่างน่าทึ่ง ส่วน Sword and Fairy 4 เป็นงานปี 2024 ★ 9.5 / 10';
+  const assessment = assessDramaAnswerQuality(
+    'ดำเนินการต่อ: เปรียบเทียบซีรีส์ปี 2024 กับผลงานไอดอลในอดีต',
+    answer
+  );
+
+  assert.equal(assessment.valid, false);
+  assert.ok(assessment.issues.includes('false-dual-role-framing'));
+  assert.ok(assessment.issues.includes('unattributed-rating'));
+  assert.ok(assessment.issues.includes('missing-past-work-evidence'));
+});

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

@@ -0,0 +1,285 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import os from 'node:os';
+import path from 'node:path';
+import { mkdtemp, rm } from 'node:fs/promises';
+
+import {
+  loadDynamicCatalog,
+  saveDynamicCatalog,
+  validateCatalogEntry,
+  addDynamicEntry,
+  getDynamicEntries,
+  clearDynamicCatalog,
+  getDynamicCatalogStats,
+  pruneExpiredEntries
+} from '../dynamicCatalog.js';
+
+import {
+  isTrustedSource,
+  computeEventSimHash,
+  isDuplicateEvent,
+  extractStructuredEvent,
+  ingestRawEvent,
+  runIngestionScan
+} from '../ingestionWorker.js';
+
+import { executeTool } from '../tools.js';
+import { routeCommand } from '../commands.js';
+
+test('Dynamic Catalog: validation and CRUD operations', async (t) => {
+  const tmpDir = await mkdtemp(path.join(os.tmpdir(), 'kiku-dynamic-test-'));
+  const catalogPath = path.join(tmpDir, 'dynamic-catalog.json');
+
+  await t.test('validateCatalogEntry validates categories and required titles', () => {
+    assert.equal(validateCatalogEntry('brands', { brand: 'Lafang' }).valid, true);
+    assert.equal(validateCatalogEntry('invalid_cat', { title: 'Test' }).valid, false);
+    assert.equal(validateCatalogEntry('works', {}).valid, false);
+    assert.equal(validateCatalogEntry('timeline', { title: 'Milestone 2026' }).valid, true);
+  });
+
+  await t.test('addDynamicEntry persists and assigns clean IDs and metadata', () => {
+    const entry = addDynamicEntry('brands', {
+      brand: 'TuTuCare',
+      brandNameEn: 'TuTuCare',
+      brandNameCn: '途途呵护',
+      year: 2024,
+      role: 'Brand Ambassador',
+      highlight: 'Pet and rabbit care ambassador'
+    }, { catalogPath, trustTier: 1, source: 'official_weibo' });
+
+    assert.ok(entry.id.startsWith('dyn-bra-'));
+    assert.equal(entry.brand, 'TuTuCare');
+    assert.equal(entry.trustTier, 1);
+    assert.equal(entry.year, 2024);
+
+    const brands = getDynamicEntries('brands', null, catalogPath);
+    assert.equal(brands.length, 1);
+    assert.equal(brands[0].id, entry.id);
+
+    const stats = getDynamicCatalogStats(catalogPath);
+    assert.equal(stats.totalEntries, 1);
+    assert.equal(stats.brandsCount, 1);
+  });
+
+  await t.test('pruneExpiredEntries removes expired entries and retains valid ones', () => {
+  
+    const eightDaysAgo = new Date(Date.now() - 8 * 24 * 3600 * 1000).toISOString();
+    addDynamicEntry('events', {
+      id: 'old-event-1',
+      title: 'Old Live Stream',
+      createdAt: eightDaysAgo
+    }, { catalogPath });
+
+    const statsBefore = getDynamicCatalogStats(catalogPath);
+    assert.equal(statsBefore.eventsCount, 1);
+
+    const pruned = pruneExpiredEntries({ catalogPath, ttlDays: 7 });
+    assert.equal(pruned.prunedCount, 1);
+
+    const statsAfter = getDynamicCatalogStats(catalogPath);
+    assert.equal(statsAfter.eventsCount, 0);
+  });
+
+  await t.test('clearDynamicCatalog empties all collections', () => {
+    clearDynamicCatalog(catalogPath);
+    const stats = getDynamicCatalogStats(catalogPath);
+    assert.equal(stats.totalEntries, 0);
+  });
+
+  await rm(tmpDir, { recursive: true, force: true });
+});
+
+test('Ingestion Worker: trust tiers, deduplication, and extraction', async (t) => {
+  const tmpDir = await mkdtemp(path.join(os.tmpdir(), 'kiku-ingest-test-'));
+  const catalogPath = path.join(tmpDir, 'dynamic-catalog.json');
+
+  await t.test('isTrustedSource classifies official platforms and press', () => {
+    const douyin = isTrustedSource('douyin');
+    assert.equal(douyin.trusted, true);
+    assert.equal(douyin.tier, 1);
+
+    const weiboUrl = isTrustedSource('https://weibo.com/u/123456');
+    assert.equal(weiboUrl.trusted, true);
+    assert.equal(weiboUrl.tier, 1);
+
+    const press = isTrustedSource('https://www.sohu.com/a/123456');
+    assert.equal(press.trusted, true);
+    assert.equal(press.tier, 2);
+
+    const community = isTrustedSource('https://randomblog.com/post/123');
+    assert.equal(community.trusted, false);
+    assert.equal(community.tier, 3);
+  });
+
+  await t.test('isDuplicateEvent detects identical and near-duplicate entries via SimHash', () => {
+    const existing = [
+      {
+        id: 'item-1',
+        brand: 'Lafang',
+        year: 2026,
+        highlight: 'จวีจิ้งอี ไลฟ์สดแบรนด์ Lafang บน Douyin'
+      }
+    ];
+
+    const exactMatch = { brand: 'Lafang', year: 2026 };
+    assert.equal(isDuplicateEvent(exactMatch, existing), true);
+
+    const simHashMatch = {
+      brand: 'Other',
+      year: 2026,
+      highlight: 'จวีจิ้งอี ไลฟ์สดแบรนด์ Lafang บน Douyin ในลุคนางฟ้า'
+    };
+    assert.equal(isDuplicateEvent(simHashMatch, existing), true);
+
+    const different = {
+      brand: 'FRED Paris',
+      year: 2024,
+      highlight: 'เครื่องประดับชั้นสูงจากฝรั่งเศส'
+    };
+    assert.equal(isDuplicateEvent(different, existing), false);
+  });
+
+  await t.test('extractStructuredEvent correctly parses Thai date and brand entity', async () => {
+    const sample = 'คืนวันที่ 12 กันยายน จวีจิ้งอี ไลฟ์สดงานแบรนด์ Lafang (拉芳) บนแพลตฟอร์ม Douyin ด้วยลุคนางฟ้าดอกไม้';
+    const res = await extractStructuredEvent(sample);
+
+    assert.equal(res.category, 'brands');
+    assert.equal(res.year, 2026);
+    assert.equal(res.date, '2026-09-12');
+    assert.equal(res.brand, 'Lafang');
+    assert.equal(res.brandNameCn, '拉芳');
+  });
+
+  await t.test('ingestRawEvent rejects untrusted source and ingests trusted source', async () => {
+    const text = 'จวีจิ้งอี ร่วมงานอีเวนต์พิเศษ';
+
+
+    const rejected = await ingestRawEvent(text, {
+      source: 'https://unverified-blog.org',
+      catalogPath
+    });
+    assert.equal(rejected.status, 'rejected');
+
+    const success = await ingestRawEvent(text, {
+      source: 'douyin',
+      catalogPath
+    });
+    assert.equal(success.status, 'success');
+
+   
+    const dup = await ingestRawEvent(text, {
+      source: 'douyin',
+      catalogPath
+    });
+    assert.equal(dup.status, 'duplicate');
+  });
+
+  await t.test('runIngestionScan scans and ingests verified candidates', async () => {
+    const mockFetcher = async () => [
+      {
+        title: 'Ju Jingyi attends Luxury Gala',
+        snippet: 'Official appearance at annual fashion gala',
+        url: 'https://weibo.com/detail/999'
+      },
+      {
+        title: 'Ju Jingyi fan forum post',
+        snippet: 'Unverified rumor from forum',
+        url: 'https://randomforum.xyz/topic/1'
+      }
+    ];
+
+    const result = await runIngestionScan({
+      fetcher: mockFetcher,
+      catalogPath,
+      minTrustTier: 2
+    });
+
+    assert.equal(result.totalScanned, 2);
+    assert.equal(result.ingestedCount, 1);
+    assert.equal(result.skippedUntrusted, 1);
+  });
+
+  await rm(tmpDir, { recursive: true, force: true });
+});
+
+test('Core Tools: Dynamic Catalog Overlay integration and record_dynamic_event tool', async () => {
+ 
+  clearDynamicCatalog();
+
+ 
+  const recordRes = await executeTool('record_dynamic_event', {
+    category: 'brands',
+    entry: {
+      brand: 'TestDynamicBrand',
+      brandNameEn: 'TestDynamicBrand',
+      brandNameCn: '测试品牌',
+      year: 2026,
+      category: 'beauty',
+      highlight: 'Special Dynamic Brand Ambassador'
+    },
+    source: 'weibo',
+    trustTier: 1
+  });
+
+  assert.equal(recordRes.status, 'success');
+  assert.equal(recordRes.entry.brand, 'TestDynamicBrand');
+
+ 
+  const brandsRes = await executeTool('get_brand_endorsements', { query: 'TestDynamicBrand' });
+  assert.equal(brandsRes.status, 'success');
+  assert.ok(brandsRes.brands.some(b => b.brand.includes('TestDynamicBrand')));
+
+
+  await executeTool('record_dynamic_event', {
+    category: 'timeline',
+    entry: {
+      title: 'Dynamic Milestone 2026',
+      titleCn: '动态里程碑',
+      year: 2026,
+      summary: 'Special dynamic timeline entry test'
+    }
+  });
+
+  const timelineRes = await executeTool('get_career_timeline', { year: 2026 });
+  assert.equal(timelineRes.status, 'success');
+  assert.ok(timelineRes.milestones.some(m => m.title.includes('Dynamic Milestone 2026')));
+
+
+  await executeTool('record_dynamic_event', {
+    category: 'gallery',
+    entry: {
+      titleTh: 'ภาพพิเศษ 2026',
+      titleCn: '动态写真',
+      category: 'fashion',
+      year: 2026,
+      image: 'https://example.com/dynamic-photo.jpg'
+    }
+  });
+
+  const galleryRes = await executeTool('get_gallery_photos', { year: 2026 });
+  assert.equal(galleryRes.status, 'success');
+  assert.ok(galleryRes.photos.some(p => p.title.includes('ภาพพิเศษ 2026')));
+
+ 
+  clearDynamicCatalog();
+});
+
+test('CLI: /ingest routeCommand handles status, add, and clear', async () => {
+  clearDynamicCatalog();
+
+  const statusRes = await routeCommand('/ingest status', {});
+  assert.equal(statusRes, 'HANDLED');
+
+  const addRes = await routeCommand('/ingest add จวีจิ้งอี ไลฟ์สดงานแบรนด์ Lafang บน Douyin', {});
+  assert.equal(addRes, 'HANDLED');
+
+  const stats = getDynamicCatalogStats();
+  assert.ok(stats.totalEntries >= 1);
+
+  const clearRes = await routeCommand('/ingest clear', {});
+  assert.equal(clearRes, 'HANDLED');
+
+  const statsCleared = getDynamicCatalogStats();
+  assert.equal(statsCleared.totalEntries, 0);
+});

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

@@ -0,0 +1,92 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveQueryEntities, getContextualizedSearchQuery, detectPlatforms, detectPromotionIntent } from '../catalogEntityResolver.js';
+import { DynamicToolRouter } from '../toolRouter.js';
+import { createCatalogMatcher, executeTool } from '../tools.js';
+
+test('catalogEntityResolver resolves entities across languages without rigid keywords', () => {
+  const prsrQuery = 'ค้นหาการโปรโมท PRSR บน bilibili';
+  const prsrRes = resolveQueryEntities(prsrQuery);
+
+  assert.equal(prsrRes.hasBrand, true);
+  assert.ok(prsrRes.primaryBrand);
+  assert.equal(prsrRes.primaryBrand.id, 'prsr');
+  assert.ok(prsrRes.platforms.includes('bilibili'));
+  assert.equal(prsrRes.isPromotion, true);
+  assert.ok(prsrRes.contextualChineseKeywords.includes('帕莎眼镜'));
+
+  const pashaQuery = 'ดูคลิปโฆษณา pasha ใน b站';
+  const pashaRes = resolveQueryEntities(pashaQuery);
+  assert.equal(pashaRes.hasBrand, true);
+  assert.equal(pashaRes.primaryBrand.id, 'prsr');
+  assert.ok(pashaRes.platforms.includes('bilibili'));
+
+  const qixingcaiQuery = 'ผลงานชีซิงไฉ่';
+  const qixingcaiRes = resolveQueryEntities(qixingcaiQuery);
+  assert.equal(qixingcaiRes.hasWork, true);
+  assert.equal(qixingcaiRes.primaryWork.nameCn, '七星彩');
+
+  const inBlossomQuery = 'เพลงประกอบฮวาเจียนลิ่ง';
+  const inBlossomRes = resolveQueryEntities(inBlossomQuery);
+  assert.equal(inBlossomRes.hasWork, true);
+  assert.equal(inBlossomRes.primaryWork.nameCn, '花间令');
+});
+
+test('getContextualizedSearchQuery enriches Chinese queries with artist and brand aliases', () => {
+  const biliPrsr = getContextualizedSearchQuery('PRSR', 'bilibili');
+  assert.ok(biliPrsr.includes('鞠婧祎'), 'Must include artist name in Chinese');
+  assert.ok(biliPrsr.includes('帕莎'), 'Must include Chinese brand name');
+
+  const biliPrompt = getContextualizedSearchQuery('ค้นหาการโปรโมท PRSR บน bilibili', 'bilibili');
+  assert.ok(biliPrompt.includes('鞠婧祎'));
+  assert.ok(biliPrompt.includes('帕莎'));
+  assert.ok(biliPrompt.includes('PRSR'));
+
+  const dramaQuery = getContextualizedSearchQuery('In Blossom', 'bilibili');
+  assert.ok(dramaQuery.includes('鞠婧祎'));
+  assert.ok(dramaQuery.includes('花间令'));
+});
+
+test('DynamicToolRouter routes brand and media tools simultaneously on cross-cutting queries', () => {
+  const router = new DynamicToolRouter();
+
+  const routed = router.routeToolsForQuery('ค้นหาการโปรโมท PRSR บน bilibili');
+  const toolNames = new Set(routed.map(t => t.function.name));
+
+  assert.ok(toolNames.has('get_brand_endorsements'), 'Must include get_brand_endorsements');
+  assert.ok(toolNames.has('search_bilibili'), 'Must include search_bilibili');
+  assert.ok(toolNames.has('get_media_links'), 'Must include get_media_links');
+  assert.ok(routed.length <= 15);
+
+  const fallback = router.routeToolsForQuery('สวัสดีครับ');
+  assert.ok(fallback.length <= 10, 'Fallback tools must not exceed 10');
+  assert.ok(fallback.some(t => t.function.name === 'global_search'));
+  assert.ok(fallback.some(t => t.function.name === 'get_brand_endorsements'));
+});
+
+test('createCatalogMatcher handles promotional query framing without token ratio penalty', () => {
+  const matcher = createCatalogMatcher('ค้นหาการโปรโมท PRSR บน bilibili');
+  assert.equal(matcher('PRSR / Pasha', '帕莎眼镜', 'Global Brand Ambassador'), true);
+
+  const yunxiMatcher = createCatalogMatcher('เพลง Ost Ju Jingyi 2024 Yunxi');
+  assert.equal(yunxiMatcher('ตำนานหยุนซี Legend of Yunxi', 'Yunxi'), true);
+});
+
+test('get_brand_endorsements tool returns bilibiliSearchUrl and handles query filter', async () => {
+  const res = await executeTool('get_brand_endorsements', { query: 'PRSR' });
+  assert.equal(res.status, 'success');
+  assert.ok(res.count >= 1);
+  const prsr = res.brands[0];
+  assert.ok(prsr.brand.includes('PRSR') || prsr.brand.includes('Pasha'));
+  assert.ok(prsr.bilibiliSearchUrl, 'Must include bilibiliSearchUrl');
+  assert.ok(prsr.bilibiliSearchUrl.includes('search.bilibili.com'));
+  assert.ok(prsr.bilibiliSearchUrl.includes(encodeURIComponent('鞠婧祎')));
+});
+
+test('get_media_links tool searches brand commercial links alongside works and music', async () => {
+  const res = await executeTool('get_media_links', { query: 'PRSR' });
+  assert.equal(res.status, 'success');
+  assert.ok(res.results.brands.length >= 1, 'Should find PRSR in brand media results');
+  assert.ok(res.results.brands[0].bilibiliSearchUrl);
+  assert.ok(res.results.brands[0].youtubeCommercialSearch);
+});

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

@@ -0,0 +1,49 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { sanitizeQuery } from '../sanitizer.js';
+import { DynamicToolRouter } from '../toolRouter.js';
+import { executeTool } from '../tools.js';
+import { ContextCompactor } from '../contextCompactor.js';
+
+test('Edge Cases Suite: Sanitizer handles empty, whitespace, and extreme length strings gracefully', () => {
+  const emptyRes = sanitizeQuery('');
+  assert.equal(emptyRes.sanitized, '');
+
+  const spaceRes = sanitizeQuery('   \t\n  ');
+  assert.equal(spaceRes.sanitized, '');
+
+  const longText = 'A'.repeat(40000);
+  const longRes = sanitizeQuery(longText);
+  assert.ok(longRes.sanitized.length <= 32768);
+});
+
+test('Edge Cases Suite: DynamicToolRouter returns safe fallback when given empty or strange inputs', () => {
+  const router = new DynamicToolRouter();
+  const nullRouted = router.routeToolsForQuery(null);
+  assert.ok(nullRouted.length > 0);
+
+  const emptyRouted = router.routeToolsForQuery('');
+  assert.ok(emptyRouted.length > 0);
+
+  const weirdRouted = router.routeToolsForQuery('!@#$%^&*()_+~`|}{[]:;?><,./');
+  assert.ok(weirdRouted.length > 0);
+});
+
+test('Edge Cases Suite: Catalog tools return not_found status instead of throwing on unknown records', async () => {
+  const notFoundWork = await executeTool('search_works', { query: 'non_existent_drama_xyz_99999' });
+  assert.equal(notFoundWork.status, 'not_found');
+  assert.equal(notFoundWork.count, 0);
+
+  const notFoundSong = await executeTool('search_discography', { query: 'non_existent_song_xyz_99999' });
+  assert.equal(notFoundSong.status, 'not_found');
+  assert.equal(notFoundSong.count, 0);
+});
+
+test('Edge Cases Suite: ContextCompactor handles empty, malformed, or oversized history arrays', () => {
+  const compactor = new ContextCompactor({ maxTokens: 100, keepRecentMessages: 2 });
+  assert.deepEqual(compactor.compact([]), []);
+  assert.deepEqual(compactor.compact(null), null);
+
+  const singleMsg = [{ role: 'user', content: 'Hello' }];
+  assert.deepEqual(compactor.compact(singleMsg), singleMsg);
+});