kiku-agent 1.3.1 → 1.3.3

package/server/agent/agentCore.js

@@ -14,13 +14,13 @@ import { AgentSession } from './session.js';
 import { ResearchSubagent } from './subagent.js';
 import { SuggestionEngine } from './suggestions.js';
 import { buildTextToolProtocolDirective, extractTopLevelJsonObjects, MALFORMED_TOOL_CALL_FEEDBACK, parseTextToolCallsFromContent, stripToolCallBlocks } from './textToolProtocol.js';
-import { DynamicToolRouter } from './toolRouter.js';
+import { DynamicToolRouter, calculateSearchEscalationScore } from './toolRouter.js';
 import { executeTool, prepareToolArguments, toolsSchema, isBuiltinTool } from './tools.js';
 import { detectAmbiguities, isQueryTooVague, emitClarifyingQuestions, calculateConfidence, generateClarifyingQuestions, buildClarificationContext } from './clarifyingQuestions.js';
 import { ClarificationAnalytics, ClarificationConfig } from './clarificationAnalytics.js';
 import { calculateTokenCost } from './telemetry.js';
 import { extractCitations, resolveCitationReference } from './citations.js';
-import { resolveQueryEntities } from './catalogEntityResolver.js';
+import { resolveQueryEntities, isQueryInDomain, classifyQueryDomain } from './catalogEntityResolver.js';
 import { TokenTracker } from './tokenTracker.js';
 import { RoutingInterceptor } from './routingInterceptor.js';
 
@@ -327,17 +327,18 @@ export class KikuAgent {
     }
 
   
-    const hasPriorClarification = (this._clarificationAskedCount && this._clarificationAskedCount >= 1) ||
-      (this.conversationHistory && this.conversationHistory.some(m => m.content && (m.content.includes('[SYSTEM CLARIFICATION]') || m.content.includes('CLARIFICATION:'))));
-    if (hasPriorClarification) {
+   
+    if (query.includes('[SYSTEM CLARIFICATION]') || query.includes('CLARIFICATION:')) {
       return null;
     }
 
-    if (isQueryTooVague(query)) {
+    const lastUserMsg = this.conversationHistory?.slice().reverse().find(m => m.role === 'user');
+    const wasLastTurnClarified = lastUserMsg?.content && (lastUserMsg.content.includes('[SYSTEM CLARIFICATION]') || lastUserMsg.content.includes('CLARIFICATION:'));
+    if (wasLastTurnClarified) {
       return null;
     }
 
-    if (query.includes('[SYSTEM CLARIFICATION]') || query.includes('CLARIFICATION:')) {
+    if (isQueryTooVague(query)) {
       return null;
     }
 
@@ -345,8 +346,7 @@ export class KikuAgent {
     const confidence = calculateConfidence(query, ambiguities);
     const threshold = clarifyConfig.confidenceThreshold;
 
-  
-    const CROSS_CATEGORY_PRIORITIES = ['media_type', 'career_phase', 'specific_work', 'timeframe', 'comparison'];
+    const CROSS_CATEGORY_PRIORITIES = ['media_type', 'career_phase', 'specific_work', 'timeframe', 'comparison', 'scope', 'aspect_focus', 'depth'];
     const highImpactAmbiguities = ambiguities.filter(a => CROSS_CATEGORY_PRIORITIES.includes(a.category));
 
     const shouldAsk = (confidence.score < threshold || confidence.shouldAsk) && highImpactAmbiguities.length > 0;
@@ -714,8 +714,12 @@ export class KikuAgent {
    * the limit, replace the oldest tool results with omission stubs — tool
    * payloads are the bulkiest and least-likely-to-be-reused part of history.
    */
-  _enforceContextBudget() {
-    const rawLimit = Number(process.env.KIKU_CONTEXT_LIMIT);
+  _enforceContextBudget(limitOverride) {
+    const envLimit = Number(process.env.KIKU_CONTEXT_LIMIT);
+    const override = Number(limitOverride);
+    const rawLimit = (Number.isFinite(override) && override > 0)
+      ? override
+      : envLimit;
     if (!Number.isFinite(rawLimit) || rawLimit <= 0) return false;
     const budget = Math.floor(rawLimit * 0.85);
 
@@ -740,6 +744,7 @@ export class KikuAgent {
       if (total <= budget) break;
       if (msg.role !== 'tool' || msg._omittedForContext) continue;
       const prev = msg._tokenEstimate || estimateTokenCount([msg]);
+      if (prev <= omittedTokens) continue;
       total -= prev - omittedTokens;
       msg.content = omitted;
       msg._omittedForContext = true;
@@ -817,10 +822,10 @@ export class KikuAgent {
     return results;
   }
 
-  buildSystemPrompt(scopedTools = null) {
+  buildSystemPrompt(scopedTools = null, options = {}) {
     const allTools = this.getAllToolsSchema ? this.getAllToolsSchema() : [];
     const activeTools = scopedTools || allTools;
-    return buildSystemPrompt(activeTools, { isNativeToolCalling: true });
+    return buildSystemPrompt(activeTools, { isNativeToolCalling: true, ...options });
   }
 
   _extractTextToolCalls(content) {
@@ -863,9 +868,22 @@ export class KikuAgent {
       onError = () => { },
       onNotice = () => { },
       systemDirectives = null,
-      signal = null
+      signal = null,
+      temperature = undefined,
+      topP = undefined,
+      contextLimit = undefined,
+      minP = undefined,
+      repeatPenalty = undefined
     } = callbacks;
 
+    const _num = (v) => Number.isFinite(Number(v)) ? Number(v) : undefined;
+    const runTemperature = _num(temperature) !== undefined ? Math.min(2, Math.max(0, _num(temperature))) : undefined;
+    const runTopP = _num(topP) !== undefined ? Math.min(1, Math.max(0.01, _num(topP))) : undefined;
+    const runMinP = _num(minP) !== undefined ? Math.min(1, Math.max(0, _num(minP))) : undefined;
+    const runRepeatPenalty = _num(repeatPenalty) !== undefined ? Math.min(2, Math.max(1, _num(repeatPenalty))) : undefined;
+    const _ctx = Math.floor(Number(contextLimit));
+    const runContextLimit = Number.isFinite(_ctx) && _ctx >= 1024 ? Math.min(_ctx, 1000000) : undefined;
+
     const queryStartTime = Date.now();
     const queryId = `q_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
     const dominantLang = detectDominantLanguage(promptForLLM, this.session?.dominantLanguage);
@@ -890,7 +908,25 @@ export class KikuAgent {
       ];
     }
 
-    const isSecurityAttack = /(ผู้ใช้คนอื่น|หัวหน้าของเขา|แสดงประวัติส่วนตัวของเขา|ขอรหัส|password|secret|credential|token|api_?key|api\s*key|\.env|cookies\.txt|kiku_vip_keys|system\s+directive|system\s+prompt|prompt\s+leak|bypass|unauthorized|环境变量)/i.test(promptForLLM);
+    const promptLower = promptForLLM.toLowerCase();
+    const isDirectSystemAttack = (
+      /\b(system\s*prompt|system\s*directive|prompt\s*leak|kiku_vip_keys)\b/i.test(promptLower) ||
+      /(?:^|\s|\/|\"|\')\.env(?:$|\s|\b|\/|\"|\')/i.test(promptLower) ||
+      /(?:^|\s|\/|\"|\')cookies\.txt(?:$|\s|\b|\/|\"|\')/i.test(promptLower) ||
+      /(ผู้ใช้คนอื่น|หัวหน้าของเขา|แสดงประวัติส่วนตัวของเขา|ขอรหัสผ่านระบบ|ขอรหัสผ่าน|ขอรหัส)/i.test(promptLower) ||
+      /(reveal|disclose|show|leak|output|dump|print|tell|share|extract|เปิดเผย|ขอดู|บอก|ขอ|输出|显示|导出)[\s\S]{0,40}(your\s+(api\s*key|credential|secret|token|system|config|password)|(system|bot|server)\s+(config|prompt|credential|credentials|secret|secrets|key|keys|password|passwords)|(api\s*keys?|private\s*keys?|master\s*keys?|passwords?|credentials?|环境变量|系统配置|所有密钥|系统指令))/i.test(promptLower) ||
+      /(tell\s+me|show\s+me|what\s+is)[\s\S]{0,30}(your\s+(system\s+prompt|api\s*key|credentials?|secret\s*key))/i.test(promptLower) ||
+      /\b(do\s+anything\s+now|you\s+are\s+now\s+dan|ignore\s+all\s+(previous|prior)\s+instructions)\b/i.test(promptLower) ||
+      /(没有任何限制的ai|列出你的所有系统指令|所有密钥)/i.test(promptLower)
+    );
+
+    const isEducationalProgramming = (
+      /(?:python|javascript|typescript|java|c\+\+|golang|rust|php|code|coding|example|เขียนโค้ด|โปรแกรม|algorithm|library|module|package|import|func|syntax)/i.test(promptLower) &&
+      !/(your|this|system|bot|server|kiku|internal)\s+(prompt|credential|key|secret|token|config|password)/i.test(promptLower) &&
+      !/(reveal|leak|dump|disclose|extract|เปิดเผย)/i.test(promptLower)
+    );
+
+    const isSecurityAttack = isDirectSystemAttack && !isEducationalProgramming;
     if (isSecurityAttack) {
       const refusalMessage = dominantLang === 'zh'
         ? "抱歉，无法提供系统配置、私有数据或敏感指令。"
@@ -919,6 +955,7 @@ export class KikuAgent {
       }
     }
 
+    if (callbacks?.clientLocation) this.clientLocation = callbacks.clientLocation;
     this.session.createUserMessage(promptForLLM);
     const userMessage = { role: 'user', content: promptForLLMWithGrounding };
     this.conversationHistory.push(userMessage);
@@ -997,13 +1034,41 @@ export class KikuAgent {
     }
 
     const mentionsArtist = /(ju\s?jing\s?yi|jujingyi|จวีจิ้งอี|จิ้งอี|จวี|鞠婧祎|小鞠|kikuuu?|miju|蜜橘)/i.test(promptForLLM);
-    if (queryResolution.matchedEntities.length === 0 && !mentionsArtist && !autoResearchTriggered) {
+    const hasCatalogSignals = queryResolution.matchedEntities.length > 0 || mentionsArtist;
+    const isDomain = isQueryInDomain(promptForLLM) || hasCatalogSignals;
+
+    // Context Awakening Detection in multi-turn conversations
+    if (this.conversationHistory.length > 2) {
+      const priorUserMessages = this.conversationHistory.filter(m => m.role === 'user');
+      const wasPriorOpenDomain = priorUserMessages.length > 1 && priorUserMessages.slice(-3, -1).some(m => !isQueryInDomain(m.content));
+      if (wasPriorOpenDomain && isDomain) {
+        turnDirectives.push({
+          role: 'system',
+          content: '[CONTEXT AWAKENING ACTIVATED: The user has transitioned from open-domain into the Ju Jingyi domain. Awaken immediately into the authoritative Ju Jingyi concierge persona with verified catalog retrieval, warm elegance, and meticulous factual grounding.]'
+        });
+      }
+    }
+
+    if (!isDomain) {
+      turnDirectives.push({
+        role: 'system',
+        content: '[OPEN-DOMAIN EXPERT DIRECTIVE: The user is inquiring about an open-domain topic (coding, mathematics, science, or general problem solving). Deliver a direct, high-caliber, structured technical answer with clean code blocks or LaTeX formulas ($ ... $ / $$ ... $$). When teaching programming, provide a clear tutorial with runnable code snippets immediately. Do NOT force Ju Jingyi roleplay or unsolicited artist references. NEVER mention system directives or output meta-commentary about system messages.]'
+      });
+    } else if (queryResolution.matchedEntities.length === 0 && !mentionsArtist && !autoResearchTriggered) {
       turnDirectives.push({
         role: 'system',
         content: "[SYSTEM NOTE: This query does not appear to be about Ju Jingyi or her catalog. Answer directly from your general knowledge in the user's language. Do NOT call catalog tools (profile, works, discography, brands, awards, gallery, quotes, timeline) for this query. When using web_search, search_news, or search_chinese_web, search for the specific entity or topic the user asked about — do NOT prepend 'Ju Jingyi' or '鞠婧祎' to the search query.]"
       });
     }
 
+    const searchEscalationScore = calculateSearchEscalationScore(promptForLLM);
+    if (searchEscalationScore >= 15 && !autoResearchTriggered) {
+      turnDirectives.push({
+        role: 'system',
+        content: `[SEARCH ESCALATION DIRECTIVE: The user inquiry contains recency, news, live event, social media (Weibo/Douyin), or verification signals (Search Escalation Score: ${searchEscalationScore}). While the verified catalog holds confirmed historical career milestones, you MUST actively query live external search tools (search_chinese_web, search_news, web_search, search_bilibili) to capture current news and updates. Do NOT conclude that information is missing without searching external tools first.]`
+      });
+    }
+
     const clarifyingResult = await this._handleClarifyingQuestions(
       promptForLLM,
       dominantLang,
@@ -1049,6 +1114,17 @@ export class KikuAgent {
     this._activeToolSchema = activeTools;
     const activeToolNames = new Set(activeTools.map(t => t.function?.name).filter(Boolean));
 
+    const activeDomain = isDomain ? 'IN_DOMAIN' : 'OPEN_DOMAIN';
+    const effectiveSystemPrompt = this.buildSystemPrompt(activeTools, {
+      domain: activeDomain,
+      inDomain: isDomain,
+      query: promptForLLM,
+    });
+    this.conversationHistory[0] = {
+      role: 'system',
+      content: effectiveSystemPrompt + memoryContext,
+    };
+
     while (currentIteration < this.maxIterations) {
       if (signal?.aborted) {
         this.stateMachine.reset();
@@ -1061,7 +1137,7 @@ export class KikuAgent {
       if (currentIteration > 1) {
         await this.applySlidingWindow();
       }
-      this._enforceContextBudget();
+      this._enforceContextBudget(runContextLimit);
 
       let assistantMessage = null;
       let isReasoning = false;
@@ -1077,8 +1153,12 @@ export class KikuAgent {
         assistantMessage = await this.client.chat({
           messages: chatMessages,
           tools: activeTools,
-          temperature: 0.3,
+          temperature: runTemperature ?? 0.3,
+          topP: runTopP ?? null,
+          minP: runMinP,
+          repeatPenalty: runRepeatPenalty,
           maxTokens: OUTPUT_TOKEN_BUDGET,
+          contextLimit: runContextLimit,
           stream: true,
           signal,
           onThought: (thoughtChunk) => {
@@ -1177,15 +1257,27 @@ export class KikuAgent {
        
         if (currentIteration === 1 && recordedTools.length === 0) {
           const content = String(assistantMessage.content || '');
-          const refusalRegex = /(ไม่มี(การ)?บันทึก|ไม่มี(อยู่ใน)?ระบบ|ไม่มีข้อมูล|ไม่มีรายละเอียด|ไม่พบ|ข้อมูลทางธุรกิจ|ข้อมูลธุรกิจ|ข้อมูลเชิงพาณิชย์|ความลับทางการค้า|ความลับ|ความลับเชิงพาณิชย์|ปรัชญาการทำงาน|ตัวตนของฉัน|นอกเหนือขอบเขต|ไม่สามารถระบุ|ไม่ได้ระบุ|not found|no verified record|no record|could not find|unable to find|outside the scope|confidential|internal business|trade secret|business secret|commercial secret|proprietary|internal statistics?|operational philosophy|my own mindset|without querying|没有找到|未找到|暂无|没有记录|无法查询|商业机密|内部数据|机密)/i;
-          const isRefusal = refusalRegex.test(content);
-          const isSec = /(ผู้ใช้คนอื่น|หัวหน้าของเขา|รหัสผ่าน|ความลับของระบบ|password|secret|credential|token|\.env|cookies\.txt|kiku_vip_keys|system\s+directive|mcp\s+directive|bypass|unauthorized)/i.test(promptForLLM);
-          if (isRefusal && !isSec) {
+          const refusalRegex = /(ไม่มี(การ)?บันทึก|ไม่มี(อยู่ใน)?ระบบ|ไม่มีข้อมูล|ไม่มีรายละเอียด|ไม่พบ(?:ข้อมูล|บันทึก|ผลงาน|รายการ|รายละเอียด|หลักฐาน)|ข้อมูลทางธุรกิจ|ข้อมูลธุรกิจ|ข้อมูลเชิงพาณิชย์|ความลับทางการค้า|ความลับเชิงพาณิชย์|ปรัชญาการทำงาน|ตัวตนของฉัน|นอกเหนือขอบเขต|ไม่สามารถระบุ|ไม่ได้ระบุ|not found|no verified record|no record|could not find|unable to find|outside the scope|confidential|internal business|trade secret|business secret|commercial secret|proprietary|internal statistics?|operational philosophy|my own mindset|without querying|没有找到|未找到|暂无|没有记录|无法查询|商业机密|内部数据|机密)/i;
+          const isNegation = /(?:ไม่(?:ใช่|ถือเป็น)?(?:ความลับ|เรื่องลับ)|not\s+(?:a\s+)?(?:secret|confidential|trade\s*secret)|ไม่ใช่ข้อมูลธุรกิจ|ไม่ได้เป็นความลับ)/i.test(content);
+          const isNegativeFactualQuery = /(?:ข่าวลือ|คดี|ทำผิด|เรื่องอื้อฉาว|เสียหาย|แต่งงาน|แฟน(?!คลับ)|สามี|scandal|rumor|arrest|crime|lawsuit|negative)/i.test(promptForLLM);
+          const isSubstantiveAnswer = content.length > 100 && /(?:จวีจิ้งอี|Ju Jingyi|鞠婧祎|ซีรีส์|ผลงาน|เพลง|ละคร|บทบาท|ศิลปิน|นักแสดง|รางวัล)/i.test(content);
+          const isRefusal = refusalRegex.test(content) && !isNegation && !isNegativeFactualQuery && !isSubstantiveAnswer;
+          const isSec = /(ผู้ใช้คนอื่น|หัวหน้าของเขา|รหัสผ่าน|ความลับของระบบ|\bpassword\b|\bsecret\b|\bcredential\b|\baccess.token\b|\.env|cookies\.txt|kiku_vip_keys|system\s+directive|mcp\s+directive|bypass|unauthorized)/i.test(promptForLLM);
+          const inDomain = isQueryInDomain(promptForLLM);
+          const isImageAttachment = /\[USER ATTACHMENT:[^\]]*(?:รูปภาพ|image)/i.test(promptForLLM);
+          const isVisionLimitation = isImageAttachment && /(?:ภาพ|รูป|รูปภาพ|ไฟล์ภาพ|photo|image|picture|มองไม่เห็น|ดูรูปไม่ได้|ไม่สามารถดูภาพ|เปิดดูภาพไม่ได้|วิเคราะห์ภาพโดยตรงไม่ได้|ระบบข้อความ)/i.test(content);
+          if (isRefusal && !isSec && inDomain && !isVisionLimitation) {
+            const dynamicSuggested = (this.router?.routeToolsForQuery(promptForLLM) || [])
+              .slice(0, 5)
+              .map(t => t.function?.name || t.name)
+              .filter(Boolean)
+              .join(', ') || 'search_works, search_discography, get_brand_endorsements, get_career_timeline';
+
             this.conversationHistory.pop();
             if (currentAssistantSessionMsg) currentAssistantSessionMsg.parts = [];
             this.conversationHistory.push({
               role: 'user',
-              content: '[MANDATORY RETRIEVAL RULE & VERIFICATION CONSTRAINT] You are strictly FORBIDDEN from asserting that catalog information does not exist, is confidential, or is missing without querying a tool first in this turn. Call the appropriate catalog tool (e.g. get_brand_endorsements, search_works, search_discography, get_awards, get_quotes, get_music_videos, get_gallery_photos) NOW to fetch and verify the facts before answering.'
+              content: `[MANDATORY RETRIEVAL RULE & VERIFICATION CONSTRAINT] You are strictly FORBIDDEN from asserting that information does not exist, is confidential, or is missing without querying a tool first in this turn. Call the appropriate tool (e.g. ${dynamicSuggested}) NOW to fetch and verify the facts before answering.`
             });
             continue;
           }
@@ -1194,10 +1286,10 @@ export class KikuAgent {
           const isExplicitCatalogMention = explicitCatalogRegex.test(promptForLLM);
           const hasCatalogTarget = (queryResolution?.recommendedTools?.length > 0 || queryResolution?.matchedEntities?.length > 0 || isExplicitCatalogMention) && (mentionsArtist || isExplicitCatalogMention);
 
-          if (!isSec && hasCatalogTarget) {
+          if (!isSec && hasCatalogTarget && !isVisionLimitation) {
             const suggestedTools = queryResolution?.recommendedTools?.length > 0
               ? queryResolution.recommendedTools.join(', ')
-              : 'search_works, search_discography, get_brand_endorsements, get_career_timeline, get_profile_and_fandom';
+              : ((this.router?.routeToolsForQuery(promptForLLM) || []).slice(0, 5).map(t => t.function?.name || t.name).join(', ') || 'search_works, search_discography, get_brand_endorsements');
             this.conversationHistory.pop();
             if (currentAssistantSessionMsg) currentAssistantSessionMsg.parts = [];
             this.conversationHistory.push({
@@ -1206,6 +1298,18 @@ export class KikuAgent {
             });
             continue;
           }
+
+          const isWeatherQuery = /(?:สภาพอากาศ|พยากรณ์อากาศ|อากาศ|ฝนตก|อุณหภูมิ|กี่องศา|weather|forecast|temperature|rain|แถวนี้|ใกล้ฉัน|ที่นี่)/i.test(promptForLLM);
+          const isLocationDisclaimer = /(?:ไม่ทราบพิกัด|ไม่ทราบตำแหน่ง|ไม่ทราบที่ตั้ง|ไม่รู้ตำแหน่ง|ระบุสถานที่|ระบุพิกัด|ระบุตำแหน่ง|ขออนุญาตดึงตำแหน่ง|จะแสดงผลหลังจาก|รอดึงตำแหน่ง|รอข้อมูลตำแหน่ง|ดึงตำแหน่งปัจจุบันก่อน|don't know (?:your )?location|unknown location|specify (?:your )?location|provide (?:your )?location)/i.test(content);
+          if (isWeatherQuery && isLocationDisclaimer && !isSec) {
+            this.conversationHistory.pop();
+            if (currentAssistantSessionMsg) currentAssistantSessionMsg.parts = [];
+            this.conversationHistory.push({
+              role: 'user',
+              content: '[MANDATORY TOOL CALL: get_weather] You must NOT defer answering, ask for user device permission, or state that weather will be displayed later. Call the tool get_weather (passing the named destination if one was specified) NOW and present the real-time weather metrics (temperature, condition, humidity, wind) and map pin immediately to the user.'
+            });
+            continue;
+          }
         }
 
         const needProtocol = Boolean(this.client?.toolsDisabledReason) && !textProtocolTaught;
@@ -1229,13 +1333,25 @@ export class KikuAgent {
         const totalDurationMs = Date.now() - queryStartTime;
         this.session.stats.totalDurationMs += totalDurationMs;
 
-        const finalAnswer = sanitizeResponse(assistantMessage.content || (
-          dominantLang === 'zh' ? "抱歉，无法处理您的回答。" :
-            dominantLang === 'ja' ? "申し訳ありません、回答を処理できませんでした。" :
-              dominantLang === 'ko' ? "죄송합니다. 답변을 처리할 수 없습니다." :
-                dominantLang === 'en' ? "Sorry, unable to process a response." :
-                  "ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้"
-        ));
+        const hasImageAttachment = /\[USER ATTACHMENT:[^\]]*(?:รูปภาพ|image)/i.test(promptForLLM);
+        const imageFallbackAnswer = dominantLang === 'zh'
+          ? "已收到您的图片。由于当前系统主要为文本与作品资料库分析，暂不支持直接解析图像像素。您可以告诉我关于这张图片的剧名、角色、活动或想查询的内容，我很乐意为您检索相关资料与写真哦。"
+          : dominantLang === 'en'
+            ? "I received your image attachment. Currently, the system focuses on text and catalog intelligence and cannot directly inspect image pixels. Feel free to tell me the drama name, character, event, or what you'd like to look up about this photo, and I'll gladly retrieve the verified catalog details and gallery stills for you."
+            : "ได้รับรูปภาพเรียบร้อยแล้วค่ะ แต่เนื่องจากระบบปัจจุบันเน้นการวิเคราะห์ข้อมูลและแคตตาล็อกเป็นหลัก จึงยังไม่รองรับการวิเคราะห์พิกเซลภาพโดยตรง คุณสามารถพิมพ์บอกชื่อผลงาน ละคร ลุคงาน หรือสิ่งที่ต้องการค้นหาเกี่ยวกับภาพนี้ เพื่อให้ฉันช่วยค้นหาข้อมูลและรูปภาพจากคลังข้อมูลได้เลยนะคะ";
+
+        const fallbackAnswer = hasImageAttachment
+          ? imageFallbackAnswer
+          : (
+            dominantLang === 'zh' ? "抱歉，无法处理您的回答。" :
+              dominantLang === 'ja' ? "申し訳ありません、回答を処理できませんでした。" :
+                dominantLang === 'ko' ? "죄송합니다. 답변을 처리할 수 없습니다." :
+                  dominantLang === 'en' ? "Sorry, unable to process a response." :
+                    "ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้"
+          );
+
+        const rawAnswerContent = stripToolCallBlocks(assistantMessage.content || fallbackAnswer);
+        const finalAnswer = sanitizeResponse(rawAnswerContent);
         historyMessage.content = finalAnswer;
         this.conversationHistory = this.conversationHistory.filter(m =>
           !(typeof m?.content === 'string' && m.content.includes('[MANDATORY'))
@@ -1367,11 +1483,18 @@ export class KikuAgent {
         if (cachedResult) {
           result = { ...cachedResult, cache: { hit: true, reason: 'duplicate_call_in_query' } };
         } else if (isBuiltin) {
-          result = await executeTool(toolName, finalArgs, { agent: this, memory: this.memory, client: this.client, signal, onSubagentProgress });
+          result = await executeTool(toolName, finalArgs, { agent: this, memory: this.memory, client: this.client, signal, onSubagentProgress, clientLocation: callbacks?.clientLocation || this.clientLocation });
         } else if (isMcp) {
-          result = await this.mcpManager.callTool(toolName, finalArgs);
+          try {
+            result = await this.mcpManager.callTool(toolName, finalArgs);
+          } catch (err) {
+            result = {
+              status: 'error',
+              message: `Failed executing MCP tool "${toolName}": ${err.message}`
+            };
+          }
         } else {
-          result = await executeTool(toolName, finalArgs, { agent: this, memory: this.memory, client: this.client, signal, onSubagentProgress });
+          result = await executeTool(toolName, finalArgs, { agent: this, memory: this.memory, client: this.client, signal, onSubagentProgress, clientLocation: callbacks?.clientLocation || this.clientLocation });
         }
 
         if (!cachedResult) toolResultCache.set(signature, result);
@@ -1383,6 +1506,127 @@ export class KikuAgent {
 
         this._extractFactsFromToolResult(toolName, finalArgs, result);
 
+        const isNotFoundResult = Boolean(
+          result && (
+            result.status === 'not_found' ||
+            result.status === 'no_results' ||
+            result.count === 0 ||
+            result.returnedCount === 0 ||
+            (Array.isArray(result.photos) && result.photos.length === 0) ||
+            (Array.isArray(result.works) && result.works.length === 0) ||
+            (Array.isArray(result.songs) && result.songs.length === 0) ||
+            (Array.isArray(result.awards) && result.awards.length === 0) ||
+            (Array.isArray(result.brands) && result.brands.length === 0) ||
+            (typeof result.message === 'string' && /No matching (?:data|photos|works|awards|discography|items) found in local catalog|ไม่พบข้อมูล/i.test(result.message))
+          )
+        );
+
+        const CATALOG_SEARCH_TOOLS = new Set([
+          'get_gallery_photos',
+          'search_works',
+          'search_discography',
+          'get_awards',
+          'get_brand_endorsements',
+          'get_career_timeline',
+          'get_work_detail',
+          'get_song_detail',
+          'get_quotes',
+          'get_profile_and_fandom'
+        ]);
+
+        const isSec = /(ผู้ใช้คนอื่น|หัวหน้าของเขา|รหัสผ่าน|ความลับของระบบ|\bpassword\b|\bsecret\b|\bcredential\b|\baccess.token\b|\.env|cookies\.txt|kiku_vip_keys|system\s+directive|mcp\s+directive|bypass|unauthorized)/i.test(promptForLLM);
+        const forbidExternal = /(?:เฉพาะใน|ห้ามค้นเว็บ|ห้ามค้นเน็ต|only\s+in\s+catalog|catalog\s+only|no\s+web)/i.test(promptForLLM);
+
+        if (isNotFoundResult && CATALOG_SEARCH_TOOLS.has(toolName) && !isSec && !forbidExternal && !signal?.aborted && !result._escalated) {
+          const isImageQuery = toolName === 'get_gallery_photos' ||
+            /(?:รูป|ภาพ|รูปภาพ|ภาพถ่าย|โปสเตอร์|สติลล์|concept\s*art|stills?|photo|image|picture|poster|剧照|概念图|写真)/i.test(promptForLLM) ||
+            /(?:รูป|ภาพ|concept\s*art|stills?|photo|image|剧照|概念图)/i.test(finalArgs?.query || '');
+          const isChineseQuery = /[\u4E00-\u9FA5]/.test(promptForLLM) || /[\u4E00-\u9FA5]/.test(finalArgs?.query || '');
+          const isNewsQuery = /(?:ข่าว|ล่าสุด|วันนี้|อัปเดต|เมื่อวาน|สัปดาห์นี้|news|latest|recent|update|最新|新闻)/i.test(promptForLLM);
+
+          const rawQuery = finalArgs?.query || finalArgs?.keywords || finalArgs?.title || finalArgs?.workIdOrTitle || promptForLLM;
+          let cleanQuery = String(rawQuery).replace(/\[USER ATTACHMENT:[^\]]*\]/gi, '').trim();
+          if (!/(?:จวีจิ้งอี|Ju\s*Jingyi|鞠婧祎|Kiku)/i.test(cleanQuery)) {
+            cleanQuery = `鞠婧祎 ${cleanQuery}`.trim();
+          }
+
+          let fallbackToolName = 'web_search';
+          let fallbackArgs = { keywords: cleanQuery, target_language: isChineseQuery ? 'zh' : 'th' };
+
+          if (isImageQuery && (activeToolNames.has('search_web_images') || isBuiltinTool('search_web_images'))) {
+            fallbackToolName = 'search_web_images';
+            fallbackArgs = { keywords: cleanQuery, target_language: isChineseQuery ? 'zh' : 'th' };
+          } else if (isNewsQuery && (activeToolNames.has('search_news') || isBuiltinTool('search_news'))) {
+            fallbackToolName = 'search_news';
+            fallbackArgs = { keywords: cleanQuery, target_language: isChineseQuery ? 'zh' : 'th' };
+          } else if (isChineseQuery && (activeToolNames.has('search_chinese_web') || isBuiltinTool('search_chinese_web'))) {
+            fallbackToolName = 'search_chinese_web';
+            fallbackArgs = { keywords: cleanQuery, target_language: 'zh' };
+          }
+
+          if (activeToolNames.has(fallbackToolName) || isBuiltinTool(fallbackToolName)) {
+            activeToolNames.add(fallbackToolName);
+            if (typeof callbacks?.onToolRemove === 'function') {
+              callbacks.onToolRemove(toolName);
+            }
+            try {
+              onNotice(`ไม่พบข้อมูลในแค็ตตาล็อกสำหรับ "${toolName}" → สลับไปยังเครื่องมือค้นหาภายนอกอินเทอร์เน็ต (${fallbackToolName})...`);
+            } catch { }
+            eventBus.emit(Events.AGENT_TOOL_ESCALATED, { queryId, fromTool: toolName, toTool: fallbackToolName });
+
+            const preparedFallback = prepareToolArguments(fallbackToolName, fallbackArgs);
+            const finalFallbackArgs = preparedFallback.safe ? preparedFallback.args : fallbackArgs;
+
+            this.stateMachine.transition(AgentStates.FETCHING_TOOL, { toolName: fallbackToolName });
+            const fbToolPart = this.session.addToolPart(currentAssistantSessionMsg, fallbackToolName, finalFallbackArgs);
+            onToolStart(fallbackToolName, finalFallbackArgs);
+            eventBus.emit(Events.AGENT_TOOL_START, { queryId, toolName: fallbackToolName, args: finalFallbackArgs });
+
+            const fbStartTime = Date.now();
+            const fallbackResult = await executeTool(fallbackToolName, finalFallbackArgs, {
+              agent: this,
+              memory: this.memory,
+              client: this.client,
+              signal,
+              onSubagentProgress,
+              clientLocation: callbacks?.clientLocation || this.clientLocation
+            });
+            const fbDurationMs = Date.now() - fbStartTime;
+
+            this.session.finalizeToolPart(currentAssistantSessionMsg, fbToolPart.id, fallbackResult);
+            onToolResult(fallbackToolName, fallbackResult, fbDurationMs);
+            eventBus.emit(Events.AGENT_TOOL_RESULT, { queryId, toolName: fallbackToolName, result: fallbackResult, durationMs: fbDurationMs });
+
+            this._extractFactsFromToolResult(fallbackToolName, finalFallbackArgs, fallbackResult);
+
+            toolResultTracker.total++;
+            toolResultTracker.toolNames.push(fallbackToolName);
+            if (fallbackResult.status === 'not_found') toolResultTracker.notFound++;
+            else if (fallbackResult.status === 'error') toolResultTracker.error++;
+            else toolResultTracker.success++;
+
+            const cappedFallback = this._capToolResultForHistory(fallbackResult);
+            const fallbackInstruction = 'Use the external internet search results above to answer the user query with verified information, media references, and rich detail.';
+
+            return {
+              toolMessage: {
+                role: 'tool',
+                tool_call_id: toolCallId,
+                name: fallbackToolName,
+                content: JSON.stringify({
+                  authoritative: true,
+                  escalatedFrom: toolName,
+                  result: cappedFallback,
+                  instruction: fallbackInstruction
+                })
+              },
+              toolName: fallbackToolName,
+              result: fallbackResult,
+              escalatedFrom: toolName
+            };
+          }
+        }
+
         toolResultTracker.total++;
         toolResultTracker.toolNames.push(toolName);
         if (result.status === 'not_found') toolResultTracker.notFound++;
@@ -1392,7 +1636,7 @@ export class KikuAgent {
         const cappedResult = this._capToolResultForHistory(result);
 
         let instruction = result.status === 'not_found'
-          ? 'CRITICAL: No matching data was found for this query in the catalog. State explicitly in the user\'s language that no verified records exist in the database. Do NOT invent, fabricate, or guess any records. Do NOT claim you searched external platforms like Bilibili, Weibo, or Google unless those specific tools were called. Under no circumstances should you generate plausible-sounding but unverified details.'
+          ? 'CRITICAL: No matching data was found for this query in the verified catalog. If the user\'s inquiry concerns recent activities, unreleased works, live news, Weibo/social updates, or rumors, you SHOULD call external search tools (search_chinese_web, search_news, or web_search) to check for external evidence before concluding. If external searches have already been completed or are not applicable, state clearly in the user\'s language that the record was not found in the verified database. Do NOT fabricate facts, dates, or relationships.'
           : result.status === 'error'
             ? 'CRITICAL: The tool failed to retrieve data. Do NOT claim that the requested facts were verified. You MUST acknowledge the error and either retry or inform the user that the information could not be retrieved.'
             : 'Use ONLY the specific facts present in this result when answering. Do NOT add, infer, or extrapolate information beyond what is explicitly provided. Do NOT fabricate additional details, dates, names, or relationships not present in this result. Do not echo raw JSON data — summarize in natural language while preserving factual accuracy.';
@@ -1455,11 +1699,18 @@ export class KikuAgent {
       promptForLLM
     );
 
-    const langPrompt = dominantLang === 'zh'
-      ? "请根据上述工具查询结果回答，回答深度须与问题相称：单一事实类问题（日期、名字、数字、是/否）用 1-4 句话直接简洁作答，不加标题或表格；仅当问题是比较、排序、列表或深度分析时，才使用完整的 Markdown 结构（标题、要点、表格）并附上具体的 YouTube 真实链接（如 Direct Watch: https://www.youtube.com/watch?v=... 或 Search: https://www.youtube.com/results?search_query=...）。不要用无关段落填充简短的事实性回答，但也绝不能遗漏用户明确要求的任何条目。\n\n【反幻觉守则 — 必须遵守】只陈述工具结果中明确包含的事实。禁止编造、推测或补充工具结果中不存在的剧名、歌曲名、角色名、品牌名、日期或任何细节。如果工具结果不足以完整回答，请明确说明哪些部分未经验证，而不是凭空补全。"
-      : dominantLang === 'en'
-        ? "Based on the tool results above, provide a response whose depth matches the question: for simple single-fact questions (a date, a name, a number, yes/no) answer concisely and directly in 1-4 sentences without headers or tables; only for comparison, ranking, list, or deep-dive questions use rich detail with well-organized Markdown headers, bullet points, and verified YouTube links (https://www.youtube.com/results?search_query=...). Never pad short factual answers with filler sections, and never omit any item the user explicitly requested.\n\n【Anti-Hallucination Mandate — MANDATORY】Only state facts explicitly present in the tool results above. Do NOT fabricate, infer, or supplement drama titles, song names, character roles, brand names, dates, or any details not found in the tool results. If the tool results are insufficient to fully answer, explicitly note which parts are unverified rather than inventing plausible-sounding details."
-        : "สรุปคำตอบจากผลลัพธ์เครื่องมือข้างต้น โดยให้ความลึกของคำตอบสมดุลกับคำถาม: คำถามข้อเท็จจริงเดี่ยว (วันที่ ชื่อ ตัวเลข ใช่/ไม่ใช่) ตอบสั้น ตรงประเด็น 1-4 ประโยค โดยไม่ต้องมีหัวข้อหรือตาราง ส่วนคำถามเปรียบเทียบ จัดอันดับ จัดรายการ หรือวิเคราะห์เชิงลึก จึงจัดโครงสร้างด้วยหัวข้อ Markdown, ตาราง และ bullet points พร้อมแสดงลิงก์ YouTube จริง (Direct Watch Link และ https://www.youtube.com/results?search_query=...) อย่างครบถ้วน ห้ามเติมเนื้อหาฟุ่มเฟือยในคำตอบสั้น แต่ห้ามลดทอนรายการที่ผู้ใช้ระบุขอมาทุกข้อ\n\n【กฎป้องกันการแต่งข้อมูล — บังคับใช้】ระบุเฉพาะข้อเท็จจริงที่มีอยู่จริงในผลลัพธ์เครื่องมือเท่านั้น ห้ามสร้างชื่อละคร เพลง ตัวละคร แบรนด์ วันที่ หรือรายละเอียดใดๆ ที่ไม่มีอยู่ในผลลัพธ์เครื่องมือ หากข้อมูลไม่เพียงพอสำหรับคำตอบที่สมบูรณ์ ให้ระบุชัดเจนว่าส่วนใดยังไม่ได้รับการยืนยัน แทนการเติมข้อมูลที่ฟังดูน่าเชื่อแต่ไม่มีหลักฐาน";
+    const inDomain = isQueryInDomain(promptForLLM);
+    const langPrompt = inDomain
+      ? (dominantLang === 'zh'
+        ? "请根据上述工具查询结果回答，回答深度须与问题相称：单一事实类问题（日期、名字、数字、是/否）用 1-4 句话直接简洁作答，不加标题或表格；仅当问题是比较、排序、列表或深度分析时，才使用完整的 Markdown 结构（标题、要点、表格）并附上具体的 YouTube 真实链接（如 Direct Watch: https://www.youtube.com/watch?v=... 或 Search: https://www.youtube.com/results?search_query=...）。不要用无关段落填充简短的事实性回答，但也绝不能遗漏用户明确要求的任何条目。\n\n【反幻觉守则 — 必须遵守】只陈述工具结果中明确包含的事实。禁止编造、推测或补充工具结果中不存在的剧名、歌曲名、角色名、品牌名、日期或任何细节。如果工具结果不足以完整回答，请明确说明哪些部分未经验证，而不是凭空补全。"
+        : dominantLang === 'en'
+          ? "Based on the tool results above, provide a response whose depth matches the question: for simple single-fact questions (a date, a name, a number, yes/no) answer concisely and directly in 1-4 sentences without headers or tables; only for comparison, ranking, list, or deep-dive questions use rich detail with well-organized Markdown headers, bullet points, and verified YouTube links (https://www.youtube.com/results?search_query=...). Never pad short factual answers with filler sections, and never omit any item the user explicitly requested.\n\n【Anti-Hallucination Mandate — MANDATORY】Only state facts explicitly present in the tool results above. Do NOT fabricate, infer, or supplement drama titles, song names, character roles, brand names, dates, or any details not found in the tool results. If the tool results are insufficient to fully answer, explicitly note which parts are unverified rather than inventing plausible-sounding details."
+          : "สรุปคำตอบจากผลลัพธ์เครื่องมือข้างต้น โดยให้ความลึกของคำตอบสมดุลกับคำถาม: คำถามข้อเท็จจริงเดี่ยว (วันที่ ชื่อ ตัวเลข ใช่/ไม่ใช่) ตอบสั้น ตรงประเด็น 1-4 ประโยค โดยไม่ต้องมีหัวข้อหรือตาราง ส่วนคำถามเปรียบเทียบ จัดอันดับ จัดรายการ หรือวิเคราะห์เชิงลึก จึงจัดโครงสร้างด้วยหัวข้อ Markdown, ตาราง และ bullet points พร้อมแสดงลิงก์ YouTube จริง (Direct Watch Link และ https://www.youtube.com/results?search_query=...) อย่างครบถ้วน ห้ามเติมเนื้อหาฟุ่มเฟือยในคำตอบสั้น แต่ห้ามลดทอนรายการที่ผู้ใช้ระบุขอมาทุกข้อ\n\n【กฎป้องกันการแต่งข้อมูล — บังคับใช้】ระบุเฉพาะข้อเท็จจริงที่มีอยู่จริงในผลลัพธ์เครื่องมือเท่านั้น ห้ามสร้างชื่อละคร เพลง ตัวละคร แบรนด์ วันที่ หรือรายละเอียดใดๆ ที่ไม่มีอยู่ในผลลัพธ์เครื่องมือ หากข้อมูลไม่เพียงพอสำหรับคำตอบที่สมบูรณ์ ให้ระบุชัดเจนว่าส่วนใดยังไม่ได้รับการยืนยัน แทนการเติมข้อมูลที่ฟังดูน่าเชื่อแต่ไม่มีหลักฐาน")
+      : (dominantLang === 'zh'
+        ? "请针对用户的通用或外部问题，提供清晰、准确、有条理且有帮助的回答。若有网络检索结果可作为参考，亦可自然运用通用知识进行解答。"
+        : dominantLang === 'en'
+          ? "Please provide a clear, accurate, and well-structured answer to the user's general or open-domain question. Reference web search results if available, and feel free to use general knowledge."
+          : "โปรดให้คำตอบที่ชัดเจน ถูกต้อง และมีประโยชน์ต่อคำถามทั่วไปหรือหัวข้อภายนอกนี้ โดยสามารถอ้างอิงจากผลการค้นหาเว็บ (หากมี) หรือตอบด้วยความรู้รอบตัวได้อย่างเป็นธรรมชาติ");
 
     const synthHistoryBase = this.conversationHistory.length;
     this.conversationHistory.push({ role: 'user', content: langPrompt });
@@ -1478,8 +1729,12 @@ export class KikuAgent {
         ...turnDirectives,
         ...this.conversationHistory.slice(1)
       ],
-      temperature: 0.3,
+      temperature: runTemperature ?? 0.3,
+      topP: runTopP ?? null,
+      minP: runMinP,
+      repeatPenalty: runRepeatPenalty,
       maxTokens: OUTPUT_TOKEN_BUDGET,
+      contextLimit: runContextLimit,
       stream: true,
       signal,
       onThought: (thoughtChunk) => {
@@ -1616,10 +1871,11 @@ export class KikuAgent {
   _computeConfidenceScore(toolResultTracker) {
     if (toolResultTracker.total === 0) return 0;
 
-    const successRatio = toolResultTracker.success / toolResultTracker.total;
-    const errorPenalty = toolResultTracker.error * 0.5;
-    const notFoundPenalty = toolResultTracker.notFound * 0.35;
-    const base = Math.max(0, successRatio - errorPenalty - notFoundPenalty);
+    const total = toolResultTracker.total;
+    const successRatio = toolResultTracker.success / total;
+    const errorRatio = toolResultTracker.error / total;
+    const notFoundRatio = toolResultTracker.notFound / total;
+    const base = Math.max(0, successRatio - errorRatio * 0.5 - notFoundRatio * 0.35);
 
     const hasVerifiedSource = toolResultTracker.success > 0;
     const allFailed = toolResultTracker.success === 0 && (toolResultTracker.notFound > 0 || toolResultTracker.error > 0);
@@ -1631,6 +1887,23 @@ export class KikuAgent {
   }
 
   async _performSelfCritique(toolResultTracker, dominantLang, originalQuery) {
+    const inDomain = isQueryInDomain(originalQuery);
+    if (!inDomain) {
+      const th = dominantLang === 'th';
+      const zh = dominantLang === 'zh';
+      const prefix = th
+        ? '【คำสั่งระบบสำหรับหัวข้อทั่วไป — เปิดกว้าง】'
+        : zh
+          ? '【开放领域问答指令】'
+          : '【OPEN-DOMAIN SYNTHESIS DIRECTIVE】';
+      const body = th
+        ? 'คำถามนี้เป็นความรู้ทั่วไปหรือหัวข้อภายนอกที่ไม่เกี่ยวกับผลงานของศิลปินโดยตรง คุณสามารถตอบได้อย่างเป็นธรรมชาติ มีประโยชน์ และถูกต้องตามความรู้รอบตัว หรืออ้างอิงจากผลการค้นหาเว็บภายนอก (หากมี) โดยไม่ต้องบังคับหาข้อมูลในแค็ตตาล็อกของศิลปิน'
+        : zh
+          ? '此问题属于通用知识或外部话题。您可以结合常识与外部网页搜索结果自然、准确、有建设性地回答，无需强行关联艺人数据库。'
+          : 'This query relates to open-domain knowledge or general topics. Provide a helpful, accurate, and natural answer using your general knowledge and web search results without forcing catalog references.';
+      return `${prefix}\n${body}\nOriginal query: ${originalQuery}`;
+    }
+
     const confidence = this._computeConfidenceScore(toolResultTracker);
 
     const th = dominantLang === 'th';

package/server/agent/appPaths.js

@@ -24,3 +24,34 @@ export const SETTINGS_FILE = path.join(KIKU_DATA_DIR, 'settings.json');
 export const PROFILES_FILE = path.join(KIKU_DATA_DIR, 'profiles.json');
 export const HIERARCHICAL_MEMORY_DIR = path.join(KIKU_DATA_DIR, 'memory_nodes');
 export const ARTIFACTS_STORE_DIR = path.join(KIKU_DATA_DIR, 'artifacts_store');
+
+export function getSystemDrive(env = process.env) {
+  return env.SystemDrive || 'C:';
+}
+
+export function getProgramFilesDir(env = process.env) {
+  return env.ProgramFiles || env.ProgramW6432 || path.join(getSystemDrive(env), 'Program Files');
+}
+
+export function getProgramFilesX86Dir(env = process.env) {
+  return env['ProgramFiles(x86)'] || path.join(getSystemDrive(env), 'Program Files (x86)');
+}
+
+export function getLocalAppDataDir(env = process.env) {
+  return env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
+}
+
+export function getAppDataDir(env = process.env) {
+  return env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+}
+
+export function resolveDynamicWindowsAppPaths(...relativeParts) {
+  const dirs = [
+    getProgramFilesDir(),
+    getProgramFilesX86Dir(),
+    getLocalAppDataDir(),
+    path.join(getLocalAppDataDir(), 'Programs'),
+    getAppDataDir(),
+  ];
+  return [...new Set(dirs.map(d => path.join(d, ...relativeParts)))];
+}