kiku-agent 1.0.6 → 1.0.8

package/package.json

@@ -1,93 +1,96 @@
-{
-  "name": "kiku-agent",
-  "version": "1.0.6",
-  "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
-  "type": "module",
-  "bin": {
-    "kiku-agent": "server/agent/cli.js",
-    "kiku-mcp": "server/mcp/stdio.js"
-  },
-  "exports": {
-    ".": "./server/agent/agentCore.js",
-    "./mcp": "./server/mcp/server.js",
-    "./tools": "./server/agent/tools.js"
-  },
-  "files": [
-    "server/agent/*.js",
-    "server/mcp/*.js",
-    "server/mcp/data/*.js",
-    "server/mcp/**/*.json",
-    "src/data/**/*.js",
-    "README.md"
-  ],
-  "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",
-    "cli",
-    "ai-agent",
-    "mcp",
-    "model-context-protocol",
-    "lm-studio"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ThemeHackers/jujingyi_kikuuu.git"
-  },
-  "homepage": "https://jujingyi-kikuuu.vercel.app/",
-  "bugs": {
-    "url": "https://github.com/ThemeHackers/jujingyi_kikuuu/issues"
-  },
-  "license": "UNLICENSED",
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview",
-    "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"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "clsx": "^2.1.1",
-    "framer-motion": "^12.4.7",
-    "lucide-react": "^1.16.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwind-merge": "^3.0.2",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "@tailwindcss/vite": "^4.0.9",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "@vitejs/plugin-react": "^4.3.4",
-    "ink": "^7.1.1",
-    "ink-select-input": "^6.2.0",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
-    "tailwindcss": "^4.0.9",
-    "tsx": "^4.23.12",
-    "vite": "^6.2.0"
-  },
-  "allowScripts": {
-    "esbuild@0.25.12": true,
-    "esbuild@0.28.2": true
-  }
-}
+{
+  "name": "kiku-agent",
+  "version": "1.0.8",
+  "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
+  "license": "GPL-3.0",
+  "type": "module",
+  "bin": {
+    "kiku-agent": "server/agent/cli.js",
+    "kiku-mcp": "server/mcp/stdio.js"
+  },
+  "exports": {
+    ".": "./server/agent/agentCore.js",
+    "./mcp": "./server/mcp/server.js",
+    "./tools": "./server/agent/tools.js"
+  },
+  "files": [
+    "server/agent/*.js",
+    "server/mcp/*.js",
+    "server/mcp/data/*.js",
+    "server/mcp/**/*.json",
+    "src/data/**/*.js",
+    "src/assets/images/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "kikuUpdate": {
+    "channel": "stable",
+    "releaseSummary": [
+      "Updated production model defaults and live fallback resolution across cloud providers",
+      "Hardened REST API key validation and isolated rate-limit probes",
+      "Fixed discography filtering, MCP configuration isolation, and environment loading order",
+      "Secured YouTube iframe messaging and expanded provider and API regression coverage"
+    ],
+    "releaseUrl": "https://www.npmjs.com/package/kiku-agent"
+  },
+  "keywords": [
+    "kiku",
+    "ju-jingyi",
+    "cli",
+    "ai-agent",
+    "mcp",
+    "model-context-protocol",
+    "lm-studio"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ThemeHackers/jujingyi_kikuuu.git"
+  },
+  "homepage": "https://jujingyi-kikuuu.vercel.app/",
+  "bugs": {
+    "url": "https://github.com/ThemeHackers/jujingyi_kikuuu/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "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"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.4.7",
+    "jpeg-js": "^0.4.4",
+    "lucide-react": "^1.16.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwind-merge": "^3.0.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.0.9",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@vitejs/plugin-react": "^4.3.4",
+    "ink": "^7.1.1",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "tailwindcss": "^4.0.9",
+    "tsx": "^4.23.12",
+    "vite": "^6.2.0"
+  },
+  "allowScripts": {
+    "esbuild@0.25.12": true,
+    "esbuild@0.28.2": true
+  }
+}

package/server/agent/agentCore.js

@@ -12,7 +12,8 @@ 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';
+import { contextCompactor } from './contextCompactor.js';
+import { AgentJobManager } from './jobManager.js';
 
 export function detectDominantLanguage(text) {
   if (!text || typeof text !== 'string') return 'th';
@@ -63,7 +64,8 @@ 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.suggestions = new SuggestionEngine({ client: this.client, memory: this.memory });
+    this.jobs = new AgentJobManager();
     this.systemPrompt = this.buildSystemPrompt();
     this.initHistory();
     this.restoredMessageCount = 0;
@@ -101,33 +103,39 @@ export class KikuAgent {
     return this._ready;
   }
 
-  async runSubagent(task, options = {}) {
-    await this._ready;
-    const subagent = new ResearchSubagent({
-      client: this.client,
-      maxIterations: options.maxIterations || 3,
-    });
-    return subagent.run(task, {
-      signal: options.signal,
-      onProgress: options.onProgress,
-      skillContext: this.memory.buildUserSkillContext(),
-    });
-  }
-
-  async runResearch(question, options = {}) {
-    await this._ready;
-    return this.research.run(question, {
-      ...options,
-      skillContext: this.memory.buildUserSkillContext(),
-    });
+  async runSubagent(task, options = {}) {
+    await this._ready;
+    return this.jobs.run('subagent', task, async ({ signal }) => {
+      const subagent = new ResearchSubagent({
+        client: this.client,
+        maxIterations: options.maxIterations || 3,
+      });
+      return subagent.run(task, {
+        signal,
+        onProgress: options.onProgress,
+        skillContext: this.memory.buildUserSkillContext(),
+      });
+    }, options);
+  }
+
+  async runResearch(question, options = {}) {
+    await this._ready;
+    const type = options.mode === 'verify' ? 'verify' : 'research';
+    return this.jobs.run(type, question, ({ signal }) => this.research.run(question, {
+      ...options,
+      signal,
+      skillContext: this.memory.buildUserSkillContext(),
+    }), options);
   }
 
   getResearchStatus() {
     return this.research.getStatus();
   }
 
-  cancelResearch() {
-    return this.research.cancel();
+  cancelResearch() {
+    const direct = this.research.cancel();
+    const tracked = this.jobs.cancelType('research') || this.jobs.cancelType('verify');
+    return direct || tracked;
   }
 
   async generateSuggestions(options = {}) {
@@ -135,14 +143,33 @@ export class KikuAgent {
     return this.suggestions.generateSuggestions(options);
   }
 
-  async runSuggestionBatch(targets, options = {}) {
-    await this._ready;
-    return this.suggestions.runBatchSubagents(targets, options);
-  }
-
-  getLastSuggestions() {
-    return this.suggestions.getLastSuggestions();
-  }
+  async runSuggestionBatch(targets, options = {}) {
+    await this._ready;
+    return this.jobs.run('suggestion', String(targets || 'all'), ({ signal }) => this.suggestions.runBatchSubagents(targets, {
+      ...options,
+      signal,
+    }), options);
+  }
+
+  getLastSuggestions() {
+    return this.suggestions.getLastSuggestions();
+  }
+
+  getJobs() {
+    return this.jobs.list();
+  }
+
+  getJob(id) {
+    return this.jobs.get(id);
+  }
+
+  cancelJob(id) {
+    return this.jobs.cancel(id);
+  }
+
+  clearJobs() {
+    return this.jobs.clear();
+  }
 
   initHistory() {
     this.conversationHistory = [

package/server/agent/cli.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 
-import readline from 'node:readline';
-import { stdin as input } from 'node:process';
-import { existsSync } from 'node:fs';
-import { spawn } from 'node:child_process';
-import { KikuAgent } from './agentCore.js';
+import readline from 'node:readline';
+import { stdin as input } from 'node:process';
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import './youtubeAuth.js';
+import { KikuAgent } from './agentCore.js';
 import { LLMClient, LMStudioClient } from './llmClient.js';
 import { toolsSchema, toolHandlers, executeTool } from './tools.js';
 import { config, CLOUD_PROVIDERS } from './config.js';
@@ -16,8 +17,9 @@ import { sanitizeQuery } from './sanitizer.js';
 import { isAbortError } from './errors.js';
 import { COMMAND_DEFINITIONS, SUB_COMMANDS, findCommandDefinition, getCommandDetails } from './commandRegistry.js';
 import { ModelManager } from './modelManager.js';
-import { PACKAGE_VERSION } from './version.js';
-import { getTheme, getThemeName } from './theme.js';
+import { PACKAGE_VERSION } from './version.js';
+import { getTheme, getThemeName } from './theme.js';
+import { createTerminalImageGallery } from './terminalImage.js';
 import {
   classifyToolResult,
   formatDetailDuration,
@@ -37,7 +39,7 @@ import {
   printWelcomeHero, getWelcomeHeroLines, randomFanName, setupOutputInterception,
   rawWrite, INPUT_PLACEHOLDER, UI_ICONS,
   spinnerFrames, thinkingFrames, createProgressRunner,
-  enterAlternateScreen, exitAlternateScreen, getTuiViewportLayout, VirtualScreenBuffer,
+  enterAlternateScreen, exitAlternateScreen, getTuiViewportLayout, getNewOutputScrollOffset, VirtualScreenBuffer,
 } from './ui.js';
 
 let activeAbortController = null;
@@ -489,7 +491,11 @@ function printAd() {
 
 class InteractiveTuiPrompt {
   constructor(options = {}) {
-    this.promptText = options.prompt || 'Kiku ❯ ';
+    this.defaultPromptText = options.prompt || 'Kiku ❯ ';
+    this.promptText = this.defaultPromptText;
+    this.inputPlaceholder = INPUT_PLACEHOLDER;
+    this.recordInputHistory = true;
+    this.cancelValue = null;
     this.agent = options.agent || null;
     this.modelName = options.modelName || 'gemma-4-e4b';
     this.provider = options.provider || 'lmstudio';
@@ -520,27 +526,28 @@ class InteractiveTuiPrompt {
     );
   }
 
-  addViewportLines(lines) {
-    if (lines === null || lines === undefined) return;
-    if (!Array.isArray(lines)) lines = [lines];
-    const wasLive = this.scrollOffset === 0;
-    for (const l of lines) {
-      if (typeof l === 'string') {
-        const sublines = l.split('\n');
-        for (const sl of sublines) {
-          this.viewportLines.push(sl);
-        }
-      } else if (l != null) {
-        this.viewportLines.push(String(l));
-      }
+  addViewportLines(lines) {
+    if (lines === null || lines === undefined) return;
+    if (!Array.isArray(lines)) lines = [lines];
+    const wasLive = this.scrollOffset === 0;
+    let addedLineCount = 0;
+    for (const l of lines) {
+      if (typeof l === 'string') {
+        const sublines = l.split('\n');
+        for (const sl of sublines) {
+          this.viewportLines.push(sl);
+          addedLineCount += 1;
+        }
+      } else if (l != null) {
+        this.viewportLines.push(String(l));
+        addedLineCount += 1;
+      }
     }
     if (this.viewportLines.length > 5000) {
       const removedCount = this.viewportLines.length - 5000;
       this.viewportLines.splice(0, removedCount);
     }
-    if (wasLive) {
-      this.scrollOffset = 0;
-    }
+    this.scrollOffset = getNewOutputScrollOffset(addedLineCount, process.stdout.rows || 24, wasLive ? 0 : this.scrollOffset);
     this.render();
   }
 
@@ -577,10 +584,15 @@ class InteractiveTuiPrompt {
     try { if (input.isTTY) input.setRawMode(false); } catch { }
   }
 
-  async readLine() {
-    return new Promise((resolve, reject) => {
-      this._cleanupInput();
-      this.line = '';
+  async readLine(options = {}) {
+    return new Promise((resolve, reject) => {
+      this._cleanupInput();
+      const inputOptions = typeof options === 'string' ? { prompt: options } : options;
+      this.promptText = inputOptions.prompt || this.defaultPromptText;
+      this.inputPlaceholder = inputOptions.placeholder || INPUT_PLACEHOLDER;
+      this.recordInputHistory = inputOptions.history !== false;
+      this.cancelValue = inputOptions.cancelValue ?? null;
+      this.line = '';
       this.cursor = 0;
       this.historyIndex = -1;
       this.popoverIndex = 0;
@@ -614,7 +626,7 @@ class InteractiveTuiPrompt {
     this.cursor = 0;
     this.popoverActive = false;
     this.popoverItems = [];
-    if (result && result.trim()) this.history.push(result);
+    if (this.recordInputHistory && result && result.trim()) this.history.push(result);
     const resolve = this.activeResolve;
     this.activeResolve = null;
     this.activeReject = null;
@@ -783,7 +795,7 @@ class InteractiveTuiPrompt {
         trailingStyled = `${C.dim}${C.slate}${ghostDisplay}${C.reset}`;
       }
     } else if (!this.line) {
-      const placeholder = sliceLineForDisplay(INPUT_PLACEHOLDER, 0, maxLineWidth).displayLine;
+      const placeholder = sliceLineForDisplay(this.inputPlaceholder, 0, maxLineWidth).displayLine;
       trailingStyled = `${C.dim}${C.slate}${placeholder}${C.reset}`;
     }
 
@@ -800,8 +812,12 @@ class InteractiveTuiPrompt {
   handleKeypress(str, key) {
     if (!key && !str) return;
 
-    if ((key?.ctrl && key?.name === 'c') || str === '\x03') {
-      if (isProcessing) {
+    if ((key?.ctrl && key?.name === 'c') || str === '\x03') {
+      if (this.cancelValue !== null) {
+        this.finish(this.cancelValue);
+        return;
+      }
+      if (isProcessing) {
         if (this.onCancel) this.onCancel();
         else if (this.onSigInt) this.onSigInt();
         this.addViewportLines(`  ${C.amber}[✓ Cancelled by user]${C.reset}`);
@@ -826,8 +842,12 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'escape' || str === '\x1b') {
-      if (this.popoverActive) {
+    if (key?.name === 'escape' || str === '\x1b') {
+      if (this.cancelValue !== null) {
+        this.finish(this.cancelValue);
+        return;
+      }
+      if (this.popoverActive) {
         this.popoverActive = false;
         this.popoverItems = [];
         this.ghostText = '';
@@ -1540,15 +1560,23 @@ async function main() {
 
           if (opts.showStats) { printWelcomeHero(); const r = await executeTool('get_system_stats', {}); console.log(JSON.stringify(r, null, 2)); process.exit(0); }
 
-          if (opts.query) {
-            printWelcomeHero();
-            const client = new LLMClient({
+          if (opts.query) {
+            printWelcomeHero();
+            const client = new LLMClient({
               provider: opts.provider || config.activeProvider,
               baseUrl: opts.url,
               apiKey: opts.apiKey,
-              model: opts.model
-            });
-            console.log(`  ${C.bold}${C.gold}QUERY${C.reset} ${C.white}${opts.query}${C.reset}\n`);
+              model: opts.model
+            });
+            const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
+            const modelResolution = await modelManager.resolve({ requestedModel: opts.model || client.model });
+            if (!modelResolution.connected || !modelResolution.selectedModel) {
+              throw new Error(modelResolution.error || `No available chat model found for ${client.providerName}`);
+            }
+            if (modelResolution.usedFallback) {
+              console.log(`  ${C.amber}Model ${modelResolution.requestedModel} is unavailable; using ${modelResolution.selectedModel}.${C.reset}\n`);
+            }
+            console.log(`  ${C.bold}${C.gold}QUERY${C.reset} ${C.white}${opts.query}${C.reset}\n`);
             const agent = new KikuAgent({ client, thinkingMode: opts.thinking });
             await executeQueryWithUI(agent, opts.query, agent.session.thinkingMode === 'show', null, 1);
             process.exit(0);
@@ -1592,7 +1620,7 @@ async function main() {
             return false;
           }
 
-          const tuiPrompt = new InteractiveTuiPrompt({
+          const tuiPrompt = new InteractiveTuiPrompt({
             prompt: 'Kiku ❯ ',
             agent,
             modelName: opts.model || client.model || 'gemma-4-e4b',
@@ -1612,7 +1640,8 @@ async function main() {
                 process.exit(0);
               }
             }
-          });
+          });
+          const terminalGallery = createTerminalImageGallery();
 
           globalTuiPrompt = tuiPrompt;
           setupOutputInterception(tuiPrompt, () => isProcessing);
@@ -1665,7 +1694,7 @@ async function main() {
             }
           }
 
-          const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
+          const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
           const modelResolution = catalogOnlyMode
             ? { connected: false, state: 'catalog_only' }
             : await modelManager.resolve({ requestedModel: opts.model || client.model });
@@ -1685,7 +1714,7 @@ async function main() {
               title: 'Connected & Ready',
               status: 'connected',
               lines: [
-                `• Provider: ${client.providerName} (Local)  • Model: ${modelResolution.selectedModel}`,
+                `• Provider: ${client.providerName}${client.provider === 'lmstudio' ? ' (Local)' : ''}  • Model: ${modelResolution.selectedModel}`,
                 `• Status: Chat & Tool DAG Active  • Tools: ${toolsSchema.length} Loaded`,
               ],
             });
@@ -1734,9 +1763,17 @@ async function main() {
 
           const mcpStatus = agent.mcpManager ? agent.mcpManager.getStatus() : null;
           if (mcpStatus && mcpStatus.activeServersCount > 0 && !opts.mcp) {
-            const serverSummaries = mcpStatus.servers
-              .filter(s => s.status === 'connected')
-              .map(s => `• ${s.name} (${s.type}) — ${s.toolsCount} tools`);
+            const serverSummaries = mcpStatus.servers
+              .filter(s => s.status === 'connected')
+              .map(s => {
+                const sources = (s.sources || [])
+                  .map(source => String(source).split(/[\\/]/).pop())
+                  .filter(Boolean);
+                const sourceLabel = sources.length > 0
+                  ? ` • source: ${[...new Set(sources)].join(', ')}`
+                  : '';
+                return `• ${s.name} (${s.type}) — ${s.toolsCount} tools${sourceLabel}`;
+              });
             printRichCard({
               title: 'Persisted MCP Connected',
               status: 'mcp',
@@ -1795,10 +1832,16 @@ async function main() {
             printHelp,
             printQueryDetails,
             copyQueryDetails,
-            printWelcome: printWelcomeHero,
-            printAd,
-            cancelActiveQuery,
-            enqueueQuery: async (prompt, isRetry) => {
+            printWelcome: printWelcomeHero,
+            printAd,
+            showTerminalImage: () => {
+              const imageLines = terminalGallery.maybeRender(queryCount, { force: true });
+              if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
+              return imageLines.length > 0;
+            },
+            cancelActiveQuery,
+            readInput: options => tuiPrompt.readLine(options),
+            enqueueQuery: async (prompt, isRetry) => {
               queryQueue.push({ id: 'q_' + Date.now(), number: nextQueryNumber++, prompt, addedAt: Date.now() });
               triggerQueueProcessing();
             },
@@ -1870,10 +1913,12 @@ async function main() {
                       });
                     }
                   } finally {
-                    activeAbortController = null;
-                    queryCount++;
-                    printAd();
-                    activeQueryNumber = null;
+                    activeAbortController = null;
+                    queryCount++;
+                    printAd();
+                    const imageLines = terminalGallery.maybeRender(queryCount);
+                    if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
+                    activeQueryNumber = null;
                     if (globalTuiPrompt) {
                       globalTuiPrompt.agentState = '';
                       globalTuiPrompt.render();