kiku-agent 1.0.4 → 1.0.6

package/README.md

@@ -48,7 +48,24 @@ The same package also installs the stdio MCP server command:
 kiku-mcp
 ```
 
-For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.4.tgz`.
+### Updating the CLI and MCP server
+
+Kiku uses the published `kiku-agent` package on npm as its update source. Inside an interactive session:
+
+```text
+/update                         # Check the configured release channel
+/update install                 # Install the stable `latest` release
+/update install next            # Install a preview release
+/update install 1.2.3           # Install an exact published version
+/update channel next            # Persist the preferred channel
+/update rollback                # Restore the previously recorded version
+```
+
+Automatic installation is available for global npm installs. Source checkouts, local dependencies, and `npx` executions receive a safe manual command instead of having their files replaced. Major updates require `--allow-major`; deprecated releases require `--allow-deprecated`. npm commands are executed without a shell and only allow known channel names or strict semantic versions.
+
+After an update or rollback, restart `kiku-agent` and any application hosting `kiku-mcp`. Update settings and rollback history are stored in the normal Kiku user data directory as `update-state.json`; sessions, memory, `.env`, and YouTube cookies are not modified.
+
+For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.6.tgz`.
 
 ### ✨ Features
 - **LM Studio Integration**: Connects seamlessly to LM Studio's OpenAI-compatible server at `http://127.0.0.1:1234/v1` (default model `google/gemma-4-e4b`, with auto-detection of loaded models).
@@ -104,6 +121,7 @@ npm run kiku-agent -- --model google/gemma-4-e4b-Q4_K_M --url http://127.0.0.1:1
 | Flag | Description |
 |---|---|
 | `-h`, `--help` | Show usage help |
+| `-V`, `--version` | Print the installed package version and exit |
 | `-P`, `--provider <name>` | Select active provider (`lmstudio`, `openai`, `gemini`, `groq`, `deepseek`, `openrouter`, `custom`) |
 | `-k`, `--api-key <key>` | Specify API key for cloud provider |
 | `-m`, `--model <id>` | Override model ID (e.g. `gpt-4o-mini`, `google/gemma-4-e4b-Q4_K_M`) |
@@ -131,8 +149,11 @@ Run `/help` inside a session for the full list. Commonly used:
 - `/model use <model-id>` — Switch runtime model without restarting the CLI
 - `/model reconnect` — Recheck server and leave catalog-only mode after a chat model is loaded
 - `/doctor` — Check Node, writable app data, LM Studio, model availability, FFmpeg, speaker, and yt-dlp
+- `/update [check|install|channel|rollback]` — Manage npm-backed CLI and MCP package updates
 - `/tools` — View all tool names and parameter descriptions
-- `/details [Qn]` — Expand recorded thinking and tool results for a question
+- `/details [Qn]` — Open a compact diagnostic overview for the latest or selected question (F2 opens latest)
+- `/details [Qn] answer|thinking|tools` — Inspect one diagnostic section without dumping every raw result
+- `/details [Qn] tool <n>` — Inspect bounded raw arguments and result for one tool call
 - `/stats` — Print summary counts of dramas, songs, brands, and awards
 - `/thinking [show|hide]` — Toggle reasoning process visibility
 - `/save` — Export session transcript to Markdown file
@@ -252,6 +273,8 @@ The production deployment exposes a stateless Streamable HTTP endpoint at `https
 /mcp tools
 ```
 
+`/mcp` shows the connection summary plus every available MCP tool command in a compact list. `/mcp tools` expands the same list with parameters and descriptions. Long command panels open at their first page in the classic TUI; use Page Down or End to continue through the result.
+
 ---
 
 ## ⚙️ Environment Variables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiku-agent",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
   "type": "module",
   "bin": {
@@ -23,6 +23,16 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "kikuUpdate": {
+    "channel": "stable",
+    "releaseSummary": [
+      "AI research suggestion engine and batch subagent execution",
+      "Enhanced web search fallbacks and missing catalog tool hints",
+      "Updated brand endorsements (Versace) and dual catalog sync",
+      "Secure npm-backed updates and terminal markdown renderer"
+    ],
+    "releaseUrl": "https://www.npmjs.com/package/kiku-agent"
+  },
   "keywords": [
     "kiku",
     "ju-jingyi",
@@ -51,8 +61,7 @@
     "kiku-agent": "node server/agent/cli.js",
     "kiku-mcp": "node server/mcp/stdio.js",
     "kiku-ink": "npx tsx server/agent/ink/main.jsx",
-    "test": "node --test server/agent/tests/*.test.js server/mcp/tests/*.test.js",
-    "prepublishOnly": "npm test"
+    "test": "node --test server/agent/tests/*.test.js server/mcp/tests/*.test.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",

package/server/agent/agentCore.js

@@ -9,6 +9,7 @@ import { sanitizeQuery, isLikelySafe } from './sanitizer.js';
 import { createAbortError, isAbortError } from './errors.js';
 import { ResearchSubagent } from './subagent.js';
 import { ResearchOrchestrator } from './research.js';
+import { SuggestionEngine } from './suggestions.js';
 import { McpClientManager } from './mcpClient.js';
 import { DynamicToolRouter } from './toolRouter.js';
 import { contextCompactor } from './contextCompactor.js';
@@ -62,6 +63,7 @@ export class KikuAgent {
     this.mcpManager = options.mcpManager || new McpClientManager();
     this.router = new DynamicToolRouter(this.getAllToolsSchema());
     this.research = new ResearchOrchestrator({ client: this.client });
+    this.suggestions = new SuggestionEngine({ client: this.client, memory: this.memory });
     this.systemPrompt = this.buildSystemPrompt();
     this.initHistory();
     this.restoredMessageCount = 0;
@@ -88,7 +90,7 @@ export class KikuAgent {
         await this.mcpManager.loadPersistedServers();
         this.router.setTools(this.getAllToolsSchema());
         this.systemPrompt = this.buildSystemPrompt();
-      } catch {}
+      } catch { }
     }
     if (!this.conversationHistory || this.conversationHistory.length === 0) {
       this.initHistory();
@@ -128,6 +130,20 @@ export class KikuAgent {
     return this.research.cancel();
   }
 
+  async generateSuggestions(options = {}) {
+    await this._ready;
+    return this.suggestions.generateSuggestions(options);
+  }
+
+  async runSuggestionBatch(targets, options = {}) {
+    await this._ready;
+    return this.suggestions.runBatchSubagents(targets, options);
+  }
+
+  getLastSuggestions() {
+    return this.suggestions.getLastSuggestions();
+  }
+
   initHistory() {
     this.conversationHistory = [
       {
@@ -139,12 +155,12 @@ export class KikuAgent {
 
   clearMemory() {
     if (this.session.messages.length > 0) {
-      this.memory.archiveSession(this.session.toSnapshot()).catch(() => {});
-      this.memory.consolidateSession(this.session.toSnapshot()).catch(() => {});
+      this.memory.archiveSession(this.session.toSnapshot()).catch(() => { });
+      this.memory.consolidateSession(this.session.toSnapshot()).catch(() => { });
     }
     this.initHistory();
     this.session.reset();
-    this.session.clearDisk().catch(() => {});
+    this.session.clearDisk().catch(() => { });
   }
 
   async loadSession() {
@@ -156,7 +172,7 @@ export class KikuAgent {
           content: this.systemPrompt
         }
       ];
-      
+
       for (const msg of this.session.messages) {
         if (msg.role === 'user') {
           const textPart = msg.parts.find(p => p.type === 'text');
@@ -224,6 +240,47 @@ export class KikuAgent {
     return result;
   }
 
+  async removeMcp(name) {
+    const result = await this.mcpManager.remove(name);
+    this.router.setTools(this.getAllToolsSchema());
+    this.systemPrompt = this.buildSystemPrompt();
+    if (this.conversationHistory && this.conversationHistory[0]?.role === 'system') {
+      this.conversationHistory[0].content = this.getEnrichedSystemPrompt();
+    }
+    return result;
+  }
+
+  async reconnectMcp(name) {
+    const result = name && name !== 'all'
+      ? await this.mcpManager.reconnect(name)
+      : await this.mcpManager.reconnectAll();
+    this.router.setTools(this.getAllToolsSchema());
+    this.systemPrompt = this.buildSystemPrompt();
+    if (this.conversationHistory && this.conversationHistory[0]?.role === 'system') {
+      this.conversationHistory[0].content = this.getEnrichedSystemPrompt();
+    }
+    return result;
+  }
+
+  async saveMcpConfig(target = 'global') {
+    if (target === 'workspace' || target === 'local') {
+      return this.mcpManager.saveToWorkspace();
+    }
+    return this.mcpManager.savePersistedConfig();
+  }
+
+  async loadMcpConfig(customPath) {
+    const results = customPath
+      ? await this.mcpManager.loadConfigFile(customPath)
+      : await this.mcpManager.loadPersistedServers();
+    this.router.setTools(this.getAllToolsSchema());
+    this.systemPrompt = this.buildSystemPrompt();
+    if (this.conversationHistory && this.conversationHistory[0]?.role === 'system') {
+      this.conversationHistory[0].content = this.getEnrichedSystemPrompt();
+    }
+    return results;
+  }
+
   buildSystemPrompt() {
     const allTools = this.getAllToolsSchema();
     const toolsSummary = allTools.map(t => {
@@ -280,9 +337,9 @@ ${toolsSummary}
    - Directory listing ➔ list_directory
    - Screenshot ➔ screenshot_webpage
 
-6. AGGRESSIVE WEB SEARCH FALLBACK:
-   - If local tools return insufficient results, IMMEDIATELY call web_search or web_extract.
-   - Combine local data WITH web search for complete, accurate answers.
+6. AGGRESSIVE WEB SEARCH FALLBACK (CRITICAL):
+   - If a local catalog tool (e.g. search_works, search_discography, get_brand_endorsements, get_awards) returns not_found, empty, or 0 results, DO NOT give up or guess. You MUST IMMEDIATELY call web_search or web_extract in the next step to look up live external facts online.
+   - Combine local catalog data WITH live web search for complete, accurate, and up-to-date answers.
    - Use web_extract for comprehensive research on any topic.
 
 7. LEGAL & CAREER KNOWLEDGE:
@@ -367,18 +424,18 @@ ${toolsSummary}
     for (const topic of topics) {
       this.memory.trackTopicInterest(topic);
     }
-    
+
     const {
-      onStepStart = () => {},
-      onReasoningStart = () => {},
-      onReasoningDelta = () => {},
-      onReasoningEnd = () => {},
-      onToolStart = () => {},
-      onToolResult = () => {},
-      onTokenStart = () => {},
-      onTokenDelta = () => {},
-      onFinalAnswer = () => {},
-      onError = () => {},
+      onStepStart = () => { },
+      onReasoningStart = () => { },
+      onReasoningDelta = () => { },
+      onReasoningEnd = () => { },
+      onToolStart = () => { },
+      onToolResult = () => { },
+      onTokenStart = () => { },
+      onTokenDelta = () => { },
+      onFinalAnswer = () => { },
+      onError = () => { },
       signal = null
     } = callbacks;
 
@@ -509,6 +566,15 @@ ${toolsSummary}
       let toolCalls = assistantMessage.tool_calls || [];
       if (toolCalls.length === 0 && assistantMessage.content) {
         toolCalls = this.parseTextToolCalls(assistantMessage.content);
+       
+        if (toolCalls.length > 0) {
+          let cleaned = assistantMessage.content;
+
+          cleaned = cleaned.replace(/```(?:json)?\s*\{[\s\S]*?\}\s*```/g, '');
+        
+          cleaned = cleaned.replace(/Action:\s*[a-zA-Z0-9_]+\s*\nAction Input:\s*(?:\{[\s\S]*?\}|[^\n]+)/g, '');
+          assistantMessage.content = cleaned.trim();
+        }
       }
 
       this.conversationHistory.push(assistantMessage);
@@ -519,8 +585,8 @@ ${toolsSummary}
 
         const finalAnswer = assistantMessage.content || (
           dominantLang === 'zh' ? "抱歉，无法处理您的回答。" :
-          dominantLang === 'en' ? "Sorry, unable to process a response." :
-          "ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้"
+            dominantLang === 'en' ? "Sorry, unable to process a response." :
+              "ขออภัยค่ะ ไม่สามารถประมวลผลคำตอบได้"
         );
         onFinalAnswer(finalAnswer, { durationMs: totalDurationMs, language: dominantLang });
         this._extractFactsFromFinalAnswer(finalAnswer);
@@ -532,11 +598,8 @@ ${toolsSummary}
         return finalAnswer;
       }
 
-      for (const [toolCallIndex, tc] of toolCalls.entries()) {
-        if (signal?.aborted) {
-          this.stateMachine.reset();
-          throw createAbortError();
-        }
+      const executionPromises = toolCalls.map(async (tc, toolCallIndex) => {
+        if (signal?.aborted) throw createAbortError();
 
         const toolName = tc?.function?.name || '';
         const toolCallId = tc?.id || `call_${queryId}_${currentIteration}_${toolCallIndex}`;
@@ -560,20 +623,21 @@ ${toolsSummary}
             validationWarnings: prepared.warnings,
           };
           eventBus.emit(Events.AGENT_TOOL_ERROR, {
-            queryId, toolName, args: tc.function.arguments,
+            queryId, toolName, args: tc?.function?.arguments,
             error: prepared.error,
           });
           onToolStart(toolName, {});
           onToolResult(toolName, rejectedResult, 0);
-          const toolMessage = {
-            role: 'tool',
-            tool_call_id: toolCallId,
-            name: toolName,
-            content: JSON.stringify(rejectedResult)
+          return {
+            toolMessage: {
+              role: 'tool',
+              tool_call_id: toolCallId,
+              name: toolName,
+              content: JSON.stringify(rejectedResult)
+            }
           };
-          this.conversationHistory.push(toolMessage);
-          continue;
         }
+
         if (prepared.warnings.length > 0) {
           eventBus.emit(Events.AGENT_TOOL_ERROR, {
             queryId, toolName, warnings: prepared.warnings,
@@ -581,7 +645,6 @@ ${toolsSummary}
         }
 
         const finalArgs = prepared.args;
-
         this.stateMachine.transition(AgentStates.FETCHING_TOOL, { toolName });
 
         const toolPart = this.session.addToolPart(currentAssistantSessionMsg, toolName, finalArgs);
@@ -610,30 +673,40 @@ ${toolsSummary}
 
         this._extractFactsFromToolResult(toolName, finalArgs, result);
 
-        const toolMessage = {
-          role: 'tool',
-          tool_call_id: toolCallId,
-          name: toolName,
-          content: JSON.stringify({
-            authoritative: true,
-            result,
-            instruction: result.status === 'not_found'
-              ? 'No matching data was found. Do not invent records; say that the catalog has no match or use an appropriate fallback tool.'
-              : result.status === 'error'
-                ? 'The tool failed. Do not claim that the requested facts were verified.'
-                : 'Use only facts present in this result when answering.'
-          })
+     
+        const cappedResult = this._capToolResultForHistory(result);
+
+        return {
+          toolMessage: {
+            role: 'tool',
+            tool_call_id: toolCallId,
+            name: toolName,
+            content: JSON.stringify({
+              authoritative: true,
+              result: cappedResult,
+              instruction: result.status === 'not_found'
+                ? 'No matching data was found. Do not invent records; say that the catalog has no match or use an appropriate fallback tool.'
+                : result.status === 'error'
+                  ? 'The tool failed. Do not claim that the requested facts were verified.'
+                  : 'Use only facts present in this result when answering. Do not echo raw JSON data — summarize in natural language.'
+            })
+          }
         };
+      });
 
-        this.conversationHistory.push(toolMessage);
+      const toolResults = await Promise.all(executionPromises);
+      for (const item of toolResults) {
+        if (item?.toolMessage) {
+          this.conversationHistory.push(item.toolMessage);
+        }
       }
     }
 
-    const langPrompt = dominantLang === 'zh' 
+    const langPrompt = dominantLang === 'zh'
       ? "请根据上述工具查询结果，直接回答（不要开头问候语），用流畅优雅的中文，先1-2句概述，再列要点。包含具体的 YouTube 真实链接（如 Direct Watch: https://www.youtube.com/watch?v=... หรือ Search: https://www.youtube.com/results?search_query=...）及事实数据。"
       : dominantLang === 'en'
-      ? "Based on the tool results above, answer directly (no opening greeting or template phrase). Give a 1-2 sentence summary, then concise bullet points in polished English. Include verified YouTube direct and search links (https://www.youtube.com/results?search_query=...)."
-      : "สรุปคำตอบจากผลลัพธ์เครื่องมือข้างต้น โดยไม่ต้องทักทาย ตอบตรงประเด็น 1-2 ประโยค แล้วตามด้วย bullet points สั้นๆ เป็นภาษาไทย พร้อมแสดงลิงก์ YouTube จริง (Direct Watch Link และ https://www.youtube.com/results?search_query=...) และข้อมูลผลงานที่ถูกต้องแม่นยำ";
+        ? "Based on the tool results above, answer directly (no opening greeting or template phrase). Give a 1-2 sentence summary, then concise bullet points in polished English. Include verified YouTube direct and search links (https://www.youtube.com/results?search_query=...)."
+        : "สรุปคำตอบจากผลลัพธ์เครื่องมือข้างต้น โดยไม่ต้องทักทาย ตอบตรงประเด็น 1-2 ประโยค แล้วตามด้วย bullet points สั้นๆ เป็นภาษาไทย พร้อมแสดงลิงก์ YouTube จริง (Direct Watch Link และ https://www.youtube.com/results?search_query=...) และข้อมูลผลงานที่ถูกต้องแม่นยำ";
 
     this.conversationHistory.push({ role: 'user', content: langPrompt });
 
@@ -677,19 +750,55 @@ ${toolsSummary}
     const defaultDone = dominantLang === 'zh' ? "查询完毕" : dominantLang === 'en' ? "Search complete." : "เสร็จสิ้นการค้นหาข้อมูล";
     const output = finalRes?.content || defaultDone;
     onFinalAnswer(output, { durationMs: totalDurationMs, language: dominantLang });
-    
+
     this._extractFactsFromFinalAnswer(output);
 
     this.stateMachine.transition(AgentStates.COMPLETE);
     eventBus.emit(Events.AGENT_FINAL_ANSWER, { queryId, answer: output, durationMs: totalDurationMs });
     eventBus.emit(Events.AGENT_QUERY_END, { queryId, durationMs: totalDurationMs });
     this.stateMachine.reset();
-    
+
     this.saveSession().catch(err => console.error('Session save failed:', err));
-    
+
     return output;
   }
 
+  _capToolResultForHistory(result) {
+    if (!result || typeof result !== 'object') return result;
+
+    const MAX_RESULT_BYTES = 4096;
+    const serialized = JSON.stringify(result);
+    if (serialized.length <= MAX_RESULT_BYTES) return result;
+
+
+    const truncate = (obj) => {
+      if (Array.isArray(obj)) {
+        if (obj.length > 8) {
+          const kept = obj.slice(0, 8).map(truncate);
+          kept.push({ _truncated: true, totalItems: obj.length, showing: 8 });
+          return kept;
+        }
+        return obj.map(truncate);
+      }
+      if (obj && typeof obj === 'object') {
+        const out = {};
+        for (const [key, val] of Object.entries(obj)) {
+          out[key] = truncate(val);
+        }
+        return out;
+      }
+    
+      if (typeof obj === 'string' && obj.length > 500) {
+        return obj.slice(0, 500) + '…[truncated]';
+      }
+      return obj;
+    };
+
+    const capped = truncate(result);
+    capped._cappedForHistory = true;
+    return capped;
+  }
+
   _extractFactsFromToolResult(toolName, toolArgs, result) {
     if (!result || result.status === 'error' || result.status === 'not_found') return;