kiku-agent 1.0.7 → 1.0.9

package/server/agent/commandRegistry.js

@@ -1,13 +1,13 @@
 export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/help', usage: '/help [command]', desc: 'Show all commands or details for one command', insert: '/help ' },
-  { name: '/history', usage: '/history [n|search|clear]', desc: 'View or search chat history', insert: '/history ' },
-  { name: '/session', usage: '/session [info|list|export|clear]', desc: 'Manage the current session', insert: '/session ' },
+  { name: '/history', usage: '/history [n|search|summary|clear]', desc: 'View, search, or summarize chat history', insert: '/history ' },
+  { name: '/session', usage: '/session [info|summary|list|export|clear]', desc: 'Manage or summarize the current session', insert: '/session ' },
   { name: '/thinking', usage: '/thinking [show|hide|toggle]', desc: 'Control reasoning visibility', insert: '/thinking ' },
   { name: '/details', usage: '/details [Qn] [overview|answer|thinking|tools|tool n]', desc: 'Inspect query diagnostics (F2 opens latest overview)', insert: '/details ' },
   { name: '/copy', usage: '/copy [Qn] [answer|thinking|tools|tool n|all|markdown]', desc: 'Copy full untruncated model answer, thinking, or diagnostics to clipboard', insert: '/copy ' },
   { name: '/lang', usage: '/lang [th|zh|en|auto]', desc: 'Set the response language', insert: '/lang ' },
   { name: '/theme', usage: '/theme [name|list|current|reset]', desc: 'View or change the terminal color theme', insert: '/theme ' },
-  { name: '/mem', usage: '/mem [add|del|search|list|topics|import|export|clear]', desc: 'Manage long-term memory', insert: '/mem ' },
+  { name: '/mem', usage: '/mem [add|del|search|list|topics|summary|import|export|clear]', desc: 'Manage and summarize long-term memory', insert: '/mem ' },
   { name: '/subagent', usage: '/subagent <research task>', desc: 'Run a bounded Ju Jingyi research subagent', insert: '/subagent ' },
   { name: '/research', usage: '/research <question|status|last|sources|cancel>', desc: 'Run coordinated multi-source Ju Jingyi research', insert: '/research ' },
   { name: '/verify', usage: '/verify <claim>', desc: 'Verify a Ju Jingyi claim with independent workers', insert: '/verify ' },
@@ -16,6 +16,12 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/skill', usage: '/skill [learn|list|del|on|off|clear]', desc: 'Teach Kiku how to answer for you', insert: '/skill ' },
   { name: '/tool', usage: '/tool <name> [args]', desc: 'Execute a registered tool directly', insert: '/tool ' },
   { name: '/tools', usage: '/tools [filter]', desc: 'List registered tools', insert: '/tools ' },
+  { name: '/find', usage: '/find <query> [--type <type>] [--year YYYY]', desc: 'Search every Ju Jingyi catalog', insert: '/find ' },
+  { name: '/compare', usage: '/compare <item-a> -- <item-b>', desc: 'Compare catalog entries or career years', insert: '/compare ' },
+  { name: '/favorites', usage: '/favorites [list|add|suggest|remove|export]', desc: 'Manage a persistent fan collection', insert: '/favorites ' },
+  { name: '/news', usage: '/news [topic] [--days N] [--official-only]', desc: 'Find recent source-backed Ju Jingyi news', insert: '/news ' },
+  { name: '/jobs', usage: '/jobs [list|show|cancel|clear]', desc: 'Inspect and control tracked agent jobs', insert: '/jobs ' },
+  { name: '/discover', usage: '/discover [drama|song|stage|photo]', desc: 'Discover something from the catalog', insert: '/discover ' },
   { name: '/stats', usage: '/stats', desc: 'Show the content database overview', insert: '/stats' },
   { name: '/provider', usage: '/provider [list|use <name> [model]|models [name]|info <name>|test|setkey <key>|status]', desc: 'Manage AI providers (OpenAI, Gemini, Groq, DeepSeek, OpenRouter, LM Studio)', insert: '/provider ' },
   { name: '/model', usage: '/model [status|list|recommend|use <id>|reconnect]', desc: 'Inspect, recommend, or switch active AI model', insert: '/model ' },
@@ -29,7 +35,10 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/system', usage: '/system', desc: 'Show operating-system and memory information', insert: '/system' },
   { name: '/gpu', usage: '/gpu [status]', desc: 'Show GPU & VRAM hardware resource metrics', insert: '/gpu' },
   { name: '/about', usage: '/about', desc: 'Show information about Kiku Agent', insert: '/about' },
+  { name: '/quiz', usage: '/quiz [lang]', desc: 'Take the 15-question Ju Jingyi quiz to claim a Developer VIP Key', insert: '/quiz ' },
+  { name: '/key', usage: '/key [show|apply <key>|clear]', desc: 'Manage your Developer VIP API Key', insert: '/key ' },
   { name: '/ads', usage: '/ads', desc: 'Show the next sponsor card', insert: '/ads' },
+  { name: '/gallery', usage: '/gallery', desc: 'Show the next Ju Jingyi image in the terminal', insert: '/gallery' },
   { name: '/retry', usage: '/retry', desc: 'Retry the previous query', insert: '/retry' },
   { name: '/cancel', usage: '/cancel', desc: 'Abort the currently running query, tool, or subagent task', insert: '/cancel' },
   { name: '/clear', usage: '/clear', desc: 'Archive the session and clear the screen', insert: '/clear' },
@@ -56,12 +65,20 @@ export const COMMAND_DEFINITIONS = Object.freeze([
 export const COMMAND_NAMES = Object.freeze(COMMAND_DEFINITIONS.map(command => command.name));
 
 export const SUB_COMMANDS = Object.freeze({
-  '/mem': ['add <fact>', 'search <query>', 'list', 'topics', 'del <id>', 'import <path>', 'export', 'clear'],
+  '/mem': ['add <fact>', 'search <query>', 'list', 'topics', 'summary', 'del <id>', 'import <path>', 'export', 'clear'],
+  '/quiz': ['lang th', 'lang en', 'lang zh'],
+  '/key': ['show', 'apply <key>', 'clear'],
   '/subagent': ['<research task>'],
   '/research': ['<question>', 'status', 'last', 'sources', 'cancel'],
   '/verify': ['<claim>'],
   '/suggestion': ['list', 'run 1', 'run all', 'auto', 'refresh', 'topic drama', 'topic music', 'topic fashion', 'topic 2026'],
   '/skill': ['learn <instruction>', 'list', 'del <id>', 'on', 'off', 'clear'],
+  '/find': ['--type work', '--type song', '--type role', '--type brand', '--type award', '--type photo', '--type stage', '--year 2026', '--limit 8'],
+  '/compare': ['<item-a> -- <item-b>', '<year-a> -- <year-b>', '--type work', '--type song'],
+  '/favorites': ['list', 'list --type work', 'add <query>', 'add song <query>', 'suggest', 'remove <id>', 'export json', 'export markdown'],
+  '/news': ['--days 7', '--days 30', '--official-only', '<topic> --days 14'],
+  '/jobs': ['list', 'show <id>', 'cancel <id>', 'clear'],
+  '/discover': ['drama', 'song', 'stage', 'photo', 'song --mood calm', 'stage --year 2025'],
   '/provider': ['list', 'status', 'models', 'models openai', 'models gemini', 'models groq', 'models deepseek', 'models openrouter', 'models lmstudio', 'use openai', 'use openrouter', 'use groq', 'use deepseek', 'use gemini', 'use lmstudio', 'use custom', 'info', 'test', 'setkey <key>'],
   '/model': ['status', 'list', 'recommend', 'use <model-id>', 'reconnect'],
   '/mcp': ['status', 'list', 'tools', 'connect <name> <url>', 'disconnect <name>', 'remove <name>', 'reconnect [all]', 'save', 'reload'],
@@ -70,13 +87,77 @@ export const SUB_COMMANDS = Object.freeze({
   '/thinking': ['show', 'hide', 'toggle'],
   '/details': ['latest', 'overview', 'answer', 'thinking', 'tools', 'tool <n>', 'all', 'markdown', 'Q1 overview', 'Q1 tool 1'],
   '/copy': ['answer', 'thinking', 'tools', 'tool 1', 'overview', 'all', 'markdown', 'Q1 answer', 'Q1 thinking', 'Q1 all'],
-  '/session': ['info', 'list', 'export', 'clear'],
-  '/history': ['10', '20', '50', 'search <query>', 'clear'],
+  '/session': ['info', 'summary', 'list', 'export', 'clear'],
+  '/history': ['10', '20', '50', 'search <query>', 'summary', 'clear'],
   '/queue': ['clear'],
   '/update': ['check', 'install', 'install next', 'install canary', 'channel', 'channel latest', 'channel next', 'channel canary', 'rollback', 'help'],
 });
 
 export const COMMAND_DETAILS = Object.freeze({
+  '/find': {
+    summary: 'Search works, songs, roles, brands, awards, photos, and performances without an active chat model',
+    usage: '/find <query> [--type <type>] [--year YYYY] [--limit 1-20]',
+    subcommands: [
+      { cmd: '<query>', desc: 'Search all supported catalog types', example: '/find In Blossom' },
+      { cmd: '--type <type>', desc: 'Limit results to work, song, role, brand, award, photo, or stage', example: '/find Rain Love --type song' },
+      { cmd: '--year YYYY', desc: 'Limit results to one catalog year', example: '/find --type work --year 2025' },
+      { cmd: '--limit N', desc: 'Return between 1 and 20 results', example: '/find จวีจิ้งอี --limit 12' },
+    ],
+    examples: ['/find In Blossom', '/find Versace --type brand', '/find --type work --year 2026'],
+  },
+  '/compare': {
+    summary: 'Compare two catalog entries or summarize two career years side by side',
+    usage: '/compare <item-a> -- <item-b> [--type <type>]',
+    subcommands: [
+      { cmd: '<item-a> -- <item-b>', desc: 'Resolve and compare two catalog entries', example: '/compare In Blossom -- Beauty of Resilience' },
+      { cmd: '<year-a> -- <year-b>', desc: 'Compare catalog activity across two years', example: '/compare 2024 -- 2025' },
+      { cmd: '--type <type>', desc: 'Resolve both items within one catalog type', example: '/compare Rain Love -- Moonlight --type song' },
+    ],
+    examples: ['/compare In Blossom -- Beauty of Resilience', '/compare 2024 -- 2025'],
+  },
+  '/favorites': {
+    summary: 'Build and export a persistent personal collection of Ju Jingyi content with AI suggestions',
+    usage: '/favorites [list | add [type] <query> | suggest | remove <id> | export <json|markdown>]',
+    subcommands: [
+      { cmd: 'list [--type <type>]', desc: 'List every favorite or filter by catalog type', example: '/favorites list --type song' },
+      { cmd: 'add [type] <query>', desc: 'Resolve a catalog entry and save it', example: '/favorites add song Rain Love' },
+      { cmd: 'suggest', desc: 'Synthesize AI recommendations based on your saved favorites', example: '/favorites suggest' },
+      { cmd: 'remove <id>', desc: 'Remove one favorite by its displayed ID', example: '/favorites remove fav_123_abc' },
+      { cmd: 'export <json|markdown>', desc: 'Export favorites to the protected Kiku exports directory', example: '/favorites export markdown' },
+    ],
+    examples: ['/favorites add In Blossom', '/favorites suggest', '/favorites list', '/favorites export json'],
+  },
+  '/news': {
+    summary: 'Search recent Ju Jingyi coverage and display source URLs with available dates',
+    usage: '/news [topic] [--days 1-90] [--official-only]',
+    subcommands: [
+      { cmd: '[topic]', desc: 'Search recent news for an optional topic', example: '/news ซีรีส์ใหม่' },
+      { cmd: '--days N', desc: 'Set the recent-news window from 1 to 90 days', example: '/news Versace --days 30' },
+      { cmd: '--official-only', desc: 'Keep results from supported official social and media hosts', example: '/news --days 14 --official-only' },
+    ],
+    examples: ['/news', '/news drama --days 7', '/news --official-only'],
+  },
+  '/jobs': {
+    summary: 'Inspect, cancel, and clear tracked research, verification, subagent, and suggestion jobs',
+    usage: '/jobs [list | show <id> | cancel <id> | clear]',
+    subcommands: [
+      { cmd: 'list', desc: 'List active and recent jobs', example: '/jobs list' },
+      { cmd: 'show <id>', desc: 'Show timestamps, state, and error details for one job', example: '/jobs show job_123_abc' },
+      { cmd: 'cancel <id>', desc: 'Abort one running job', example: '/jobs cancel job_123_abc' },
+      { cmd: 'clear', desc: 'Remove completed, failed, and cancelled jobs', example: '/jobs clear' },
+    ],
+    examples: ['/jobs', '/jobs show job_123_abc', '/jobs cancel job_123_abc'],
+  },
+  '/discover': {
+    summary: 'Pick a catalog recommendation for a drama, song, stage performance, or photo',
+    usage: '/discover [drama|song|stage|photo] [--year YYYY] [--mood <mood>]',
+    subcommands: [
+      { cmd: 'drama | song | stage | photo', desc: 'Choose the type of recommendation', example: '/discover drama' },
+      { cmd: '--year YYYY', desc: 'Limit discovery to one year', example: '/discover stage --year 2025' },
+      { cmd: '--mood <mood>', desc: 'Use calm, romantic, energetic, dramatic, or any', example: '/discover song --mood calm' },
+    ],
+    examples: ['/discover drama', '/discover song --mood calm', '/discover photo'],
+  },
   '/suggestion': {
     summary: 'Generate AI research suggestions & execute with concurrent subagents',
     usage: '/suggestion [list | run <id|ids|all> | auto | topic <name> | refresh]',
@@ -182,6 +263,35 @@ export const COMMAND_DETAILS = Object.freeze({
       '/verify Ju Jingyi will star in a new 2026 historical drama',
     ],
   },
+  '/quiz': {
+    summary: 'Interactive 15-question Ju Jingyi quiz to claim a Developer VIP Key (1,000 req/min)',
+    usage: '/quiz [lang <th|en|zh>]',
+    subcommands: [
+      { cmd: '', desc: 'Start the quiz in your current language setting', example: '/quiz' },
+      { cmd: 'lang th', desc: 'Start the quiz in Thai', example: '/quiz lang th' },
+      { cmd: 'lang en', desc: 'Start the quiz in English', example: '/quiz lang en' },
+      { cmd: 'lang zh', desc: 'Start the quiz in Chinese', example: '/quiz lang zh' },
+    ],
+    examples: [
+      '/quiz',
+      '/quiz lang th',
+      '/quiz lang en',
+    ],
+  },
+  '/key': {
+    summary: 'View, apply, or clear your Developer VIP API Key',
+    usage: '/key [show | apply <key> | clear]',
+    subcommands: [
+      { cmd: 'show', desc: 'Display your current stored VIP key', example: '/key show' },
+      { cmd: 'apply <key>', desc: 'Manually save a VIP key for use in API requests', example: '/key apply kiku_vip_sk_abc123' },
+      { cmd: 'clear', desc: 'Remove the stored VIP key', example: '/key clear' },
+    ],
+    examples: [
+      '/key',
+      '/key apply kiku_vip_sk_abc123',
+      '/key clear',
+    ],
+  },
   '/subagent': {
     summary: 'Spawn an isolated iterative research subagent to investigate a specific task or subtopic',
     usage: '/subagent <task | status | last | tools>',
@@ -302,26 +412,30 @@ export const COMMAND_DETAILS = Object.freeze({
     usage: '/session [info | list | export | clear]',
     subcommands: [
       { cmd: 'info', desc: 'Display session ID, active duration, message count, and turn stats', example: '/session info' },
+      { cmd: 'summary', desc: 'Synthesize an AI analytical summary of the active session', example: '/session summary' },
       { cmd: 'list', desc: 'List all saved conversation sessions on disk', example: '/session list' },
       { cmd: 'export', desc: 'Export full conversation session history to JSON', example: '/session export' },
       { cmd: 'clear', desc: 'Archive current conversation session and reset history', example: '/session clear' },
     ],
     examples: [
       '/session info',
+      '/session summary',
       '/session list',
       '/session clear',
     ],
   },
   '/history': {
-    summary: 'View or search recent chat message history',
-    usage: '/history [count | search <query> | clear]',
+    summary: 'View, search, or summarize recent chat message history',
+    usage: '/history [count | search <query> | summary | clear]',
     subcommands: [
       { cmd: '[n]', desc: 'Display the last N messages (default: 20)', example: '/history 10' },
       { cmd: 'search <query>', desc: 'Search messages in current session history', example: '/history search In Blossom' },
+      { cmd: 'summary', desc: 'Synthesize an AI summary of past conversation turns', example: '/history summary' },
       { cmd: 'clear', desc: 'Clear in-memory conversation history', example: '/history clear' },
     ],
     examples: [
       '/history',
+      '/history summary',
       '/history 50',
       '/history search drama',
     ],