kiku-agent 1.3.0 → 1.3.1

package/README.md

@@ -52,7 +52,7 @@ kiku-agent
 ```
 
 > [!NOTE]
-> The global package deliberately excludes native binary build dependencies (Python, `node-gyp`, Visual Studio C++ build tools are not required). For a local checkout before publishing, pack and install via `npm install -g ./kiku-agent-1.3.0.tgz`.
+> The global package deliberately excludes native binary build dependencies (Python, `node-gyp`, Visual Studio C++ build tools are not required). For a local checkout before publishing, pack and install via `npm install -g ./kiku-agent-1.3.1.tgz`.
 
 ### Zero-Install One-Shot Query
 
@@ -96,7 +96,7 @@ npm run kiku-agent -- --provider openrouter --model openrouter/auto
 
 ## Features
 
-- **Autonomous ReAct Agent**: Equipped with **59 validated tools** covering catalog knowledge, live web search, news/encyclopedia discovery, YouTube audio playback, filesystem inspection, stateful memory checkpoints, entertainment analytics, and research workers.
+- **Autonomous ReAct Agent**: Equipped with **60 validated tools** covering catalog knowledge, live web search, news/encyclopedia discovery, YouTube audio playback, filesystem inspection, stateful memory checkpoints, entertainment analytics, and research workers.
 - **Stateful & Self-Reflective Memory Engine**: Hierarchical workspace (`kiku/runs/{run_id}/...`), pointer-over-data rule (>1,000 chars referenced to prevent context bloat), real-time step checkpoints (`checkpoint_step`, `record_failure`, `load_active_run`), post-run compaction into global reflections (`kiku/knowledge/reflections.md`), and 4-tier token budget allocation.
 - **Fault-Tolerant Hybrid Meta-Search**: Zero-key search combining DuckDuckGo, SearXNG, and Jina with token bucket rate limiting, circuit breakers, SSRF DNS pinning, multilingual query fan-out, and Reciprocal Rank Fusion (RRF).
 - **Predictive VRAM & Telemetry Engine**: Real-time GPU memory footprint estimation, context scaling ladder, multi-stage memory bus width disambiguation, sliding-window attention (SWA) KV cache modeling, and offline database of 100+ accelerators (`/vram`, `npm run vram:live`).
@@ -214,15 +214,15 @@ Type `/help` inside any active session for the interactive command palette. Comm
 
 ---
 
-## Available Agent Tools (59)
+## Available Agent Tools (60)
 
-Kiku Agent includes **59 validated tools** across 6 categories that the agent autonomously invokes during conversations:
+Kiku Agent includes **60 validated tools** across 6 categories that the agent autonomously invokes during conversations:
 
 - **Catalog (14)**: Profile, fandom facts, quotes, filmography (2013–2026), character roles, discography, music videos, brands, career timeline, awards, Weibo/Douyin feeds, 4K gallery, and global fuzzy search.
 - **Web & Network (6)**: Live DuckDuckGo search, hybrid meta-search orchestrator (SearXNG, Jina), article extraction, raw webpage fetch, JSON parser, page screenshots, and REST API querying.
 - **Discovery & Analytics (11)**: Live news/RSS feeds, encyclopedia lookup, Chinese web portals, Chinese web image search (`search_web_images` for on-set stills, red carpet & press photos), Bilibili video search, music-platform search, YouTube transcripts, datetime utility, and entertainment/industry metrics.
 - **Music Player (15)**: YouTube streaming via `yt-dlp` & `ffmpeg`, playlist queue management, track playback controls, and volume mute/unmute.
-- **Filesystem & Stateful Memory (6)**: Directory listing, safe local file reader, archive statistics, plus **Hierarchical Memory Checkpoints**: `checkpoint_step` (record execution step and state), `record_failure` (capture error code and recovery path), and `load_active_run` (hydrate run context and memory pointers).
+- **Filesystem & Stateful Memory (7)**: Directory listing, safe local file reader, archive statistics, plus **Hierarchical Memory Checkpoints**: `checkpoint_step` (record execution step and state), `record_failure` (capture error code and recovery path), `load_active_run` (hydrate run context and memory pointers), and `record_dynamic_event` (log dynamic career & media updates).
 - **Research, Skills & VIP (7)**: Autonomous research subagents, deep research coordinator, claim verification, topic suggestion, persistent skill learning, trivia quiz challenge, and Developer VIP key management.
 
 > [!TIP]
@@ -269,7 +269,7 @@ The package ships an official Model Context Protocol server exposing the Ju Jing
 kiku-mcp
 
 # Zero-install via npx:
-npx -y kiku-agent kiku-mcp
+npx -y -p kiku-agent kiku-mcp
 ```
 
 #### Claude Desktop & Cursor Integration
@@ -281,7 +281,7 @@ Add the following snippet to your `claude_desktop_config.json` or Cursor MCP con
   "mcpServers": {
     "kiku": {
       "command": "npx",
-      "args": ["-y", "kiku-agent", "kiku-mcp"]
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"]
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiku-agent",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
   "license": "GPL-3.0",
   "type": "module",
@@ -15,8 +15,13 @@
   },
   "files": [
     "server/*.js",
+    "server/routes/**/*",
     "server/web-chat/**/*",
     "server/agent/*.js",
+    "server/agent/websearch/**/*",
+    "server/agent/memory/**/*",
+    "server/agent/telemetry/**/*",
+    "server/agent/ink/**/*",
     "server/mcp/*.js",
     "server/mcp/data/*.js",
     "server/mcp/**/*.json",

package/server/agent/agentCore.js

@@ -997,10 +997,10 @@ export class KikuAgent {
     }
 
     const mentionsArtist = /(ju\s?jing\s?yi|jujingyi|จวีจิ้งอี|จิ้งอี|จวี|鞠婧祎|小鞠|kikuuu?|miju|蜜橘)/i.test(promptForLLM);
-    if (matchedQueryIntents.length === 0 && queryResolution.matchedEntities.length === 0 && !mentionsArtist && !autoResearchTriggered) {
+    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; use web_search or web_extract only if current external information is genuinely required.]"
+        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.]"
       });
     }
 

package/server/agent/catalogEntityResolver.js

@@ -586,6 +586,14 @@ export function getContextualizedSearchQuery(keyword = '', platform = 'bilibili'
 
   const resolution = resolveQueryEntities(raw);
 
+  const ARTIST_RE = /(ju\s?jing\s?yi|jujingyi|จวีจิ้งอี|จิ้งอี|鞠婧祎|小鞠|kikuuu?|蜜橘)/i;
+  const mentionsArtist = ARTIST_RE.test(raw);
+  const hasCatalogMatch = resolution.matchedEntities.length > 0;
+
+  if (!mentionsArtist && !hasCatalogMatch) {
+    return raw;
+  }
+
   if (platform === 'bilibili' || platform === 'chinese_web') {
     const parts = ['鞠婧祎'];
 

package/server/agent/cli.js

@@ -2202,6 +2202,10 @@ async function runWebChatStandalone(opts) {
 }
 
 async function main() {
+  if (process.argv[2] === 'kiku-mcp' || process.argv[2] === 'mcp-server') {
+    await import('../mcp/stdio.js');
+    return;
+  }
   const opts = parseCliArgs();
 
   if (!opts.query && !process.stdin.isTTY) {

package/server/agent/ink/App.jsx

@@ -0,0 +1,348 @@
+import React, { useState, useEffect, useCallback, useRef } from 'react';
+import { Box, Text, Static, useInput, useApp, useStdin } from 'ink';
+import { PromptInput } from './PromptInput.jsx';
+import { ThinkingPanel } from './ThinkingPanel.jsx';
+import { ToolCompleted, ToolSummary, ToolRunning } from './ToolResult.jsx';
+import { TaskPlanPanel } from './TaskPlanPanel.jsx';
+import { Panel, Separator } from './Panel.jsx';
+import { useAgentState, useStreamingText, useThinking, useToolResults, useTaskPlan, useEvent } from './useEventBus.js';
+import { eventBus, Events } from '../eventBus.js';
+import { getInkPalette } from '../theme.js';
+import { PACKAGE_VERSION } from '../version.js';
+
+const FAN_NAMES = ['Mìjú / 蜜橘'];
+function randomFanName() {
+  return FAN_NAMES[Math.floor(Math.random() * FAN_NAMES.length)];
+}
+
+function Header() {
+  const theme = getInkPalette();
+
+  return (
+    <Box flexDirection="column">
+      <Text color={theme.primary}>
+        {'  ██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗'}
+      </Text>
+      <Text color={theme.primary}>
+        {'  ██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║'}
+      </Text>
+      <Text color={theme.secondary}>
+        {'  █████═╝ ██║█████═╝ ██║   ██║    ███████║██║'}
+      </Text>
+      <Text color={theme.secondary}>
+        {'  ██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██║██║'}
+      </Text>
+      <Text color={theme.primary}>
+        {'  ██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║'}
+      </Text>
+      <Text color={theme.primary}>
+        {'  ╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝'}
+      </Text>
+      <Text />
+      <Box>
+        <Text color={theme.muted}>Architecture: </Text>
+        <Text bold color={theme.highlight}>Next-Gen v{PACKAGE_VERSION} </Text>
+        <Text color={theme.muted}>• SSOT Catalog • Dynamic Tool Router • Semantic Memory</Text>
+      </Box>
+      <Text />
+      <Text bold color={theme.secondary}>Example Questions & Capabilities:</Text>
+      <Text color={theme.text}>  <Text color={theme.primary}>[Dramas 2026]</Text> <Text>"What are Ju Jingyi's upcoming 2026 drama series (Veil of Shadows, Eternal Fragrance)?"</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.primary}>[Characters ]</Text> <Text>"Tell me about Yang Caiwei in In Blossom and Han Yunxi in Legend of Yunxi."</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.info}>[Music & OST]</Text> <Text>"What OST songs are from The Blooms at Ruyi Pavilion? /play Rain of Ginkgo"</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.info}>[Global Brand]</Text> <Text>"Tell me about her Global Fragrance Ambassador role for Versace and luxury brands."</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.success}>[Fact-Check ]</Text> <Text>"/verify Check Star48 contract status or /research 2026 broadcast licenses"</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.success}>[Persona/Mem]</Text> <Text>"/skill learn Always answer politely as a passionate Miju fan club member"</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.tertiary}>[Multi-Agent]</Text> <Text>"/subagent Investigate her upcoming drama production timeline and Weibo updates"</Text></Text>
+      <Text color={theme.text}>  <Text color={theme.tertiary}>[System Stats]</Text> <Text>"/stats or /doctor to inspect database records, models, and audio engine"</Text></Text>
+      <Text />
+      <Text>
+        <Text color={theme.tertiary}>Quick Commands: </Text>
+        <Text color={theme.info}>/help</Text>
+        <Text dimColor> • </Text>
+        <Text color={theme.success}>/subagent</Text>
+        <Text dimColor> • </Text>
+        <Text color={theme.success}>/research</Text>
+        <Text dimColor> • </Text>
+        <Text color={theme.success}>/verify</Text>
+        <Text dimColor> • </Text>
+        <Text color={theme.success}>/skill</Text>
+        <Text dimColor> • </Text>
+        <Text color={theme.success}>/exit</Text>
+        <Text dimColor> (Tab or ↑/↓ to navigate)</Text>
+      </Text>
+      <Text />
+    </Box>
+  );
+}
+
+function UserMessage({ text }) {
+  const theme = getInkPalette();
+
+  return (
+    <Box flexDirection="column">
+      <Text>
+        <Text color={theme.secondary} bold>{randomFanName()}: </Text>
+        <Text color={theme.text}>{text}</Text>
+      </Text>
+    </Box>
+  );
+}
+
+function StreamingResponse({ text, isStreaming }) {
+  if (!text && !isStreaming) return null;
+  const theme = getInkPalette();
+
+  const lines = text.split('\n');
+
+  return (
+    <Box flexDirection="column">
+      {lines.map((line, i) => (
+        <Box key={i}>
+          <Text>  </Text>
+          <Text color={theme.text}>{line || ' '}</Text>
+        </Box>
+      ))}
+      {isStreaming && (
+        <Box>
+          <Text color={theme.muted} dimColor> ▌</Text>
+        </Box>
+      )}
+    </Box>
+  );
+}
+
+function CompletedResponse({ text }) {
+  if (!text) return null;
+  const theme = getInkPalette();
+
+  const lines = text.split('\n');
+
+  return (
+    <Box flexDirection="column">
+      {lines.map((line, i) => (
+        <Box key={i}>
+          <Text>  </Text>
+          <Text color={theme.text}>{line || ' '}</Text>
+        </Box>
+      ))}
+    </Box>
+  );
+}
+
+function MusicStatusBar({ musicStatus }) {
+  if (!musicStatus) return null;
+  const theme = getInkPalette();
+
+  return (
+    <Box>
+      <Text color={theme.info}>{musicStatus} </Text>
+    </Box>
+  );
+}
+
+export function App({ agent, client, baseUrl, printHelp, printAd }) {
+  const { exit } = useApp();
+  const theme = getInkPalette();
+  const [outputLines, setOutputLines] = useState([]);
+  const [isProcessing, setIsProcessing] = useState(false);
+  const [lastQuery, setLastQuery] = useState(null);
+  const [finalAnswer, setFinalAnswer] = useState('');
+  const [, setThemeRevision] = useState(0);
+
+  const agentState = useAgentState();
+  const { text: streamingText, isStreaming, reset: resetStreaming } = useStreamingText();
+  const thinking = useThinking();
+  const { tools, clearTools } = useToolResults();
+  const { plan: taskPlan, clearPlan } = useTaskPlan();
+  const musicStatus = useEvent('music:state:change', '');
+
+  const agentStateLabel = isProcessing ? agentState.label : '';
+  const showStreaming = isStreaming && streamingText.length > 0;
+
+  useEffect(() => {
+    const unsub = eventBus.on(Events.AGENT_FINAL_ANSWER, (data) => {
+      setFinalAnswer(data?.answer || '');
+      setIsProcessing(false);
+      clearTools();
+    });
+    return unsub;
+  }, []);
+
+  useEffect(() => {
+    const unsub = eventBus.on(Events.AGENT_QUERY_ERROR, (data) => {
+      setOutputLines(prev => [...prev, {
+        type: 'error',
+        text: data?.error || 'Unknown error',
+        id: Date.now(),
+      }]);
+      setIsProcessing(false);
+    });
+    return unsub;
+  }, []);
+
+  const handleSubmit = useCallback(async (input) => {
+    const trimmed = input.trim();
+    if (!trimmed) return;
+
+    setOutputLines(prev => [...prev, {
+      type: 'user',
+      text: trimmed,
+      id: Date.now(),
+    }]);
+
+    if (trimmed.startsWith('/')) {
+      const { routeCommand } = await import('../commands.js');
+      const cmdCtx = {
+        agent,
+        client,
+        baseUrl,
+        sub: trimmed.split(/\s+/)[1] || '',
+        extra: trimmed.split(/\s+/).slice(2).join(' '),
+        parts: trimmed.split(/\s+/),
+        lastQuery,
+        printHelp,
+        printWelcome: () => {},
+        printAd,
+        enqueueQuery: () => {},
+        clearQueryQueue: () => {},
+        getQueryQueueLength: () => 0,
+      };
+
+      const result = await routeCommand(trimmed, cmdCtx);
+      const commandName = trimmed.split(/\s+/, 1)[0].toLowerCase();
+      if (commandName === '/theme' || commandName === '/themes') {
+        setThemeRevision(revision => revision + 1);
+      }
+      if (result === 'EXIT') {
+        exit();
+      }
+      return;
+    }
+
+    setLastQuery(trimmed);
+    setIsProcessing(true);
+    setFinalAnswer('');
+    resetStreaming();
+    clearTools();
+    clearPlan();
+
+    try {
+      const { sanitizeQuery } = await import('../sanitizer.js');
+      const { sanitized } = sanitizeQuery(trimmed);
+      const promptForLLM = sanitized || trimmed;
+
+      await agent.ask(promptForLLM, {
+        onStepStart: () => {},
+        onReasoningStart: () => {},
+        onReasoningDelta: () => {},
+        onReasoningEnd: () => {},
+        onToolStart: () => {},
+        onToolResult: () => {},
+        onTokenStart: () => {},
+        onTokenDelta: () => {},
+        onFinalAnswer: (answer) => {
+          setOutputLines(prev => [...prev, {
+            type: 'assistant',
+            text: answer,
+            tools: [...tools],
+            thinking: thinking.thinking,
+            thinkingDuration: thinking.duration,
+            id: Date.now(),
+          }]);
+          setIsProcessing(false);
+          setFinalAnswer('');
+          resetStreaming();
+          clearTools();
+        },
+        onError: (err) => {
+          setOutputLines(prev => [...prev, {
+            type: 'error',
+            text: err.message,
+            id: Date.now(),
+          }]);
+          setIsProcessing(false);
+        },
+      });
+    } catch (err) {
+      setOutputLines(prev => [...prev, {
+        type: 'error',
+        text: err.message,
+        id: Date.now(),
+      }]);
+      setIsProcessing(false);
+    }
+  }, [agent, client, baseUrl, lastQuery, tools, thinking]);
+
+  return (
+    <Box flexDirection="column" width="100%">
+      <Static items={[0]}>
+        {() => <Header key="header" />}
+      </Static>
+
+      <Box flexDirection="column">
+        {outputLines.map((line) => {
+          if (line.type === 'user') {
+            return <UserMessage key={line.id} text={line.text} />;
+          }
+          if (line.type === 'assistant') {
+            return (
+              <Box key={line.id} flexDirection="column">
+                {line.thinking && line.thinking.length > 0 && (
+                  <ThinkingPanel
+                    text={line.thinking}
+                    isActive={false}
+                    duration={line.thinkingDuration}
+                  />
+                )}
+                {line.tools && line.tools.length > 0 && (
+                  <ToolSummary tools={line.tools} />
+                )}
+                <CompletedResponse text={line.text} />
+              </Box>
+            );
+          }
+          if (line.type === 'error') {
+            return (
+              <Box key={line.id}>
+                <Text> </Text>
+                <Text color={theme.error}>[ERROR] {line.text}</Text>
+              </Box>
+            );
+          }
+          return null;
+        })}
+      </Box>
+
+      {isProcessing && (
+        <Box flexDirection="column">
+          {taskPlan && <TaskPlanPanel plan={taskPlan} />}
+
+          {thinking.isActive && (
+            <ThinkingPanel
+              text={thinking.thinking}
+              isActive={true}
+              duration={0}
+            />
+          )}
+
+          {tools.map((t, idx) => (
+            t.status === 'running'
+              ? <ToolRunning key={t.id || idx} name={t.name} args={t.args} />
+              : <ToolCompleted key={t.id || idx} name={t.name} result={t.result} duration={t.duration} />
+          ))}
+
+          {showStreaming && (
+            <StreamingResponse text={streamingText} isStreaming={true} />
+          )}
+        </Box>
+      )}
+
+      <PromptInput
+        onSubmit={handleSubmit}
+        musicStatus={musicStatus}
+        isProcessing={isProcessing}
+        agentStateLabel={agentStateLabel}
+      />
+    </Box>
+  );
+}

package/server/agent/ink/Panel.jsx

@@ -0,0 +1,54 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import { getInkPalette } from '../theme.js';
+
+export function Panel({ title, lines = [], borderColor = 'sakura', width }) {
+  const theme = getInkPalette();
+  const colorMap = {
+    sakura: theme.primary, gold: theme.highlight, cyan: theme.info,
+    emerald: theme.success, slate: theme.muted, roseGlow: theme.secondary,
+    lavender: theme.tertiary, amber: theme.warning,
+  };
+  const color = colorMap[borderColor] || borderColor;
+  const backgroundColor = theme.panel;
+
+  return (
+    <Box flexDirection="column" width={width || '100%'}>
+      {title && (
+        <Box>
+          <Text backgroundColor={backgroundColor}>  </Text>
+          <Text backgroundColor={backgroundColor} bold color={color}>{title} </Text>
+        </Box>
+      )}
+      {lines.map((line, i) => (
+        <Box key={i}>
+          <Text backgroundColor={backgroundColor}>  </Text>
+          {typeof line === 'string' ? (
+            <Text backgroundColor={backgroundColor} color={theme.text}>{line} </Text>
+          ) : (
+            line
+          )}
+        </Box>
+      ))}
+    </Box>
+  );
+}
+
+export function InlinePanel({ icon, text, color = 'white' }) {
+  return (
+    <Box>
+      <Text> </Text>
+      <Text>{icon} </Text>
+      <Text color={color}>{text}</Text>
+    </Box>
+  );
+}
+
+export function Separator({ color }) {
+  const theme = getInkPalette();
+  return (
+    <Box>
+      <Text color={color || theme.subdued}>{'─'.repeat(70)}</Text>
+    </Box>
+  );
+}