kiku-agent 1.0.9 → 1.0.11

package/server/agent/commandRegistry.js

@@ -1,12 +1,12 @@
 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|export|clear]', desc: 'Manage or summarize the current session', insert: '/session ' },
+  { 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 [Qn] [answer|thinking|tools|tool n|all|markdown]', desc: 'Copy full untruncated model answer, thinking, or diagnostics to clipboard', insert: '/copy ' },
+  { 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|reset]', desc: 'View or change the terminal color theme', insert: '/theme ' },
+  { 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 ' },
@@ -23,7 +23,7 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/jobs', usage: '/jobs [list|show|cancel|clear]', desc: 'Inspect and control tracked agent jobs', insert: '/jobs ' },
   { name: '/discover', usage: '/discover [drama|song|stage|photo]', desc: 'Discover something from the catalog', insert: '/discover ' },
   { name: '/stats', usage: '/stats', desc: 'Show the content database overview', insert: '/stats' },
-  { name: '/provider', usage: '/provider [list|use <name> [model]|models [name]|info <name>|test|setkey <key>|status]', desc: 'Manage AI providers (OpenAI, Gemini, Groq, DeepSeek, OpenRouter, LM Studio)', insert: '/provider ' },
+  { name: '/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' },
@@ -65,12 +65,14 @@ export const COMMAND_DEFINITIONS = Object.freeze([
 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>'],
+  '/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'],
@@ -79,21 +81,98 @@ export const SUB_COMMANDS = Object.freeze({
   '/news': ['--days 7', '--days 30', '--official-only', '<topic> --days 14'],
   '/jobs': ['list', 'show <id>', 'cancel <id>', 'clear'],
   '/discover': ['drama', 'song', 'stage', 'photo', 'song --mood calm', 'stage --year 2025'],
-  '/provider': ['list', 'status', 'models', 'models openai', 'models gemini', 'models groq', 'models deepseek', 'models openrouter', 'models lmstudio', 'use openai', 'use openrouter', 'use groq', 'use deepseek', 'use gemini', 'use lmstudio', 'use custom', 'info', 'test', 'setkey <key>'],
+  '/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': ['list', 'current', 'sakura', 'midnight', 'ocean', 'forest', 'sunset', 'monochrome', 'reset'],
+  '/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': ['answer', 'thinking', 'tools', 'tool 1', 'overview', 'all', 'markdown', 'Q1 answer', 'Q1 thinking', 'Q1 all'],
-  '/session': ['info', 'summary', 'list', 'export', 'clear'],
+  '/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'],
-  '/update': ['check', 'install', 'install next', 'install canary', 'channel', 'channel latest', 'channel next', 'channel canary', 'rollback', 'help'],
+  '/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]',
@@ -199,25 +278,45 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
   },
   '/provider': {
-    summary: 'Manage AI model providers (OpenAI, Gemini, Groq, DeepSeek, OpenRouter, LM Studio)',
-    usage: '/provider [list | status | use <name> [model] | models [name] | info <name> | test | setkey <key>]',
+    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 gemini gemini-3.7-flash' },
+      { 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 sk-...' },
-      { cmd: 'test', desc: 'Perform a lightweight ping/test call to verify provider responsiveness', example: '/provider test' },
-      { cmd: 'info <name>', desc: 'Show pricing, context window, token limits, and documentation for a provider', example: '/provider info deepseek' },
+      { 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 use gemini',
-      '/provider use openai gpt-5.6-luna',
-      '/provider setkey YOUR_API_KEY',
+      '/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]',
@@ -263,6 +362,14 @@ export const COMMAND_DETAILS = Object.freeze({
       '/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>]',
@@ -278,23 +385,9 @@ export const COMMAND_DETAILS = Object.freeze({
       '/quiz lang en',
     ],
   },
-  '/key': {
-    summary: 'View, apply, or clear your Developer VIP API Key',
-    usage: '/key [show | apply <key> | clear]',
-    subcommands: [
-      { cmd: 'show', desc: 'Display your current stored VIP key', example: '/key show' },
-      { cmd: 'apply <key>', desc: 'Manually save a VIP key for use in API requests', example: '/key apply kiku_vip_sk_abc123' },
-      { cmd: 'clear', desc: 'Remove the stored VIP key', example: '/key clear' },
-    ],
-    examples: [
-      '/key',
-      '/key apply kiku_vip_sk_abc123',
-      '/key clear',
-    ],
-  },
   '/subagent': {
     summary: 'Spawn an isolated iterative research subagent to investigate a specific task or subtopic',
-    usage: '/subagent <task | status | last | tools>',
+    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' },
@@ -357,18 +450,22 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
   },
   '/copy': {
-    summary: 'Copy complete untruncated model answer, thinking trace, tools, or markdown to system clipboard',
-    usage: '/copy [Qn] [answer | thinking | tools | tool <n> | all | markdown | overview]',
+    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',
@@ -377,8 +474,10 @@ export const COMMAND_DETAILS = Object.freeze({
   },
   '/theme': {
     summary: 'View or switch the terminal color theme dynamically',
-    usage: '/theme [sakura | midnight | ocean | forest | sunset | monochrome | list | current | reset]',
+    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' },
@@ -408,19 +507,25 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
   },
   '/session': {
-    summary: 'Manage current conversation session, storage, and snapshots',
-    usage: '/session [info | list | export | clear]',
+    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, and turn stats', example: '/session info' },
+      { 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: 'export', desc: 'Export full conversation session history to JSON', example: '/session export' },
+      { 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',
     ],
   },
@@ -536,6 +641,230 @@ export const COMMAND_DETAILS = Object.freeze({
       '/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) {