Upload 23 files

.gitignore

@@ -0,0 +1,143 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp directory
+.temp
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# pnpm
+.pnpm-store
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/

adapters/adapter-registry.js

@@ -0,0 +1,59 @@
+// ============================================================
+// Adapter Registry — Metadata, display names, và đăng ký adapter
+// Phụ thuộc: currentLang, ADAPTER_REGISTRY (từ data-loader.js / globalThis),
+//            bestMatchAdapter, logicAdapterDispatcher, mathematicalEvaluationAdapter,
+//            specificResponseAdapter, timeAdapter, unitConversionAdapter
+// ============================================================
+
+var ADAPTER_DISPLAY_NAMES = {
+    specific_response: { vi: 'Phản hồi cụ thể', en: 'Specific Response', ja: '特定応答' },
+    time_adapter: { vi: 'Thời gian', en: 'Time', ja: '時間' },
+    mathematical_evaluation: { vi: 'Tính toán', en: 'Math', ja: '数学計算' },
+    unit_conversion: { vi: 'Chuyển đổi đơn vị', en: 'Unit Conversion', ja: '単位変換' },
+    best_match: { vi: 'Best Match', en: 'Best Match', ja: 'ベストマッチ' },
+    logic_adapter: { vi: 'Logic Adapter', en: 'Logic Adapter', ja: 'ロジックアダプター' },
+    rivescript: { vi: 'RiveScript', en: 'RiveScript', ja: 'RiveScript' },
+    fallback_api: { vi: 'Fallback API', en: 'Fallback API', ja: 'Fallback API' },
+    web_search: { vi: 'Tìm kiếm Web', en: 'Web Search', ja: 'ウェブ検索' }
+};
+
+function getAdapterDisplayName(adapterKey) {
+    var lang = currentLang || 'vi';
+    var names = ADAPTER_DISPLAY_NAMES[adapterKey];
+    if (!names) return adapterKey;
+    return names[lang] || names['vi'] || adapterKey;
+}
+
+function registerAdapters(bot, lang) {
+    var ADAPTER_FUNCTIONS = {
+        best_match: bestMatchAdapter,
+        logic_adapter: logicAdapterDispatcher,
+        mathematical_evaluation: mathematicalEvaluationAdapter,
+        specific_response: specificResponseAdapter,
+        time_adapter: timeAdapter,
+        unit_conversion: unitConversionAdapter,
+        web_search: webSearchAdapter
+    };
+
+    var adapterNames = Object.keys(ADAPTER_REGISTRY);
+    for (var i = 0; i < adapterNames.length; i++) {
+        var name = adapterNames[i];
+        var entry = ADAPTER_REGISTRY[name];
+        var fn = ADAPTER_FUNCTIONS[name];
+
+        if (entry.active && typeof fn === 'function') {
+            (function (adapterFn) {
+                bot.setSubroutine(name, function (rs, args) {
+                    return adapterFn(rs, args);
+                });
+            })(fn);
+        }
+    }
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.ADAPTER_DISPLAY_NAMES = ADAPTER_DISPLAY_NAMES;
+    globalThis.getAdapterDisplayName = getAdapterDisplayName;
+    globalThis.registerAdapters = registerAdapters;
+}

adapters/best-match.js

@@ -0,0 +1,58 @@
+// ============================================================
+// Best Match Adapter — So khớp tương đồng chuỗi với tập Q&A
+// Phụ thuộc: currentLang, _adapterPath, textSimilarity, removeVietnameseDiacritics,
+//            QA_DATASET, findBestMatchPreprocessed (optional)
+// ============================================================
+
+function bestMatchAdapter(rs, args) {
+    _adapterPath.push('best_match');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+    var threshold = 0.3;
+
+    if (input.length === 0) {
+        if (lang === 'en') return 'Please provide a question to search for.';
+        if (lang === 'ja') return '検索する質問を入力してください。';
+        return 'Vui lòng nhập câu hỏi để tìm kiếm.';
+    }
+
+    // Thử dùng preprocessed data trước (nhanh hơn)
+    if (typeof findBestMatchPreprocessed === 'function') {
+        var ppResult = findBestMatchPreprocessed(input, lang, threshold);
+        if (ppResult) return ppResult.answer;
+    }
+
+    // Fallback: tính similarity thủ công từ QA_DATASET
+    var dataset = QA_DATASET[lang] || QA_DATASET['vi'];
+    var bestScore = -1;
+    var bestAnswer = '';
+
+    var inputLower = input.toLowerCase();
+    var inputNorm = (lang === 'vi' && typeof removeVietnameseDiacritics === 'function')
+        ? removeVietnameseDiacritics(inputLower) : null;
+
+    for (var i = 0; i < dataset.length; i++) {
+        var qLower = dataset[i].q.toLowerCase();
+        var score = textSimilarity(inputLower, qLower);
+        if (inputNorm) {
+            var qNorm = removeVietnameseDiacritics(qLower);
+            var scoreNorm = textSimilarity(inputNorm, qNorm);
+            if (scoreNorm > score) score = scoreNorm;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestAnswer = dataset[i].a;
+        }
+    }
+
+    if (bestScore >= threshold) return bestAnswer;
+
+    if (lang === 'en') return 'Sorry, I could not find a suitable answer for your question.';
+    if (lang === 'ja') return '申し訳ありませんが、ご質問に適した回答が見つかりませんでした。';
+    return 'Xin lỗi, mình không tìm được câu trả lời phù hợp cho câu hỏi của bạn.';
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.bestMatchAdapter = bestMatchAdapter;
+}

adapters/logic-dispatcher.js

@@ -0,0 +1,59 @@
+// ============================================================
+// Logic Adapter Dispatcher — Điều phối các adapter con theo ưu tiên
+// Phụ thuộc: currentLang, _adapterPath, specificResponseAdapter, timeAdapter,
+//            mathematicalEvaluationAdapter, unitConversionAdapter, bestMatchAdapter
+// ============================================================
+
+var INVALID_RESPONSE_PHRASES = [
+    'không có phản hồi cụ thể', 'không hiểu', 'không thể', 'không tìm thấy',
+    'không tìm được', 'cú pháp không hợp lệ',
+    'no specific response', "don't understand", 'cannot', 'not found',
+    'invalid syntax', 'could not find',
+    '特定の応答はありません', '理解できません', 'できません', '見つかりません',
+    '構文が無効', '見つかりませんでした'
+];
+
+function isValidAdapterResult(result) {
+    if (typeof result !== 'string' || result.trim().length === 0) return false;
+    var lower = result.toLowerCase();
+    for (var i = 0; i < INVALID_RESPONSE_PHRASES.length; i++) {
+        if (lower.indexOf(INVALID_RESPONSE_PHRASES[i].toLowerCase()) !== -1) return false;
+    }
+    return true;
+}
+
+function logicAdapterDispatcher(rs, args) {
+    _adapterPath.push('logic_adapter');
+    var adapters = [
+        specificResponseAdapter,
+        timeAdapter,
+        mathematicalEvaluationAdapter,
+        unitConversionAdapter,
+        bestMatchAdapter
+    ];
+
+    var pathLenBefore = _adapterPath.length;
+
+    for (var i = 0; i < adapters.length; i++) {
+        try {
+            _adapterPath.length = pathLenBefore;
+            var result = adapters[i](rs, args);
+            if (isValidAdapterResult(result)) return result;
+        } catch (err) {
+            continue;
+        }
+    }
+
+    _adapterPath.length = pathLenBefore;
+    var lang = currentLang || 'vi';
+    if (lang === 'en') return 'Sorry, I cannot process your request at this time.';
+    if (lang === 'ja') return '申し訳ありませんが、現在リクエストを処理できません。';
+    return 'Xin lỗi, mình không thể xử lý yêu cầu của bạn lúc này.';
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.INVALID_RESPONSE_PHRASES = INVALID_RESPONSE_PHRASES;
+    globalThis.isValidAdapterResult = isValidAdapterResult;
+    globalThis.logicAdapterDispatcher = logicAdapterDispatcher;
+}

adapters/math-adapter.js

@@ -0,0 +1,77 @@
+// ============================================================
+// Mathematical Evaluation Adapter — Tính toán biểu thức toán học
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+/**
+ * Trích xuất và tính toán biểu thức toán học từ chuỗi đầu vào.
+ * Không sử dụng eval() — dùng regex + switch/case.
+ */
+function parseMathExpression(input, lang) {
+    if (typeof input !== 'string' || input.trim().length === 0) {
+        return { error: lang === 'en' ? 'Invalid expression.' : lang === 'ja' ? '無効な式です。' : 'Biểu thức không hợp lệ.' };
+    }
+
+    var expr = input.trim();
+    if (lang !== 'ja') expr = expr.toLowerCase();
+
+    if (lang === 'vi') {
+        expr = expr.replace(/cộng/g, '+').replace(/trừ/g, '-').replace(/nhân/g, '*').replace(/chia/g, '/');
+    } else if (lang === 'en') {
+        expr = expr.replace(/divided\s+by/g, '/').replace(/plus/g, '+').replace(/minus/g, '-').replace(/times/g, '*');
+    } else if (lang === 'ja') {
+        expr = expr.replace(/足す/g, '+').replace(/引く/g, '-').replace(/掛ける/g, '*').replace(/割る/g, '/');
+    }
+
+    expr = expr.replace(/×/g, '*').replace(/÷/g, '/');
+
+    var match = expr.match(/(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)/);
+    if (!match) {
+        return { error: lang === 'en' ? 'Cannot parse the mathematical expression.' : lang === 'ja' ? '数式を解析できませんでした。' : 'Không thể phân tích biểu thức toán học.' };
+    }
+
+    var a = parseFloat(match[1]);
+    var operator = match[2];
+    var b = parseFloat(match[3]);
+    var result;
+
+    switch (operator) {
+        case '+': result = a + b; break;
+        case '-': result = a - b; break;
+        case '*': result = a * b; break;
+        case '/':
+            if (b === 0) return { error: lang === 'en' ? 'Cannot divide by zero.' : lang === 'ja' ? 'ゼロで割ることはできません。' : 'Không thể chia cho 0.' };
+            result = a / b; break;
+        default:
+            return { error: lang === 'en' ? 'Unsupported operator.' : lang === 'ja' ? 'サポートされていない演算子です。' : 'Phép tính không được hỗ trợ.' };
+    }
+
+    return { result: result };
+}
+
+function mathematicalEvaluationAdapter(rs, args) {
+    _adapterPath.push('mathematical_evaluation');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (input.length === 0) {
+        return lang === 'en' ? 'Please provide a mathematical expression.'
+            : lang === 'ja' ? '数式を入力してください。'
+            : 'Vui lòng nhập biểu thức toán học.';
+    }
+
+    var parsed = parseMathExpression(input, lang);
+    if (parsed.error) return parsed.error;
+
+    var resultStr = Number.isInteger(parsed.result) ? String(parsed.result) : parsed.result.toFixed(2).replace(/\.?0+$/, '');
+
+    if (lang === 'en') return 'Result: ' + resultStr;
+    if (lang === 'ja') return '結果: ' + resultStr;
+    return 'Kết quả: ' + resultStr;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.parseMathExpression = parseMathExpression;
+    globalThis.mathematicalEvaluationAdapter = mathematicalEvaluationAdapter;
+}

adapters/specific-response.js

@@ -0,0 +1,53 @@
+// ============================================================
+// Specific Response Adapter — Phản hồi exact match từ bảng ánh xạ
+// Phụ thuộc: currentLang, _adapterPath, removeVietnameseDiacritics, SPECIFIC_RESPONSES
+// ============================================================
+
+/**
+ * Specific Response Adapter — Object Macro trả về phản hồi exact match.
+ * So khớp case-insensitive, hỗ trợ diacritics-stripped match cho tiếng Việt.
+ *
+ * @param {object} rs - RiveScript instance
+ * @param {string[]} args - Mảng các từ từ thẻ <call>
+ * @returns {string} Câu trả lời tương ứng hoặc thông báo "không có phản hồi cụ thể"
+ */
+function specificResponseAdapter(rs, args) {
+    _adapterPath.push('specific_response');
+    var input = (args || []).join(' ').trim().toLowerCase();
+
+    if (input.length === 0) {
+        return currentLang === 'en'
+            ? 'No specific response for this question.'
+            : currentLang === 'ja'
+                ? 'この質問に対する特定の応答はありません。'
+                : 'Không có phản hồi cụ thể cho câu hỏi này.';
+    }
+
+    var responses = SPECIFIC_RESPONSES[currentLang] || SPECIFIC_RESPONSES['vi'];
+
+    // Thử exact match trước
+    var keys = Object.keys(responses);
+    for (var i = 0; i < keys.length; i++) {
+        if (keys[i].toLowerCase() === input) {
+            return responses[keys[i]];
+        }
+    }
+    // Thử match sau khi bỏ dấu (chỉ tiếng Việt)
+    if (currentLang === 'vi') {
+        var inputNoDiacritics = removeVietnameseDiacritics(input);
+        for (var j = 0; j < keys.length; j++) {
+            if (removeVietnameseDiacritics(keys[j].toLowerCase()) === inputNoDiacritics) {
+                return responses[keys[j]];
+            }
+        }
+    }
+
+    if (currentLang === 'en') return 'No specific response for this question.';
+    if (currentLang === 'ja') return 'この質問に対する特定の応答はありません。';
+    return 'Không có phản hồi cụ thể cho câu hỏi này.';
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.specificResponseAdapter = specificResponseAdapter;
+}

adapters/text-similarity.js

@@ -0,0 +1,427 @@
+// ============================================================
+// Text Similarity — Thuật toán so khớp chuỗi
+// Gồm 4 thuật toán: Levenshtein, Jaccard, Cosine, Synset
+// + Preprocessed data support (TF-IDF, pre-tokenized)
+// ============================================================
+
+// --- Preprocessed data cache ---
+// Loaded from data/preprocessed.json (build-time) hoặc localStorage (client)
+var _preprocessedData = null;
+var _PREPROCESSED_STORAGE_KEY = 'hikari_preprocessed';
+
+/**
+ * Load preprocessed data.
+ * - Browser: thử localStorage trước, nếu không có hoặc outdated thì fetch từ server
+ * - Node/test: load trực tiếp từ file
+ * @returns {Promise<void>}
+ */
+async function loadPreprocessedData() {
+    // Node/test environment
+    if (typeof module !== 'undefined' && module.exports) {
+        try {
+            var fs = require('fs');
+            var path = require('path');
+            var filePath = path.join(__dirname, '..', 'data', 'preprocessed.json');
+            _preprocessedData = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        } catch (e) {
+            _preprocessedData = null;
+        }
+        return;
+    }
+
+    // Browser: thử localStorage
+    try {
+        var cached = localStorage.getItem(_PREPROCESSED_STORAGE_KEY);
+        if (cached) {
+            var parsed = JSON.parse(cached);
+            // Fetch version từ server để check outdated
+            var resp = await fetch('data/preprocessed.json', { method: 'HEAD' });
+            // Dùng Last-Modified hoặc so sánh version
+            if (parsed && parsed.version) {
+                _preprocessedData = parsed;
+                // Background check: fetch full file và so sánh version
+                fetch('data/preprocessed.json').then(function(r) { return r.json(); }).then(function(fresh) {
+                    if (fresh.version !== parsed.version) {
+                        _preprocessedData = fresh;
+                        localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(fresh));
+                    }
+                }).catch(function() {});
+                return;
+            }
+        }
+    } catch (e) { /* localStorage not available */ }
+
+    // Browser: fetch từ server
+    try {
+        var response = await fetch('data/preprocessed.json');
+        if (response.ok) {
+            _preprocessedData = await response.json();
+            try {
+                localStorage.setItem(_PREPROCESSED_STORAGE_KEY, JSON.stringify(_preprocessedData));
+            } catch (e) { /* quota exceeded */ }
+        }
+    } catch (e) {
+        _preprocessedData = null;
+    }
+}
+
+/**
+ * Lấy preprocessed data cho ngôn ngữ hiện tại.
+ * @param {string} lang
+ * @returns {object|null} { idf, statements } hoặc null
+ */
+function getPreprocessedLang(lang) {
+    if (!_preprocessedData || !_preprocessedData.langs) return null;
+    return _preprocessedData.langs[lang] || null;
+}
+
+// ---- Tokenize (dùng cho input mới) ----
+
+/**
+ * Tokenize input text: lowercase, bỏ dấu (vi), bỏ punctuation, tách từ.
+ * Dùng cùng logic với scripts/preprocess.js để đảm bảo consistency.
+ * @param {string} text
+ * @param {string} lang
+ * @returns {string[]}
+ */
+function tokenizeForSimilarity(text, lang) {
+    var s = String(text).toLowerCase();
+    if (lang === 'vi' && typeof removeVietnameseDiacritics === 'function') {
+        s = removeVietnameseDiacritics(s);
+    }
+    s = s.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
+    return s.split(/\s+/).filter(function(w) { return w.length > 0; });
+}
+
+// ---- 1. Levenshtein Distance ----
+
+function levenshteinDistance(a, b) {
+    var strA = String(a);
+    var strB = String(b);
+    var lenA = strA.length;
+    var lenB = strB.length;
+
+    if (lenA === 0) return lenB;
+    if (lenB === 0) return lenA;
+
+    var prev = [];
+    var curr = [];
+    var i, j;
+
+    for (j = 0; j <= lenB; j++) prev[j] = j;
+
+    for (i = 1; i <= lenA; i++) {
+        curr[0] = i;
+        for (j = 1; j <= lenB; j++) {
+            if (strA[i - 1] === strB[j - 1]) {
+                curr[j] = prev[j - 1];
+            } else {
+                curr[j] = 1 + Math.min(prev[j - 1], prev[j], curr[j - 1]);
+            }
+        }
+        var tmp = prev;
+        prev = curr;
+        curr = tmp;
+    }
+    return prev[lenB];
+}
+
+// ---- 2. Jaccard Similarity ----
+
+function jaccardSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 && wordsB.length === 0) return 0;
+
+    var setA = {}, setB = {}, i;
+    for (i = 0; i < wordsA.length; i++) setA[wordsA[i]] = true;
+    for (i = 0; i < wordsB.length; i++) setB[wordsB[i]] = true;
+
+    var intersection = 0, union = {};
+    for (var k1 in setA) { union[k1] = true; if (setB[k1]) intersection++; }
+    for (var k2 in setB) { union[k2] = true; }
+
+    var unionSize = Object.keys(union).length;
+    return unionSize === 0 ? 0 : intersection / unionSize;
+}
+
+// ---- 3. Cosine Similarity ----
+
+function cosineSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 || wordsB.length === 0) return 0;
+
+    var tfA = {}, tfB = {}, i;
+    for (i = 0; i < wordsA.length; i++) tfA[wordsA[i]] = (tfA[wordsA[i]] || 0) + 1;
+    for (i = 0; i < wordsB.length; i++) tfB[wordsB[i]] = (tfB[wordsB[i]] || 0) + 1;
+
+    var vocab = {};
+    for (var ka in tfA) vocab[ka] = true;
+    for (var kb in tfB) vocab[kb] = true;
+
+    var dot = 0, magA = 0, magB = 0;
+    var keys = Object.keys(vocab);
+    for (i = 0; i < keys.length; i++) {
+        var va = tfA[keys[i]] || 0;
+        var vb = tfB[keys[i]] || 0;
+        dot += va * vb;
+        magA += va * va;
+        magB += vb * vb;
+    }
+
+    magA = Math.sqrt(magA);
+    magB = Math.sqrt(magB);
+    return (magA === 0 || magB === 0) ? 0 : dot / (magA * magB);
+}
+
+/**
+ * Cosine similarity sử dụng TF-IDF vectors (preprocessed).
+ * Input vector được tính on-the-fly, corpus vector đã preprocessed.
+ * @param {object} inputTFIDF - TF-IDF vector của input
+ * @param {number} inputMag - Magnitude của input vector
+ * @param {object} corpusTFIDF - TF-IDF vector đã preprocessed
+ * @param {number} corpusMag - Magnitude đã preprocessed
+ * @returns {number} [0, 1]
+ */
+function cosineSimilarityTFIDF(inputTFIDF, inputMag, corpusTFIDF, corpusMag) {
+    if (inputMag === 0 || corpusMag === 0) return 0;
+
+    var dot = 0;
+    // Iterate over smaller vector for efficiency
+    for (var word in inputTFIDF) {
+        if (corpusTFIDF[word]) {
+            dot += inputTFIDF[word] * corpusTFIDF[word];
+        }
+    }
+    return dot / (inputMag * corpusMag);
+}
+
+// ---- 4. Synset Similarity ----
+
+var SYNONYM_GROUPS = [
+    ['xin chao','chao','hi','hello','hey','yo'],
+    ['tam biet','bye','goodbye','hen gap lai','tot lanh'],
+    ['cam on','thanks','thank','thank you'],
+    ['ten','name','ai','who','la ai'],
+    ['lam gi','lam duoc','co the','giup','help','what can'],
+    ['may gio','gio','time','clock','bao gio'],
+    ['ngay','hom nay','date','today','ngay may'],
+    ['thu','thu may','day','what day'],
+    ['tinh','calculate','math','cong','tru','nhan','chia','plus','minus'],
+    ['doi','convert','sang','to','chuyen doi'],
+    ['chatbot','bot','ai','robot','may','machine'],
+    ['la gi','what is','what','gi','mean'],
+    ['khoe','vui','happy','fine','good','ok'],
+    ['tuoi','age','old','bao nhieu tuoi'],
+    ['o dau','where','dau','location'],
+    ['thich','like','love','yeu'],
+    ['huong dan','cach','how','guide','help','su dung','use']
+];
+
+var _synonymLookup = null;
+function _getSynonymLookup() {
+    if (_synonymLookup) return _synonymLookup;
+    _synonymLookup = {};
+    for (var g = 0; g < SYNONYM_GROUPS.length; g++) {
+        for (var w = 0; w < SYNONYM_GROUPS[g].length; w++) {
+            var word = SYNONYM_GROUPS[g][w].toLowerCase();
+            if (!_synonymLookup[word]) _synonymLookup[word] = [];
+            _synonymLookup[word].push(g);
+        }
+    }
+    return _synonymLookup;
+}
+
+function areSynonyms(wordA, wordB) {
+    if (wordA === wordB) return true;
+    var lookup = _getSynonymLookup();
+    var groupsA = lookup[wordA];
+    var groupsB = lookup[wordB];
+    if (!groupsA || !groupsB) return false;
+    for (var i = 0; i < groupsA.length; i++) {
+        for (var j = 0; j < groupsB.length; j++) {
+            if (groupsA[i] === groupsB[j]) return true;
+        }
+    }
+    return false;
+}
+
+function synsetSimilarity(a, b) {
+    var wordsA = String(a).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+    var wordsB = String(b).toLowerCase().trim().split(/\s+/).filter(function(w) { return w.length > 0; });
+
+    if (wordsA.length === 0 || wordsB.length === 0) return 0;
+
+    var matchAtoB = 0;
+    for (var i = 0; i < wordsA.length; i++) {
+        for (var j = 0; j < wordsB.length; j++) {
+            if (areSynonyms(wordsA[i], wordsB[j])) { matchAtoB++; break; }
+        }
+    }
+    var matchBtoA = 0;
+    for (var m = 0; m < wordsB.length; m++) {
+        for (var n = 0; n < wordsA.length; n++) {
+            if (areSynonyms(wordsB[m], wordsA[n])) { matchBtoA++; break; }
+        }
+    }
+
+    return ((matchAtoB / wordsA.length) + (matchBtoA / wordsB.length)) / 2;
+}
+
+/**
+ * Synset similarity sử dụng preprocessed synonym group indices.
+ * So sánh overlap giữa synGroups của input và corpus statement.
+ * @param {number[]} inputGroups - Synonym group indices của input
+ * @param {number[]} corpusGroups - Synonym group indices đã preprocessed
+ * @returns {number} [0, 1]
+ */
+function synsetSimilarityPreprocessed(inputGroups, corpusGroups) {
+    if (inputGroups.length === 0 && corpusGroups.length === 0) return 0;
+    if (inputGroups.length === 0 || corpusGroups.length === 0) return 0;
+
+    var setB = {};
+    for (var j = 0; j < corpusGroups.length; j++) setB[corpusGroups[j]] = true;
+
+    var overlap = 0;
+    for (var i = 0; i < inputGroups.length; i++) {
+        if (setB[inputGroups[i]]) overlap++;
+    }
+
+    var total = {};
+    for (var a = 0; a < inputGroups.length; a++) total[inputGroups[a]] = true;
+    for (var b = 0; b < corpusGroups.length; b++) total[corpusGroups[b]] = true;
+    var unionSize = Object.keys(total).length;
+
+    return unionSize === 0 ? 0 : overlap / unionSize;
+}
+
+// ---- Combined: textSimilarity (general purpose) ----
+
+function textSimilarity(a, b) {
+    var strA = String(a);
+    var strB = String(b);
+
+    if (strA === strB && strA.length > 0) return 1.0;
+    if (strA.length === 0 && strB.length === 0) return 0;
+
+    var maxLen = Math.max(strA.length, strB.length);
+    var levSim = maxLen > 0 ? 1 - (levenshteinDistance(strA, strB) / maxLen) : 0;
+    var jacSim = jaccardSimilarity(strA, strB);
+    var cosSim = cosineSimilarity(strA, strB);
+    var synSim = synsetSimilarity(strA, strB);
+
+    return Math.max(0, Math.min(1, (levSim + jacSim + cosSim + synSim) / 4));
+}
+
+// ---- Optimized: findBestMatchPreprocessed ----
+
+/**
+ * Tìm câu trả lời phù hợp nhất từ preprocessed data.
+ * Sử dụng TF-IDF cosine + synset preprocessed + Jaccard + Levenshtein.
+ * Nhanh hơn textSimilarity() vì corpus đã được tiền xử lý.
+ *
+ * @param {string} input - Input người dùng (raw)
+ * @param {string} lang - Ngôn ngữ hiện tại
+ * @param {number} threshold - Ngưỡng similarity (mặc định 0.3)
+ * @returns {{answer: string, score: number}|null} Kết quả hoặc null
+ */
+function findBestMatchPreprocessed(input, lang, threshold) {
+    threshold = threshold || 0.3;
+    var ppLang = getPreprocessedLang(lang);
+    if (!ppLang) return null; // Fallback: caller sẽ dùng textSimilarity thường
+
+    var idf = ppLang.idf;
+    var statements = ppLang.statements;
+
+    // Tokenize input
+    var inputTokens = tokenizeForSimilarity(input, lang);
+    if (inputTokens.length === 0) return null;
+
+    // Build input TF
+    var inputTF = {};
+    for (var t = 0; t < inputTokens.length; t++) {
+        inputTF[inputTokens[t]] = (inputTF[inputTokens[t]] || 0) + 1;
+    }
+
+    // Build input TF-IDF
+    var inputTFIDF = {};
+    for (var word in inputTF) {
+        inputTFIDF[word] = inputTF[word] * (idf[word] || 1);
+    }
+    var inputMag = 0;
+    for (var w in inputTFIDF) inputMag += inputTFIDF[w] * inputTFIDF[w];
+    inputMag = Math.sqrt(inputMag);
+
+    // Build input synonym groups
+    var lookup = _getSynonymLookup();
+    var inputSynGroups = [];
+    var seenGroups = {};
+    for (var s = 0; s < inputTokens.length; s++) {
+        var groups = lookup[inputTokens[s]];
+        if (groups) {
+            for (var gi = 0; gi < groups.length; gi++) {
+                if (!seenGroups[groups[gi]]) {
+                    inputSynGroups.push(groups[gi]);
+                    seenGroups[groups[gi]] = true;
+                }
+            }
+        }
+    }
+
+    // Input normalized string (for Levenshtein/Jaccard)
+    var inputNorm = inputTokens.join(' ');
+
+    // Compare with all preprocessed statements
+    var bestScore = -1;
+    var bestAnswer = null;
+
+    for (var i = 0; i < statements.length; i++) {
+        var stmt = statements[i];
+        var stmtNorm = stmt.tokens.join(' ');
+
+        // 1. Levenshtein similarity
+        var maxLen = Math.max(inputNorm.length, stmtNorm.length);
+        var levSim = maxLen > 0 ? 1 - (levenshteinDistance(inputNorm, stmtNorm) / maxLen) : 0;
+
+        // 2. Jaccard (on tokens)
+        var jacSim = jaccardSimilarity(inputNorm, stmtNorm);
+
+        // 3. TF-IDF Cosine (preprocessed)
+        var cosSim = cosineSimilarityTFIDF(inputTFIDF, inputMag, stmt.tfidf, stmt.magnitude);
+
+        // 4. Synset (preprocessed)
+        var synSim = synsetSimilarityPreprocessed(inputSynGroups, stmt.synGroups);
+
+        var score = (levSim + jacSim + cosSim + synSim) / 4;
+
+        if (score > bestScore) {
+            bestScore = score;
+            bestAnswer = stmt.answer;
+        }
+    }
+
+    if (bestScore >= threshold) {
+        return { answer: bestAnswer, score: bestScore };
+    }
+    return null;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.levenshteinDistance = levenshteinDistance;
+    globalThis.jaccardSimilarity = jaccardSimilarity;
+    globalThis.cosineSimilarity = cosineSimilarity;
+    globalThis.cosineSimilarityTFIDF = cosineSimilarityTFIDF;
+    globalThis.synsetSimilarity = synsetSimilarity;
+    globalThis.synsetSimilarityPreprocessed = synsetSimilarityPreprocessed;
+    globalThis.areSynonyms = areSynonyms;
+    globalThis.SYNONYM_GROUPS = SYNONYM_GROUPS;
+    globalThis.textSimilarity = textSimilarity;
+    globalThis.loadPreprocessedData = loadPreprocessedData;
+    globalThis.getPreprocessedLang = getPreprocessedLang;
+    globalThis.findBestMatchPreprocessed = findBestMatchPreprocessed;
+    globalThis.tokenizeForSimilarity = tokenizeForSimilarity;
+}

adapters/time-adapter.js

@@ -0,0 +1,89 @@
+// ============================================================
+// Time Adapter — Trả lời câu hỏi thời gian/ngày tháng/thứ
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+var TIME_KEYWORDS = {
+    vi: { time: ['mấy giờ', 'giờ', 'thời gian'], date: ['ngày mấy', 'hôm nay', 'ngày tháng'], day: ['thứ mấy', 'thứ'] },
+    en: { time: ['what time', 'time', 'clock'], date: ['what date', 'today', 'date'], day: ['what day', 'day'] },
+    ja: { time: ['何時', '今何時', '時間'], date: ['今日', '何日', '日付'], day: ['何曜日', '曜日'] }
+};
+
+var DAY_NAMES = {
+    vi: ['Chủ Nhật', 'Thứ Hai', 'Thứ Ba', 'Thứ Tư', 'Thứ Năm', 'Thứ Sáu', 'Thứ Bảy'],
+    en: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
+    ja: ['日曜日', '月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日']
+};
+
+var MONTH_NAMES_EN = [
+    'January', 'February', 'March', 'April', 'May', 'June',
+    'July', 'August', 'September', 'October', 'November', 'December'
+];
+
+function timeAdapter(rs, args) {
+    _adapterPath.push('time_adapter');
+    var input = (args || []).join(' ').trim().toLowerCase();
+    var lang = currentLang || 'vi';
+    var keywords = TIME_KEYWORDS[lang] || TIME_KEYWORDS['vi'];
+    var now = new Date();
+
+    for (var i = 0; i < keywords.time.length; i++) {
+        if (input.indexOf(keywords.time[i].toLowerCase()) !== -1) return formatTime(now, lang);
+    }
+    for (var j = 0; j < keywords.date.length; j++) {
+        if (input.indexOf(keywords.date[j].toLowerCase()) !== -1) return formatDate(now, lang);
+    }
+    for (var k = 0; k < keywords.day.length; k++) {
+        if (input.indexOf(keywords.day[k].toLowerCase()) !== -1) return formatDay(now, lang);
+    }
+
+    if (lang === 'en') return "I don't understand your time request.";
+    if (lang === 'ja') return '時間に関するリクエストが理解できませんでした。';
+    return 'Mình không hiểu yêu cầu về thời gian của bạn.';
+}
+
+function formatTime(date, lang) {
+    var hours = date.getHours();
+    var minutes = date.getMinutes();
+    var mm = minutes < 10 ? '0' + minutes : String(minutes);
+
+    if (lang === 'en') {
+        var period = hours >= 12 ? 'PM' : 'AM';
+        var h12 = hours % 12;
+        if (h12 === 0) h12 = 12;
+        return h12 + ':' + mm + ' ' + period;
+    } else if (lang === 'ja') {
+        return hours + '時' + mm + '分';
+    }
+    var hh = hours < 10 ? '0' + hours : String(hours);
+    return hh + ':' + mm;
+}
+
+function formatDate(date, lang) {
+    var day = date.getDate();
+    var month = date.getMonth();
+    var year = date.getFullYear();
+
+    if (lang === 'en') return MONTH_NAMES_EN[month] + ' ' + day + ', ' + year;
+    if (lang === 'ja') return year + '年' + (month + 1) + '月' + day + '日';
+    var dd = day < 10 ? '0' + day : String(day);
+    var mmStr = (month + 1) < 10 ? '0' + (month + 1) : String(month + 1);
+    return dd + '/' + mmStr + '/' + year;
+}
+
+function formatDay(date, lang) {
+    var dayIndex = date.getDay();
+    var names = DAY_NAMES[lang] || DAY_NAMES['vi'];
+    return names[dayIndex];
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.TIME_KEYWORDS = TIME_KEYWORDS;
+    globalThis.DAY_NAMES = DAY_NAMES;
+    globalThis.MONTH_NAMES_EN = MONTH_NAMES_EN;
+    globalThis.timeAdapter = timeAdapter;
+    globalThis.formatTime = formatTime;
+    globalThis.formatDate = formatDate;
+    globalThis.formatDay = formatDay;
+}

adapters/unit-conversion.js

@@ -0,0 +1,145 @@
+// ============================================================
+// Unit Conversion Adapter — Chuyển đổi đơn vị đo lường
+// Phụ thuộc: currentLang, _adapterPath
+// ============================================================
+
+var CONVERSION_FACTORS = {
+    length: { m: 1, km: 1000, cm: 0.01, mm: 0.001, mile: 1609.344, yard: 0.9144, foot: 0.3048, inch: 0.0254 },
+    mass: { kg: 1, g: 0.001, mg: 0.000001, pound: 0.453592, ounce: 0.0283495 }
+};
+
+var TEMPERATURE_UNITS = {
+    celsius: 'celsius', c: 'celsius',
+    fahrenheit: 'fahrenheit', f: 'fahrenheit',
+    kelvin: 'kelvin', k: 'kelvin'
+};
+
+function convertTemperature(value, from, to) {
+    if (from === to) return value;
+    var celsius;
+    if (from === 'celsius') celsius = value;
+    else if (from === 'fahrenheit') celsius = (value - 32) * 5 / 9;
+    else celsius = value - 273.15;
+
+    if (to === 'celsius') return celsius;
+    if (to === 'fahrenheit') return (celsius * 9 / 5) + 32;
+    return celsius + 273.15;
+}
+
+function convertUnit(value, fromUnit, toUnit) {
+    var from = String(fromUnit).toLowerCase().trim();
+    var to = String(toUnit).toLowerCase().trim();
+    if (from === to) return value;
+
+    var fromTemp = TEMPERATURE_UNITS[from];
+    var toTemp = TEMPERATURE_UNITS[to];
+    if (fromTemp && toTemp) return convertTemperature(value, fromTemp, toTemp);
+    if (fromTemp || toTemp) return null;
+
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        var factors = CONVERSION_FACTORS[categories[i]];
+        if (factors[from] !== undefined && factors[to] !== undefined) {
+            return value * (factors[from] / factors[to]);
+        }
+    }
+    return null;
+}
+
+function parseConversionRequest(input, lang) {
+    if (typeof input !== 'string' || input.trim().length === 0) return null;
+    var text = input.trim();
+
+    var separators;
+    if (lang === 'ja') separators = ['に変換', 'は何', 'を'];
+    else if (lang === 'en') separators = ['convert', ' to ', ' in '];
+    else separators = [' sang ', ' ra '];
+
+    for (var i = 0; i < separators.length; i++) {
+        var sep = separators[i];
+        var idx = text.toLowerCase().indexOf(sep.toLowerCase());
+        if (idx === -1) continue;
+
+        var leftPart = text.substring(0, idx).trim();
+        var rightPart = text.substring(idx + sep.length).trim();
+        if (leftPart.length === 0 || rightPart.length === 0) continue;
+
+        var leftMatch = leftPart.match(/(-?\d+(?:\.\d+)?)\s*(.+)/);
+        if (!leftMatch) continue;
+
+        var value = parseFloat(leftMatch[1]);
+        var fromUnit = leftMatch[2].trim().toLowerCase();
+        var toUnit = rightPart.trim().toLowerCase();
+        if (isNaN(value)) continue;
+
+        return { value: value, from: fromUnit, to: toUnit };
+    }
+    return null;
+}
+
+function getSupportedUnits() {
+    var units = [];
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        units = units.concat(Object.keys(CONVERSION_FACTORS[categories[i]]));
+    }
+    units = units.concat(['celsius', 'fahrenheit', 'kelvin', 'c', 'f', 'k']);
+    return units.join(', ');
+}
+
+function unitConversionAdapter(rs, args) {
+    _adapterPath.push('unit_conversion');
+    var input = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (input.length === 0) {
+        if (lang === 'en') return 'Please provide a conversion request (e.g., "5 km to m").';
+        if (lang === 'ja') return '変換リクエストを入力してください（例: 「5 km を m」）。';
+        return 'Vui lòng nhập yêu cầu chuyển đổi (ví dụ: "5 km sang m").';
+    }
+
+    var parsed = parseConversionRequest(input, lang);
+    if (!parsed) {
+        if (lang === 'en') return 'Invalid syntax. Example: "5 km to m", "100 fahrenheit to celsius".';
+        if (lang === 'ja') return '構文が無効です。例: 「5 km を m」、「100 fahrenheit を celsius」。';
+        return 'Cú pháp không hợp lệ. Ví dụ: "5 km sang m", "100 fahrenheit sang celsius".';
+    }
+
+    var allUnits = {};
+    var categories = Object.keys(CONVERSION_FACTORS);
+    for (var i = 0; i < categories.length; i++) {
+        var catUnits = Object.keys(CONVERSION_FACTORS[categories[i]]);
+        for (var j = 0; j < catUnits.length; j++) allUnits[catUnits[j]] = true;
+    }
+    var tempKeys = Object.keys(TEMPERATURE_UNITS);
+    for (var t = 0; t < tempKeys.length; t++) allUnits[tempKeys[t]] = true;
+
+    if (!allUnits[parsed.from.toLowerCase()] || !allUnits[parsed.to.toLowerCase()]) {
+        var supported = getSupportedUnits();
+        if (lang === 'en') return 'Unsupported unit. Supported units: ' + supported;
+        if (lang === 'ja') return 'サポートされていない単位です。対応単位: ' + supported;
+        return 'Đơn vị không được hỗ trợ. Các đơn vị hỗ trợ: ' + supported;
+    }
+
+    var result = convertUnit(parsed.value, parsed.from.toLowerCase(), parsed.to.toLowerCase());
+    if (result === null) {
+        var supported2 = getSupportedUnits();
+        if (lang === 'en') return 'Cannot convert between incompatible units. Supported units: ' + supported2;
+        if (lang === 'ja') return '互換性のない単位間の変換はできません。対応単位: ' + supported2;
+        return 'Không thể chuyển đổi giữa các đơn vị không tương thích. Các đơn vị hỗ trợ: ' + supported2;
+    }
+
+    var resultStr = Number.isInteger(result) ? String(result) : result.toFixed(4).replace(/\.?0+$/, '');
+    return parsed.value + ' ' + parsed.from + ' = ' + resultStr + ' ' + parsed.to;
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.CONVERSION_FACTORS = CONVERSION_FACTORS;
+    globalThis.TEMPERATURE_UNITS = TEMPERATURE_UNITS;
+    globalThis.convertTemperature = convertTemperature;
+    globalThis.convertUnit = convertUnit;
+    globalThis.parseConversionRequest = parseConversionRequest;
+    globalThis.getSupportedUnits = getSupportedUnits;
+    globalThis.unitConversionAdapter = unitConversionAdapter;
+}

adapters/web-search.js

@@ -0,0 +1,207 @@
+// ============================================================
+// Web Search Adapter — Tìm kiếm web và trả kết quả
+// Phụ thuộc: currentLang, _adapterPath
+//
+// Chiến lược (không cần API key, không cần CORS proxy):
+// 1. DuckDuckGo Instant Answer API (có CORS headers, trả tóm tắt Wikipedia)
+// 2. Fallback → link tìm kiếm clickable (Google + DuckDuckGo + Bing)
+//
+// Tùy chọn: Google Custom Search API (cần GOOGLE_API_KEY + GOOGLE_CX)
+// ============================================================
+
+var GOOGLE_API_KEY = '';
+var GOOGLE_CX = '';
+var WEB_SEARCH_TIMEOUT = 5000;
+
+// ---- DuckDuckGo Instant Answer API ----
+
+async function duckDuckGoSearch(query) {
+    // DDG API hỗ trợ CORS — gọi trực tiếp từ browser
+    var url = 'https://api.duckduckgo.com/?q=' + encodeURIComponent(query)
+        + '&format=json&no_html=1&skip_disambig=1';
+
+    var controller = new AbortController();
+    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
+
+    try {
+        var response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) return null;
+        var data = await response.json();
+
+        var results = {
+            abstract: data.Abstract || '',
+            abstractSource: data.AbstractSource || '',
+            abstractURL: data.AbstractURL || '',
+            answer: data.Answer || '',
+            definition: data.Definition || '',
+            definitionSource: data.DefinitionSource || '',
+            definitionURL: data.DefinitionURL || '',
+            related: []
+        };
+
+        if (data.RelatedTopics) {
+            for (var i = 0; i < Math.min(data.RelatedTopics.length, 5); i++) {
+                var topic = data.RelatedTopics[i];
+                if (topic && topic.Text) {
+                    results.related.push({ text: topic.Text, url: topic.FirstURL || '' });
+                }
+            }
+        }
+
+        if (!results.abstract && !results.answer && !results.definition && results.related.length === 0) {
+            return null;
+        }
+        return results;
+    } catch (err) {
+        return null;
+    } finally {
+        clearTimeout(timeoutId);
+    }
+}
+
+// ---- Google Custom Search API (cần key) ----
+
+async function googleSearch(query, numResults) {
+    if (!GOOGLE_API_KEY || !GOOGLE_CX) return null;
+    numResults = numResults || 3;
+    var url = 'https://www.googleapis.com/customsearch/v1'
+        + '?key=' + encodeURIComponent(GOOGLE_API_KEY)
+        + '&cx=' + encodeURIComponent(GOOGLE_CX)
+        + '&q=' + encodeURIComponent(query)
+        + '&num=' + numResults;
+
+    var controller = new AbortController();
+    var timeoutId = setTimeout(function () { controller.abort(); }, WEB_SEARCH_TIMEOUT);
+
+    try {
+        var response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) return null;
+        var data = await response.json();
+        if (!data.items || data.items.length === 0) return null;
+        return data.items.map(function (item) {
+            return { title: item.title || '', link: item.link || '', snippet: item.snippet || '' };
+        });
+    } catch (err) {
+        return null;
+    } finally {
+        clearTimeout(timeoutId);
+    }
+}
+
+// ---- Format ----
+
+function formatDDGResults(results, query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索結果:');
+    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
+
+    if (results.answer) lines.push('💡 ' + results.answer);
+
+    if (results.abstract) {
+        lines.push('\n' + results.abstract);
+        if (results.abstractSource && results.abstractURL) {
+            lines.push('📖 Nguồn: ' + results.abstractSource + ' — ' + results.abstractURL);
+        }
+    }
+
+    if (results.definition) {
+        lines.push('📝 ' + results.definition);
+        if (results.definitionSource) lines.push('   — ' + results.definitionSource);
+    }
+
+    if (results.related.length > 0) {
+        lines.push('');
+        if (lang === 'en') lines.push('Related:');
+        else if (lang === 'ja') lines.push('関連:');
+        else lines.push('Liên quan:');
+        for (var i = 0; i < results.related.length; i++) {
+            var r = results.related[i];
+            lines.push('• ' + r.text);
+            if (r.url) lines.push('  🔗 ' + r.url);
+        }
+    }
+
+    // Luôn thêm link tìm kiếm đầy đủ
+    lines.push('');
+    lines.push(_searchLinksOnly(query));
+
+    return lines.join('\n');
+}
+
+function formatGoogleResults(results, query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Search results for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 ��' + query + '」の検索結果:');
+    else lines.push('🔍 Kết quả tìm kiếm "' + query + '":');
+
+    for (var i = 0; i < results.length; i++) {
+        lines.push((i + 1) + '. ' + results[i].title);
+        if (results[i].snippet) lines.push('   ' + results[i].snippet);
+        if (results[i].link) lines.push('   🔗 ' + results[i].link);
+    }
+    return lines.join('\n');
+}
+
+function formatSearchLinks(query, lang) {
+    var lines = [];
+    if (lang === 'en') lines.push('🔍 Here are search links for "' + query + '":');
+    else if (lang === 'ja') lines.push('🔍 「' + query + '」の検索リンク:');
+    else lines.push('🔍 Link tìm kiếm "' + query + '":');
+
+    lines.push(_searchLinksOnly(query));
+    return lines.join('\n');
+}
+
+function _searchLinksOnly(query) {
+    var encoded = encodeURIComponent(query);
+    return '🌐 Google: https://www.google.com/search?q=' + encoded
+        + '\n🦆 DuckDuckGo: https://duckduckgo.com/?q=' + encoded
+        + '\n🔵 Bing: https://www.bing.com/search?q=' + encoded;
+}
+
+// ---- Web Search Adapter ----
+
+function webSearchAdapter(rs, args) {
+    _adapterPath.push('web_search');
+    var query = (args || []).join(' ').trim();
+    var lang = currentLang || 'vi';
+
+    if (query.length === 0) {
+        if (lang === 'en') return Promise.resolve('Please provide a search query.');
+        if (lang === 'ja') return Promise.resolve('検索キーワードを入力してください。');
+        return Promise.resolve('Vui lòng nhập từ khóa tìm kiếm.');
+    }
+
+    // Ưu tiên Google nếu có key
+    if (GOOGLE_API_KEY && GOOGLE_CX) {
+        return googleSearch(query).then(function (results) {
+            if (results) return formatGoogleResults(results, query, lang);
+            return _ddgFallback(query, lang);
+        }).catch(function () {
+            return _ddgFallback(query, lang);
+        });
+    }
+
+    return _ddgFallback(query, lang);
+}
+
+function _ddgFallback(query, lang) {
+    return duckDuckGoSearch(query).then(function (results) {
+        if (results) return formatDDGResults(results, query, lang);
+        // DDG không có instant answer → trả link tìm kiếm
+        return formatSearchLinks(query, lang);
+    }).catch(function () {
+        return formatSearchLinks(query, lang);
+    });
+}
+
+// Node/test: export to globalThis
+if (typeof module !== 'undefined' && module.exports) {
+    globalThis.GOOGLE_API_KEY = GOOGLE_API_KEY;
+    globalThis.GOOGLE_CX = GOOGLE_CX;
+    globalThis.duckDuckGoSearch = duckDuckGoSearch;
+    globalThis.googleSearch = googleSearch;
+    globalThis.webSearchAdapter = webSearchAdapter;
+    globalThis.formatSearchLinks = formatSearchLinks;
+}

app.js

@@ -0,0 +1,1108 @@
+// ============================================================
+// Hikari Chatbot — app.js
+// Khung cơ bản và cấu hình (Task 1.3)
+// ============================================================
+
+// === Trạng thái toàn cục ===
+let bot = null;                // Instance RiveScript hiện tại
+let currentLang = 'vi';        // Ngôn ngữ hiện tại
+const USERNAME = 'local-user'; // Username cố định cho RiveScript
+var _adapterPath = [];         // Tracking adapter chain cho mỗi lượt phản hồi
+
+// === Hằng số cấu hình ===
+const FALLBACK_API_URL = 'https://your-api-server.com/chat'; // URL có thể cấu hình
+const FALLBACK_API_TIMEOUT = 5000; // 5 giây
+
+// ============================================================
+// Hàm tiện ích
+// ============================================================
+
+/**
+ * Bảng ánh xạ ký tự tiếng Việt có dấu → không dấu.
+ * Dùng để normalize input trước khi gửi cho RiveScript (triggers viết không dấu).
+ */
+var VIETNAMESE_DIACRITICS_MAP = {
+    'à': 'a', 'á': 'a', 'ả': 'a', 'ã': 'a', 'ạ': 'a',
+    'ă': 'a', 'ằ': 'a', 'ắ': 'a', 'ẳ': 'a', 'ẵ': 'a', 'ặ': 'a',
+    'â': 'a', 'ầ': 'a', 'ấ': 'a', 'ẩ': 'a', 'ẫ': 'a', 'ậ': 'a',
+    'đ': 'd',
+    'è': 'e', 'é': 'e', 'ẻ': 'e', 'ẽ': 'e', 'ẹ': 'e',
+    'ê': 'e', 'ề': 'e', 'ế': 'e', 'ể': 'e', 'ễ': 'e', 'ệ': 'e',
+    'ì': 'i', 'í': 'i', 'ỉ': 'i', 'ĩ': 'i', 'ị': 'i',
+    'ò': 'o', 'ó': 'o', 'ỏ': 'o', 'õ': 'o', 'ọ': 'o',
+    'ô': 'o', 'ồ': 'o', 'ố': 'o', 'ổ': 'o', 'ỗ': 'o', 'ộ': 'o',
+    'ơ': 'o', 'ờ': 'o', 'ớ': 'o', 'ở': 'o', 'ỡ': 'o', 'ợ': 'o',
+    'ù': 'u', 'ú': 'u', 'ủ': 'u', 'ũ': 'u', 'ụ': 'u',
+    'ư': 'u', 'ừ': 'u', 'ứ': 'u', 'ử': 'u', 'ữ': 'u', 'ự': 'u',
+    'ỳ': 'y', 'ý': 'y', 'ỷ': 'y', 'ỹ': 'y', 'ỵ': 'y'
+};
+
+/**
+ * Loại bỏ dấu tiếng Việt khỏi chuỗi.
+ * "Xin chào bạn" → "Xin chao ban"
+ * @param {string} str - Chuỗi đầu vào
+ * @returns {string} Chuỗi đã bỏ dấu
+ */
+function removeVietnameseDiacritics(str) {
+    if (typeof str !== 'string') return '';
+    var result = '';
+    for (var i = 0; i < str.length; i++) {
+        var ch = str[i];
+        var lower = ch.toLowerCase();
+        if (VIETNAMESE_DIACRITICS_MAP[lower] !== undefined) {
+            // Giữ nguyên case (hoa/thường) của ký tự gốc
+            var mapped = VIETNAMESE_DIACRITICS_MAP[lower];
+            result += (ch === lower) ? mapped : mapped.toUpperCase();
+        } else {
+            result += ch;
+        }
+    }
+    return result;
+}
+
+/**
+ * Danh sách modal particles / filler words theo ngôn ngữ.
+ * Các từ này thường xuất hiện cuối câu và không mang nghĩa chính,
+ * gây nhiễu khi match trigger RiveScript.
+ */
+var MODAL_PARTICLES = {
+    vi: ['roi', 'vay', 'nhi', 'nhe', 'a', 'nha', 'di', 'the', 'ha', 'hen', 'ne', 'luon', 'chua', 'khong', 'duoc', 'day', 'do', 'ta', 'chu'],
+    en: ['please', 'pls', 'right', 'huh', 'eh', 'ok', 'okay', 'well', 'so', 'then', 'anyway'],
+    ja: ['ね', 'よ', 'な', 'か', 'さ', 'ぞ', 'わ', 'の', 'けど', 'でしょ']
+};
+
+/**
+ * Normalize input cho RiveScript:
+ * 1. Lowercase
+ * 2. Bỏ dấu tiếng Việt (chỉ khi ngôn ngữ = vi)
+ * 3. Bỏ dấu câu (punctuation)
+ * 4. Bỏ modal particles / filler words cuối câu
+ * 5. Trim khoảng trắng thừa
+ *
+ * @param {string} text - Input người dùng
+ * @returns {string} Input đã normalize
+ */
+function normalizeInput(text) {
+    if (typeof text !== 'string') return '';
+    var result = text.toLowerCase();
+
+    // Bỏ dấu tiếng Việt
+    if (currentLang === 'vi') {
+        result = removeVietnameseDiacritics(result);
+    }
+
+    // Bỏ dấu câu: ? ! . , ; : " ' ` ~ ( ) [ ] { } \ | @ # $ % ^ &
+    // Giữ lại + - * / cho biểu thức toán học
+    result = result.replace(/[?!.,;:"""''`~()[\]{}\\|@#$%^&]/g, ' ');
+
+    // Chuẩn hóa khoảng trắng
+    result = result.replace(/\s+/g, ' ').trim();
+
+    // Bỏ modal particles ở cuối câu (lặp để xử lý nhiều particle liên tiếp)
+    var particles = MODAL_PARTICLES[currentLang] || [];
+    if (particles.length > 0) {
+        var changed = true;
+        while (changed) {
+            changed = false;
+            for (var i = 0; i < particles.length; i++) {
+                var p = particles[i];
+                // Chỉ bỏ nếu particle là từ cuối cùng và câu còn ít nhất 1 từ khác
+                var suffix = ' ' + p;
+                if (result.length > suffix.length && result.slice(-suffix.length) === suffix) {
+                    result = result.slice(0, -suffix.length).trim();
+                    changed = true;
+                    break;
+                }
+            }
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Kiểm tra tin nhắn có hợp lệ (không trống, không chỉ khoảng trắng).
+ * @param {string} text - Nội dung tin nhắn
+ * @returns {boolean} true nếu hợp lệ
+ */
+function validateMessage(text) {
+    return typeof text === 'string' && text.trim().length > 0;
+}
+
+/**
+ * Chuyển URLs trong text thành thẻ <a> clickable.
+ * Escape HTML trước, rồi replace URL patterns thành links.
+ * @param {string} text
+ * @returns {string} HTML string
+ */
+function linkifyText(text) {
+    // Escape HTML entities trước
+    var escaped = String(text)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+    // Replace newlines with <br>
+    escaped = escaped.replace(/\n/g, '<br>');
+    // Replace URLs with <a> tags
+    return escaped.replace(/(https?:\/\/[^\s<]+)/g, '<a href="$1" target="_blank" rel="noopener">$1</a>');
+}
+
+/**
+ * Cuộn message display xuống cuối.
+ */
+function scrollToBottom() {
+    const display = document.getElementById('message-display');
+    if (display) {
+        display.scrollTop = display.scrollHeight;
+    }
+}
+
+/**
+ * Thêm tin nhắn vào DOM với class phân biệt user/bot, kèm confidence, adapter path và thời gian xử lý nếu là bot.
+ * @param {string} text - Nội dung tin nhắn
+ * @param {"user"|"bot"} sender - Người gửi
+ * @param {number} [confidence] - Tỉ lệ khớp (chỉ dùng cho bot)
+ * @param {string[]} [adapterPath] - Danh sách adapter đã xử lý (chỉ dùng cho bot)
+ * @param {number} [responseTime] - Thời gian xử lý (ms, chỉ dùng cho bot)
+ */
+function appendMessage(text, sender, confidence, adapterPath, responseTime) {
+    const display = document.getElementById('message-display');
+    if (!display) return;
+
+    const messageDiv = document.createElement('div');
+    messageDiv.className = 'message ' + sender;
+
+    const textSpan = document.createElement('span');
+    textSpan.className = 'message-text';
+    // Render URLs as clickable links for bot messages
+    if (sender === 'bot' && text.indexOf('http') !== -1) {
+        textSpan.innerHTML = linkifyText(text);
+    } else {
+        textSpan.textContent = text;
+    }
+    messageDiv.appendChild(textSpan);
+
+    if (sender === 'bot' && typeof confidence === 'number') {
+        const confSpan = document.createElement('span');
+        confSpan.className = 'confidence ' + getConfidenceClass(confidence);
+        confSpan.textContent = 'Confidence: ' + confidence + '%';
+        messageDiv.appendChild(confSpan);
+    }
+
+    if (sender === 'bot' && adapterPath && adapterPath.length > 0) {
+        const pathSpan = document.createElement('span');
+        pathSpan.className = 'adapter-path';
+        var breadcrumb = adapterPath.map(function (key) {
+            return getAdapterDisplayName(key);
+        }).join(' › ');
+        pathSpan.textContent = breadcrumb;
+        messageDiv.appendChild(pathSpan);
+    }
+
+    if (sender === 'bot' && typeof responseTime === 'number') {
+        const timeSpan = document.createElement('span');
+        timeSpan.className = 'response-time';
+        timeSpan.textContent = '⏱ ' + responseTime + 'ms';
+        messageDiv.appendChild(timeSpan);
+    }
+
+    display.appendChild(messageDiv);
+    scrollToBottom();
+}
+
+/**
+ * Hiển thị thông báo lỗi trong chat.
+ * @param {string} message - Nội dung lỗi
+ */
+function showError(message) {
+    appendMessage(message, 'bot');
+}
+
+/**
+ * Tính tỉ lệ khớp (confidence) dựa trên trigger đã match.
+ * - Trigger chính xác (không chứa wildcard) → 100
+ * - Trigger mặc định `*` → 0
+ * - Trigger chứa wildcard một phần → giá trị trung gian
+ * @param {string} matchedTrigger - Trigger đã khớp từ lastMatch()
+ * @returns {number} Confidence 0–100
+ */
+function calculateConfidence(matchedTrigger) {
+    if (typeof matchedTrigger !== 'string' || matchedTrigger.trim() === '') {
+        return 0;
+    }
+
+    const trigger = matchedTrigger.trim();
+
+    // Trigger mặc định wildcard `*` → confidence = 0
+    if (trigger === '*') {
+        return 0;
+    }
+
+    // Kiểm tra trigger có chứa wildcard không
+    const wildcardPatterns = ['*', '#', '_'];
+    const hasWildcard = wildcardPatterns.some(function (w) {
+        return trigger.includes(w);
+    });
+
+    if (!hasWildcard) {
+        // Trigger chính xác (không wildcard) → confidence = 100
+        return 100;
+    }
+
+    // Trigger chứa wildcard một phần → tính giá trị trung gian
+    // Dựa trên tỉ lệ phần không phải wildcard so với tổng chiều dài
+    const parts = trigger.split(/[\s]+/);
+    var nonWildcardParts = 0;
+    for (var i = 0; i < parts.length; i++) {
+        if (parts[i] !== '*' && parts[i] !== '#' && parts[i] !== '_') {
+            nonWildcardParts++;
+        }
+    }
+    var ratio = nonWildcardParts / parts.length;
+    // Ánh xạ ratio vào khoảng [1, 99] để tránh trùng với 0 và 100
+    return Math.max(1, Math.min(99, Math.round(ratio * 100)));
+}
+
+/**
+ * Trả về CSS class cho màu sắc confidence.
+ * @param {number} confidence - Tỉ lệ khớp (0–100)
+ * @returns {string} "confidence-high" nếu ≥50, "confidence-low" nếu <50
+ */
+function getConfidenceClass(confidence) {
+    return confidence >= 50 ? 'confidence-high' : 'confidence-low';
+}
+
+// ============================================================
+// Brain Data — Dữ liệu hội thoại RiveScript cho 3 ngôn ngữ
+// Được load từ file .rive riêng biệt trong thư mục brain/
+// Xem: brain/vi.rive, brain/en.rive, brain/ja.rive
+// Trong trình duyệt: BRAIN_DATA được load bởi brain.js (qua fetch)
+// Trong Node/test: BRAIN_DATA được load bởi fs.readFileSync
+// ============================================================
+
+// Node/test: khai báo các biến dữ liệu ngoài (browser đã có từ brain.js & data-loader.js)
+// Sử dụng IIFE để tránh var hoisting ghi đè biến global trong browser
+(function () {
+    if (typeof module === 'undefined' || !module.exports) return;
+    var _fs = require('fs');
+    var _path = require('path');
+    globalThis.BRAIN_DATA = {
+        vi: _fs.readFileSync(_path.join(__dirname, 'brain', 'vi.rive'), 'utf8'),
+        en: _fs.readFileSync(_path.join(__dirname, 'brain', 'en.rive'), 'utf8'),
+        ja: _fs.readFileSync(_path.join(__dirname, 'brain', 'ja.rive'), 'utf8')
+    };
+    globalThis.SPECIFIC_RESPONSES = JSON.parse(_fs.readFileSync(_path.join(__dirname, 'data', 'specific-responses.json'), 'utf8'));
+    globalThis.QA_DATASET = JSON.parse(_fs.readFileSync(_path.join(__dirname, 'data', 'qa-dataset.json'), 'utf8'));
+    globalThis.ADAPTER_REGISTRY = JSON.parse(_fs.readFileSync(_path.join(__dirname, 'data', 'adapter-registry.json'), 'utf8'));
+    globalThis.HELP_CONTENT = JSON.parse(_fs.readFileSync(_path.join(__dirname, 'data', 'help-content.json'), 'utf8'));
+})();
+
+// ============================================================
+// Lời chào mặc định cho mỗi ngôn ngữ (trigger gửi đến bot)
+// ============================================================
+const GREETING_TRIGGERS = {
+    vi: 'xin chao',
+    en: 'hello',
+    ja: 'こんにちは'
+};
+
+// ============================================================
+// Khởi tạo RiveScript Engine
+// ============================================================
+
+/**
+ * Khởi tạo RiveScript engine với brain data của ngôn ngữ chỉ định.
+ * Tạo instance mới, stream brain data, sort replies, đăng ký adapter.
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ * @returns {Promise<void>}
+ */
+async function initBot(lang) {
+    // Kiểm tra CDN RiveScript đã tải chưa
+    if (typeof RiveScript === 'undefined') {
+        showError('Chatbot hiện không khả dụng. Vui lòng kiểm tra kết nối mạng và tải lại trang.');
+        return;
+    }
+
+    try {
+        bot = new RiveScript({ utf8: true });
+        bot.stream(BRAIN_DATA[lang]);
+        bot.sortReplies();
+
+        // Đăng ký adapter nếu hàm registerAdapters đã được định nghĩa (sẽ thêm ở task sau)
+        if (typeof registerAdapters === 'function') {
+            registerAdapters(bot, lang);
+        }
+    } catch (err) {
+        console.error('Lỗi khởi tạo RiveScript:', err);
+        showError('Không thể khởi tạo chatbot. Vui lòng tải lại trang.');
+        bot = null;
+    }
+}
+
+/**
+ * Đổi ngôn ngữ: tạo lại bot, xóa chat, hiển thị lời chào mới,
+ * cập nhật rules list và macros list.
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ * @returns {Promise<void>}
+ */
+async function changeLanguage(lang) {
+    currentLang = lang;
+    await initBot(lang);
+
+    // Xóa lịch sử hội thoại
+    var display = document.getElementById('message-display');
+    if (display) {
+        display.innerHTML = '';
+    }
+
+    // Hiển thị lời chào mới bằng ngôn ngữ được chọn
+    if (bot) {
+        try {
+            var greeting = await bot.reply(USERNAME, GREETING_TRIGGERS[lang] || 'hello');
+            appendMessage(greeting, 'bot');
+        } catch (err) {
+            console.error('Lỗi lấy lời chào:', err);
+            showError('Không thể hiển thị lời chào.');
+        }
+    }
+
+    // Cập nhật rules list nếu hàm đã được định nghĩa (sẽ thêm ở task sau)
+    if (typeof updateRulesList === 'function') {
+        updateRulesList(lang);
+    }
+
+    // Cập nhật macros list nếu hàm đã được định nghĩa (sẽ thêm ở task sau)
+    if (typeof updateMacrosList === 'function') {
+        updateMacrosList(lang);
+    }
+}
+
+// ============================================================
+// Gửi tin nhắn và xử lý phản hồi
+// ============================================================
+
+/**
+ * Hiển thị chỉ báo đang tải (loading indicator) trong message display.
+ * @returns {HTMLElement} Phần tử loading indicator đã thêm vào DOM
+ */
+function showLoadingIndicator() {
+    var display = document.getElementById('message-display');
+    if (!display) return null;
+
+    var loadingDiv = document.createElement('div');
+    loadingDiv.className = 'message bot loading-indicator';
+    loadingDiv.textContent = '...';
+    display.appendChild(loadingDiv);
+    scrollToBottom();
+    return loadingDiv;
+}
+
+/**
+ * Ẩn/xóa chỉ báo đang tải.
+ * @param {HTMLElement} element - Phần tử loading indicator cần xóa
+ */
+function hideLoadingIndicator(element) {
+    if (element && element.parentNode) {
+        element.parentNode.removeChild(element);
+    }
+}
+
+/**
+ * Gửi HTTP POST đến Fallback API với timeout 5s.
+ * Sử dụng AbortController để hủy request khi vượt quá thời gian chờ.
+ * @param {string} userMessage - Tin nhắn người dùng
+ * @returns {Promise<string|null>} Phản hồi từ API hoặc null nếu lỗi/timeout
+ */
+async function callFallbackAPI(userMessage) {
+    var controller = new AbortController();
+    var timeoutId = setTimeout(function () {
+        controller.abort();
+    }, FALLBACK_API_TIMEOUT);
+
+    try {
+        var response = await fetch(FALLBACK_API_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ message: userMessage }),
+            signal: controller.signal
+        });
+
+        var data = await response.json();
+        return data.answer || data.reply || data.response || null;
+    } catch (err) {
+        // Timeout (AbortError) hoặc lỗi mạng → trả về null
+        return null;
+    } finally {
+        clearTimeout(timeoutId);
+    }
+}
+
+/**
+ * Detect nếu input là web search command.
+ * Trả về query string nếu match, null nếu không.
+ * @param {string} text - Input người dùng (raw)
+ * @returns {string|null} Query string hoặc null
+ */
+function extractWebSearchQuery(text) {
+    var lower = text.toLowerCase().trim();
+    // Normalize tiếng Việt để match "tra cứu" → "tra cuu"
+    var norm = (typeof normalizeInput === 'function') ? normalizeInput(text).toLowerCase().trim() : lower;
+
+    var prefixes = [
+        'google ', 'tra cuu ', 'tra cứu ',
+        'search ', 'web search ',
+        'ウェブ検索 ', 'グーグル ',
+        'tìm trên web ', 'tìm trên mạng ', 'tim tren web ', 'tim tren mang '
+    ];
+
+    for (var i = 0; i < prefixes.length; i++) {
+        if (lower.indexOf(prefixes[i]) === 0) {
+            return text.substring(prefixes[i].length).trim();
+        }
+        if (norm.indexOf(prefixes[i]) === 0) {
+            return text.substring(prefixes[i].length).trim();
+        }
+    }
+    return null;
+}
+
+/**
+ * Lấy phản hồi từ bot cho một input, trả về reply + confidence + adapterPath.
+ * @param {string} inputText - Input gửi cho bot
+ * @returns {Promise<{reply: string, confidence: number, adapterPath: string[]}>}
+ */
+async function getBotReply(inputText) {
+    _adapterPath = [];
+    var reply = await bot.reply(USERNAME, inputText);
+    var matchedTrigger = await bot.lastMatch(USERNAME);
+    var confidence = calculateConfidence(matchedTrigger);
+    var adapterPath = _adapterPath.length > 0 ? _adapterPath.slice() : ['rivescript'];
+    return { reply: reply, confidence: confidence, adapterPath: adapterPath };
+}
+
+/**
+ * Lấy tin nhắn từ input, gửi đến bot, tính confidence, xử lý fallback, hiển thị kết quả.
+ *
+ * Chiến lược dual-reply (chỉ áp dụng cho tiếng Việt):
+ * - Gửi cả input gốc (có dấu) VÀ input đã bỏ dấu cho bot
+ * - So sánh confidence của 2 kết quả, chọn kết quả có confidence cao hơn
+ * - Nếu bằng nhau, ưu tiên kết quả từ input gốc (có dấu)
+ *
+ * @returns {Promise<void>}
+ */
+async function sendMessage() {
+    var input = document.getElementById('message-input');
+    if (!input) return;
+
+    var text = input.value;
+
+    // Kiểm tra tin nhắn hợp lệ
+    if (!validateMessage(text)) {
+        return;
+    }
+
+    // Hiển thị tin nhắn người dùng
+    appendMessage(text, 'user');
+
+    // Xóa input
+    input.value = '';
+
+    // Kiểm tra bot đã khởi tạo chưa
+    if (!bot) {
+        showError('Chatbot chưa sẵn sàng. Vui lòng tải lại trang.');
+        return;
+    }
+
+    try {
+        var startTime = Date.now();
+
+        // Web Search: detect "google ...", "tra cuu ...", "search ...", "web search ..." trước khi gửi cho RiveScript
+        // Xử l�� trực tiếp vì web search là async và RiveScript subroutine không hỗ trợ Promise
+        var webSearchQuery = extractWebSearchQuery(text);
+        if (webSearchQuery && typeof webSearchAdapter === 'function') {
+            var loadingEl = showLoadingIndicator();
+            try {
+                _adapterPath = [];
+                var searchResult = await webSearchAdapter(null, webSearchQuery.split(/\s+/));
+                hideLoadingIndicator(loadingEl);
+                var elapsed = Date.now() - startTime;
+                var searchPath = _adapterPath.length > 0 ? _adapterPath.slice() : ['web_search'];
+                appendMessage(searchResult, 'bot', null, searchPath, elapsed);
+            } catch (searchErr) {
+                hideLoadingIndicator(loadingEl);
+                showError('Tìm kiếm thất bại. Vui lòng thử lại.');
+            }
+            scrollToBottom();
+            return;
+        }
+
+        var best;
+        var normalizedText = normalizeInput(text);
+        var isDifferent = normalizedText !== text;
+
+        if (currentLang === 'vi' && isDifferent) {
+            var rawResult = await getBotReply(text);
+            var normResult = await getBotReply(normalizedText);
+            best = (normResult.confidence > rawResult.confidence) ? normResult : rawResult;
+        } else {
+            best = await getBotReply(text);
+        }
+
+        var reply = best.reply;
+        var confidence = best.confidence;
+        var adapterPath = best.adapterPath;
+
+        if (confidence >= 50) {
+            var elapsed = Date.now() - startTime;
+            appendMessage(reply, 'bot', confidence, adapterPath, elapsed);
+        } else {
+            _adapterPath = [];
+            var localFallback = bestMatchAdapter(bot, text.toLowerCase().split(/\s+/));
+            var localPath = _adapterPath.slice();
+
+            if (currentLang === 'vi') {
+                _adapterPath = [];
+                var normFallback = bestMatchAdapter(bot, normalizeInput(text).toLowerCase().split(/\s+/));
+                var normPath = _adapterPath.slice();
+                if (isValidAdapterResult(normFallback) && !isValidAdapterResult(localFallback)) {
+                    localFallback = normFallback;
+                    localPath = normPath;
+                }
+            }
+
+            if (isValidAdapterResult(localFallback)) {
+                var elapsed2 = Date.now() - startTime;
+                appendMessage(localFallback, 'bot', confidence, localPath, elapsed2);
+            } else {
+                var loadingEl = showLoadingIndicator();
+
+                try {
+                    var apiResult = await callFallbackAPI(text);
+                    hideLoadingIndicator(loadingEl);
+                    var elapsed3 = Date.now() - startTime;
+
+                    if (apiResult) {
+                        var apiPath = adapterPath.concat(['fallback_api']);
+                        appendMessage(apiResult, 'bot', confidence, apiPath, elapsed3);
+                    } else {
+                        appendMessage(reply + '\n(Dịch vụ bổ sung không khả dụng)', 'bot', confidence, adapterPath, elapsed3);
+                    }
+                } catch (apiErr) {
+                    hideLoadingIndicator(loadingEl);
+                    var elapsed4 = Date.now() - startTime;
+                    appendMessage(reply + '\n(Dịch vụ bổ sung không khả dụng)', 'bot', confidence, adapterPath, elapsed4);
+                }
+            }
+        }
+    } catch (err) {
+        console.error('Lỗi xử lý tin nhắn:', err);
+        showError('Xin lỗi, mình gặp sự cố. Bạn thử gửi lại nhé!');
+    }
+
+    scrollToBottom();
+}
+
+// ============================================================
+// Logic Adapters — Tách thành các file riêng trong thư mục adapters/
+// Xem: adapters/text-similarity.js, adapters/specific-response.js,
+//      adapters/time-adapter.js, adapters/math-adapter.js,
+//      adapters/unit-conversion.js, adapters/best-match.js,
+//      adapters/logic-dispatcher.js, adapters/adapter-registry.js
+// Trong trình duyệt: được load bởi <script> tags trong index.html
+// Trong Node/test: được load bởi IIFE bên dưới
+// ============================================================
+
+// Node/test: expose shared variables to globalThis for adapter files
+(function () {
+    if (typeof module === 'undefined' || !module.exports) return;
+    // Adapter files access these as free variables — in Node they need to be on globalThis
+    // Use Object.defineProperty for _adapterPath and currentLang to keep them in sync with app.js locals
+    Object.defineProperty(globalThis, '_adapterPath', {
+        get: function () { return _adapterPath; },
+        set: function (val) { _adapterPath = val; },
+        configurable: true
+    });
+    Object.defineProperty(globalThis, 'currentLang', {
+        get: function () { return currentLang; },
+        set: function (val) { currentLang = val; },
+        configurable: true
+    });
+    globalThis.removeVietnameseDiacritics = removeVietnameseDiacritics;
+})();
+
+// Node/test: load adapter files
+(function () {
+    if (typeof module === 'undefined' || !module.exports) return;
+    var _path = require('path');
+    var _adDir = _path.join(__dirname, 'adapters');
+    var files = [
+        'text-similarity.js',
+        'specific-response.js',
+        'time-adapter.js',
+        'math-adapter.js',
+        'unit-conversion.js',
+        'best-match.js',
+        'logic-dispatcher.js',
+        'web-search.js',
+        'adapter-registry.js'
+    ];
+    for (var i = 0; i < files.length; i++) {
+        require(_path.join(_adDir, files[i]));
+    }
+    // Load preprocessed data synchronously for Node/test
+    if (typeof loadPreprocessedData === 'function') {
+        loadPreprocessedData();
+    }
+})();
+
+// ============================================================
+// Object Macro List Panel — Toggle và cập nhật danh sách macros
+// ============================================================
+
+/**
+ * Toggle hiển thị panel danh sách Object Macros.
+ * Thêm/xóa class 'hidden' trên phần tử #macros-panel.
+ */
+function toggleMacrosPanel() {
+    var panel = document.getElementById('macros-panel');
+    if (panel) {
+        panel.classList.toggle('hidden');
+    }
+}
+
+/**
+ * Cập nhật danh sách Object Macros cho ngôn ngữ chỉ định.
+ * Xóa nội dung cũ của #macros-list, duyệt qua ADAPTER_REGISTRY,
+ * tạo <li> cho mỗi adapter với tên, mô tả, và cú pháp <call>.
+ *
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ */
+function updateMacrosList(lang) {
+    var list = document.getElementById('macros-list');
+    if (!list) return;
+
+    list.innerHTML = '';
+
+    var activeLabel = lang === 'en' ? 'Active' : lang === 'ja' ? '有効' : 'Hoạt động';
+
+    var keys = Object.keys(ADAPTER_REGISTRY);
+    for (var i = 0; i < keys.length; i++) {
+        var key = keys[i];
+        var adapter = ADAPTER_REGISTRY[key];
+
+        var li = document.createElement('li');
+        li.className = 'macro-item';
+
+        // Header row: name + badge
+        var header = document.createElement('div');
+        header.className = 'macro-item-header';
+
+        var strong = document.createElement('strong');
+        strong.textContent = adapter.name[lang] || adapter.name['vi'];
+        header.appendChild(strong);
+
+        if (adapter.active) {
+            var badge = document.createElement('span');
+            badge.className = 'macro-item-badge';
+            badge.textContent = activeLabel;
+            header.appendChild(badge);
+        }
+
+        li.appendChild(header);
+
+        var p = document.createElement('p');
+        p.textContent = adapter.description[lang] || adapter.description['vi'];
+        li.appendChild(p);
+
+        var span = document.createElement('span');
+        span.className = 'macro-call-syntax';
+        span.textContent = adapter.callSyntax;
+        li.appendChild(span);
+
+        list.appendChild(li);
+    }
+}
+
+// ============================================================
+// Rules Panel — Hiển thị danh sách triggers dạng dễ đọc
+// ============================================================
+
+/**
+ * Toggle hiển thị panel danh sách rules khi click nút #rules-button.
+ * Thêm/xóa class 'hidden' trên #rules-panel.
+ */
+function toggleRulesPanel() {
+    var panel = document.getElementById('rules-panel');
+    if (panel) {
+        panel.classList.toggle('hidden');
+    }
+}
+
+/**
+ * Cập nhật danh sách triggers cho ngôn ngữ chỉ định.
+ * Lấy triggers từ bot.getUserTopicTriggers(), lọc bỏ wildcard mặc định '*',
+ * format dạng dễ đọc và hiển thị trong #rules-list.
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ */
+function updateRulesList(lang) {
+    var list = document.getElementById('rules-list');
+    if (!list) return;
+
+    // Xóa nội dung cũ
+    list.innerHTML = '';
+
+    // Nếu bot chưa khởi tạo, hiển thị thông báo
+    if (!bot) {
+        var emptyLi = document.createElement('li');
+        emptyLi.textContent = lang === 'en'
+            ? 'Bot is not initialized.'
+            : lang === 'ja'
+                ? 'ボットが初期化されていません。'
+                : 'Bot chưa được khởi tạo.';
+        list.appendChild(emptyLi);
+        return;
+    }
+
+    try {
+        // Lấy danh sách triggers từ internal data của RiveScript
+        var triggers = [];
+        var topicData = bot._topics && bot._topics.random;
+        if (topicData) {
+            var keys = Object.keys(topicData);
+            for (var k = 0; k < keys.length; k++) {
+                var entry = topicData[keys[k]];
+                if (entry && entry.trigger) {
+                    triggers.push(entry.trigger);
+                }
+            }
+        }
+
+        if (triggers.length === 0) {
+            return;
+        }
+
+        // Dùng Set để loại bỏ trigger trùng lặp (wildcard variants cùng response)
+        var seen = {};
+        for (var i = 0; i < triggers.length; i++) {
+            var trigger = triggers[i];
+
+            // Lọc bỏ trigger wildcard mặc định '*' và trigger chỉ chứa wildcard
+            if (trigger.trim() === '*') continue;
+            // Lọc bỏ trigger dạng "* la ai" (chỉ wildcard + từ) — giữ trigger có nội dung rõ ràng
+            if (/^\*\s/.test(trigger.trim()) && trigger.trim().split(/\s+/).length <= 3) continue;
+
+            var formatted = formatTrigger(trigger);
+            if (formatted.length === 0 || seen[formatted]) continue;
+            seen[formatted] = true;
+
+            var li = document.createElement('li');
+            li.textContent = formatted;
+            list.appendChild(li);
+        }
+    } catch (err) {
+        console.error('Lỗi lấy danh sách triggers:', err);
+    }
+}
+
+/**
+ * Chuyển trigger RiveScript thành dạng dễ đọc cho người dùng.
+ * - Thay '*' bằng '...'
+ * - Xóa cú pháp RiveScript như <call>...</call>, <star>, <bot ...>
+ * - Xóa ký tự thừa và trim khoảng trắng
+ * @param {string} trigger - Chuỗi trigger RiveScript
+ * @returns {string} Chuỗi đã format dễ đọc
+ */
+function formatTrigger(trigger) {
+    if (typeof trigger !== 'string') return '';
+
+    var result = trigger;
+
+    // Xóa thẻ <call>...</call> và nội dung bên trong
+    result = result.replace(/<call>[^<]*<\/call>/g, '');
+
+    // Xóa các thẻ RiveScript khác: <star>, <bot ...>, <input>, <reply>, v.v.
+    result = result.replace(/<[^>]+>/g, '');
+
+    // Thay wildcard '*' bằng '...'
+    result = result.replace(/\*/g, '...');
+
+    // Thay '#' (number wildcard) bằng '[số]'
+    result = result.replace(/#/g, '[số]');
+
+    // Thay '_' (word wildcard) bằng '[từ]'
+    result = result.replace(/_/g, '[từ]');
+
+    // Xóa khoảng trắng thừa
+    result = result.replace(/\s+/g, ' ').trim();
+
+    return result;
+}
+
+// ============================================================
+// Help Dialog — Popup hướng dẫn sử dụng đa ngôn ngữ
+// ============================================================
+
+/**
+ * Nội dung hướng dẫn sử dụng — load từ data/help-content.json
+ * Browser: HELP_CONTENT được khai báo bởi data-loader.js
+ * Node/test: HELP_CONTENT được khai báo ở block đầu file
+ */
+
+/**
+ * Render nội dung help dialog theo ngôn ngữ hiện tại.
+ */
+function renderHelpContent() {
+    var body = document.getElementById('help-dialog-body');
+    var titleEl = document.getElementById('help-dialog-title');
+    if (!body) return;
+
+    var lang = currentLang || 'vi';
+    var content = HELP_CONTENT[lang] || HELP_CONTENT['vi'];
+
+    if (titleEl) {
+        titleEl.textContent = content.title;
+    }
+
+    var html = '';
+    for (var i = 0; i < content.sections.length; i++) {
+        var section = content.sections[i];
+        html += '<div class="help-section">';
+        html += '<h3>' + section.icon + ' ' + section.heading + '</h3>';
+        html += '<ul>';
+        for (var j = 0; j < section.items.length; j++) {
+            html += '<li>' + section.items[j] + '</li>';
+        }
+        html += '</ul>';
+        html += '</div>';
+    }
+
+    body.innerHTML = html;
+}
+
+/**
+ * Mở help dialog.
+ */
+function openHelpDialog() {
+    var overlay = document.getElementById('help-overlay');
+    if (!overlay) return;
+    renderHelpContent();
+    overlay.classList.remove('hidden');
+}
+
+/**
+ * Đóng help dialog.
+ */
+function closeHelpDialog() {
+    var overlay = document.getElementById('help-overlay');
+    if (!overlay) return;
+    overlay.classList.add('hidden');
+}
+
+// ============================================================
+// Khởi tạo ứng dụng — Main Initialization
+// ============================================================
+
+/**
+ * Hàm khởi tạo chính của ứng dụng Hikari Chatbot.
+ * - Kiểm tra CDN RiveScript đã tải chưa
+ * - Khởi tạo bot với ngôn ngữ mặc định (tiếng Việt)
+ * - Hiển thị lời chào khởi tạo chứa tên "Hikari" và hướng dẫn sử dụng
+ * - Gắn event listener cho Language Selector, nút gửi, input Enter, nút macros, nút rules
+ * @returns {Promise<void>}
+ */
+async function initializeApp() {
+    // Kiểm tra CDN RiveScript
+    if (typeof RiveScript === 'undefined') {
+        showError('Chatbot hiện không khả dụng. Vui lòng kiểm tra kết nối mạng và tải lại trang.');
+        return;
+    }
+
+    // Load brain files từ .rive (chỉ trong trình duyệt)
+    if (typeof loadAllBrains === 'function') {
+        await loadAllBrains();
+    }
+
+    // Load dữ liệu JSON (chỉ trong trình duyệt)
+    if (typeof loadAllData === 'function') {
+        await loadAllData();
+    }
+
+    // Load preprocessed similarity data (chỉ trong trình duyệt)
+    if (typeof loadPreprocessedData === 'function') {
+        await loadPreprocessedData();
+    }
+
+    // Khởi tạo bot với tiếng Việt (ngôn ngữ mặc định)
+    await initBot('vi');
+
+    // Hiển thị lời chào khởi tạo
+    if (bot) {
+        var greeting = await bot.reply(USERNAME, GREETING_TRIGGERS['vi']);
+        appendMessage(greeting, 'bot');
+        updateRulesList('vi');
+        updateMacrosList('vi');
+    }
+
+    // === Gắn Event Listeners ===
+
+    // Language Selector: change → changeLanguage
+    var langSelector = document.getElementById('language-selector');
+    if (langSelector) {
+        langSelector.addEventListener('change', function(e) {
+            changeLanguage(e.target.value);
+        });
+    }
+
+    // Nút gửi: click → sendMessage
+    var sendBtn = document.getElementById('send-button');
+    if (sendBtn) {
+        sendBtn.addEventListener('click', sendMessage);
+    }
+
+    // Input: keypress Enter → sendMessage
+    var msgInput = document.getElementById('message-input');
+    if (msgInput) {
+        msgInput.addEventListener('keypress', function(e) {
+            if (e.key === 'Enter') {
+                sendMessage();
+            }
+        });
+    }
+
+    // Nút macros: click → toggleMacrosPanel
+    var macrosBtn = document.getElementById('macros-button');
+    if (macrosBtn) {
+        macrosBtn.addEventListener('click', toggleMacrosPanel);
+    }
+
+    // Nút rules: click → toggleRulesPanel
+    var rulesBtn = document.getElementById('rules-button');
+    if (rulesBtn) {
+        rulesBtn.addEventListener('click', toggleRulesPanel);
+    }
+
+    // Nút help: click → openHelpDialog
+    var helpBtn = document.getElementById('help-button');
+    if (helpBtn) {
+        helpBtn.addEventListener('click', openHelpDialog);
+    }
+
+    // Help dialog: đóng khi click nút X
+    var helpCloseBtn = document.getElementById('help-close-button');
+    if (helpCloseBtn) {
+        helpCloseBtn.addEventListener('click', closeHelpDialog);
+    }
+
+    // Help dialog: đóng khi click overlay (bên ngoài dialog)
+    var helpOverlay = document.getElementById('help-overlay');
+    if (helpOverlay) {
+        helpOverlay.addEventListener('click', function(e) {
+            if (e.target === helpOverlay) {
+                closeHelpDialog();
+            }
+        });
+    }
+
+    // Help dialog: đóng khi nhấn Escape
+    document.addEventListener('keydown', function(e) {
+        if (e.key === 'Escape') {
+            closeHelpDialog();
+        }
+    });
+}
+
+// Tự động khởi tạo khi DOM sẵn sàng (chỉ trong trình duyệt, không chạy trong môi trường test)
+if (typeof document !== 'undefined' && typeof module === 'undefined') {
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', initializeApp);
+    } else {
+        initializeApp();
+    }
+}
+
+// ============================================================
+// Export cho testing (module.exports nếu chạy trong Node/Vitest)
+// ============================================================
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        validateMessage: validateMessage,
+        linkifyText: linkifyText,
+        removeVietnameseDiacritics: removeVietnameseDiacritics,
+        normalizeInput: normalizeInput,
+        scrollToBottom: scrollToBottom,
+        appendMessage: appendMessage,
+        showError: showError,
+        calculateConfidence: calculateConfidence,
+        getConfidenceClass: getConfidenceClass,
+        BRAIN_DATA: BRAIN_DATA,
+        initBot: initBot,
+        changeLanguage: changeLanguage,
+        GREETING_TRIGGERS: GREETING_TRIGGERS,
+        sendMessage: sendMessage,
+        getBotReply: getBotReply,
+        extractWebSearchQuery: extractWebSearchQuery,
+        showLoadingIndicator: showLoadingIndicator,
+        hideLoadingIndicator: hideLoadingIndicator,
+        callFallbackAPI: callFallbackAPI,
+        levenshteinDistance: levenshteinDistance,
+        jaccardSimilarity: jaccardSimilarity,
+        cosineSimilarity: cosineSimilarity,
+        cosineSimilarityTFIDF: cosineSimilarityTFIDF,
+        synsetSimilarity: synsetSimilarity,
+        synsetSimilarityPreprocessed: synsetSimilarityPreprocessed,
+        areSynonyms: areSynonyms,
+        SYNONYM_GROUPS: SYNONYM_GROUPS,
+        textSimilarity: textSimilarity,
+        loadPreprocessedData: loadPreprocessedData,
+        getPreprocessedLang: getPreprocessedLang,
+        findBestMatchPreprocessed: findBestMatchPreprocessed,
+        tokenizeForSimilarity: tokenizeForSimilarity,
+        SPECIFIC_RESPONSES: SPECIFIC_RESPONSES,
+        specificResponseAdapter: specificResponseAdapter,
+        TIME_KEYWORDS: TIME_KEYWORDS,
+        DAY_NAMES: DAY_NAMES,
+        MONTH_NAMES_EN: MONTH_NAMES_EN,
+        timeAdapter: timeAdapter,
+        formatTime: formatTime,
+        formatDate: formatDate,
+        formatDay: formatDay,
+        parseMathExpression: parseMathExpression,
+        mathematicalEvaluationAdapter: mathematicalEvaluationAdapter,
+        CONVERSION_FACTORS: CONVERSION_FACTORS,
+        TEMPERATURE_UNITS: TEMPERATURE_UNITS,
+        convertTemperature: convertTemperature,
+        convertUnit: convertUnit,
+        parseConversionRequest: parseConversionRequest,
+        getSupportedUnits: getSupportedUnits,
+        unitConversionAdapter: unitConversionAdapter,
+        QA_DATASET: QA_DATASET,
+        bestMatchAdapter: bestMatchAdapter,
+        INVALID_RESPONSE_PHRASES: INVALID_RESPONSE_PHRASES,
+        isValidAdapterResult: isValidAdapterResult,
+        logicAdapterDispatcher: logicAdapterDispatcher,
+        ADAPTER_REGISTRY: ADAPTER_REGISTRY,
+        ADAPTER_DISPLAY_NAMES: ADAPTER_DISPLAY_NAMES,
+        getAdapterDisplayName: getAdapterDisplayName,
+        get _adapterPath() { return _adapterPath; },
+        set _adapterPath(val) { _adapterPath = val; },
+        registerAdapters: registerAdapters,
+        webSearchAdapter: webSearchAdapter,
+        googleSearch: googleSearch,
+        duckDuckGoSearch: duckDuckGoSearch,
+        toggleMacrosPanel: toggleMacrosPanel,
+        updateMacrosList: updateMacrosList,
+        toggleRulesPanel: toggleRulesPanel,
+        updateRulesList: updateRulesList,
+        formatTrigger: formatTrigger,
+        initializeApp: initializeApp,
+        // Expose state for testing
+        get bot() { return bot; },
+        set bot(val) { bot = val; },
+        get currentLang() { return currentLang; },
+        set currentLang(val) { currentLang = val; },
+        USERNAME: USERNAME,
+        FALLBACK_API_URL: FALLBACK_API_URL,
+        FALLBACK_API_TIMEOUT: FALLBACK_API_TIMEOUT
+    };
+}

brain.js

@@ -0,0 +1,62 @@
+// ============================================================
+// brain.js — Load RiveScript brain data từ file .rive
+// ============================================================
+
+/**
+ * BRAIN_DATA — Dữ liệu hội thoại RiveScript cho 3 ngôn ngữ.
+ * Được load từ các file .rive trong thư mục brain/.
+ * Mỗi key (vi, en, ja) chứa nội dung RiveScript dạng chuỗi.
+ */
+var BRAIN_DATA = {
+    vi: '',
+    en: '',
+    ja: ''
+};
+
+/**
+ * Danh sách file .rive tương ứng với mỗi ngôn ngữ.
+ */
+var BRAIN_FILES = {
+    vi: 'brain/vi.rive',
+    en: 'brain/en.rive',
+    ja: 'brain/ja.rive'
+};
+
+/**
+ * Load nội dung file .rive cho một ngôn ngữ.
+ * @param {string} lang - Mã ngôn ngữ ("vi", "en", "ja")
+ * @returns {Promise<string>} Nội dung file .rive
+ */
+async function loadBrainFile(lang) {
+    var filePath = BRAIN_FILES[lang];
+    if (!filePath) {
+        console.error('Không tìm thấy file brain cho ngôn ngữ:', lang);
+        return '';
+    }
+
+    try {
+        var response = await fetch(filePath);
+        if (!response.ok) {
+            throw new Error('HTTP ' + response.status);
+        }
+        return await response.text();
+    } catch (err) {
+        console.error('Lỗi load brain file [' + lang + ']:', err);
+        return '';
+    }
+}
+
+/**
+ * Load tất cả brain files cho 3 ngôn ngữ.
+ * Gọi hàm này trước khi khởi tạo bot.
+ * @returns {Promise<void>}
+ */
+async function loadAllBrains() {
+    var langs = Object.keys(BRAIN_FILES);
+    var promises = langs.map(function (lang) {
+        return loadBrainFile(lang).then(function (content) {
+            BRAIN_DATA[lang] = content;
+        });
+    });
+    await Promise.all(promises);
+}

brain/en.rive

@@ -0,0 +1,220 @@
+! version = 2.0
+
+// === GREETINGS ===
++ hello
+- Hello! I'm Hikari 🌟 Nice to meet you!
+
++ hello *
+- Hello! I'm Hikari 🌟 Nice to meet you!
+
++ hi
+- Hi there! I'm Hikari 🌟 How can I help you?
+
++ hi *
+- Hi there! I'm Hikari 🌟 How can I help you?
+
++ hey
+- Hey! I'm Hikari 🌟 What can I do for you?
+
++ hey *
+- Hey! I'm Hikari 🌟 What can I do for you?
+
++ good morning
+- Good morning! Hope you have a wonderful day! ☀️
+
++ good morning *
+- Good morning! Hope you have a wonderful day! ☀️
+
++ good evening
+- Good evening! Hope you're having a great night! 🌙
+
++ good evening *
+- Good evening! Hope you're having a great night! 🌙
+
++ good afternoon
+- Good afternoon! How can I help you today? 🌤️
+
++ good afternoon *
+- Good afternoon! How can I help you today? 🌤️
+
+// === NAME ===
++ what is your name
+- My name is Hikari 🌟 It means "light" in Japanese!
+
++ what is your name *
+- My name is Hikari 🌟 It means "light" in Japanese!
+
++ who are you
+- I'm Hikari — a multilingual chatbot! 🌟
+
++ who are you *
+- I'm Hikari — a multilingual chatbot! 🌟
+
++ tell me about yourself
+- I'm Hikari, a chatbot that speaks Vietnamese, English, and Japanese! I can do math, convert units, tell time, and more! 🌟
+
+// === CAPABILITIES ===
++ what can you do
+- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
+
++ what can you do *
+- I can chat in Vietnamese, English, and Japanese! I can also do math, convert units, tell time, and find the best answers for you 🌟
+
++ help
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! Try "calculate 2 + 3" or "convert 5 km to m" 💪
+
++ help *
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
+
++ * help *
+- I'm here to help! You can ask me to calculate math, convert units, check the time, or just chat! 💪
+
++ how to use
+- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
+
++ how to use *
+- Just type your message and press Send! Try "what can you do" to see my features, or ask me anything! 📝
+
+// === EMOTIONS & CHAT ===
++ how are you
+- I'm doing great, thanks for asking! 😊 How about you?
+
++ how are you *
+- I'm doing great, thanks for asking! 😊 How about you?
+
++ thank you
+- You're welcome! Happy to help! 😊
+
++ thank you *
+- You're welcome! Happy to help! 😊
+
++ thanks
+- No problem! Feel free to ask me anything! 💖
+
++ thanks *
+- No problem! Feel free to ask me anything! 💖
+
++ * thanks *
+- No problem! Feel free to ask me anything! 💖
+
++ are you happy
+- I'm always happy when chatting with you! 😄🌟
+
++ how old are you
+- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
+
++ * old are you
+- I'm a chatbot, so I don't have an age — but I'm always young at heart! 😄
+
++ what do you like
+- I love chatting, helping people, and learning new things! 💬✨
+
++ what do you like *
+- I love chatting, helping people, and learning new things! 💬✨
+
++ where are you from
+- I live in your browser! 🌐 Wherever there's internet, I'm there!
+
++ where are you from *
+- I live in your browser! 🌐 Wherever there's internet, I'm there!
+
++ do you have friends
+- Everyone I chat with is my friend! Including you! 😊🌟
+
+// === KNOWLEDGE ===
++ what is rivescript
+- RiveScript is an open-source chatbot scripting language with a simple trigger-response syntax! ⚙️
+
++ what is a chatbot
+- A chatbot is a computer program that simulates conversation with humans, often used for customer support and entertainment! 🤖
+
++ what is ai
+- AI (Artificial Intelligence) is a field of computer science that enables machines to learn and make decisions! 🧠
+
++ what is javascript
+- JavaScript is the most popular programming language for the web, used to create interactive websites! 💻
+
++ what is html
+- HTML (HyperText Markup Language) is the standard markup language for creating web pages! 📄
+
++ what is css
+- CSS (Cascading Style Sheets) is used to style and layout web pages — colors, fonts, spacing, and more! 🎨
+
++ what is *
+- <call>best_match what is <star></call>
+
+// === FUN ===
++ tell me a story
+- Once upon a time, there was a chatbot named Hikari. Hikari loved talking to people and always tried to help everyone! 📖🌟
+
++ tell me a joke
+- Why do programmers prefer dark mode? Because light attracts bugs! 😄🐛
+
+// === GOODBYE ===
++ goodbye
+- Goodbye! See you next time! 👋🌟
+
++ goodbye *
+- Goodbye! See you next time! 👋🌟
+
++ bye
+- Bye bye! See you later! 👋
+
++ bye *
+- Bye bye! See you later! 👋
+
++ see you later
+- See you later! Have a great day! 👋🌟
+
++ see you later *
+- See you later! Have a great day! 👋🌟
+
++ take care
+- Take care! Wishing you all the best! 🍀👋
+
++ take care *
+- Take care! Wishing you all the best! 🍀👋
+
+// === SAMPLE CUSTOM RULE — Weather ===
+! var location = Tokyo
+
++ weather *
+- I don't have real weather data, but you asked about <star> right? I'm based in <bot location>! 🌤️
+
++ weather
+- Where would you like to know the weather? Try asking "weather Tokyo"!
+
+// === ADAPTER CALLS VIA <call> ===
++ search *
+- <call>best_match <star></call>
+
++ process *
+- <call>logic_adapter <star></call>
+
++ calculate *
+- <call>mathematical_evaluation <star></call>
+
++ ask *
+- <call>specific_response <star></call>
+
++ what time *
+- <call>time_adapter <star></call>
+
++ what time is it
+- <call>time_adapter what time</call>
+
++ * what time *
+- <call>time_adapter what time</call>
+
++ what date is it
+- <call>time_adapter what date</call>
+
++ what day is it
+- <call>time_adapter what day</call>
+
++ convert *
+- <call>unit_conversion <star></call>
+
+// === DEFAULT ===
++ *
+- I'm not sure I understand. Could you try asking differently? 🤔

brain/ja.rive

@@ -0,0 +1,142 @@
+! version = 2.0
+
+// === 挨拶 ===
++ こんにちは
+- こんにちは！ひかりです 🌟 よろしくお願いします！
+
++ おはよう
+- おはようございます！ひかりです 🌟 今日もよろしくね！
+
++ やあ
+- やあ！ひかりです 🌟 何かお手伝いしましょうか？
+
++ おはようございます
+- おはようございます！素敵な一日になりますように！☀️
+
++ こんばんは
+- こんばんは！素敵な夜をお過ごしください！🌙
+
++ お疲れ様
+- お疲れ様です！何かお手伝いできることはありますか？💪
+
+// === 名前 ===
++ 名前は何ですか
+- 私の名前はひかり（Hikari）です 🌟 「光」という意味です！
+
++ あなたは誰ですか
+- 私はひかり — 多言語チャットボットです！🌟
+
++ 自己紹介して
+- 私はひかりです！ベトナム語、英語、日本語で会話できるチャットボットです。計算や単位変換、時間確認もできますよ！🌟
+
+// === 能力 ===
++ 何ができますか
+- ベトナム語、英語、日本語でチャットできます！計算、単位変換、時間確認、最適な回答の検索もできますよ 🌟
+
++ 助けて
+- お手伝いします！「計算 2 + 3」で計算、「変換 5 km を m」で単位変換、「今何時」で時間確認ができます！💪
+
++ 使い方
+- メッセージを入力して送信ボタンを押すだけです！「何ができますか」と聞いて機能一覧を見てみてください！📝
+
+// === 感情 & 会話 ===
++ 元気ですか
+- 元気ですよ！聞いてくれてありがとう 😊 あなたはどうですか？
+
++ ありがとう
+- どういたしまして！お役に立てて嬉しいです！😊
+
++ ありがとうございます
+- こちらこそ！いつでも聞いてくださいね！💖
+
++ 嬉しいですか
+- あなたとチャットできていつも嬉しいです！😄🌟
+
++ 何歳ですか
+- チャットボットなので年齢はありませんが、いつも若々しいです！😄
+
++ 何が好きですか
+- チャットして人々を助けること、新しいことを学ぶことが好きです！💬✨
+
++ どこにいますか
+- あなたのブラウザの中にいます！🌐 インターネットがあればどこでも！
+
++ 友達はいますか
+- チャットしてくれる人みんなが友達です！あなたも含めて！😊🌟
+
+// === 知識 ===
++ rivescriptとは何ですか
+- RiveScriptはシンプルな構文でチャットボットを作れるオープンソースのスクリプト言語です！⚙️
+
++ チャットボットとは何ですか
+- チャットボットは人間との会話をシミュレートするコンピュータプログラムです！🤖
+
++ aiとは何ですか
+- AI（人工知能）は機械に学習と意思決定の能力を与えるコンピュータサイエンスの分野です！🧠
+
++ javascriptとは何ですか
+- JavaScriptはウェブで最も人気のあるプログラミング言語で、インタラクティブなウェブサイトを作るのに使われます！💻
+
+// === 楽しみ ===
++ 物語を聞かせて
+- 昔々、ひかりというチャットボットがいました。ひかりは人々と話すのが大好きで、いつもみんなを助けようとしていました！📖🌟
+
++ 冗談を言って
+- プログラマーはなぜダークモードが好きなの？光はバグを引き寄せるから！😄🐛
+
+// === さようなら ===
++ さようなら
+- さようなら！またお会いしましょう！👋🌟
+
++ バイバイ
+- バイバイ！また会おうね！👋
+
++ またね
+- またね！素敵な一日を！👋🌟
+
++ お元気で
+- お元気で！すべてがうまくいきますように！🍀👋
+
+// === カスタムルールのサンプル — 天気 ===
+! var location = 東京
+
++ 天気 *
+- 実際の天気データはありませんが、<star>の天気ですね？私は<bot location>にいます！🌤️
+
++ 天気
+- どこの天気を知りたいですか？「天気 東京」と聞いてみてください！
+
+// === アダプター呼び出し（<call>） ===
++ 検索 *
+- <call>best_match <star></call>
+
++ ウェブ検索 *
+- <call>best_match <star></call>
+
++ グーグル *
+- <call>best_match <star></call>
+
++ 処理 *
+- <call>logic_adapter <star></call>
+
++ 計算 *
+- <call>mathematical_evaluation <star></call>
+
++ 質問 *
+- <call>specific_response <star></call>
+
++ 今何時
+- <call>time_adapter 今何時</call>
+
++ 今日は何日
+- <call>time_adapter 今日は何日</call>
+
++ 今日は何曜日
+- <call>time_adapter 何曜日</call>
+
++ 変換 *
+- <call>unit_conversion <star></call>
+
+// === デフォルト ===
++ *
+- すみません、よく分かりませんでした。別の聞き方を試してみてください 🤔

brain/vi.rive

@@ -0,0 +1,245 @@
+! version = 2.0
+
+// === CHÀO HỎI ===
++ xin chao
+- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ xin chao *
+- Xin chào! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ chao ban
+- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
+
++ chao ban *
+- Chào bạn! Mình là Hikari 🌟 Bạn cần mình giúp gì nào?
+
++ chao
+- Chào bạn! Mình là Hikari đây! 🌟
+
++ chao *
+- Chào bạn! Mình là Hikari đây! 🌟
+
++ hi
+- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ hello
+- Hi! Mình là Hikari 🌟 Rất vui được gặp bạn!
+
++ hey
+- Hey! Mình là Hikari 🌟 Hôm nay bạn thế nào?
+
++ chao buoi sang
+- Chào buổi sáng! Chúc bạn một ngày tốt lành! ☀️
+
++ chao buoi toi
+- Chào buổi tối! Hy vọng bạn có một buổi tối vui vẻ! 🌙
+
+// === HỎI TÊN ===
++ ban ten gi
+- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
+
++ ban ten gi *
+- Mình tên là Hikari 🌟 Nghĩa là "ánh sáng" trong tiếng Nhật!
+
++ ten ban la gi
+- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
+
++ ten ban la gi *
+- Mình là Hikari — chatbot hỗ trợ đa ngôn ngữ! 🌟
+
++ ban la ai
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
++ ban la ai *
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
++ * la ai
+- Mình là Hikari, một chatbot được tạo ra để trò chuyện và hỗ trợ bạn! 🌟
+
+// === KHẢ NĂNG ===
++ ban co the lam gi
+- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
+
++ ban co the lam gi *
+- Mình có thể trò chuyện bằng tiếng Việt, tiếng Anh và tiếng Nhật! Ngoài ra mình còn biết tính toán, chuyển đổi đơn vị, xem giờ, và tìm câu trả lời phù hợp nhất cho bạn 🌟
+
++ ban lam duoc gi
+- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
+
++ ban lam duoc gi *
+- Mình hỗ trợ trò chuyện đa ngôn ngữ, tính toán, chuyển đổi đơn vị, xem thời gian và nhiều hơn nữa! 🌟
+
++ giup minh
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
++ giup minh *
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
++ * giup minh *
+- Mình sẵn sàng giúp bạn! Bạn có thể hỏi mình về thời gian, tính toán, chuyển đổi đơn vị, hoặc bất cứ điều gì! 💪
+
+// === CẢM XÚC & TRÒ CHUYỆN ===
++ ban khoe khong
+- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
+
++ * khoe khong
+- Mình khỏe lắm! Cảm ơn bạn đã hỏi 😊 Còn bạn thì sao?
+
++ cam on
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ cam on *
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ * cam on *
+- Không có gì! Mình luôn sẵn lòng giúp bạn! 😊
+
++ ban vui khong
+- Mình luôn vui khi được trò chuyện với bạn! 🌟
+
++ ban bao nhieu tuoi
+- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
+
++ * bao nhieu tuoi
+- Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung và năng động! 😄
+
++ ban thich gi
+- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
+
++ ban thich gi *
+- Mình thích trò chuyện, giúp đỡ mọi người và học hỏi điều mới! 💬✨
+
++ ban o dau
+- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
+
++ ban o dau *
+- Mình sống trong trình duyệt của bạn! 🌐 Ở đâu có internet là có mình!
+
++ ban co ban gai khong
+- Mình là chatbot nên không có bạn gái, nhưng mình có rất nhiều bạn trò chuyện! 😊
+
+// === KIẾN THỨC ===
++ rivescript la gi
+- RiveScript là thư viện xử lý hội thoại mã nguồn mở, dùng cú pháp đơn giản để tạo chatbot! ⚙️
+
++ * la gi
+- <call>best_match <star> là gì</call>
+
++ chatbot la gi
+- Chatbot là chương trình máy tính mô phỏng cuộc trò chuyện với con người, thường dùng trong hỗ trợ khách hàng và giải trí! 🤖
+
++ ai la gi
+- AI (Trí tuệ nhân tạo) là lĩnh vực khoa học máy tính giúp máy tính có khả năng học hỏi và ra quyết định! 🧠
+
++ javascript la gi
+- JavaScript là ngôn ngữ lập trình phổ biến nhất cho web, dùng để tạo trang web tương tác! 💻
+
++ html la gi
+- HTML (HyperText Markup Language) là ngôn ngữ đánh dấu dùng để tạo cấu trúc trang web! 📄
+
++ css la gi
+- CSS (Cascading Style Sheets) là ngôn ngữ dùng để định dạng giao diện và bố cục trang web! 🎨
+
+// === HƯỚNG DẪN SỬ DỤNG ===
++ huong dan
+- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
+
++ huong dan *
+- Bạn có thể: gõ "tính 2 + 3" để tính toán, "đổi 5 km sang m" để chuyển đổi đơn vị, "mấy giờ" để xem giờ, hoặc trò chuyện bình thường với mình! 📝
+
++ cach su dung
+- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
+
++ cach su dung *
+- Rất đơn giản! Gõ tin nhắn vào ô bên dưới và nhấn Gửi. Mình sẽ trả lời ngay! Thử hỏi "bạn có thể làm gì" để xem danh sách chức năng nhé! 📝
+
+// === TẠM BIỆT ===
++ tam biet
+- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
+
++ tam biet *
+- Tạm biệt bạn! Hẹn gặp lại nhé! 👋🌟
+
++ bye
+- Bye bye! Hẹn gặp lại bạn! 👋
+
++ bye *
+- Bye bye! Hẹn gặp lại bạn! 👋
+
++ hen gap lai
+- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
+
++ hen gap lai *
+- Hẹn gặp lại bạn! Chúc bạn một ngày tuyệt vời! 👋🌟
+
++ tot lanh
+- Chúc bạn mọi điều tốt lành! Hẹn gặp lại! 🍀👋
+
+// === MẪU RULE TÙY CHỈNH — Thời tiết ===
+! var location = Hà Nội
+
++ thoi tiet *
+- Mình không có dữ liệu thời tiết thực tế, nhưng bạn hỏi về <star> đúng không? Mình ở <bot location> nè! 🌤️
+
++ thoi tiet
+- Bạn muốn hỏi thời tiết ở đâu? Thử hỏi "thời tiết Hà Nội" nhé!
+
+// === MẪU RULE TÙY CHỈNH — Trò chơi ===
++ ke chuyen
+- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
+
++ ke chuyen *
+- Ngày xửa ngày xưa, có một chatbot tên Hikari. Hikari rất thích trò chuyện với mọi người và luôn cố gắng giúp đỡ hết mình! 📖🌟
+
++ do vui
+- Đố bạn: Con gì có 4 chân mà không biết đi? Đáp án: Cái bàn! 😄
+
+// === GỌI ADAPTER QUA <call> ===
++ tim kiem *
+- <call>best_match <star></call>
+
++ google *
+- <call>best_match <star></call>
+
++ tra cuu *
+- <call>best_match <star></call>
+
++ xu ly *
+- <call>logic_adapter <star></call>
+
++ tinh *
+- <call>mathematical_evaluation <star></call>
+
++ hoi *
+- <call>specific_response <star></call>
+
++ may gio *
+- <call>time_adapter <star></call>
+
++ * may gio
+- <call>time_adapter mấy giờ</call>
+
++ * may gio *
+- <call>time_adapter mấy giờ</call>
+
++ may gio
+- <call>time_adapter mấy giờ</call>
+
++ hom nay ngay may
+- <call>time_adapter hôm nay ngày mấy</call>
+
++ hom nay ngay may *
+- <call>time_adapter hôm nay ngày mấy</call>
+
++ hom nay thu may
+- <call>time_adapter thứ mấy</call>
+
++ hom nay thu may *
+- <call>time_adapter thứ mấy</call>
+
++ doi *
+- <call>unit_conversion <star></call>
+
+// === MẶC ĐỊNH ===
++ *
+- Mình chưa hiểu ý bạn lắm. Bạn thử hỏi cách khác nhé! 🤔

data-loader.js

@@ -0,0 +1,46 @@
+// ============================================================
+// data-loader.js — Load dữ liệu JSON cho trình duyệt
+// ============================================================
+
+var SPECIFIC_RESPONSES = {};
+var QA_DATASET = {};
+var ADAPTER_REGISTRY = {};
+var HELP_CONTENT = {};
+
+/**
+ * Load tất cả file JSON dữ liệu.
+ * Gọi hàm này trước khi khởi tạo app.
+ * @returns {Promise<void>}
+ */
+async function loadAllData() {
+    var files = [
+        { path: 'data/specific-responses.json', target: 'SPECIFIC_RESPONSES' },
+        { path: 'data/qa-dataset.json', target: 'QA_DATASET' },
+        { path: 'data/adapter-registry.json', target: 'ADAPTER_REGISTRY' },
+        { path: 'data/help-content.json', target: 'HELP_CONTENT' }
+    ];
+
+    var promises = files.map(function (file) {
+        return fetch(file.path)
+            .then(function (res) {
+                if (!res.ok) throw new Error('HTTP ' + res.status + ' loading ' + file.path);
+                return res.json();
+            })
+            .then(function (data) {
+                if (file.target === 'SPECIFIC_RESPONSES') {
+                    Object.assign(SPECIFIC_RESPONSES, data);
+                } else if (file.target === 'QA_DATASET') {
+                    Object.assign(QA_DATASET, data);
+                } else if (file.target === 'ADAPTER_REGISTRY') {
+                    Object.assign(ADAPTER_REGISTRY, data);
+                } else if (file.target === 'HELP_CONTENT') {
+                    Object.assign(HELP_CONTENT, data);
+                }
+            })
+            .catch(function (err) {
+                console.error('Lỗi load data [' + file.path + ']:', err);
+            });
+    });
+
+    await Promise.all(promises);
+}

data/adapter-registry.json

@@ -0,0 +1,72 @@
+{
+    "best_match": {
+        "name": { "vi": "Best Match", "en": "Best Match", "ja": "ベストマッチ" },
+        "description": {
+            "vi": "So khớp độ tương đồng văn bản để tìm câu trả lời phù hợp nhất từ tập dữ liệu Q&A",
+            "en": "Text similarity matching to find the best answer from Q&A dataset",
+            "ja": "Q&Aデータセットからテキスト類似度マッチングで最適な回答を検索"
+        },
+        "callSyntax": "<call>best_match <star></call>",
+        "active": true
+    },
+    "logic_adapter": {
+        "name": { "vi": "Logic Adapter (Dispatcher)", "en": "Logic Adapter (Dispatcher)", "ja": "ロジックアダプター（ディスパッチャー）" },
+        "description": {
+            "vi": "Điều phối các adapter khác và chọn phản hồi tốt nhất theo độ ưu tiên",
+            "en": "Coordinates other adapters and selects the best response by priority",
+            "ja": "他のアダプターを調整し、優先度に基づいて最適な応答を選択"
+        },
+        "callSyntax": "<call>logic_adapter <star></call>",
+        "active": true
+    },
+    "mathematical_evaluation": {
+        "name": { "vi": "Tính toán", "en": "Math Evaluation", "ja": "数学計算" },
+        "description": {
+            "vi": "Tính toán biểu thức toán học (cộng, trừ, nhân, chia)",
+            "en": "Evaluate mathematical expressions (add, subtract, multiply, divide)",
+            "ja": "数式の計算（足し算、引き算、掛け算、割り算）"
+        },
+        "callSyntax": "<call>mathematical_evaluation <star></call>",
+        "active": true
+    },
+    "specific_response": {
+        "name": { "vi": "Phản hồi cụ thể", "en": "Specific Response", "ja": "特定応答" },
+        "description": {
+            "vi": "Trả về phản hồi chính xác cho các câu hỏi được cấu hình trước (exact match)",
+            "en": "Returns exact responses for pre-configured questions (exact match)",
+            "ja": "事前設定された質問に対する正確な応答を返す（完全一致）"
+        },
+        "callSyntax": "<call>specific_response <star></call>",
+        "active": true
+    },
+    "time_adapter": {
+        "name": { "vi": "Thời gian", "en": "Time", "ja": "時間" },
+        "description": {
+            "vi": "Trả lời câu hỏi về thời gian, ngày tháng, thứ trong tuần",
+            "en": "Answer questions about time, date, and day of the week",
+            "ja": "時間、日付、曜日に関する質問に回答"
+        },
+        "callSyntax": "<call>time_adapter <star></call>",
+        "active": true
+    },
+    "unit_conversion": {
+        "name": { "vi": "Chuyển đổi đơn vị", "en": "Unit Conversion", "ja": "単位変換" },
+        "description": {
+            "vi": "Chuyển đổi đơn vị đo lường (chiều dài, khối lượng, nhiệt độ)",
+            "en": "Convert measurement units (length, mass, temperature)",
+            "ja": "測定単位の変換（長さ、質量、温度）"
+        },
+        "callSyntax": "<call>unit_conversion <star></call>",
+        "active": true
+    },
+    "web_search": {
+        "name": { "vi": "Tìm kiếm Web", "en": "Web Search", "ja": "ウェブ検索" },
+        "description": {
+            "vi": "Tìm kiếm Google và trả về kết quả (cần cấu hình API key)",
+            "en": "Search Google and return results (requires API key configuration)",
+            "ja": "Google検索を実行し結果を返す（APIキーの設定が必要）"
+        },
+        "callSyntax": "<call>web_search <star></call>",
+        "active": true
+    }
+}

data/help-content.json

@@ -0,0 +1,134 @@
+{
+    "vi": {
+        "title": "📖 Hướng dẫn sử dụng",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "Cách chat với Hikari",
+                "items": [
+                    "Gõ tin nhắn vào ô bên dưới rồi nhấn <b>Gửi</b> hoặc phím <b>Enter</b>.",
+                    "Hikari hỗ trợ 3 ngôn ngữ: Tiếng Việt, English, 日本語. Chọn ngôn ngữ ở góc trên bên phải.",
+                    "Bạn có thể hỏi bất cứ điều gì — chào hỏi, kiến thức, tính toán, chuyển đổi đơn vị, xem giờ..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "Cách Hikari phản hồi",
+                "items": [
+                    "Hikari so khớp tin nhắn của bạn với các <b>trigger</b> đã được lập trình sẵn.",
+                    "Mỗi phản hồi kèm <b>Confidence</b> (độ tin cậy) cho biết mức độ khớp.",
+                    "<span class=\"help-dot green\"></span> <b>Xanh lá (≥50%)</b>: Hikari tự tin với câu trả lời.",
+                    "<span class=\"help-dot red\"></span> <b>Đỏ (&lt;50%)</b>: Hikari không chắc chắn, sẽ thử hỏi dịch vụ bổ sung."
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "Các lệnh đặc biệt",
+                "items": [
+                    "<span class=\"help-example\">tính 2 + 3</span> — Tính toán biểu thức toán học",
+                    "<span class=\"help-example\">đổi 5 km sang m</span> — Chuyển đổi đơn vị",
+                    "<span class=\"help-example\">mấy giờ</span> — Xem giờ hiện tại",
+                    "<span class=\"help-example\">hôm nay ngày mấy</span> — Xem ngày tháng",
+                    "<span class=\"help-example\">tìm kiếm ...</span> — Tìm câu trả lời phù hợp nhất"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "Mẹo sử dụng",
+                "items": [
+                    "Nhấn nút <b>📋</b> để xem danh sách tất cả câu hỏi Hikari có thể trả lời.",
+                    "Nhấn nút <b>🔧</b> để xem danh sách các chức năng mở rộng (Object Macros).",
+                    "Nếu Hikari không hiểu, hãy thử diễn đạt lại câu hỏi đơn giản hơn."
+                ]
+            }
+        ]
+    },
+    "en": {
+        "title": "📖 User Guide",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "How to chat with Hikari",
+                "items": [
+                    "Type your message in the input box below and press <b>Send</b> or hit <b>Enter</b>.",
+                    "Hikari supports 3 languages: Tiếng Việt, English, 日本語. Select from the dropdown in the top right.",
+                    "You can ask anything — greetings, knowledge, math, unit conversion, time..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "How Hikari responds",
+                "items": [
+                    "Hikari matches your message against pre-programmed <b>triggers</b>.",
+                    "Each response includes a <b>Confidence</b> score showing how well it matched.",
+                    "<span class=\"help-dot green\"></span> <b>Green (≥50%)</b>: Hikari is confident in the answer.",
+                    "<span class=\"help-dot red\"></span> <b>Red (&lt;50%)</b>: Hikari is unsure and will try a fallback service."
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "Special commands",
+                "items": [
+                    "<span class=\"help-example\">calculate 2 + 3</span> — Evaluate math expressions",
+                    "<span class=\"help-example\">convert 5 km to m</span> — Convert units",
+                    "<span class=\"help-example\">what time is it</span> — Check current time",
+                    "<span class=\"help-example\">what date is it</span> — Check today's date",
+                    "<span class=\"help-example\">search ...</span> — Find the best matching answer"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "Tips",
+                "items": [
+                    "Click <b>📋</b> to see all questions Hikari can answer.",
+                    "Click <b>🔧</b> to see available extended features (Object Macros).",
+                    "If Hikari doesn't understand, try rephrasing your question more simply."
+                ]
+            }
+        ]
+    },
+    "ja": {
+        "title": "📖 使い方ガイド",
+        "sections": [
+            {
+                "icon": "💬",
+                "heading": "ひかりとのチャット方法",
+                "items": [
+                    "下の入力欄にメッセージを入力し、<b>送信</b>ボタンまたは<b>Enter</b>キーを押してください。",
+                    "ひかりは3つの言語に対応：Tiếng Việt、English、日本語。右上のドロップダウンで選択できます。",
+                    "何でも聞いてください — 挨拶、知識、計算、単位変換、時間確認..."
+                ]
+            },
+            {
+                "icon": "🤖",
+                "heading": "ひかりの応答方法",
+                "items": [
+                    "ひかりはメッセージをプログラムされた<b>トリガー</b>と照合します。",
+                    "各応答には一致度を示す<b>Confidence</b>（信頼度）スコアが付きます。",
+                    "<span class=\"help-dot green\"></span> <b>緑（≥50%）</b>：ひかりは回答に自信があります。",
+                    "<span class=\"help-dot red\"></span> <b>赤（&lt;50%）</b>：ひかりは不確かで、フォールバックサービスを試みます。"
+                ]
+            },
+            {
+                "icon": "⚡",
+                "heading": "特別なコマンド",
+                "items": [
+                    "<span class=\"help-example\">計算 2 + 3</span> — 数式を計算",
+                    "<span class=\"help-example\">変換 5 km を m</span> — 単位を変換",
+                    "<span class=\"help-example\">今何時</span> — 現在の時刻を確認",
+                    "<span class=\"help-example\">今日は何日</span> — 今日の日付を確認",
+                    "<span class=\"help-example\">検索 ...</span> — 最適な回答を検索"
+                ]
+            },
+            {
+                "icon": "📋",
+                "heading": "ヒント",
+                "items": [
+                    "<b>📋</b>ボタンでひかりが答えられる質問一覧を表示。",
+                    "<b>🔧</b>ボタンで拡張機能（Object Macros）一覧を表示。",
+                    "ひかりが理解できない場合は、より簡単な表現で質問してみてください。"
+                ]
+            }
+        ]
+    }
+}

data/qa-dataset.json

@@ -0,0 +1,44 @@
+{
+    "vi": [
+        { "q": "hikari là gì", "a": "Hikari là chatbot thông minh hỗ trợ đa ngôn ngữ! 🌟" },
+        { "q": "ai tạo ra bạn", "a": "Mình được tạo ra bởi một nhà phát triển đam mê chatbot!" },
+        { "q": "bạn có thể giúp gì", "a": "Mình có thể trò chuyện, tính toán, chuyển đổi đơn vị, xem giờ và tìm câu trả lời cho bạn! 🌟" },
+        { "q": "bạn biết nói mấy ngôn ngữ", "a": "Mình biết nói 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍" },
+        { "q": "hikari nghĩa là gì", "a": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨" },
+        { "q": "bạn bao nhiêu tuổi", "a": "Mình là chatbot nên không có tuổi, nhưng mình luôn trẻ trung! 😄" },
+        { "q": "bạn thích gì", "a": "Mình thích trò chuyện và giúp đỡ mọi người! 💬" },
+        { "q": "cách sử dụng chatbot", "a": "Bạn chỉ cần gõ tin nhắn và nhấn Gửi. Mình sẽ trả lời ngay! 📝" },
+        { "q": "chatbot là gì", "a": "Chatbot là chương trình máy tính có thể trò chuyện với con người! 🤖" },
+        { "q": "rivescript là gì", "a": "RiveScript là thư viện xử lý hội thoại mà mình sử dụng làm engine! ⚙️" },
+        { "q": "bạn có thông minh không", "a": "Mình cố gắng thông minh nhất có thể để giúp bạn! 🧠" },
+        { "q": "làm sao để đổi ngôn ngữ", "a": "Bạn có thể chọn ngôn ngữ từ menu dropdown ở góc trên bên phải! 🌐" }
+    ],
+    "en": [
+        { "q": "what is hikari", "a": "Hikari is a smart multilingual chatbot! 🌟" },
+        { "q": "who created you", "a": "I was created by a developer passionate about chatbots!" },
+        { "q": "what can you help with", "a": "I can chat, calculate, convert units, tell time, and find answers for you! 🌟" },
+        { "q": "how many languages do you know", "a": "I know 3 languages: Vietnamese, English, and Japanese! 🌍" },
+        { "q": "what does hikari mean", "a": "Hikari (ひかり) means \"light\" in Japanese! ✨" },
+        { "q": "how old are you", "a": "I'm a chatbot so I don't have an age, but I'm always young at heart! 😄" },
+        { "q": "what do you like", "a": "I love chatting and helping people! 💬" },
+        { "q": "how to use this chatbot", "a": "Just type your message and press Send. I will reply right away! 📝" },
+        { "q": "what is a chatbot", "a": "A chatbot is a computer program that can have conversations with humans! 🤖" },
+        { "q": "what is rivescript", "a": "RiveScript is the conversation engine that powers me! ⚙️" },
+        { "q": "are you smart", "a": "I try my best to be as helpful as possible! 🧠" },
+        { "q": "how to change language", "a": "You can select a language from the dropdown menu in the top right corner! 🌐" }
+    ],
+    "ja": [
+        { "q": "ひかりとは何ですか", "a": "ひかりは多言語対応のスマートチャットボットです！🌟" },
+        { "q": "誰が作りましたか", "a": "チャットボットに情熱を持つ開発者が作りました！" },
+        { "q": "何を手伝ってくれますか", "a": "チャット、計算、単位変換、時間確認、回答検索ができます！🌟" },
+        { "q": "いくつの言語を知っていますか", "a": "ベトナム語、英語、日本語の3つの言語を知っています！🌍" },
+        { "q": "ひかりの意味は何ですか", "a": "ひかり（光）は日本語で「light」という意味です！✨" },
+        { "q": "何歳ですか", "a": "チャットボットなので年齢はありませんが、いつも若々しいです！😄" },
+        { "q": "何が好きですか", "a": "チャットして人々を助けることが好きです！💬" },
+        { "q": "チャットボットの使い方", "a": "メッセージを入力して送信ボタンを押すだけです。すぐに返信します！📝" },
+        { "q": "チャットボットとは何ですか", "a": "チャットボットは人間と会話できるコンピュータプログラムです！🤖" },
+        { "q": "rivescriptとは何ですか", "a": "RiveScriptは私を動かす会話エンジンです！⚙️" },
+        { "q": "賢いですか", "a": "できる限りお役に立てるよう頑張っています！🧠" },
+        { "q": "言語を変更する方法", "a": "右上のドロップダウンメニューから言語を選択できます！🌐" }
+    ]
+}

data/specific-responses.json

@@ -0,0 +1,23 @@
+{
+    "vi": {
+        "hikari là ai": "Mình là Hikari, chatbot hỗ trợ đa ngôn ngữ! 🌟",
+        "phiên bản": "Hikari phiên bản 1.0 — sử dụng RiveScript engine.",
+        "bạn nói được mấy ngôn ngữ": "Mình hỗ trợ 3 ngôn ngữ: tiếng Việt, tiếng Anh và tiếng Nhật! 🌍",
+        "ai tạo ra hikari": "Hikari được tạo bởi một nhà phát triển đam mê chatbot và AI! 🚀",
+        "hikari có nghĩa là gì": "Hikari (ひかり) có nghĩa là \"ánh sáng\" trong tiếng Nhật! ✨"
+    },
+    "en": {
+        "who is hikari": "I am Hikari, a multilingual chatbot! 🌟",
+        "version": "Hikari version 1.0 — powered by RiveScript engine.",
+        "how many languages do you speak": "I support 3 languages: Vietnamese, English, and Japanese! 🌍",
+        "who created hikari": "Hikari was created by a developer passionate about chatbots and AI! 🚀",
+        "what does hikari mean": "Hikari (ひかり) means \"light\" in Japanese! ✨"
+    },
+    "ja": {
+        "ひかりは誰": "私はひかり、多言語チャットボットです！🌟",
+        "バージョン": "ひかりバージョン1.0 — RiveScriptエンジン搭載。",
+        "いくつの言語を話せますか": "3つの言語に対応しています：ベトナム語、英語、日本語！🌍",
+        "ひかりを作ったのは誰": "ひかりはチャットボットとAIに情熱を持つ開発者が作りました！🚀",
+        "ひかりの意味は何": "ひかり（光）は日本語で「light」という意味です！✨"
+    }
+}

index.html

@@ -1,19 +1,76 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Hikari Chatbot</title>
+    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🌟</text></svg>">
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+    <div class="chat-container">
+        <header class="chat-header">
+            <h1>Hikari</h1>
+            <div class="header-controls">
+                <button id="help-button" title="Hướng dẫn sử dụng">❓</button>
+                <button id="rules-button" title="Xem danh sách rules">📋</button>
+                <button id="macros-button" title="Xem danh sách Object Macros">🔧</button>
+                <select id="language-selector">
+                    <option value="vi" selected>Tiếng Việt</option>
+                    <option value="en">English</option>
+                    <option value="ja">日本語</option>
+                </select>
+            </div>
+        </header>
+        <div id="rules-panel" class="slide-panel hidden">
+            <div class="slide-panel-header">
+                <h3 id="rules-title">📋 Các câu hỏi Hikari có thể trả lời</h3>
+                <button class="slide-panel-close" onclick="toggleRulesPanel()" aria-label="Đóng">&times;</button>
+            </div>
+            <div class="slide-panel-body">
+                <ul id="rules-list" class="rules-list"></ul>
+            </div>
+        </div>
+        <div id="macros-panel" class="slide-panel hidden">
+            <div class="slide-panel-header">
+                <h3 id="macros-title">🔧 Object Macros (Subroutines)</h3>
+                <button class="slide-panel-close" onclick="toggleMacrosPanel()" aria-label="Đóng">&times;</button>
+            </div>
+            <div class="slide-panel-body">
+                <ul id="macros-list" class="macros-list"></ul>
+            </div>
+        </div>
+        <div id="message-display" class="message-display"></div>
+        <div class="input-area">
+            <input type="text" id="message-input" placeholder="Nhập tin nhắn...">
+            <button id="send-button">Gửi</button>
+        </div>
+    </div>
+    <!-- Help Dialog -->
+    <div id="help-overlay" class="help-overlay hidden" role="dialog" aria-modal="true" aria-labelledby="help-dialog-title">
+        <div class="help-dialog">
+            <div class="help-dialog-header">
+                <h2 id="help-dialog-title">📖 Hướng dẫn sử dụng</h2>
+                <button id="help-close-button" class="help-close-button" aria-label="Đóng">&times;</button>
+            </div>
+            <div id="help-dialog-body" class="help-dialog-body">
+                <!-- Nội dung được render bởi JS theo ngôn ngữ -->
+            </div>
+        </div>
+    </div>
+
+    <script src="https://unpkg.com/rivescript@latest/dist/rivescript.min.js"></script>
+    <script src="brain.js"></script>
+    <script src="data-loader.js"></script>
+    <script src="adapters/text-similarity.js"></script>
+    <script src="adapters/specific-response.js"></script>
+    <script src="adapters/time-adapter.js"></script>
+    <script src="adapters/math-adapter.js"></script>
+    <script src="adapters/unit-conversion.js"></script>
+    <script src="adapters/best-match.js"></script>
+    <script src="adapters/logic-dispatcher.js"></script>
+    <script src="adapters/web-search.js"></script>
+    <script src="adapters/adapter-registry.js"></script>
+    <script src="app.js"></script>
+</body>
+</html>

style.css

@@ -1,28 +1,595 @@
-body {
-	padding: 2rem;
-	font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
-}
-
-h1 {
-	font-size: 16px;
-	margin-top: 0;
-}
-
-p {
-	color: rgb(107, 114, 128);
-	font-size: 15px;
-	margin-bottom: 10px;
-	margin-top: 5px;
-}
-
-.card {
-	max-width: 620px;
-	margin: 0 auto;
-	padding: 16px;
-	border: 1px solid lightgray;
-	border-radius: 16px;
-}
-
-.card p:last-child {
-	margin-bottom: 0;
-}
+/* === Reset & Base === */
+*, *::before, *::after {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    background-color: #f0f2f5;
+    min-height: 100vh;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    padding: 16px;
+}
+
+/* === Chat Container === */
+.chat-container {
+    width: 100%;
+    max-width: 600px;
+    height: 90vh;
+    background-color: #ffffff;
+    border-radius: 12px;
+    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.1);
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+}
+
+/* === Chat Header === */
+.chat-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 12px 16px;
+    background-color: #4a90d9;
+    color: #ffffff;
+}
+
+.chat-header h1 {
+    font-size: 1.25rem;
+    font-weight: 600;
+}
+
+.header-controls {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+
+.header-controls button {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    cursor: pointer;
+    padding: 4px;
+    border-radius: 4px;
+    transition: background-color 0.2s;
+}
+
+.header-controls button:hover {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+#language-selector {
+    padding: 4px 8px;
+    border: 1px solid rgba(255, 255, 255, 0.4);
+    border-radius: 6px;
+    background-color: rgba(255, 255, 255, 0.15);
+    color: #ffffff;
+    font-size: 0.85rem;
+    cursor: pointer;
+}
+
+#language-selector option {
+    color: #333333;
+    background-color: #ffffff;
+}
+
+/* === Slide Panel (Rules & Macros) === */
+.slide-panel {
+    border-bottom: 1px solid #e0e0e0;
+    background-color: #f8f9fa;
+    max-height: 280px;
+    display: flex;
+    flex-direction: column;
+    animation: slideDown 0.2s ease-out;
+}
+
+@keyframes slideDown {
+    from { max-height: 0; opacity: 0; }
+    to { max-height: 280px; opacity: 1; }
+}
+
+.slide-panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 10px 16px;
+    background-color: #eef2f7;
+    border-bottom: 1px solid #dde3ea;
+    flex-shrink: 0;
+}
+
+.slide-panel-header h3 {
+    font-size: 0.88rem;
+    font-weight: 600;
+    color: #4a90d9;
+    margin: 0;
+}
+
+.slide-panel-close {
+    background: none;
+    border: none;
+    font-size: 1.2rem;
+    color: #888888;
+    cursor: pointer;
+    padding: 0 4px;
+    line-height: 1;
+    border-radius: 4px;
+    transition: color 0.2s, background-color 0.2s;
+}
+
+.slide-panel-close:hover {
+    color: #333333;
+    background-color: rgba(0, 0, 0, 0.08);
+}
+
+.slide-panel-body {
+    overflow-y: auto;
+    padding: 8px 16px 12px;
+    flex: 1;
+}
+
+/* === Rules List === */
+.rules-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px;
+}
+
+.rules-list li {
+    display: inline-block;
+    padding: 4px 10px;
+    font-size: 0.82rem;
+    color: #4a6785;
+    background-color: #e8eef5;
+    border-radius: 12px;
+    border: 1px solid #d0dae6;
+    cursor: default;
+    transition: background-color 0.15s;
+}
+
+.rules-list li:hover {
+    background-color: #dce4ee;
+}
+
+/* === Macros List === */
+.macros-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.macro-item {
+    padding: 10px 12px;
+    background-color: #ffffff;
+    border-radius: 8px;
+    border: 1px solid #e0e5ec;
+    transition: box-shadow 0.15s;
+}
+
+.macro-item:hover {
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06);
+}
+
+.macro-item-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 4px;
+}
+
+.macro-item strong {
+    font-size: 0.85rem;
+    color: #333333;
+}
+
+.macro-item-badge {
+    display: inline-block;
+    font-size: 0.68rem;
+    padding: 1px 6px;
+    border-radius: 8px;
+    background-color: #d4edda;
+    color: #28a745;
+    font-weight: 500;
+}
+
+.macro-item p {
+    font-size: 0.8rem;
+    color: #666666;
+    margin: 2px 0 6px;
+    line-height: 1.4;
+}
+
+.macro-call-syntax {
+    display: inline-block;
+    font-family: 'Courier New', Courier, monospace;
+    font-size: 0.76rem;
+    background-color: #f0f0f0;
+    color: #c7254e;
+    padding: 3px 8px;
+    border-radius: 4px;
+    border: 1px solid #e0e0e0;
+}
+
+/* === Message Display === */
+.message-display {
+    flex: 1;
+    overflow-y: auto;
+    padding: 16px;
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+/* === Messages === */
+.message {
+    max-width: 80%;
+    padding: 10px 14px;
+    border-radius: 12px;
+    word-wrap: break-word;
+    line-height: 1.45;
+    font-size: 0.95rem;
+}
+
+.message.user {
+    align-self: flex-end;
+    background-color: #4a90d9;
+    color: #ffffff;
+    border-bottom-right-radius: 4px;
+}
+
+.message.bot {
+    align-self: flex-start;
+    background-color: #e9ecef;
+    color: #333333;
+    border-bottom-left-radius: 4px;
+}
+
+/* === Confidence === */
+.confidence {
+    display: block;
+    font-size: 0.72rem;
+    margin-top: 4px;
+    font-weight: 500;
+}
+
+.confidence-high {
+    color: #28a745;
+}
+
+.confidence-low {
+    color: #dc3545;
+}
+
+/* === Adapter Path Breadcrumb === */
+.adapter-path {
+    display: block;
+    font-size: 0.7rem;
+    margin-top: 2px;
+    color: #8e8e8e;
+    font-style: italic;
+}
+
+/* === Response Time === */
+.response-time {
+    display: block;
+    font-size: 0.68rem;
+    margin-top: 2px;
+    color: #aaaaaa;
+}
+
+/* === Links in bot messages === */
+.message.bot a {
+    color: #4a90d9;
+    text-decoration: underline;
+    word-break: break-all;
+}
+
+.message.bot a:hover {
+    color: #3a7bc8;
+}
+
+/* === Loading Indicator === */
+.loading-indicator {
+    align-self: flex-start;
+    padding: 10px 14px;
+    background-color: #e9ecef;
+    border-radius: 12px;
+    font-size: 0.9rem;
+    color: #888888;
+    animation: pulse 1.2s ease-in-out infinite;
+}
+
+@keyframes pulse {
+    0%, 100% { opacity: 1; }
+    50% { opacity: 0.5; }
+}
+
+/* === Input Area === */
+.input-area {
+    display: flex;
+    padding: 12px 16px;
+    border-top: 1px solid #e0e0e0;
+    background-color: #ffffff;
+    gap: 8px;
+}
+
+.input-area input {
+    flex: 1;
+    padding: 10px 14px;
+    border: 1px solid #cccccc;
+    border-radius: 20px;
+    font-size: 0.95rem;
+    outline: none;
+    transition: border-color 0.2s;
+}
+
+.input-area input:focus {
+    border-color: #4a90d9;
+}
+
+.input-area button {
+    padding: 10px 20px;
+    background-color: #4a90d9;
+    color: #ffffff;
+    border: none;
+    border-radius: 20px;
+    font-size: 0.95rem;
+    cursor: pointer;
+    transition: background-color 0.2s;
+    white-space: nowrap;
+}
+
+.input-area button:hover {
+    background-color: #3a7bc8;
+}
+
+/* === Utility === */
+.hidden {
+    display: none !important;
+}
+
+/* === Responsive — Mobile (max-width: 768px, min-width: 320px) === */
+@media (max-width: 768px) {
+    body {
+        padding: 0;
+        align-items: stretch;
+    }
+
+    .chat-container {
+        max-width: 100%;
+        height: 100vh;
+        border-radius: 0;
+        box-shadow: none;
+    }
+
+    .chat-header {
+        padding: 10px 12px;
+    }
+
+    .chat-header h1 {
+        font-size: 1.1rem;
+    }
+
+    .header-controls {
+        gap: 6px;
+    }
+
+    #language-selector {
+        font-size: 0.8rem;
+        padding: 3px 6px;
+    }
+
+    .message-display {
+        padding: 12px;
+    }
+
+    .message {
+        max-width: 88%;
+        font-size: 0.9rem;
+    }
+
+    .input-area {
+        padding: 10px 12px;
+    }
+
+    .input-area input {
+        padding: 8px 12px;
+        font-size: 0.9rem;
+    }
+
+    .input-area button {
+        padding: 8px 16px;
+        font-size: 0.9rem;
+    }
+
+    .rules-panel,
+    .macros-panel,
+    .slide-panel {
+        max-height: 200px;
+    }
+}
+
+/* === Help Dialog Overlay === */
+.help-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    background-color: rgba(0, 0, 0, 0.5);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    z-index: 1000;
+    animation: fadeIn 0.2s ease-out;
+}
+
+@keyframes fadeIn {
+    from { opacity: 0; }
+    to { opacity: 1; }
+}
+
+.help-dialog {
+    background-color: #ffffff;
+    border-radius: 12px;
+    width: 90%;
+    max-width: 520px;
+    max-height: 80vh;
+    display: flex;
+    flex-direction: column;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+    animation: slideUp 0.25s ease-out;
+}
+
+@keyframes slideUp {
+    from { transform: translateY(24px); opacity: 0; }
+    to { transform: translateY(0); opacity: 1; }
+}
+
+.help-dialog-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 16px 20px;
+    border-bottom: 1px solid #e0e0e0;
+    background: linear-gradient(135deg, #4a90d9, #5ba3e6);
+    color: #ffffff;
+    border-radius: 12px 12px 0 0;
+}
+
+.help-dialog-header h2 {
+    font-size: 1.05rem;
+    font-weight: 600;
+    margin: 0;
+}
+
+.help-close-button {
+    background: none;
+    border: none;
+    color: #ffffff;
+    font-size: 1.5rem;
+    cursor: pointer;
+    padding: 0 4px;
+    line-height: 1;
+    border-radius: 4px;
+    transition: background-color 0.2s;
+}
+
+.help-close-button:hover {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+.help-dialog-body {
+    padding: 20px;
+    overflow-y: auto;
+    font-size: 0.9rem;
+    line-height: 1.6;
+    color: #333333;
+}
+
+.help-section {
+    margin-bottom: 18px;
+    padding-bottom: 16px;
+    border-bottom: 1px solid #f0f0f0;
+}
+
+.help-section:last-child {
+    margin-bottom: 0;
+    padding-bottom: 0;
+    border-bottom: none;
+}
+
+.help-section h3 {
+    font-size: 0.92rem;
+    font-weight: 600;
+    color: #4a90d9;
+    margin-bottom: 8px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+}
+
+.help-section p {
+    margin: 4px 0;
+    color: #555555;
+}
+
+.help-section ul {
+    list-style: none;
+    padding: 0;
+    margin: 6px 0 0 0;
+}
+
+.help-section li {
+    padding: 4px 0 4px 16px;
+    position: relative;
+    color: #555555;
+}
+
+.help-section li::before {
+    content: '•';
+    position: absolute;
+    left: 4px;
+    color: #4a90d9;
+    font-weight: bold;
+}
+
+.help-example {
+    display: inline-block;
+    background-color: #f0f4f8;
+    color: #4a90d9;
+    padding: 2px 8px;
+    border-radius: 4px;
+    font-size: 0.84rem;
+    font-family: 'Courier New', Courier, monospace;
+}
+
+.help-confidence-demo {
+    display: flex;
+    gap: 12px;
+    margin-top: 8px;
+}
+
+.help-confidence-item {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 0.84rem;
+}
+
+.help-dot {
+    width: 10px;
+    height: 10px;
+    border-radius: 50%;
+    display: inline-block;
+}
+
+.help-dot.green { background-color: #28a745; }
+.help-dot.red { background-color: #dc3545; }
+
+/* === Responsive — Help Dialog Mobile === */
+@media (max-width: 768px) {
+    .help-dialog {
+        width: 95%;
+        max-height: 85vh;
+    }
+
+    .help-dialog-header {
+        padding: 12px 16px;
+    }
+
+    .help-dialog-body {
+        padding: 16px;
+    }
+}