kiku-agent 1.0.11 → 1.2.0

package/server/agent/commandRegistry.js

@@ -1,879 +1,946 @@
-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|summary|clear]', desc: 'View, search, or summarize chat history', insert: '/history ' },
-  { name: '/session', usage: '/session [info|summary|list|load <id>|export|clear]', desc: 'Manage, restore, or summarize conversation sessions', 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 [session|[Qn] [answer|thinking|tools|tool n|all|json]]', desc: 'Copy full session transcript, answer, thinking, or tools 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|next|prev|reset]', desc: 'View or change the terminal color theme', insert: '/theme ' },
-  { 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 ' },
-  { name: '/sources', usage: '/sources', desc: 'Show sources from the latest research job', insert: '/sources' },
-  { name: '/suggestion', usage: '/suggestion [list|run <id|all>|auto|refresh|topic <name>]', desc: 'Generate AI research suggestions & execute with concurrent subagents', insert: '/suggestion ' },
-  { 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]|setkey [provider] <key>|info <name>|test|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 ' },
-  { name: '/mcp', usage: '/mcp [status|list|connect <name> <url|cmd>|disconnect <name>|remove <name>|reconnect [all]|save|reload|tools]', desc: 'Manage persistent Model Context Protocol connections', insert: '/mcp ' },
-  { name: '/ping', usage: '/ping', desc: 'Check active model server latency', insert: '/ping' },
-  { name: '/config', usage: '/config', desc: 'Show runtime configuration', insert: '/config' },
-  { name: '/doctor', usage: '/doctor', desc: 'Check first-run environment and optional features', insert: '/doctor' },
-  { name: '/prompt', usage: '/prompt', desc: 'Preview the active system persona', insert: '/prompt' },
-  { name: '/version', usage: '/version', desc: 'Show Kiku Agent version information', insert: '/version' },
-  { name: '/update', usage: '/update [check|install [target]|channel [name]|rollback]', desc: 'Check, install, configure, or roll back npm releases', insert: '/update ' },
-  { 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' },
-  { name: '/save', usage: '/save', desc: 'Export the transcript to Markdown', insert: '/save' },
-  { name: '/play', usage: '/play <song>', desc: 'Play music', insert: '/play ' },
-  { name: '/stop', usage: '/stop', desc: 'Stop music playback', insert: '/stop' },
-  { name: '/pause', usage: '/pause', desc: 'Pause music playback', insert: '/pause' },
-  { name: '/resume', usage: '/resume', desc: 'Resume music playback', insert: '/resume' },
-  { name: '/next', usage: '/next', desc: 'Play the next queued track', insert: '/next' },
-  { name: '/prev', usage: '/prev', desc: 'Return to the previous track', insert: '/prev' },
-  { name: '/mute', usage: '/mute', desc: 'Mute music playback', insert: '/mute' },
-  { name: '/unmute', usage: '/unmute', desc: 'Unmute music playback', insert: '/unmute' },
-  { name: '/add', usage: '/add <song>', desc: 'Add a song to the music queue', insert: '/add ' },
-  { name: '/remove', usage: '/remove <index>', desc: 'Remove a song from the music queue', insert: '/remove ' },
-  { name: '/clearqueue', usage: '/clearqueue', desc: 'Clear the music queue', insert: '/clearqueue' },
-  { name: '/search', usage: '/search <query>', desc: 'Search YouTube', insert: '/search ' },
-  { name: '/current', usage: '/current', desc: 'Show the current track', insert: '/current' },
-  { name: '/queue', usage: '/queue [clear]', desc: 'Show or clear the active queue', insert: '/queue ' },
-  { name: '/login', usage: '/login', desc: 'Connect a YouTube browser session', insert: '/login' },
-  { name: '/ytstatus', usage: '/ytstatus', desc: 'Show YouTube authentication status', insert: '/ytstatus' },
-  { name: '/exit', usage: '/exit', desc: 'Archive the session and quit', insert: '/exit' },
-]);
-
-export const COMMAND_NAMES = Object.freeze(COMMAND_DEFINITIONS.map(command => command.name));
-
-export const SUB_COMMANDS = Object.freeze({
-  '/help': ['find', 'provider', 'model', 'session', 'details', 'copy', 'mcp', 'mem', 'research', 'verify', 'suggestion', 'skill', 'theme', 'update', 'quiz', 'key', 'play', 'doctor'],
-  '/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>', 'status', 'last'],
-  '/research': ['<question>', 'status', 'last', 'sources', 'cancel'],
-  '/verify': ['<claim>'],
-  '/sources': ['show'],
-  '/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'],
-  '/stats': ['overview'],
-  '/provider': [
-    'list',
-    'status',
-    'models',
-    'models groq',
-    'models openrouter',
-    'models openai',
-    'models gemini',
-    'models deepseek',
-    'models lmstudio',
-    'use groq',
-    'use openrouter',
-    'use openai',
-    'use gemini',
-    'use deepseek',
-    'use lmstudio',
-    'use custom',
-    'setkey <key>',
-    'setkey groq <key>',
-    'setkey openrouter <key>',
-    'setkey openai <key>',
-    'setkey gemini <key>',
-    'setkey deepseek <key>',
-    'info',
-    'info groq',
-    'info openrouter',
-    'info openai',
-    'info gemini',
-    'info deepseek',
-    'info lmstudio',
-    'test',
-    'test groq',
-    'test openrouter',
-    'test openai',
-    'test gemini',
-    'test deepseek',
-    'test lmstudio'
-  ],
-  '/model': ['status', 'list', 'recommend', 'use <model-id>', 'reconnect'],
-  '/mcp': ['status', 'list', 'tools', 'connect <name> <url>', 'disconnect <name>', 'remove <name>', 'reconnect [all]', 'save', 'reload'],
-  '/ping': ['status'],
-  '/config': ['status'],
-  '/doctor': ['check'],
-  '/prompt': ['show'],
-  '/version': ['show'],
-  '/update': ['check', 'install', 'install next', 'install canary', 'channel', 'channel latest', 'channel next', 'channel canary', 'rollback', 'help'],
-  '/system': ['info'],
-  '/gpu': ['status'],
-  '/about': ['info'],
-  '/ads': ['next'],
-  '/gallery': ['show'],
-  '/retry': ['again'],
-  '/cancel': ['stop'],
-  '/clear': ['now'],
-  '/save': ['markdown'],
-  '/lang': ['th', 'zh', 'en', 'auto'],
-  '/theme': ['next', 'prev', 'list', 'current', 'sakura', 'midnight', 'ocean', 'forest', 'sunset', 'monochrome', 'reset'],
-  '/thinking': ['show', 'hide', 'toggle'],
-  '/details': ['latest', 'overview', 'answer', 'thinking', 'tools', 'tool <n>', 'all', 'markdown', 'Q1 overview', 'Q1 tool 1'],
-  '/copy': ['session', 'session markdown', 'session json', 'session text', 'answer', 'thinking', 'tools', 'tool 1', 'overview', 'all', 'markdown', 'json', 'Q1 answer', 'Q1 thinking', 'Q1 tools', 'Q1 all', 'Q1 json'],
-  '/session': ['info', 'summary', 'list', 'load <id>', 'export', 'export markdown', 'export json', 'export text', 'copy', 'clear'],
-  '/history': ['10', '20', '50', 'search <query>', 'summary', 'clear'],
-  '/play': ['<song name>', 'In Blossom OST', 'Rain Love', 'Ginkgo', '恋爱告急', '叹云兮'],
-  '/stop': ['now'],
-  '/pause': ['now'],
-  '/resume': ['now'],
-  '/next': ['track'],
-  '/prev': ['track'],
-  '/mute': ['now'],
-  '/unmute': ['now'],
-  '/add': ['<song name>', 'In Blossom OST', 'Rain Love', 'Ginkgo'],
-  '/remove': ['1', '2', '3'],
-  '/clearqueue': ['now'],
-  '/search': ['<query>', 'Ju Jingyi OST', 'Ju Jingyi MV', '鞠婧祎'],
-  '/current': ['status'],
-  '/queue': ['clear'],
-  '/login': ['browser'],
-  '/ytstatus': ['check'],
-  '/exit': ['quit'],
-});
-
-export const COMMAND_DETAILS = Object.freeze({
-  '/help': {
-    summary: 'Display comprehensive help guide, shortcuts, or in-depth documentation for any command',
-    usage: '/help [command]',
-    subcommands: [
-      { cmd: '[command]', desc: 'Show detailed parameter specs, subcommands, and examples for a specific command', example: '/help provider' },
-      { cmd: 'all', desc: 'Display complete indexed list of all 60+ commands', example: '/help' },
-    ],
-    examples: ['/help', '/help provider', '/help session', '/help research', '/help copy'],
-  },
-  '/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]',
-    subcommands: [
-      { cmd: 'list', desc: 'Display generated research suggestions and categories (default)', example: '/suggestion list' },
-      { cmd: 'run <id|ids|all>', desc: 'Dispatch concurrent subagent workers to research the selected questions in parallel', example: '/suggestion run 1,2,3' },
-      { cmd: 'auto', desc: 'Auto-generate fresh research topics and immediately dispatch parallel subagents', example: '/suggestion auto' },
-      { cmd: 'topic <name>', desc: 'Generate research questions tailored to a specific topic (drama, music, brand, awards, 2026)', example: '/suggestion topic drama' },
-      { cmd: 'refresh', desc: 'Re-roll and generate a fresh batch of 5 suggestion topics', example: '/suggestion refresh' },
-    ],
-    examples: [
-      '/suggestion',
-      '/suggestion run 1',
-      '/suggestion run 1,2,3',
-      '/suggestion run all',
-      '/suggestion auto',
-      '/suggestion topic 2026',
-    ],
-  },
-  '/mcp': {
-    summary: 'Manage persistent Model Context Protocol (MCP) server connections and external tools',
-    usage: '/mcp [status | list | connect <name> <url|stdio> | disconnect <name> | remove <name> | reconnect [all] | save [workspace|global] | reload | tools]',
-    subcommands: [
-      { cmd: 'status / list', desc: 'Display active live MCP servers, saved offline configurations, and registered tool counts', example: '/mcp status' },
-      { cmd: 'connect <name> <url|cmd>', desc: 'Connect and permanently save an MCP server config (auto-reconnects on startup)', example: '/mcp connect kiku https://jujingyi-kikuuu.vercel.app/mcp' },
-      { cmd: 'save [workspace|global]', desc: 'Explicitly save all MCP configurations to workspace (.mcp.json) or global storage', example: '/mcp save workspace' },
-      { cmd: 'reload / reconnect [name|all]', desc: 'Reload and reconnect all configured MCP servers from disk', example: '/mcp reconnect all' },
-      { cmd: 'disconnect <name>', desc: 'Disconnect the active live session while keeping the configuration saved for later', example: '/mcp disconnect kiku' },
-      { cmd: 'remove <name>', desc: 'Permanently remove the server from saved configuration and disconnect', example: '/mcp remove kiku' },
-      { cmd: 'tools', desc: 'Inspect all registered MCP tools, parameters, and input schemas', example: '/mcp tools' },
-    ],
-    examples: [
-      '/mcp status',
-      '/mcp connect kiku https://jujingyi-kikuuu.vercel.app/mcp',
-      '/mcp connect local stdio node ./server/mcp/stdio.js',
-      '/mcp tools',
-      '/mcp save workspace',
-      '/mcp reconnect all',
-    ],
-  },
-  '/provider': {
-    summary: 'Manage AI model providers (OpenAI, Gemini, Groq, DeepSeek, OpenRouter, LM Studio) and persist API keys',
-    usage: '/provider [list | status | use <name> [model] | models [name] | setkey [provider] <key> | info [name] | test [name]]',
-    subcommands: [
-      { cmd: 'list', desc: 'List all supported providers, availability, and active status', example: '/provider list' },
-      { cmd: 'status', desc: 'Show detailed connection metrics, latency, and credentials for active provider', example: '/provider status' },
-      { cmd: 'use <name> [model]', desc: 'Switch active AI provider and optionally specify initial model', example: '/provider use groq' },
-      { cmd: 'models [name]', desc: 'Fetch live model catalog from the specified or active provider API', example: '/provider models groq' },
-      { cmd: 'setkey <key>', desc: 'Configure and persist API key for the active provider', example: '/provider setkey gsk_...' },
-      { cmd: 'setkey groq <key>', desc: 'Configure and persist API key specifically for Groq Cloud', example: '/provider setkey groq gsk_...' },
-      { cmd: 'setkey openrouter <key>', desc: 'Configure and persist API key specifically for OpenRouter', example: '/provider setkey openrouter sk-or-v1-...' },
-      { cmd: 'setkey openai <key>', desc: 'Configure and persist API key specifically for OpenAI', example: '/provider setkey openai sk-...' },
-      { cmd: 'setkey gemini <key>', desc: 'Configure and persist API key specifically for Google Gemini', example: '/provider setkey gemini AIzaSy...' },
-      { cmd: 'setkey deepseek <key>', desc: 'Configure and persist API key specifically for DeepSeek', example: '/provider setkey deepseek sk-...' },
-      { cmd: 'test [name]', desc: 'Perform a lightweight ping/test call to verify provider responsiveness', example: '/provider test groq' },
-      { cmd: 'info [name]', desc: 'Show pricing, context window, token limits, and documentation for a provider', example: '/provider info groq' },
-    ],
-    examples: [
-      '/provider list',
-      '/provider setkey groq gsk_...',
-      '/provider setkey openrouter sk-or-v1-...',
-      '/provider use groq',
-      '/provider test groq',
-      '/provider models',
-    ],
-  },
-  '/key': {
-    summary: 'Manage your Developer VIP API Key (earned via /quiz or custom seed)',
-    usage: '/key [show | apply <key> | clear]',
-    subcommands: [
-      { cmd: 'show', desc: 'Display active Developer VIP key, rate limit tiers, and usage format', example: '/key show' },
-      { cmd: 'apply <key>', desc: 'Save and activate a Developer VIP API key for higher rate limits', example: '/key apply kiku_vip_sk_...' },
-      { cmd: 'clear', desc: 'Remove stored Developer VIP key from local preferences', example: '/key clear' },
-    ],
-    examples: [
-      '/key show',
-      '/key apply kiku_vip_sk_test123',
-      '/key clear',
-    ],
-  },
-  '/model': {
-    summary: 'Inspect, recommend, or switch active AI model',
-    usage: '/model [status | list | recommend | use <model-id> | reconnect]',
-    subcommands: [
-      { cmd: 'status', desc: 'Display active model name, provider, latency, and context configuration', example: '/model status' },
-      { cmd: 'list', desc: 'List models reported by the active provider or local LM Studio instance', example: '/model list' },
-      { cmd: 'use <model-id>', desc: 'Switch active model immediately without restarting the agent', example: '/model use google/gemma-4-e4b' },
-      { cmd: 'recommend', desc: 'Show curated model recommendations optimized for Ju Jingyi knowledge tasks', example: '/model recommend' },
-      { cmd: 'reconnect', desc: 'Reconnect to the local or cloud model server and verify availability', example: '/model reconnect' },
-    ],
-    examples: [
-      '/model status',
-      '/model list',
-      '/model recommend',
-      '/model use gemma-4-e4b',
-      '/model reconnect',
-    ],
-  },
-  '/research': {
-    summary: 'Run coordinated multi-source Ju Jingyi research (3 parallel subagents: catalog, web, verifier)',
-    usage: '/research <question | status | last | sources | cancel>',
-    subcommands: [
-      { cmd: '<question>', desc: 'Launch multi-worker deep research across local database and web sources', example: '/research ผลงานซีรีส์ปี 2026 ของจวีจิ้งอี' },
-      { cmd: 'status', desc: 'Check status of running background research workers', example: '/research status' },
-      { cmd: 'last', desc: 'Display synthesized findings from the latest research job', example: '/research last' },
-      { cmd: 'sources', desc: 'List all validated URLs and citations collected during research', example: '/research sources' },
-      { cmd: 'cancel', desc: 'Cancel the currently active research job', example: '/research cancel' },
-    ],
-    examples: [
-      '/research What are Ju Jingyi\'s 2026 drama projects?',
-      '/research status',
-      '/research sources',
-    ],
-  },
-  '/verify': {
-    summary: 'Verify a Ju Jingyi claim or rumor with independent workers across official catalog & web sources',
-    usage: '/verify <claim about Ju Jingyi>',
-    subcommands: [
-      { cmd: '<claim>', desc: 'Run multi-worker verification to produce a strict verdict (VERIFIED, UNVERIFIED, CONFLICTING, FALSE)', example: '/verify จวีจิ้งอีเป็น Brand Ambassador ของ Versace ในปี 2026' },
-    ],
-    examples: [
-      '/verify จวีจิ้งอีชนะเลือกตั้ง SNH48 สองสมัยซ้อน',
-      '/verify Ju Jingyi will star in a new 2026 historical drama',
-    ],
-  },
-  '/sources': {
-    summary: 'Display full citation list, verified URLs, and media links from the most recent research job',
-    usage: '/sources',
-    subcommands: [
-      { cmd: '', desc: 'Show all citations, reference domains, and validated external sources from the latest research', example: '/sources' },
-    ],
-    examples: ['/sources'],
-  },
-  '/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',
-    ],
-  },
-  '/subagent': {
-    summary: 'Spawn an isolated iterative research subagent to investigate a specific task or subtopic',
-    usage: '/subagent <task | status | last>',
-    subcommands: [
-      { cmd: '<task>', desc: 'Dispatch dedicated bounded subagent with iterative tool execution', example: '/subagent Search all OST songs sung by Ju Jingyi in 2024-2026' },
-      { cmd: 'status / last', desc: 'Inspect tool calls and synthesized evidence from the previous subagent', example: '/subagent status' },
-    ],
-    examples: [
-      '/subagent Explore Versace brand ambassadorship milestones',
-      '/subagent status',
-    ],
-  },
-  '/mem': {
-    summary: 'Manage long-term semantic memory and persistent facts',
-    usage: '/mem [list | add <fact> | search <query> | topics | del <id> | import <path> | export | clear]',
-    subcommands: [
-      { cmd: 'list', desc: 'View all stored long-term memory facts', example: '/mem list' },
-      { cmd: 'add <fact>', desc: 'Store a verified fact directly into persistent memory', example: '/mem add จวีจิ้งอีเกิดวันที่ 18 มิถุนายน 1994' },
-      { cmd: 'search <query>', desc: 'Search stored memory facts using relevance ranking', example: '/mem search Versace' },
-      { cmd: 'topics', desc: 'View list of categorized memory topics', example: '/mem topics' },
-      { cmd: 'del <id>', desc: 'Delete a specific memory entry by ID', example: '/mem del m_123' },
-      { cmd: 'export', desc: 'Export memory facts to JSON file', example: '/mem export' },
-      { cmd: 'import <path>', desc: 'Import memory facts from a JSON file', example: '/mem import ./facts.json' },
-      { cmd: 'clear', desc: 'Wipe all long-term memory facts', example: '/mem clear' },
-    ],
-    examples: [
-      '/mem list',
-      '/mem add ผู้ใช้ชื่นชอบซีรีส์ In Blossom เป็นพิเศษ',
-      '/mem search In Blossom',
-    ],
-  },
-  '/skill': {
-    summary: 'Teach Kiku custom persona rules and response preferences',
-    usage: '/skill [learn <instruction> | list | on | off | del <id> | clear]',
-    subcommands: [
-      { cmd: 'learn <instruction>', desc: 'Teach Kiku how to format responses or adapt tone', example: '/skill learn ตอบภาษาไทยแบบสุภาพและกระชับเสมอ' },
-      { cmd: 'list', desc: 'List all active learned skills and their IDs', example: '/skill list' },
-      { cmd: 'on / off', desc: 'Enable or disable learned skills globally', example: '/skill off' },
-      { cmd: 'del <id>', desc: 'Remove a specific learned skill by ID', example: '/skill del s_123' },
-      { cmd: 'clear', desc: 'Delete all custom learned skills', example: '/skill clear' },
-    ],
-    examples: [
-      '/skill learn ตอบภาษาไทยและลงท้ายด้วยค่ะเสมอ',
-      '/skill list',
-    ],
-  },
-  '/details': {
-    summary: 'Inspect deep diagnostics, tool timeline, and token metrics for queries',
-    usage: '/details [Qn] [overview | answer | thinking | tools | tool <n> | all | markdown]',
-    subcommands: [
-      { cmd: 'overview / [Qn]', desc: 'View summary of duration, iterations, token counts, and tool timeline (Press F2 for latest)', example: '/details Q1' },
-      { cmd: 'answer', desc: 'View the complete untruncated final answer', example: '/details answer' },
-      { cmd: 'thinking', desc: 'Inspect raw chain-of-thought and model reasoning', example: '/details thinking' },
-      { cmd: 'tools', desc: 'List all tool calls executed during query processing', example: '/details tools' },
-      { cmd: 'tool <n>', desc: 'Inspect exact arguments and raw return payload for tool call N', example: '/details tool 1' },
-      { cmd: 'all / markdown', desc: 'View full formatted Markdown transcript of the query', example: '/details all' },
-    ],
-    examples: [
-      '/details',
-      '/details Q1 overview',
-      '/details Q1 tool 1',
-      '/details all',
-    ],
-  },
-  '/copy': {
-    summary: 'Copy complete conversation session, model answer, thinking trace, tools, or markdown to system clipboard',
-    usage: '/copy [session [markdown|json|text] | [Qn] [answer|thinking|tools|tool <n>|all|markdown|json]]',
-    subcommands: [
-      { cmd: 'session [format]', desc: 'Copy entire conversation transcript (markdown, json, or text) to clipboard', example: '/copy session' },
-      { cmd: '[Qn] [answer]', desc: 'Copy complete untruncated model answer to system clipboard (default)', example: '/copy' },
-      { cmd: 'thinking', desc: 'Copy raw chain-of-thought and model reasoning', example: '/copy thinking' },
-      { cmd: 'tools', desc: 'Copy JSON tool executions and arguments', example: '/copy tools' },
-      { cmd: 'tool <n>', desc: 'Copy raw JSON result of specific tool call N', example: '/copy tool 1' },
-      { cmd: 'all / markdown', desc: 'Copy entire Q&A transcript in clean Markdown format', example: '/copy all' },
-      { cmd: 'json', desc: 'Copy question diagnostics as JSON', example: '/copy json' },
-      { cmd: 'overview', desc: 'Copy diagnostic overview and metadata', example: '/copy overview' },
-    ],
-    examples: [
-      '/copy',
-      '/copy session',
-      '/copy session json',
-      '/copy thinking',
-      '/copy Q2 answer',
-      '/copy tool 1',
-      '/copy all',
-    ],
-  },
-  '/theme': {
-    summary: 'View or switch the terminal color theme dynamically',
-    usage: '/theme [sakura | midnight | ocean | forest | sunset | monochrome | next | prev | list | current | reset]',
-    subcommands: [
-      { cmd: 'next', desc: 'Rotate to the next available theme palette', example: '/theme next' },
-      { cmd: 'prev', desc: 'Rotate to the previous available theme palette', example: '/theme prev' },
-      { cmd: 'list', desc: 'Preview all available color theme palettes and descriptions', example: '/theme list' },
-      { cmd: 'current', desc: 'Show currently active theme and color samples', example: '/theme current' },
-      { cmd: '<name>', desc: 'Switch theme instantly (sakura, midnight, ocean, forest, sunset, monochrome)', example: '/theme midnight' },
-      { cmd: 'reset', desc: 'Reset to default theme (sakura)', example: '/theme reset' },
-    ],
-    examples: [
-      '/theme list',
-      '/theme midnight',
-      '/theme ocean',
-      '/theme monochrome',
-    ],
-  },
-  '/update': {
-    summary: 'Check, install, configure, or roll back npm package releases for kiku-agent',
-    usage: '/update [check | install [target] | channel [name] | rollback | help]',
-    subcommands: [
-      { cmd: 'check', desc: 'Check npm registry for newer versions across release channels', example: '/update check' },
-      { cmd: 'install [target]', desc: 'Install latest version or specific tag (next, canary, exact version)', example: '/update install' },
-      { cmd: 'channel [name]', desc: 'Switch release channel (latest, next, canary)', example: '/update channel next' },
-      { cmd: 'rollback', desc: 'Revert to the previously installed package version', example: '/update rollback' },
-    ],
-    examples: [
-      '/update check',
-      '/update install',
-      '/update channel next',
-      '/update rollback',
-    ],
-  },
-  '/session': {
-    summary: 'Manage, export, copy, restore, or summarize conversation sessions and history snapshots',
-    usage: '/session [info | summary | list | load <id> | export [format] | copy [format] | clear]',
-    subcommands: [
-      { cmd: 'info', desc: 'Display session ID, active duration, message count, tool breakdown, 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: 'load <id>', desc: 'Restore and resume an archived session by ID or list number', example: '/session load 1' },
-      { cmd: 'export [format]', desc: 'Export full conversation session history to Markdown (.md), JSON (.json), or Text (.txt)', example: '/session export markdown' },
-      { cmd: 'copy [format]', desc: 'Copy entire active session transcript directly to system clipboard', example: '/session copy' },
-      { cmd: 'clear', desc: 'Archive current conversation session and reset history', example: '/session clear' },
-    ],
-    examples: [
-      '/session info',
-      '/session summary',
-      '/session export markdown',
-      '/session export json',
-      '/session copy',
-      '/session list',
-      '/session load 1',
-      '/session clear',
-    ],
-  },
-  '/history': {
-    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',
-    ],
-  },
-  '/thinking': {
-    summary: 'Control reasoning and chain-of-thought visibility during generation',
-    usage: '/thinking [show | hide | toggle]',
-    subcommands: [
-      { cmd: 'show', desc: 'Display live model reasoning process in real time', example: '/thinking show' },
-      { cmd: 'hide', desc: 'Hide thinking process and display only final answers', example: '/thinking hide' },
-      { cmd: 'toggle', desc: 'Toggle thinking display mode on/off', example: '/thinking toggle' },
-    ],
-    examples: [
-      '/thinking show',
-      '/thinking hide',
-      '/thinking toggle',
-    ],
-  },
-  '/lang': {
-    summary: 'Set response language for AI synthesis',
-    usage: '/lang [th | zh | en | auto]',
-    subcommands: [
-      { cmd: 'th', desc: 'Set response language to Thai (ค่ะ/นะคะ)', example: '/lang th' },
-      { cmd: 'zh', desc: 'Set response language to Chinese (中文)', example: '/lang zh' },
-      { cmd: 'en', desc: 'Set response language to English', example: '/lang en' },
-      { cmd: 'auto', desc: 'Auto-detect response language from user input (default)', example: '/lang auto' },
-    ],
-    examples: [
-      '/lang th',
-      '/lang zh',
-      '/lang auto',
-    ],
-  },
-  '/queue': {
-    summary: 'Inspect or clear music playback audio queue',
-    usage: '/queue [clear]',
-    subcommands: [
-      { cmd: '', desc: 'Show currently queued music tracks and playback state', example: '/queue' },
-      { cmd: 'clear', desc: 'Wipe all pending tracks from the music queue', example: '/queue clear' },
-    ],
-    examples: [
-      '/queue',
-      '/queue clear',
-    ],
-  },
-  '/gpu': {
-    summary: 'Show GPU & VRAM hardware resource metrics',
-    usage: '/gpu [status]',
-    subcommands: [
-      { cmd: 'status', desc: 'Show real-time NVIDIA/Metal GPU compute utilization and VRAM memory usage', example: '/gpu' },
-    ],
-    examples: [
-      '/gpu',
-    ],
-  },
-  '/tools': {
-    summary: 'List registered SSOT knowledge and external tools',
-    usage: '/tools [filter]',
-    subcommands: [
-      { cmd: '[filter]', desc: 'List all registered tools or filter by keyword', example: '/tools drama' },
-    ],
-    examples: [
-      '/tools',
-      '/tools search',
-      '/tools mcp',
-    ],
-  },
-  '/cancel': {
-    summary: 'Abort the currently running query, tool, or subagent task',
-    usage: '/cancel',
-    subcommands: [
-      { cmd: '', desc: 'Instantly cancel running model generation, tool execution, or research subagents', example: '/cancel' },
-    ],
-    examples: [
-      '/cancel',
-    ],
-  },
-  '/tool': {
-    summary: 'Execute a registered SSOT tool directly with arguments',
-    usage: '/tool <name> [json_args | raw_query]',
-    subcommands: [
-      { cmd: '<name> [args]', desc: 'Call tool directly without model synthesis', example: '/tool search_works {"year":2026}' },
-    ],
-    examples: [
-      '/tool get_profile_and_fandom',
-      '/tool search_works In Blossom',
-      '/tool search_discography {"category":"ost"}',
-    ],
-  },
-  '/play': {
-    summary: 'Stream YouTube audio for Ju Jingyi songs and OSTs',
-    usage: '/play <song_name_or_url>',
-    subcommands: [
-      { cmd: '<song>', desc: 'Search and play song on YouTube in the background', example: '/play 恋爱告急' },
-    ],
-    examples: [
-      '/play In Blossom OST',
-      '/play 恋爱告急',
-    ],
-  },
-  '/stats': {
-    summary: 'Show comprehensive content metrics, database records, and catalog statistics',
-    usage: '/stats',
-    subcommands: [
-      { cmd: '', desc: 'Display total counts for dramas, discography, brands, awards, and gallery photos', example: '/stats' },
-    ],
-    examples: ['/stats'],
-  },
-  '/ping': {
-    summary: 'Measure live network latency and responsiveness to active LLM inference server',
-    usage: '/ping',
-    subcommands: [
-      { cmd: '', desc: 'Send ping request to active AI model endpoint and report round-trip latency in ms', example: '/ping' },
-    ],
-    examples: ['/ping'],
-  },
-  '/config': {
-    summary: 'Display current runtime configuration, active provider, paths, and environment settings',
-    usage: '/config',
-    subcommands: [
-      { cmd: '', desc: 'Inspect active LLM provider, base URL, model name, storage directories, and MCP status', example: '/config' },
-    ],
-    examples: ['/config'],
-  },
-  '/doctor': {
-    summary: 'Run environment diagnostics, dependency verification, and feature health check',
-    usage: '/doctor',
-    subcommands: [
-      { cmd: '', desc: 'Check Node version, LM Studio server, yt-dlp, ffmpeg, MCP server, and disk permissions', example: '/doctor' },
-    ],
-    examples: ['/doctor'],
-  },
-  '/prompt': {
-    summary: 'Preview the full system prompt and active persona instructions sent to the AI',
-    usage: '/prompt',
-    subcommands: [
-      { cmd: '', desc: 'Inspect the system persona, memory context, and domain rules passed to the LLM', example: '/prompt' },
-    ],
-    examples: ['/prompt'],
-  },
-  '/version': {
-    summary: 'Display installed Kiku Agent release version, build channel, and package metadata',
-    usage: '/version',
-    subcommands: [
-      { cmd: '', desc: 'Show semantic version, git commit, Node runtime version, and release channel', example: '/version' },
-    ],
-    examples: ['/version'],
-  },
-  '/system': {
-    summary: 'Display host operating system, CPU architecture, memory usage, and Node process stats',
-    usage: '/system',
-    subcommands: [
-      { cmd: '', desc: 'Show platform OS, total RAM, heap memory allocation, process uptime, and architecture', example: '/system' },
-    ],
-    examples: ['/system'],
-  },
-  '/about': {
-    summary: 'Display background information, credits, architecture overview, and project links',
-    usage: '/about',
-    subcommands: [
-      { cmd: '', desc: 'Show project mission, tech stack overview, creator credits, and documentation links', example: '/about' },
-    ],
-    examples: ['/about'],
-  },
-  '/ads': {
-    summary: 'Display community sponsor card and featured ecosystem highlights',
-    usage: '/ads',
-    subcommands: [
-      { cmd: '', desc: 'Cycle and display the next sponsor spotlight card in the terminal', example: '/ads' },
-    ],
-    examples: ['/ads'],
-  },
-  '/gallery': {
-    summary: 'Render full-color terminal graphic portraits of Ju Jingyi from the asset gallery',
-    usage: '/gallery',
-    subcommands: [
-      { cmd: '', desc: 'Display a high-resolution downsampled ANSI image portrait in the terminal', example: '/gallery' },
-    ],
-    examples: ['/gallery'],
-  },
-  '/retry': {
-    summary: 'Re-execute the previous query with identical prompt parameters',
-    usage: '/retry',
-    subcommands: [
-      { cmd: '', desc: 'Resend the previous question to the active model for a fresh response', example: '/retry' },
-    ],
-    examples: ['/retry'],
-  },
-  '/clear': {
-    summary: 'Archive active conversation session and reset terminal screen buffer',
-    usage: '/clear',
-    subcommands: [
-      { cmd: '', desc: 'Archive current session to disk, reset message history, and clear viewport', example: '/clear' },
-    ],
-    examples: ['/clear'],
-  },
-  '/save': {
-    summary: 'Export the full active conversation transcript to a formatted Markdown file',
-    usage: '/save',
-    subcommands: [
-      { cmd: '', desc: 'Write complete conversation history, reasoning, and tools to an exported Markdown file', example: '/save' },
-    ],
-    examples: ['/save'],
-  },
-  '/stop': {
-    summary: 'Stop active background audio stream and clear playback process',
-    usage: '/stop',
-    subcommands: [
-      { cmd: '', desc: 'Immediately terminate music audio playback stream', example: '/stop' },
-    ],
-    examples: ['/stop'],
-  },
-  '/pause': {
-    summary: 'Pause active YouTube music playback stream',
-    usage: '/pause',
-    subcommands: [
-      { cmd: '', desc: 'Pause current audio stream without losing playback position', example: '/pause' },
-    ],
-    examples: ['/pause'],
-  },
-  '/resume': {
-    summary: 'Resume paused YouTube audio playback',
-    usage: '/resume',
-    subcommands: [
-      { cmd: '', desc: 'Continue playing paused audio stream from current position', example: '/resume' },
-    ],
-    examples: ['/resume'],
-  },
-  '/next': {
-    summary: 'Skip to the next song in the music playback queue',
-    usage: '/next',
-    subcommands: [
-      { cmd: '', desc: 'Skip current audio track and begin playing next queued track', example: '/next' },
-    ],
-    examples: ['/next'],
-  },
-  '/prev': {
-    summary: 'Return to and replay the previous song in the music queue',
-    usage: '/prev',
-    subcommands: [
-      { cmd: '', desc: 'Jump back to the previous track in playback history', example: '/prev' },
-    ],
-    examples: ['/prev'],
-  },
-  '/mute': {
-    summary: 'Mute music audio playback output',
-    usage: '/mute',
-    subcommands: [
-      { cmd: '', desc: 'Silence audio output while keeping playback stream active', example: '/mute' },
-    ],
-    examples: ['/mute'],
-  },
-  '/unmute': {
-    summary: 'Restore music audio playback volume output',
-    usage: '/unmute',
-    subcommands: [
-      { cmd: '', desc: 'Restore audio volume output to audible level', example: '/unmute' },
-    ],
-    examples: ['/unmute'],
-  },
-  '/add': {
-    summary: 'Add a YouTube music track or OST song to the playback queue',
-    usage: '/add <song_name_or_url>',
-    subcommands: [
-      { cmd: '<song>', desc: 'Search YouTube and enqueue song for playback', example: '/add 恋爱告急' },
-    ],
-    examples: ['/add In Blossom OST', '/add 恋爱告急'],
-  },
-  '/remove': {
-    summary: 'Remove a specific track index from the music playback queue',
-    usage: '/remove <index>',
-    subcommands: [
-      { cmd: '<index>', desc: 'Remove track by its position number in /queue', example: '/remove 2' },
-    ],
-    examples: ['/remove 1', '/remove 3'],
-  },
-  '/clearqueue': {
-    summary: 'Clear all pending tracks from the music playback queue',
-    usage: '/clearqueue',
-    subcommands: [
-      { cmd: '', desc: 'Empty all queued songs while maintaining current track', example: '/clearqueue' },
-    ],
-    examples: ['/clearqueue'],
-  },
-  '/search': {
-    summary: 'Search YouTube video and audio tracks for Ju Jingyi songs',
-    usage: '/search <query>',
-    subcommands: [
-      { cmd: '<query>', desc: 'Search YouTube for tracks and display title, duration, and direct links', example: '/search In Blossom OST' },
-    ],
-    examples: ['/search 鞠婧祎', '/search In Blossom OST'],
-  },
-  '/current': {
-    summary: 'Show metadata, duration, and status for the currently playing audio track',
-    usage: '/current',
-    subcommands: [
-      { cmd: '', desc: 'Display track title, elapsed playback duration, buffer state, and YouTube link', example: '/current' },
-    ],
-    examples: ['/current'],
-  },
-  '/login': {
-    summary: 'Authenticate YouTube session in the browser to enable age-gated music playback',
-    usage: '/login',
-    subcommands: [
-      { cmd: '', desc: 'Open interactive browser session to save YouTube cookies for seamless streaming', example: '/login' },
-    ],
-    examples: ['/login'],
-  },
-  '/ytstatus': {
-    summary: 'Show YouTube authentication, cookie source, and streaming player status',
-    usage: '/ytstatus',
-    subcommands: [
-      { cmd: '', desc: 'Check cookie availability, browser profile connection, and playback backend health', example: '/ytstatus' },
-    ],
-    examples: ['/ytstatus'],
-  },
-  '/exit': {
-    summary: 'Archive active conversation session and exit Kiku Agent CLI',
-    usage: '/exit',
-    subcommands: [
-      { cmd: '', desc: 'Safely save active session state to disk and close terminal application', example: '/exit' },
-    ],
-    examples: ['/exit'],
-  },
-});
-
-export function findCommandDefinition(name) {
-  const normalized = name?.startsWith('/') ? name.toLowerCase() : `/${String(name || '').toLowerCase()}`;
-  return COMMAND_DEFINITIONS.find(command => command.name === normalized) || null;
-}
-
-export function getCommandDetails(name) {
-  if (!name) return null;
-  const normalized = name.startsWith('/') ? name.toLowerCase() : `/${String(name).toLowerCase()}`;
-  return COMMAND_DETAILS[normalized] || null;
-}
+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|summary|clear]', desc: 'View, search, or summarize chat history', insert: '/history ' },
+  { name: '/session', usage: '/session [info|summary|list|load <id>|export|clear]', desc: 'Manage, restore, or summarize conversation sessions', 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 [session|[Qn] [answer|thinking|tools|tool n|all|json]]', desc: 'Copy full session transcript, answer, thinking, or tools 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|next|prev|reset]', desc: 'View or change the terminal color theme', insert: '/theme ' },
+  { 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 ' },
+  { name: '/sources', usage: '/sources', desc: 'Show sources from the latest research job', insert: '/sources' },
+  { name: '/debate', usage: '/debate <claim|status|last>', desc: 'Run multi-agent adversarial debate & fact synthesis', insert: '/debate ' },
+  { name: '/timeline', usage: '/timeline [year|era]', desc: 'Render career milestone graphic timeline in terminal', insert: '/timeline ' },
+  { name: '/suggestion', usage: '/suggestion [list|run <id|all>|auto|refresh|topic <name>]', desc: 'Generate AI research suggestions & execute with concurrent subagents', insert: '/suggestion ' },
+  { 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]|setkey [provider] <key>|info <name>|test|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 ' },
+  { name: '/profile', usage: '/profile [list|use <name>|show <name>|save <name>|delete <name>]', desc: 'Manage configuration profiles (default, fast, deep-reasoning, cloud, gemini)', insert: '/profile ' },
+  { name: '/mcp', usage: '/mcp [status|list|connect <name> <url|cmd>|disconnect <name>|remove <name>|reconnect [all]|save|reload|tools]', desc: 'Manage persistent Model Context Protocol connections', insert: '/mcp ' },
+  { name: '/ping', usage: '/ping', desc: 'Check active model server latency', insert: '/ping' },
+  { name: '/config', usage: '/config', desc: 'Show runtime configuration', insert: '/config' },
+  { name: '/doctor', usage: '/doctor', desc: 'Check first-run environment and optional features', insert: '/doctor' },
+  { name: '/prompt', usage: '/prompt', desc: 'Preview the active system persona', insert: '/prompt' },
+  { name: '/version', usage: '/version', desc: 'Show Kiku Agent version information', insert: '/version' },
+  { 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' },
+  { name: '/save', usage: '/save [markdown|html|json|text]', desc: 'Export the transcript to file', insert: '/save ' },
+  { name: '/play', usage: '/play <song>', desc: 'Play music', insert: '/play ' },
+  { name: '/stop', usage: '/stop', desc: 'Stop music playback', insert: '/stop' },
+  { name: '/pause', usage: '/pause', desc: 'Pause music playback', insert: '/pause' },
+  { name: '/resume', usage: '/resume', desc: 'Resume music playback', insert: '/resume' },
+  { name: '/next', usage: '/next', desc: 'Play the next queued track', insert: '/next' },
+  { name: '/prev', usage: '/prev', desc: 'Return to the previous track', insert: '/prev' },
+  { name: '/mute', usage: '/mute', desc: 'Mute music playback', insert: '/mute' },
+  { name: '/unmute', usage: '/unmute', desc: 'Unmute music playback', insert: '/unmute' },
+  { name: '/add', usage: '/add <song>', desc: 'Add a song to the music queue', insert: '/add ' },
+  { name: '/remove', usage: '/remove <index>', desc: 'Remove a song from the music queue', insert: '/remove ' },
+  { name: '/clearqueue', usage: '/clearqueue', desc: 'Clear the music queue', insert: '/clearqueue' },
+  { name: '/search', usage: '/search <query>', desc: 'Search YouTube', insert: '/search ' },
+  { name: '/current', usage: '/current', desc: 'Show the current track', insert: '/current' },
+  { name: '/queue', usage: '/queue [clear]', desc: 'Show or clear the active queue', insert: '/queue ' },
+  { name: '/web', usage: '/web [start|open|stop|status|restart] [port]', desc: 'Start or open the standalone chatbot web app (port 3300)', insert: '/web ' },
+  { name: '/web-chat', usage: '/web-chat [start|open|stop|status|restart] [port]', desc: 'Start or open the standalone chatbot web app (port 3300)', insert: '/web-chat ' },
+  { name: '/login', usage: '/login', desc: 'Connect a YouTube browser session', insert: '/login' },
+  { name: '/ytstatus', usage: '/ytstatus', desc: 'Show YouTube authentication status', insert: '/ytstatus' },
+  { name: '/exit', usage: '/exit', desc: 'Archive the session and quit', insert: '/exit' },
+]);
+
+export const COMMAND_NAMES = Object.freeze(COMMAND_DEFINITIONS.map(command => command.name));
+
+export const COMMAND_CATEGORIES = Object.freeze([
+  {
+    id: 'conversation',
+    name: 'Conversation & Session',
+    icon: '◆',
+    commands: ['/help', '/web', '/web-chat', '/session', '/history', '/details', '/copy', '/thinking', '/clear', '/save', '/retry', '/cancel', '/exit'],
+  },
+  {
+    id: 'research',
+    name: 'Research & Intelligence',
+    icon: '✦',
+    commands: ['/research', '/subagent', '/verify', '/debate', '/suggestion', '/sources', '/jobs'],
+  },
+  {
+    id: 'catalog',
+    name: 'Catalog, News & Memory',
+    icon: '■',
+    commands: ['/find', '/compare', '/timeline', '/discover', '/favorites', '/news', '/stats', '/mem', '/skill'],
+  },
+  {
+    id: 'model',
+    name: 'AI Model & MCP Connectivity',
+    icon: '●',
+    commands: ['/provider', '/model', '/profile', '/mcp', '/ping', '/prompt', '/config'],
+  },
+  {
+    id: 'media',
+    name: 'Music & Gallery',
+    icon: '🎵',
+    commands: ['/play', '/stop', '/pause', '/resume', '/next', '/prev', '/queue', '/add', '/remove', '/clearqueue', '/search', '/current', '/mute', '/unmute', '/login', '/ytstatus', '/gallery'],
+  },
+  {
+    id: 'system',
+    name: 'System, Theme & Developer Tools',
+    icon: '◆',
+    commands: ['/doctor', '/system', '/gpu', '/version', '/theme', '/lang', '/quiz', '/key', '/about', '/tools', '/tool', '/ads'],
+  },
+]);
+
+export const SUB_COMMANDS = Object.freeze({
+  '/help': ['find', 'web', 'provider', 'model', 'session', 'details', 'copy', 'mcp', 'mem', 'research', 'verify', 'suggestion', 'skill', 'theme', 'quiz', 'key', 'play', 'doctor'],
+  '/web': ['start', 'open', 'status', 'stop', 'restart', '3001'],
+  '/web-chat': ['start', 'open', 'status', 'stop', 'restart', '3001'],
+  '/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>', 'status', 'last'],
+  '/research': ['<question>', 'status', 'last', 'sources', 'cancel'],
+  '/verify': ['<claim>'],
+  '/debate': ['<claim>', 'status', 'last', 'cancel'],
+  '/timeline': ['2026', '2024-2026', 'snh48', 'solo', 'studio', 'drama'],
+  '/sources': ['show'],
+  '/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'],
+  '/stats': ['overview'],
+  '/provider': [
+    'list',
+    'status',
+    'models',
+    'models groq',
+    'models openrouter',
+    'models openai',
+    'models gemini',
+    'models deepseek',
+    'models lmstudio',
+    'use groq',
+    'use openrouter',
+    'use openai',
+    'use gemini',
+    'use deepseek',
+    'use lmstudio',
+    'use custom',
+    'setkey <key>',
+    'setkey groq <key>',
+    'setkey openrouter <key>',
+    'setkey openai <key>',
+    'setkey gemini <key>',
+    'setkey deepseek <key>',
+    'info',
+    'info groq',
+    'info openrouter',
+    'info openai',
+    'info gemini',
+    'info deepseek',
+    'info lmstudio',
+    'test',
+    'test groq',
+    'test openrouter',
+    'test openai',
+    'test gemini',
+    'test deepseek',
+    'test lmstudio'
+  ],
+  '/model': ['status', 'list', 'recommend', 'use <model-id>', 'reconnect'],
+  '/profile': ['list', 'use default', 'use fast', 'use deep-reasoning', 'use cloud', 'use gemini', 'show default', 'save <name>', 'delete <name>'],
+  '/mcp': ['status', 'list', 'tools', 'connect <name> <url>', 'disconnect <name>', 'remove <name>', 'reconnect [all]', 'save', 'reload'],
+  '/ping': ['status'],
+  '/config': ['status'],
+  '/doctor': ['check'],
+  '/prompt': ['show'],
+  '/version': ['show'],
+  '/system': ['info'],
+  '/gpu': ['status'],
+  '/about': ['info'],
+  '/ads': ['next'],
+  '/gallery': ['show'],
+  '/retry': ['again'],
+  '/cancel': ['stop'],
+  '/clear': ['now'],
+  '/save': ['markdown'],
+  '/lang': ['th', 'zh', 'en', 'auto'],
+  '/theme': ['next', 'prev', 'list', 'current', 'sakura', 'midnight', 'ocean', 'forest', 'sunset', 'monochrome', 'reset'],
+  '/thinking': ['show', 'hide', 'toggle'],
+  '/details': ['latest', 'overview', 'answer', 'thinking', 'tools', 'tool <n>', 'all', 'markdown', 'Q1 overview', 'Q1 tool 1'],
+  '/copy': ['session', 'session markdown', 'session json', 'session text', 'answer', 'thinking', 'tools', 'tool 1', 'overview', 'all', 'markdown', 'json', 'Q1 answer', 'Q1 thinking', 'Q1 tools', 'Q1 all', 'Q1 json'],
+  '/session': ['info', 'summary', 'list', 'load <id>', 'export', 'export markdown', 'export json', 'export text', 'copy', 'clear'],
+  '/history': ['10', '20', '50', 'search <query>', 'summary', 'clear'],
+  '/play': ['<song name>', 'In Blossom OST', 'Rain Love', 'Ginkgo', '恋爱告急', '叹云兮'],
+  '/stop': ['now'],
+  '/pause': ['now'],
+  '/resume': ['now'],
+  '/next': ['track'],
+  '/prev': ['track'],
+  '/mute': ['now'],
+  '/unmute': ['now'],
+  '/add': ['<song name>', 'In Blossom OST', 'Rain Love', 'Ginkgo'],
+  '/remove': ['1', '2', '3'],
+  '/clearqueue': ['now'],
+  '/search': ['<query>', 'Ju Jingyi OST', 'Ju Jingyi MV', '鞠婧祎'],
+  '/current': ['status'],
+  '/queue': ['clear'],
+  '/login': ['browser'],
+  '/ytstatus': ['check'],
+  '/exit': ['quit'],
+});
+
+export const COMMAND_DETAILS = Object.freeze({
+  '/help': {
+    summary: 'Display comprehensive help guide, shortcuts, or in-depth documentation for any command',
+    usage: '/help [command]',
+    subcommands: [
+      { cmd: '[command]', desc: 'Show detailed parameter specs, subcommands, and examples for a specific command', example: '/help provider' },
+      { cmd: 'all', desc: 'Display complete indexed list of all 60+ commands', example: '/help' },
+    ],
+    examples: ['/help', '/help provider', '/help session', '/help research', '/help copy'],
+  },
+  '/web': {
+    summary: 'Launch or manage the dedicated standalone web chatbot on port 3300',
+    usage: '/web [start|open|stop|status|restart] [port]',
+    subcommands: [
+      { cmd: 'start [port]', desc: 'Start standalone web chatbot server (default port 3300) and open browser', example: '/web start' },
+      { cmd: 'open', desc: 'Open current web chatbot URL in default browser', example: '/web open' },
+      { cmd: 'status', desc: 'Check standalone web server running state and port', example: '/web status' },
+      { cmd: 'stop', desc: 'Stop the standalone web chatbot server', example: '/web stop' },
+      { cmd: 'restart', desc: 'Restart the standalone web chatbot server', example: '/web restart' },
+    ],
+    examples: ['/web', '/web open', '/web status', '/web stop'],
+  },
+  '/web-chat': {
+    summary: 'Launch or manage the dedicated standalone web chatbot on port 3300 (alias for /web)',
+    usage: '/web-chat [start|open|stop|status|restart] [port]',
+    subcommands: [
+      { cmd: 'start [port]', desc: 'Start standalone web chatbot server (default port 3300) and open browser', example: '/web-chat start' },
+      { cmd: 'open', desc: 'Open current web chatbot URL in default browser', example: '/web-chat open' },
+      { cmd: 'status', desc: 'Check standalone web server running state and port', example: '/web-chat status' },
+      { cmd: 'stop', desc: 'Stop the standalone web chatbot server', example: '/web-chat stop' },
+      { cmd: 'restart', desc: 'Restart the standalone web chatbot server', example: '/web-chat restart' },
+    ],
+    examples: ['/web-chat', '/web-chat open', '/web-chat status', '/web-chat stop'],
+  },
+  '/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]',
+    subcommands: [
+      { cmd: 'list', desc: 'Display generated research suggestions and categories (default)', example: '/suggestion list' },
+      { cmd: 'run <id|ids|all>', desc: 'Dispatch concurrent subagent workers to research the selected questions in parallel', example: '/suggestion run 1,2,3' },
+      { cmd: 'auto', desc: 'Auto-generate fresh research topics and immediately dispatch parallel subagents', example: '/suggestion auto' },
+      { cmd: 'topic <name>', desc: 'Generate research questions tailored to a specific topic (drama, music, brand, awards, 2026)', example: '/suggestion topic drama' },
+      { cmd: 'refresh', desc: 'Re-roll and generate a fresh batch of 5 suggestion topics', example: '/suggestion refresh' },
+    ],
+    examples: [
+      '/suggestion',
+      '/suggestion run 1',
+      '/suggestion run 1,2,3',
+      '/suggestion run all',
+      '/suggestion auto',
+      '/suggestion topic 2026',
+    ],
+  },
+  '/mcp': {
+    summary: 'Manage persistent Model Context Protocol (MCP) server connections and external tools',
+    usage: '/mcp [status | list | connect <name> <url|stdio> | disconnect <name> | remove <name> | reconnect [all] | save [workspace|global] | reload | tools]',
+    subcommands: [
+      { cmd: 'status / list', desc: 'Display active live MCP servers, saved offline configurations, and registered tool counts', example: '/mcp status' },
+      { cmd: 'connect <name> <url|cmd>', desc: 'Connect and permanently save an MCP server config (auto-reconnects on startup)', example: '/mcp connect kiku https://jujingyi-kikuuu.vercel.app/mcp' },
+      { cmd: 'save [workspace|global]', desc: 'Explicitly save all MCP configurations to workspace (.mcp.json) or global storage', example: '/mcp save workspace' },
+      { cmd: 'reload / reconnect [name|all]', desc: 'Reload and reconnect all configured MCP servers from disk', example: '/mcp reconnect all' },
+      { cmd: 'disconnect <name>', desc: 'Disconnect the active live session while keeping the configuration saved for later', example: '/mcp disconnect kiku' },
+      { cmd: 'remove <name>', desc: 'Permanently remove the server from saved configuration and disconnect', example: '/mcp remove kiku' },
+      { cmd: 'tools', desc: 'Inspect all registered MCP tools, parameters, and input schemas', example: '/mcp tools' },
+    ],
+    examples: [
+      '/mcp status',
+      '/mcp connect kiku https://jujingyi-kikuuu.vercel.app/mcp',
+      '/mcp connect local stdio node ./server/mcp/stdio.js',
+      '/mcp tools',
+      '/mcp save workspace',
+      '/mcp reconnect all',
+    ],
+  },
+  '/provider': {
+    summary: 'Manage AI model providers (OpenAI, Gemini, Groq, DeepSeek, OpenRouter, LM Studio) and persist API keys',
+    usage: '/provider [list | status | use <name> [model] | models [name] | setkey [provider] <key> | info [name] | test [name]]',
+    subcommands: [
+      { cmd: 'list', desc: 'List all supported providers, availability, and active status', example: '/provider list' },
+      { cmd: 'status', desc: 'Show detailed connection metrics, latency, and credentials for active provider', example: '/provider status' },
+      { cmd: 'use <name> [model]', desc: 'Switch active AI provider and optionally specify initial model', example: '/provider use groq' },
+      { cmd: 'models [name]', desc: 'Fetch live model catalog from the specified or active provider API', example: '/provider models groq' },
+      { cmd: 'setkey <key>', desc: 'Configure and persist API key for the active provider', example: '/provider setkey gsk_...' },
+      { cmd: 'setkey groq <key>', desc: 'Configure and persist API key specifically for Groq Cloud', example: '/provider setkey groq gsk_...' },
+      { cmd: 'setkey openrouter <key>', desc: 'Configure and persist API key specifically for OpenRouter', example: '/provider setkey openrouter sk-or-v1-...' },
+      { cmd: 'setkey openai <key>', desc: 'Configure and persist API key specifically for OpenAI', example: '/provider setkey openai sk-...' },
+      { cmd: 'setkey gemini <key>', desc: 'Configure and persist API key specifically for Google Gemini', example: '/provider setkey gemini AIzaSy...' },
+      { cmd: 'setkey deepseek <key>', desc: 'Configure and persist API key specifically for DeepSeek', example: '/provider setkey deepseek sk-...' },
+      { cmd: 'test [name]', desc: 'Perform a lightweight ping/test call to verify provider responsiveness', example: '/provider test groq' },
+      { cmd: 'info [name]', desc: 'Show pricing, context window, token limits, and documentation for a provider', example: '/provider info groq' },
+    ],
+    examples: [
+      '/provider list',
+      '/provider setkey groq gsk_...',
+      '/provider setkey openrouter sk-or-v1-...',
+      '/provider use groq',
+      '/provider test groq',
+      '/provider models',
+    ],
+  },
+  '/key': {
+    summary: 'Manage your Developer VIP API Key (earned via /quiz or custom seed)',
+    usage: '/key [show | apply <key> | clear]',
+    subcommands: [
+      { cmd: 'show', desc: 'Display active Developer VIP key, rate limit tiers, and usage format', example: '/key show' },
+      { cmd: 'apply <key>', desc: 'Save and activate a Developer VIP API key for higher rate limits', example: '/key apply kiku_vip_sk_...' },
+      { cmd: 'clear', desc: 'Remove stored Developer VIP key from local preferences', example: '/key clear' },
+    ],
+    examples: [
+      '/key show',
+      '/key apply kiku_vip_sk_test123',
+      '/key clear',
+    ],
+  },
+  '/model': {
+    summary: 'Inspect, recommend, or switch active AI model',
+    usage: '/model [status | list | recommend | use <model-id> | reconnect]',
+    subcommands: [
+      { cmd: 'status', desc: 'Display active model name, provider, latency, and context configuration', example: '/model status' },
+      { cmd: 'list', desc: 'List models reported by the active provider or local LM Studio instance', example: '/model list' },
+      { cmd: 'use <model-id>', desc: 'Switch active model immediately without restarting the agent', example: '/model use google/gemma-4-e4b' },
+      { cmd: 'recommend', desc: 'Show curated model recommendations optimized for Ju Jingyi knowledge tasks', example: '/model recommend' },
+      { cmd: 'reconnect', desc: 'Reconnect to the local or cloud model server and verify availability', example: '/model reconnect' },
+    ],
+    examples: [
+      '/model status',
+      '/model list',
+      '/model recommend',
+      '/model use gemma-4-e4b',
+      '/model reconnect',
+    ],
+  },
+  '/research': {
+    summary: 'Run coordinated multi-source Ju Jingyi research (3 parallel subagents: catalog, web, verifier)',
+    usage: '/research <question | status | last | sources | cancel>',
+    subcommands: [
+      { cmd: '<question>', desc: 'Launch multi-worker deep research across local database and web sources', example: '/research ผลงานซีรีส์ปี 2026 ของจวีจิ้งอี' },
+      { cmd: 'status', desc: 'Check status of running background research workers', example: '/research status' },
+      { cmd: 'last', desc: 'Display synthesized findings from the latest research job', example: '/research last' },
+      { cmd: 'sources', desc: 'List all validated URLs and citations collected during research', example: '/research sources' },
+      { cmd: 'cancel', desc: 'Cancel the currently active research job', example: '/research cancel' },
+    ],
+    examples: [
+      '/research What are Ju Jingyi\'s 2026 drama projects?',
+      '/research status',
+      '/research sources',
+    ],
+  },
+  '/verify': {
+    summary: 'Verify a Ju Jingyi claim or rumor with independent workers across official catalog & web sources',
+    usage: '/verify <claim about Ju Jingyi>',
+    subcommands: [
+      { cmd: '<claim>', desc: 'Run multi-worker verification to produce a strict verdict (VERIFIED, UNVERIFIED, CONFLICTING, FALSE)', example: '/verify จวีจิ้งอีเป็น Brand Ambassador ของ Versace ในปี 2026' },
+    ],
+    examples: [
+      '/verify จวีจิ้งอีชนะเลือกตั้ง SNH48 สองสมัยซ้อน',
+      '/verify Ju Jingyi will star in a new 2026 historical drama',
+    ],
+  },
+  '/sources': {
+    summary: 'Display full citation list, verified URLs, and media links from the most recent research job',
+    usage: '/sources',
+    subcommands: [
+      { cmd: '', desc: 'Show all citations, reference domains, and validated external sources from the latest research', example: '/sources' },
+    ],
+    examples: ['/sources'],
+  },
+  '/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',
+    ],
+  },
+  '/subagent': {
+    summary: 'Spawn an isolated iterative research subagent to investigate a specific task or subtopic',
+    usage: '/subagent <task | status | last>',
+    subcommands: [
+      { cmd: '<task>', desc: 'Dispatch dedicated bounded subagent with iterative tool execution', example: '/subagent Search all OST songs sung by Ju Jingyi in 2024-2026' },
+      { cmd: 'status / last', desc: 'Inspect tool calls and synthesized evidence from the previous subagent', example: '/subagent status' },
+    ],
+    examples: [
+      '/subagent Explore Versace brand ambassadorship milestones',
+      '/subagent status',
+    ],
+  },
+  '/mem': {
+    summary: 'Manage long-term semantic memory and persistent facts',
+    usage: '/mem [list | add <fact> | search <query> | topics | del <id> | import <path> | export | clear]',
+    subcommands: [
+      { cmd: 'list', desc: 'View all stored long-term memory facts', example: '/mem list' },
+      { cmd: 'add <fact>', desc: 'Store a verified fact directly into persistent memory', example: '/mem add จวีจิ้งอีเกิดวันที่ 18 มิถุนายน 1994' },
+      { cmd: 'search <query>', desc: 'Search stored memory facts using relevance ranking', example: '/mem search Versace' },
+      { cmd: 'topics', desc: 'View list of categorized memory topics', example: '/mem topics' },
+      { cmd: 'del <id>', desc: 'Delete a specific memory entry by ID', example: '/mem del m_123' },
+      { cmd: 'export', desc: 'Export memory facts to JSON file', example: '/mem export' },
+      { cmd: 'import <path>', desc: 'Import memory facts from a JSON file', example: '/mem import ./facts.json' },
+      { cmd: 'clear', desc: 'Wipe all long-term memory facts', example: '/mem clear' },
+    ],
+    examples: [
+      '/mem list',
+      '/mem add ผู้ใช้ชื่นชอบซีรีส์ In Blossom เป็นพิเศษ',
+      '/mem search In Blossom',
+    ],
+  },
+  '/skill': {
+    summary: 'Teach Kiku custom persona rules and response preferences',
+    usage: '/skill [learn <instruction> | list | on | off | del <id> | clear]',
+    subcommands: [
+      { cmd: 'learn <instruction>', desc: 'Teach Kiku how to format responses or adapt tone', example: '/skill learn ตอบภาษาไทยแบบสุภาพและกระชับเสมอ' },
+      { cmd: 'list', desc: 'List all active learned skills and their IDs', example: '/skill list' },
+      { cmd: 'on / off', desc: 'Enable or disable learned skills globally', example: '/skill off' },
+      { cmd: 'del <id>', desc: 'Remove a specific learned skill by ID', example: '/skill del s_123' },
+      { cmd: 'clear', desc: 'Delete all custom learned skills', example: '/skill clear' },
+    ],
+    examples: [
+      '/skill learn ตอบภาษาไทยและลงท้ายด้วยค่ะเสมอ',
+      '/skill list',
+    ],
+  },
+  '/details': {
+    summary: 'Inspect deep diagnostics, tool timeline, and token metrics for queries',
+    usage: '/details [Qn] [overview | answer | thinking | tools | tool <n> | all | markdown]',
+    subcommands: [
+      { cmd: 'overview / [Qn]', desc: 'View summary of duration, iterations, token counts, and tool timeline (Press F2 for latest)', example: '/details Q1' },
+      { cmd: 'answer', desc: 'View the complete untruncated final answer', example: '/details answer' },
+      { cmd: 'thinking', desc: 'Inspect raw chain-of-thought and model reasoning', example: '/details thinking' },
+      { cmd: 'tools', desc: 'List all tool calls executed during query processing', example: '/details tools' },
+      { cmd: 'tool <n>', desc: 'Inspect exact arguments and raw return payload for tool call N', example: '/details tool 1' },
+      { cmd: 'all / markdown', desc: 'View full formatted Markdown transcript of the query', example: '/details all' },
+    ],
+    examples: [
+      '/details',
+      '/details Q1 overview',
+      '/details Q1 tool 1',
+      '/details all',
+    ],
+  },
+  '/copy': {
+    summary: 'Copy complete conversation session, model answer, thinking trace, tools, or markdown to system clipboard',
+    usage: '/copy [session [markdown|json|text] | [Qn] [answer|thinking|tools|tool <n>|all|markdown|json]]',
+    subcommands: [
+      { cmd: 'session [format]', desc: 'Copy entire conversation transcript (markdown, json, or text) to clipboard', example: '/copy session' },
+      { cmd: '[Qn] [answer]', desc: 'Copy complete untruncated model answer to system clipboard (default)', example: '/copy' },
+      { cmd: 'thinking', desc: 'Copy raw chain-of-thought and model reasoning', example: '/copy thinking' },
+      { cmd: 'tools', desc: 'Copy JSON tool executions and arguments', example: '/copy tools' },
+      { cmd: 'tool <n>', desc: 'Copy raw JSON result of specific tool call N', example: '/copy tool 1' },
+      { cmd: 'all / markdown', desc: 'Copy entire Q&A transcript in clean Markdown format', example: '/copy all' },
+      { cmd: 'json', desc: 'Copy question diagnostics as JSON', example: '/copy json' },
+      { cmd: 'overview', desc: 'Copy diagnostic overview and metadata', example: '/copy overview' },
+    ],
+    examples: [
+      '/copy',
+      '/copy session',
+      '/copy session json',
+      '/copy thinking',
+      '/copy Q2 answer',
+      '/copy tool 1',
+      '/copy all',
+    ],
+  },
+  '/theme': {
+    summary: 'View or switch the terminal color theme dynamically',
+    usage: '/theme [sakura | midnight | ocean | forest | sunset | monochrome | next | prev | list | current | reset]',
+    subcommands: [
+      { cmd: 'next', desc: 'Rotate to the next available theme palette', example: '/theme next' },
+      { cmd: 'prev', desc: 'Rotate to the previous available theme palette', example: '/theme prev' },
+      { cmd: 'list', desc: 'Preview all available color theme palettes and descriptions', example: '/theme list' },
+      { cmd: 'current', desc: 'Show currently active theme and color samples', example: '/theme current' },
+      { cmd: '<name>', desc: 'Switch theme instantly (sakura, midnight, ocean, forest, sunset, monochrome)', example: '/theme midnight' },
+      { cmd: 'reset', desc: 'Reset to default theme (sakura)', example: '/theme reset' },
+    ],
+    examples: [
+      '/theme list',
+      '/theme midnight',
+      '/theme ocean',
+      '/theme monochrome',
+    ],
+  },
+  '/session': {
+    summary: 'Manage, export, copy, restore, or summarize conversation sessions and history snapshots',
+    usage: '/session [info | summary | list | load <id> | export [format] | copy [format] | clear]',
+    subcommands: [
+      { cmd: 'info', desc: 'Display session ID, active duration, message count, tool breakdown, 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: 'load <id>', desc: 'Restore and resume an archived session by ID or list number', example: '/session load 1' },
+      { cmd: 'export [format]', desc: 'Export full conversation session history to Markdown (.md), JSON (.json), or Text (.txt)', example: '/session export markdown' },
+      { cmd: 'copy [format]', desc: 'Copy entire active session transcript directly to system clipboard', example: '/session copy' },
+      { cmd: 'clear', desc: 'Archive current conversation session and reset history', example: '/session clear' },
+    ],
+    examples: [
+      '/session info',
+      '/session summary',
+      '/session export markdown',
+      '/session export json',
+      '/session copy',
+      '/session list',
+      '/session load 1',
+      '/session clear',
+    ],
+  },
+  '/history': {
+    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',
+    ],
+  },
+  '/thinking': {
+    summary: 'Control reasoning and chain-of-thought visibility during generation',
+    usage: '/thinking [show | hide | toggle]',
+    subcommands: [
+      { cmd: 'show', desc: 'Display live model reasoning process in real time', example: '/thinking show' },
+      { cmd: 'hide', desc: 'Hide thinking process and display only final answers', example: '/thinking hide' },
+      { cmd: 'toggle', desc: 'Toggle thinking display mode on/off', example: '/thinking toggle' },
+    ],
+    examples: [
+      '/thinking show',
+      '/thinking hide',
+      '/thinking toggle',
+    ],
+  },
+  '/lang': {
+    summary: 'Set response language for AI synthesis',
+    usage: '/lang [th | zh | en | auto]',
+    subcommands: [
+      { cmd: 'th', desc: 'Set response language to Thai (ค่ะ/นะคะ)', example: '/lang th' },
+      { cmd: 'zh', desc: 'Set response language to Chinese (中文)', example: '/lang zh' },
+      { cmd: 'en', desc: 'Set response language to English', example: '/lang en' },
+      { cmd: 'auto', desc: 'Auto-detect response language from user input (default)', example: '/lang auto' },
+    ],
+    examples: [
+      '/lang th',
+      '/lang zh',
+      '/lang auto',
+    ],
+  },
+  '/queue': {
+    summary: 'Inspect or clear music playback audio queue',
+    usage: '/queue [clear]',
+    subcommands: [
+      { cmd: '', desc: 'Show currently queued music tracks and playback state', example: '/queue' },
+      { cmd: 'clear', desc: 'Wipe all pending tracks from the music queue', example: '/queue clear' },
+    ],
+    examples: [
+      '/queue',
+      '/queue clear',
+    ],
+  },
+  '/gpu': {
+    summary: 'Show GPU & VRAM hardware resource metrics',
+    usage: '/gpu [status]',
+    subcommands: [
+      { cmd: 'status', desc: 'Show real-time NVIDIA/Metal GPU compute utilization and VRAM memory usage', example: '/gpu' },
+    ],
+    examples: [
+      '/gpu',
+    ],
+  },
+  '/tools': {
+    summary: 'List registered SSOT knowledge and external tools',
+    usage: '/tools [filter]',
+    subcommands: [
+      { cmd: '[filter]', desc: 'List all registered tools or filter by keyword', example: '/tools drama' },
+    ],
+    examples: [
+      '/tools',
+      '/tools search',
+      '/tools mcp',
+    ],
+  },
+  '/cancel': {
+    summary: 'Abort the currently running query, tool, or subagent task',
+    usage: '/cancel',
+    subcommands: [
+      { cmd: '', desc: 'Instantly cancel running model generation, tool execution, or research subagents', example: '/cancel' },
+    ],
+    examples: [
+      '/cancel',
+    ],
+  },
+  '/tool': {
+    summary: 'Execute a registered SSOT tool directly with arguments',
+    usage: '/tool <name> [json_args | raw_query]',
+    subcommands: [
+      { cmd: '<name> [args]', desc: 'Call tool directly without model synthesis', example: '/tool search_works {"year":2026}' },
+    ],
+    examples: [
+      '/tool get_profile_and_fandom',
+      '/tool search_works In Blossom',
+      '/tool search_discography {"category":"ost"}',
+    ],
+  },
+  '/play': {
+    summary: 'Stream YouTube audio for Ju Jingyi songs and OSTs',
+    usage: '/play <song_name_or_url>',
+    subcommands: [
+      { cmd: '<song>', desc: 'Search and play song on YouTube in the background', example: '/play 恋爱告急' },
+    ],
+    examples: [
+      '/play In Blossom OST',
+      '/play 恋爱告急',
+    ],
+  },
+  '/stats': {
+    summary: 'Show comprehensive content metrics, database records, and catalog statistics',
+    usage: '/stats',
+    subcommands: [
+      { cmd: '', desc: 'Display total counts for dramas, discography, brands, awards, and gallery photos', example: '/stats' },
+    ],
+    examples: ['/stats'],
+  },
+  '/ping': {
+    summary: 'Measure live network latency and responsiveness to active LLM inference server',
+    usage: '/ping',
+    subcommands: [
+      { cmd: '', desc: 'Send ping request to active AI model endpoint and report round-trip latency in ms', example: '/ping' },
+    ],
+    examples: ['/ping'],
+  },
+  '/config': {
+    summary: 'Display current runtime configuration, active profile, provider, paths, and environment settings',
+    usage: '/config',
+    subcommands: [
+      { cmd: '', desc: 'Inspect active profile, LLM provider, base URL, model name, storage directories, and MCP status', example: '/config' },
+    ],
+    examples: ['/config'],
+  },
+  '/profile': {
+    summary: 'Manage AI configuration profiles (default, fast, deep-reasoning, cloud, gemini)',
+    usage: '/profile [list | use <name> | show <name> | save <name> | delete <name>]',
+    subcommands: [
+      { cmd: 'list', desc: 'List all available built-in and custom profiles', example: '/profile list' },
+      { cmd: 'use <name>', desc: 'Switch to a configuration profile', example: '/profile use fast' },
+      { cmd: 'show <name>', desc: 'Show detailed settings of a profile', example: '/profile show deep-reasoning' },
+      { cmd: 'save <name>', desc: 'Save current model, provider, temperature, and thinking mode to a named profile', example: '/profile save custom' },
+      { cmd: 'delete <name>', desc: 'Delete a custom profile (built-in profiles cannot be deleted)', example: '/profile delete custom' },
+    ],
+    examples: ['/profile list', '/profile use fast', '/profile use deep-reasoning', '/profile save my-setup'],
+  },
+  '/doctor': {
+    summary: 'Run environment diagnostics, dependency verification, and feature health check',
+    usage: '/doctor',
+    subcommands: [
+      { cmd: '', desc: 'Check Node version, LM Studio server, yt-dlp, ffmpeg, MCP server, and disk permissions', example: '/doctor' },
+    ],
+    examples: ['/doctor'],
+  },
+  '/prompt': {
+    summary: 'Preview the full system prompt and active persona instructions sent to the AI',
+    usage: '/prompt',
+    subcommands: [
+      { cmd: '', desc: 'Inspect the system persona, memory context, and domain rules passed to the LLM', example: '/prompt' },
+    ],
+    examples: ['/prompt'],
+  },
+  '/version': {
+    summary: 'Display installed Kiku Agent release version, build channel, and package metadata',
+    usage: '/version',
+    subcommands: [
+      { cmd: '', desc: 'Show semantic version, git commit, Node runtime version, and release channel', example: '/version' },
+    ],
+    examples: ['/version'],
+  },
+  '/system': {
+    summary: 'Display host operating system, CPU architecture, memory usage, and Node process stats',
+    usage: '/system',
+    subcommands: [
+      { cmd: '', desc: 'Show platform OS, total RAM, heap memory allocation, process uptime, and architecture', example: '/system' },
+    ],
+    examples: ['/system'],
+  },
+  '/about': {
+    summary: 'Display background information, credits, architecture overview, and project links',
+    usage: '/about',
+    subcommands: [
+      { cmd: '', desc: 'Show project mission, tech stack overview, creator credits, and documentation links', example: '/about' },
+    ],
+    examples: ['/about'],
+  },
+  '/ads': {
+    summary: 'Display community sponsor card and featured ecosystem highlights',
+    usage: '/ads',
+    subcommands: [
+      { cmd: '', desc: 'Cycle and display the next sponsor spotlight card in the terminal', example: '/ads' },
+    ],
+    examples: ['/ads'],
+  },
+  '/gallery': {
+    summary: 'Render full-color terminal graphic portraits of Ju Jingyi from the asset gallery',
+    usage: '/gallery',
+    subcommands: [
+      { cmd: '', desc: 'Display a high-resolution downsampled ANSI image portrait in the terminal', example: '/gallery' },
+    ],
+    examples: ['/gallery'],
+  },
+  '/retry': {
+    summary: 'Re-execute the previous query with identical prompt parameters',
+    usage: '/retry',
+    subcommands: [
+      { cmd: '', desc: 'Resend the previous question to the active model for a fresh response', example: '/retry' },
+    ],
+    examples: ['/retry'],
+  },
+  '/clear': {
+    summary: 'Archive active conversation session and reset terminal screen buffer',
+    usage: '/clear',
+    subcommands: [
+      { cmd: '', desc: 'Archive current session to disk, reset message history, and clear viewport', example: '/clear' },
+    ],
+    examples: ['/clear'],
+  },
+  '/save': {
+    summary: 'Export the full active conversation transcript to a formatted Markdown file',
+    usage: '/save',
+    subcommands: [
+      { cmd: '', desc: 'Write complete conversation history, reasoning, and tools to an exported Markdown file', example: '/save' },
+    ],
+    examples: ['/save'],
+  },
+  '/stop': {
+    summary: 'Stop active background audio stream and clear playback process',
+    usage: '/stop',
+    subcommands: [
+      { cmd: '', desc: 'Immediately terminate music audio playback stream', example: '/stop' },
+    ],
+    examples: ['/stop'],
+  },
+  '/pause': {
+    summary: 'Pause active YouTube music playback stream',
+    usage: '/pause',
+    subcommands: [
+      { cmd: '', desc: 'Pause current audio stream without losing playback position', example: '/pause' },
+    ],
+    examples: ['/pause'],
+  },
+  '/resume': {
+    summary: 'Resume paused YouTube audio playback',
+    usage: '/resume',
+    subcommands: [
+      { cmd: '', desc: 'Continue playing paused audio stream from current position', example: '/resume' },
+    ],
+    examples: ['/resume'],
+  },
+  '/next': {
+    summary: 'Skip to the next song in the music playback queue',
+    usage: '/next',
+    subcommands: [
+      { cmd: '', desc: 'Skip current audio track and begin playing next queued track', example: '/next' },
+    ],
+    examples: ['/next'],
+  },
+  '/prev': {
+    summary: 'Return to and replay the previous song in the music queue',
+    usage: '/prev',
+    subcommands: [
+      { cmd: '', desc: 'Jump back to the previous track in playback history', example: '/prev' },
+    ],
+    examples: ['/prev'],
+  },
+  '/mute': {
+    summary: 'Mute music audio playback output',
+    usage: '/mute',
+    subcommands: [
+      { cmd: '', desc: 'Silence audio output while keeping playback stream active', example: '/mute' },
+    ],
+    examples: ['/mute'],
+  },
+  '/unmute': {
+    summary: 'Restore music audio playback volume output',
+    usage: '/unmute',
+    subcommands: [
+      { cmd: '', desc: 'Restore audio volume output to audible level', example: '/unmute' },
+    ],
+    examples: ['/unmute'],
+  },
+  '/add': {
+    summary: 'Add a YouTube music track or OST song to the playback queue',
+    usage: '/add <song_name_or_url>',
+    subcommands: [
+      { cmd: '<song>', desc: 'Search YouTube and enqueue song for playback', example: '/add 恋爱告急' },
+    ],
+    examples: ['/add In Blossom OST', '/add 恋爱告急'],
+  },
+  '/remove': {
+    summary: 'Remove a specific track index from the music playback queue',
+    usage: '/remove <index>',
+    subcommands: [
+      { cmd: '<index>', desc: 'Remove track by its position number in /queue', example: '/remove 2' },
+    ],
+    examples: ['/remove 1', '/remove 3'],
+  },
+  '/clearqueue': {
+    summary: 'Clear all pending tracks from the music playback queue',
+    usage: '/clearqueue',
+    subcommands: [
+      { cmd: '', desc: 'Empty all queued songs while maintaining current track', example: '/clearqueue' },
+    ],
+    examples: ['/clearqueue'],
+  },
+  '/search': {
+    summary: 'Search YouTube video and audio tracks for Ju Jingyi songs',
+    usage: '/search <query>',
+    subcommands: [
+      { cmd: '<query>', desc: 'Search YouTube for tracks and display title, duration, and direct links', example: '/search In Blossom OST' },
+    ],
+    examples: ['/search 鞠婧祎', '/search In Blossom OST'],
+  },
+  '/current': {
+    summary: 'Show metadata, duration, and status for the currently playing audio track',
+    usage: '/current',
+    subcommands: [
+      { cmd: '', desc: 'Display track title, elapsed playback duration, buffer state, and YouTube link', example: '/current' },
+    ],
+    examples: ['/current'],
+  },
+  '/login': {
+    summary: 'Authenticate YouTube session in the browser to enable age-gated music playback',
+    usage: '/login',
+    subcommands: [
+      { cmd: '', desc: 'Open interactive browser session to save YouTube cookies for seamless streaming', example: '/login' },
+    ],
+    examples: ['/login'],
+  },
+  '/ytstatus': {
+    summary: 'Show YouTube authentication, cookie source, and streaming player status',
+    usage: '/ytstatus',
+    subcommands: [
+      { cmd: '', desc: 'Check cookie availability, browser profile connection, and playback backend health', example: '/ytstatus' },
+    ],
+    examples: ['/ytstatus'],
+  },
+  '/exit': {
+    summary: 'Archive active conversation session and exit Kiku Agent CLI',
+    usage: '/exit',
+    subcommands: [
+      { cmd: '', desc: 'Safely save active session state to disk and close terminal application', example: '/exit' },
+    ],
+    examples: ['/exit'],
+  },
+});
+
+export function findCommandDefinition(name) {
+  const normalized = name?.startsWith('/') ? name.toLowerCase() : `/${String(name || '').toLowerCase()}`;
+  return COMMAND_DEFINITIONS.find(command => command.name === normalized) || null;
+}
+
+export function getCommandDetails(name) {
+  if (!name) return null;
+  const normalized = name.startsWith('/') ? name.toLowerCase() : `/${String(name).toLowerCase()}`;
+  return COMMAND_DETAILS[normalized] || null;
+}