kiku-agent 1.0.9 → 1.0.11

package/server/agent/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 
-import readline from 'node:readline';
-import { stdin as input } from 'node:process';
-import { existsSync } from 'node:fs';
-import { spawn } from 'node:child_process';
-import './youtubeAuth.js';
-import { KikuAgent } from './agentCore.js';
+import readline from 'node:readline';
+import { stdin as input } from 'node:process';
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import './youtubeAuth.js';
+import { KikuAgent } from './agentCore.js';
 import { LLMClient, LMStudioClient } from './llmClient.js';
 import { toolsSchema, toolHandlers, executeTool } from './tools.js';
 import { config, CLOUD_PROVIDERS } from './config.js';
@@ -14,12 +14,12 @@ import { routeCommand } from './commands.js';
 import { eventBus, Events } from './eventBus.js';
 import { AgentStates } from './agentState.js';
 import { sanitizeQuery } from './sanitizer.js';
-import { isAbortError } from './errors.js';
+import { isAbortError, formatExecutionErrorCard } from './errors.js';
 import { COMMAND_DEFINITIONS, SUB_COMMANDS, findCommandDefinition, getCommandDetails } from './commandRegistry.js';
 import { ModelManager } from './modelManager.js';
-import { PACKAGE_VERSION } from './version.js';
-import { getTheme, getThemeName } from './theme.js';
-import { createTerminalImageGallery } from './terminalImage.js';
+import { PACKAGE_VERSION } from './version.js';
+import { getTheme, getThemeName } from './theme.js';
+import { createTerminalImageGallery, getWelcomeGalleryLines } from './terminalImage.js';
 import {
   classifyToolResult,
   formatDetailDuration,
@@ -39,7 +39,7 @@ import {
   printWelcomeHero, getWelcomeHeroLines, randomFanName, setupOutputInterception,
   rawWrite, INPUT_PLACEHOLDER, UI_ICONS,
   spinnerFrames, thinkingFrames, createProgressRunner,
-  enterAlternateScreen, exitAlternateScreen, getTuiViewportLayout, getNewOutputScrollOffset, VirtualScreenBuffer,
+  enterAlternateScreen, exitAlternateScreen, getTuiViewportLayout, getNewOutputScrollOffset, VirtualScreenBuffer,
 } from './ui.js';
 
 let activeAbortController = null;
@@ -318,7 +318,7 @@ function printQueryDetails(reference = '') {
   });
 }
 
-function copyQueryDetails(reference = '') {
+function copyQueryDetails(reference = '', session = null) {
   const request = parseDetailsRequest(reference);
   if (request.error) {
     printSolidPanel({
@@ -326,11 +326,13 @@ function copyQueryDetails(reference = '') {
       lines: [
         `${C.amber}${request.error}${C.reset}`,
         '',
+        `${C.white}/copy session [markdown|json|text]${C.reset} ${C.dim}— copy full session transcript${C.reset}`,
         `${C.white}/copy [Qn] [answer]${C.reset} ${C.dim}— copy model answer (default)${C.reset}`,
         `${C.white}/copy [Qn] thinking${C.reset} ${C.dim}— copy thinking trace${C.reset}`,
         `${C.white}/copy [Qn] tools${C.reset} ${C.dim}— copy tools JSON${C.reset}`,
         `${C.white}/copy [Qn] tool <n>${C.reset} ${C.dim}— copy tool <n> raw result${C.reset}`,
         `${C.white}/copy [Qn] all${C.reset} ${C.dim}— copy full question & answer markdown${C.reset}`,
+        `${C.white}/copy [Qn] json${C.reset} ${C.dim}— copy question diagnostics JSON${C.reset}`,
       ],
     });
     return false;
@@ -340,13 +342,13 @@ function copyQueryDetails(reference = '') {
     ? lastQueryDetails
     : queryDetails.get(request.queryNumber);
 
-  if (!details) {
+  if (!details && !request.isSession && !session) {
     const target = request.queryNumber == null ? 'the latest query' : `Q${request.queryNumber}`;
     console.log(`\n  ${C.amber}[NOT FOUND] No diagnostics recorded for ${target}.${C.reset}\n`);
     return false;
   }
 
-  const copyable = getCopyableContent(details, request);
+  const copyable = getCopyableContent(details, request, session);
   if (!copyable || !copyable.text) {
     console.log(`\n  ${C.amber}[EMPTY] Nothing to copy for ${request.view || 'answer'}.${C.reset}\n`);
     return false;
@@ -461,44 +463,112 @@ export function printHelp(specificCmd = null) {
 
 const ads = [
   {
-    title: 'DashSecurity', subtitle: 'Cybersecurity Knowledge Cloud',
+    title: 'DashSecurity',
+    subtitle: 'Cybersecurity Knowledge Cloud',
+    tagline: 'Enterprise Cyber Threat Intelligence & AI-Powered DevSecOps',
+    badge: 'Security Platform',
     url: 'https://dashsecurity.kpltgroup.com/',
-    features: ['AI-Powered SAST Scanner', 'OWASP Top 10 Detection', 'Certification Prep Labs'],
+    summary: 'Next-generation application security & vulnerability intelligence platform designed for developers, security engineers, and red teamers.',
+    features: [
+      'AI-Powered SAST/DAST Static & Dynamic Security Code Analyzer',
+      'Automated OWASP Top 10 & API Security Vulnerability Detection',
+      'Interactive Certification Prep Labs (OSCP, CEH, CompTIA Security+)',
+      'Real-time Threat Intelligence Feeds & CVE Remediation Advisory',
+    ],
+    highlights: [
+      'AI-Powered SAST/DAST Static & Dynamic Security Code Analyzer',
+      'Automated OWASP Top 10 & API Security Vulnerability Detection',
+      'Interactive Certification Prep Labs (OSCP, CEH, CompTIA Security+)',
+      'Real-time Threat Intelligence Feeds & CVE Remediation Advisory',
+    ],
+    cta: 'Explore security tools & interactive labs',
   },
   {
-    title: 'Ju Jingyi Kikuuu', subtitle: 'Official Portfolio',
+    title: 'Ju Jingyi • 鞠婧祎 Official Portal',
+    subtitle: 'Official Portfolio & SSOT Knowledge Base',
+    tagline: 'Definitive Multimedia Knowledge Base & Autonomous Agent Ecosystem',
+    badge: 'Official Fan Portal',
     url: 'https://jujingyi-kikuuu.vercel.app/',
-    features: ['45+ Music Releases', 'Complete Filmography', 'REST API v1'],
+    summary: 'The single source of truth for Ju Jingyi — featuring exhaustive career timelines, 45+ discography releases, fashion milestones, and full REST API integration.',
+    features: [
+      'Complete Filmography: In Blossom, Beauty of Resilience, 2026 upcoming dramas',
+      'Full Discography: 45+ Singles, Studio Albums, OSTs & live stage tracks',
+      'Fashion & Awards: Versace Global Ambassador milestones & career honors',
+      'Developer API: Production REST API v1, MCP Server & OpenAPI 3.1 Specification',
+    ],
+    highlights: [
+      'Complete Filmography: In Blossom, Beauty of Resilience, 2026 upcoming dramas',
+      'Full Discography: 45+ Singles, Studio Albums, OSTs & live stage tracks',
+      'Fashion & Awards: Versace Global Ambassador milestones & career honors',
+      'Developer API: Production REST API v1, MCP Server & OpenAPI 3.1 Specification',
+    ],
+    cta: 'Visit the portal & test the REST API',
   },
   {
-    title: 'ThemeHackers', subtitle: 'Security Research',
+    title: 'ThemeHackers Research Group',
+    subtitle: 'Security Research & Tooling',
+    tagline: 'Elite Offensive Cyber Research & Open-Source Security Ecosystem',
+    badge: 'Security Research',
     url: 'https://github.com/Themehackers/',
-    features: ['Penetration Testing', 'Open-Source Tools', '10+ Certifications'],
+    summary: 'Independent cybersecurity research collective specializing in red teaming, vulnerability disclosure, penetration testing frameworks, and defensive automation.',
+    features: [
+      'Red Team Operations & Advanced Penetration Testing Toolkits',
+      'Zero-Day Vulnerability Research & Coordinated Security Disclosures',
+      'Open-Source Security Automation Scripts & Reverse Engineering Tools',
+      '10+ Industry Professional Security Certifications & Technical Writeups',
+    ],
+    highlights: [
+      'Red Team Operations & Advanced Penetration Testing Toolkits',
+      'Zero-Day Vulnerability Research & Coordinated Security Disclosures',
+      'Open-Source Security Automation Scripts & Reverse Engineering Tools',
+      '10+ Industry Professional Security Certifications & Technical Writeups',
+    ],
+    cta: 'Explore open-source security repos on GitHub',
   },
 ];
 
 let adIndex = 0;
 function printAd() {
-  const ad = ads[adIndex % ads.length];
+  const currentIdx = adIndex % ads.length;
+  const ad = ads[currentIdx];
   adIndex++;
-  const w = getFullWidth();
-  console.log('');
-  printSolidBannerRow(`  ${C.gold}${C.bold}${UI_ICONS.sponsor} SPONSOR${C.reset}  ${C.bold}${C.white}${ad.title}${C.reset} — ${C.roseGlow}${ad.subtitle}${C.reset}`, w, C.bgPanelHeader);
-  printSolidBannerRow(`   ${ad.features.map(f => `${C.white}${f}${C.reset}`).join(' • ')}`, w, C.bgPanel);
-  printSolidBannerRow(`   ${C.cyberCyan}${C.underline}${ad.url}${C.reset}`, w, C.bgPanel);
-  console.log('');
+
+  const lines = [
+    `${C.bold}${C.white}${ad.tagline || ad.subtitle}${C.reset}`,
+    '',
+    `${C.dim}${ad.summary}${C.reset}`,
+    '',
+    `${C.gold}${C.bold}Core Highlights & Features:${C.reset}`,
+    ...(ad.highlights || ad.features).map(f => `  ${C.emerald}◆${C.reset} ${C.white}${f}${C.reset}`),
+    '',
+    `${C.slate}${ad.cta || 'Visit'}:${C.reset} ${C.cyberCyan}${C.underline}${ad.url}${C.reset}`,
+  ];
+
+  printSolidPanel({
+    title: `${UI_ICONS.sponsor} SPONSOR SPOTLIGHT [${currentIdx + 1}/${ads.length}] • ${ad.title} (${ad.badge || 'Featured'})`,
+    lines,
+    headerBg: C.bgPanelHeader,
+    bg: C.bgPanel,
+  });
+}
+
+function getInitialViewportLines() {
+  const heroLines = getWelcomeHeroLines();
+  const galleryLines = getWelcomeGalleryLines(2);
+  return galleryLines.length > 0 ? [...heroLines, ...galleryLines] : heroLines;
 }
 
 class InteractiveTuiPrompt {
   constructor(options = {}) {
-    this.defaultPromptText = options.prompt || 'Kiku ❯ ';
-    this.promptText = this.defaultPromptText;
-    this.inputPlaceholder = INPUT_PLACEHOLDER;
-    this.recordInputHistory = true;
-    this.cancelValue = null;
+    this.defaultPromptText = options.prompt || 'Kiku ❯ ';
+    this.promptText = this.defaultPromptText;
+    this.inputPlaceholder = INPUT_PLACEHOLDER;
+    this.recordInputHistory = true;
+    this.cancelValue = null;
     this.agent = options.agent || null;
     this.modelName = options.modelName || 'gemma-4-e4b';
     this.provider = options.provider || 'lmstudio';
+    this.isConnected = options.isConnected ?? true;
     this.history = [];
     this.historyIndex = -1;
     this.line = '';
@@ -518,7 +588,7 @@ class InteractiveTuiPrompt {
     this.agentStateTime = 0;
     this._lastCtrlCTime = 0;
 
-    this.viewportLines = getWelcomeHeroLines();
+    this.viewportLines = getInitialViewportLines();
     this.scrollOffset = 0;
     this.screenBuffer = new VirtualScreenBuffer(
       Math.max(20, process.stdout.columns || 80),
@@ -526,28 +596,28 @@ class InteractiveTuiPrompt {
     );
   }
 
-  addViewportLines(lines) {
-    if (lines === null || lines === undefined) return;
-    if (!Array.isArray(lines)) lines = [lines];
-    const wasLive = this.scrollOffset === 0;
-    let addedLineCount = 0;
-    for (const l of lines) {
-      if (typeof l === 'string') {
-        const sublines = l.split('\n');
-        for (const sl of sublines) {
-          this.viewportLines.push(sl);
-          addedLineCount += 1;
-        }
-      } else if (l != null) {
-        this.viewportLines.push(String(l));
-        addedLineCount += 1;
-      }
+  addViewportLines(lines) {
+    if (lines === null || lines === undefined) return;
+    if (!Array.isArray(lines)) lines = [lines];
+    const wasLive = this.scrollOffset === 0;
+    let addedLineCount = 0;
+    for (const l of lines) {
+      if (typeof l === 'string') {
+        const sublines = l.split('\n');
+        for (const sl of sublines) {
+          this.viewportLines.push(sl);
+          addedLineCount += 1;
+        }
+      } else if (l != null) {
+        this.viewportLines.push(String(l));
+        addedLineCount += 1;
+      }
     }
     if (this.viewportLines.length > 5000) {
       const removedCount = this.viewportLines.length - 5000;
       this.viewportLines.splice(0, removedCount);
     }
-    this.scrollOffset = getNewOutputScrollOffset(addedLineCount, process.stdout.rows || 24, wasLive ? 0 : this.scrollOffset);
+    this.scrollOffset = getNewOutputScrollOffset(addedLineCount, process.stdout.rows || 24, wasLive ? 0 : this.scrollOffset);
     this.render();
   }
 
@@ -561,7 +631,7 @@ class InteractiveTuiPrompt {
   }
 
   clearViewport() {
-    this.viewportLines = getWelcomeHeroLines();
+    this.viewportLines = getInitialViewportLines();
     this.scrollOffset = 0;
     this.render();
   }
@@ -584,15 +654,15 @@ class InteractiveTuiPrompt {
     try { if (input.isTTY) input.setRawMode(false); } catch { }
   }
 
-  async readLine(options = {}) {
-    return new Promise((resolve, reject) => {
-      this._cleanupInput();
-      const inputOptions = typeof options === 'string' ? { prompt: options } : options;
-      this.promptText = inputOptions.prompt || this.defaultPromptText;
-      this.inputPlaceholder = inputOptions.placeholder || INPUT_PLACEHOLDER;
-      this.recordInputHistory = inputOptions.history !== false;
-      this.cancelValue = inputOptions.cancelValue ?? null;
-      this.line = '';
+  async readLine(options = {}) {
+    return new Promise((resolve, reject) => {
+      this._cleanupInput();
+      const inputOptions = typeof options === 'string' ? { prompt: options } : options;
+      this.promptText = inputOptions.prompt || this.defaultPromptText;
+      this.inputPlaceholder = inputOptions.placeholder || INPUT_PLACEHOLDER;
+      this.recordInputHistory = inputOptions.history !== false;
+      this.cancelValue = inputOptions.cancelValue ?? null;
+      this.line = '';
       this.cursor = 0;
       this.historyIndex = -1;
       this.popoverIndex = 0;
@@ -626,7 +696,7 @@ class InteractiveTuiPrompt {
     this.cursor = 0;
     this.popoverActive = false;
     this.popoverItems = [];
-    if (this.recordInputHistory && result && result.trim()) this.history.push(result);
+    if (this.recordInputHistory && result && result.trim()) this.history.push(result);
     const resolve = this.activeResolve;
     this.activeResolve = null;
     this.activeReject = null;
@@ -670,7 +740,11 @@ class InteractiveTuiPrompt {
       this.popoverActive = false;
       this.popoverItems = [];
       this.popoverIndex = 0;
-      this.ghostText = '';
+      if (!this.isConnected && this.line.length > 0) {
+        this.ghostText = ' (LM Studio offline - type /model reconnect)';
+      } else {
+        this.ghostText = '';
+      }
     }
   }
 
@@ -691,7 +765,9 @@ class InteractiveTuiPrompt {
 
 
     const shortModel = (this.modelName || 'gemma-4-e4b').replace(/^.*\//, '');
-    const modelLabel = `${C.gold}✦ ${shortModel}${C.reset}`;
+    const modelLabel = this.isConnected
+      ? `${C.gold}✦ ${shortModel}${C.reset}`
+      : `${C.roseGlow}✦ OFFLINE${C.reset}`;
     const mcpCount = this.agent?.mcpManager?.servers?.size || 0;
     const mcpLabel = mcpCount > 0 ? `${C.emerald}● ${mcpCount} MCP${C.reset}` : `${C.slate}○ 0 MCP${C.reset}`;
 
@@ -732,7 +808,9 @@ class InteractiveTuiPrompt {
         const pad = Math.max(1, safeCols - getStringDisplayWidth(statusLeft) - getStringDisplayWidth(statusRight));
         statusStyled = `${statusLeft}${' '.repeat(pad)}${statusRight}`;
       } else {
-        statusStyled = statusLeft;
+        const hkRight = `${C.slate}Esc${C.reset}${C.dim} Cancel${C.reset}  ${C.slate}F3${C.reset}${C.dim} Think${C.reset}  ${C.slate}F5${C.reset}${C.dim} Copy${C.reset}  `;
+        const pad = Math.max(1, safeCols - getStringDisplayWidth(statusLeft) - getStringDisplayWidth(hkRight));
+        statusStyled = `${statusLeft}${' '.repeat(pad)}${hkRight}`;
       }
     } else if (currentOffset > 0) {
       const posInfo = startIndex > 0 ? ` ${C.slate}• ↑ ${startIndex} above${C.reset}` : '';
@@ -742,8 +820,11 @@ class InteractiveTuiPrompt {
       statusStyled = `${statusLeft}${' '.repeat(pad)}${statusRight}`;
     } else if (musicStatus) {
       statusStyled = `  ${C.cyberCyan}🎵 ${musicStatus}${C.reset}`;
+    } else if (!this.isConnected) {
+      statusStyled = `  ${C.roseGlow}○ OFFLINE${C.reset} ${C.slate}• Start LM Studio & type ${C.cyberCyan}/model reconnect${C.reset}`;
     } else {
-      statusStyled = `  ${C.emerald}● READY${C.reset}`;
+      const hkHints = `${C.slate}F1${C.reset}${C.dim} Help${C.reset}  ${C.slate}F3${C.reset}${C.dim} Think${C.reset}  ${C.slate}F4${C.reset}${C.dim} Tools${C.reset}  ${C.slate}F5${C.reset}${C.dim} Copy${C.reset}  ${C.slate}F7${C.reset}${C.dim} Theme${C.reset}`;
+      statusStyled = `  ${C.emerald}● READY${C.reset}  ${C.slate}│${C.reset}  ${hkHints}`;
     }
 
     this.screenBuffer.setRow(statusBarRow, statusStyled, C.bgPanelHeader);
@@ -795,7 +876,10 @@ class InteractiveTuiPrompt {
         trailingStyled = `${C.dim}${C.slate}${ghostDisplay}${C.reset}`;
       }
     } else if (!this.line) {
-      const placeholder = sliceLineForDisplay(this.inputPlaceholder, 0, maxLineWidth).displayLine;
+      const defaultPlaceholder = this.isConnected
+        ? this.inputPlaceholder
+        : '[AI Offline] Start LM Studio & type /model reconnect (or /help)';
+      const placeholder = sliceLineForDisplay(defaultPlaceholder, 0, maxLineWidth).displayLine;
       trailingStyled = `${C.dim}${C.slate}${placeholder}${C.reset}`;
     }
 
@@ -812,12 +896,12 @@ class InteractiveTuiPrompt {
   handleKeypress(str, key) {
     if (!key && !str) return;
 
-    if ((key?.ctrl && key?.name === 'c') || str === '\x03') {
-      if (this.cancelValue !== null) {
-        this.finish(this.cancelValue);
-        return;
-      }
-      if (isProcessing) {
+    if ((key?.ctrl && key?.name === 'c') || str === '\x03') {
+      if (this.cancelValue !== null) {
+        this.finish(this.cancelValue);
+        return;
+      }
+      if (isProcessing) {
         if (this.onCancel) this.onCancel();
         else if (this.onSigInt) this.onSigInt();
         this.addViewportLines(`  ${C.amber}[✓ Cancelled by user]${C.reset}`);
@@ -842,12 +926,12 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'escape' || str === '\x1b') {
-      if (this.cancelValue !== null) {
-        this.finish(this.cancelValue);
-        return;
-      }
-      if (this.popoverActive) {
+    if (key?.name === 'escape' || str === '\x1b') {
+      if (this.cancelValue !== null) {
+        this.finish(this.cancelValue);
+        return;
+      }
+      if (this.popoverActive) {
         this.popoverActive = false;
         this.popoverItems = [];
         this.ghostText = '';
@@ -869,38 +953,24 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (
-      str && (
-        str.startsWith('\x1b') ||
-        str.includes('\x1b') ||
-        str.includes('[<') ||
-        str.includes('[M') ||
-        /^<[0-9;]*[a-zA-Z]?$/.test(str) ||
-        /^[0-9;]+[a-zA-Z]$/.test(str) ||
-        /^[0-9;]{2,}$/.test(str) ||
-        /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/.test(str)
-      )
-    ) {
-      if (str.includes('[<64;') || str.includes('[64;') || str.includes('<64;') || (key?.name === 'up' && key?.shift)) {
-        const { viewportHeight } = getTuiViewportLayout(process.stdout.rows || 24);
-        const maxOffset = Math.max(0, this.viewportLines.length - viewportHeight);
-        this.scrollOffset = Math.min(maxOffset, this.scrollOffset + 3);
+   
+    if (str && (str.includes('[<64;') || str.includes('[64;') || str.includes('<64;') || (key?.name === 'up' && key?.shift))) {
+      const { viewportHeight } = getTuiViewportLayout(process.stdout.rows || 24);
+      const maxOffset = Math.max(0, this.viewportLines.length - viewportHeight);
+      this.scrollOffset = Math.min(maxOffset, this.scrollOffset + 3);
+      this.render();
+      return;
+    }
+    if (str && (str.includes('[<65;') || str.includes('[65;') || str.includes('<65;') || (key?.name === 'down' && key?.shift))) {
+      if (this.scrollOffset > 0) {
+        this.scrollOffset = Math.max(0, this.scrollOffset - 3);
         this.render();
-        return;
-      }
-      if (str.includes('[<65;') || str.includes('[65;') || str.includes('<65;') || (key?.name === 'down' && key?.shift)) {
-        if (this.scrollOffset > 0) {
-          this.scrollOffset = Math.max(0, this.scrollOffset - 3);
-          this.render();
-        }
-        return;
-      }
-      if (str !== '\r' && str !== '\n' && str !== '\t' && str !== '\x08' && str !== '\x7f') {
-        return;
       }
+      return;
     }
 
-    if (key?.name === 'pageup') {
+ 
+    if (key?.name === 'pageup' || str === '\x1b[5~') {
       const { viewportHeight } = getTuiViewportLayout(process.stdout.rows || 24);
       const maxOffset = Math.max(0, this.viewportLines.length - viewportHeight);
       this.scrollOffset = Math.min(maxOffset, this.scrollOffset + Math.max(1, viewportHeight - 2));
@@ -908,22 +978,48 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'pagedown') {
+    if (key?.name === 'pagedown' || str === '\x1b[6~') {
       const { viewportHeight } = getTuiViewportLayout(process.stdout.rows || 24);
       this.scrollOffset = Math.max(0, this.scrollOffset - Math.max(1, viewportHeight - 2));
       this.render();
       return;
     }
 
-    if (key?.ctrl && key?.name === 'l') {
-      this.render();
-      return;
-    }
 
-    if (key?.name === 'f2') {
-      this.finish('/details');
-      return;
-    }
+    const isF1 = key?.name === 'f1' || str === '\x1bOP' || str === '\x1b[[A' || str === '\x1b[11~';
+    const isF2 = key?.name === 'f2' || str === '\x1bOQ' || str === '\x1b[[B' || str === '\x1b[12~';
+    const isF3 = key?.name === 'f3' || str === '\x1bOR' || str === '\x1b[[C' || str === '\x1b[13~';
+    const isF4 = key?.name === 'f4' || str === '\x1bOS' || str === '\x1b[[D' || str === '\x1b[14~';
+    const isF5 = key?.name === 'f5' || str === '\x1b[15~' || str === '\x1b[[E';
+    const isF6 = key?.name === 'f6' || str === '\x1b[17~';
+    const isF7 = key?.name === 'f7' || str === '\x1b[18~';
+    const isF8 = key?.name === 'f8' || str === '\x1b[19~';
+    const isF9 = key?.name === 'f9' || str === '\x1b[20~';
+    const isF10 = key?.name === 'f10' || str === '\x1b[21~';
+
+    if (isF1) { this.finish('/help'); return; }
+    if (isF2) { this.finish('/details'); return; }
+    if (isF3) { this.finish('/details thinking'); return; }
+    if (isF4) { this.finish('/details tools'); return; }
+    if (isF5) { this.finish('/copy'); return; }
+    if (isF6) { this.finish('/gallery'); return; }
+    if (isF7) { this.finish('/theme next'); return; }
+    if (isF8) { this.finish('/stats'); return; }
+    if (isF9) { this.finish('/provider'); return; }
+    if (isF10) { this.finish('/mcp list'); return; }
+
+ 
+    const isCtrlL = (key?.ctrl && key?.name === 'l') || str === '\x0c';
+    const isCtrlT = (key?.ctrl && key?.name === 't') || str === '\x14';
+    const isCtrlR = (key?.ctrl && key?.name === 'r') || str === '\x12';
+    const isCtrlS = (key?.ctrl && key?.name === 's') || str === '\x13';
+    const isCtrlG = (key?.ctrl && key?.name === 'g') || str === '\x07';
+
+    if (isCtrlL) { this.render(); return; }
+    if (isCtrlT) { this.finish('/thinking toggle'); return; }
+    if (isCtrlR) { this.finish('/retry'); return; }
+    if (isCtrlS) { this.finish('/save'); return; }
+    if (isCtrlG) { this.finish('/gallery'); return; }
 
     if (key?.name === 'tab' || str === '\t') {
       if (this.popoverActive && this.popoverItems.length > 0) {
@@ -966,14 +1062,15 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key.name === 'up' || (key.ctrl && key.name === 'p')) {
+    const isUp = key?.name === 'up' || (key?.ctrl && key?.name === 'p') || str === '\x10';
+    if (isUp) {
       if (this.popoverActive && this.popoverItems.length > 0) {
         this.popoverIndex = (this.popoverIndex - 1 + this.popoverItems.length) % this.popoverItems.length;
         this.updateState();
         this.render();
         return;
       }
-      if (key.ctrl && this.history.length > 0) {
+      if (key?.ctrl && this.history.length > 0) {
         if (this.historyIndex === -1) this.historyIndex = this.history.length - 1;
         else if (this.historyIndex > 0) this.historyIndex--;
         this.line = this.history[this.historyIndex] || '';
@@ -989,7 +1086,8 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'down' || (key?.ctrl && key?.name === 'n')) {
+    const isDown = key?.name === 'down' || (key?.ctrl && key?.name === 'n') || str === '\x0e';
+    if (isDown) {
       if (this.popoverActive && this.popoverItems.length > 0) {
         this.popoverIndex = (this.popoverIndex + 1) % this.popoverItems.length;
         this.updateState();
@@ -1016,7 +1114,8 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'home' || (key?.ctrl && key?.name === 'a')) {
+    const isHome = key?.name === 'home' || (key?.ctrl && key?.name === 'a') || str === '\x01' || str === '\x1b[H' || str === '\x1b[1~';
+    if (isHome) {
       if (this.line === '') {
         const { viewportHeight } = getTuiViewportLayout(process.stdout.rows || 24);
         this.scrollOffset = Math.max(0, this.viewportLines.length - viewportHeight);
@@ -1028,7 +1127,8 @@ class InteractiveTuiPrompt {
       return;
     }
 
-    if (key?.name === 'end' || (key?.ctrl && key?.name === 'e')) {
+    const isEnd = key?.name === 'end' || (key?.ctrl && key?.name === 'e') || str === '\x05' || str === '\x1b[F' || str === '\x1b[4~';
+    if (isEnd) {
       if (this.line === '') {
         this.scrollOffset = 0;
         this.render();
@@ -1043,7 +1143,9 @@ class InteractiveTuiPrompt {
     if (key?.name === 'left') { if (this.cursor > 0) { this.cursor = previousGraphemeBoundary(this.line, this.cursor); this.render(); } return; }
 
     if (key?.name === 'backspace' || str === '\x08' || str === '\x7f') { if (this.cursor > 0) { const previous = previousGraphemeBoundary(this.line, this.cursor); this.line = this.line.slice(0, previous) + this.line.slice(this.cursor); this.cursor = previous; this.updateState(); this.render(); } return; }
-    if (key?.name === 'delete') { if (this.cursor < this.line.length) { const next = nextGraphemeBoundary(this.line, this.cursor); this.line = this.line.slice(0, this.cursor) + this.line.slice(next); this.updateState(); this.render(); } return; }
+
+    const isDelete = key?.name === 'delete' || str === '\x1b[3~';
+    if (isDelete) { if (this.cursor < this.line.length) { const next = nextGraphemeBoundary(this.line, this.cursor); this.line = this.line.slice(0, this.cursor) + this.line.slice(next); this.updateState(); this.render(); } return; }
 
     if (str && !key?.ctrl && !key?.meta) {
       if (
@@ -1113,16 +1215,21 @@ function getSuggestionsForLine(line, cursor = (line || '').length, agent = null)
   if (parts.length > 1 || (parts.length === 1 && line.includes(' '))) {
     const subs = SUB_COMMANDS[baseCmd] || [];
     const details = getCommandDetails(baseCmd);
+    const def = findCommandDefinition(baseCmd);
     const query = parts.slice(1).join(' ').toLowerCase();
     return subs
       .filter(s => s.toLowerCase().includes(query))
       .map(s => {
-        const subKey = s.split(/\s+/)[0].toLowerCase();
+        const sNorm = s.trim().toLowerCase();
+        const subWords = sNorm.split(/\s+/);
         const matchedDetail = details?.subcommands?.find(sc => {
-          const scKey = sc.cmd.split(/\s+/)[0].toLowerCase();
-          return scKey === subKey || sc.cmd.toLowerCase().includes(subKey);
+          const scNorm = (sc.cmd || '').trim().toLowerCase();
+          const scWords = scNorm.split(/\s+/);
+          if (scNorm === sNorm) return true;
+          if (scWords.length >= 2 && subWords.length >= 2 && scWords[0] === subWords[0] && scWords[1] === subWords[1]) return true;
+          return scWords[0] === subWords[0];
         });
-        const desc = matchedDetail?.desc || '';
+        const desc = matchedDetail?.desc || details?.summary || def?.desc || '';
         return { name: `${baseCmd} ${s}`, desc, insert: `${baseCmd} ${s} ` };
       });
   }
@@ -1509,13 +1616,8 @@ async function executeQueryWithUI(agent, prompt, isThinkingVisible = false, sign
                 }
               },
 
-              onError: (err) => {
+              onError: (_err) => {
                 stopSpinner();
-                printRichCard({
-                  title: 'Execution Error',
-                  status: 'error',
-                  lines: [err.message],
-                });
               },
             });
 
@@ -1526,11 +1628,7 @@ async function executeQueryWithUI(agent, prompt, isThinkingVisible = false, sign
             stopSpinner();
             persistQueryDetails(isAbortError(err) ? 'aborted' : 'error', err);
             if (!isAbortError(err)) {
-              printRichCard({
-                title: 'Query Failed',
-                status: 'error',
-                lines: [err.message],
-              });
+              printRichCard(formatExecutionErrorCard(err, { client: agent.client, provider: agent.client?.provider, model: agent.client?.model }));
             } else {
               printRichCard({
                 title: 'Query Cancelled',
@@ -1560,23 +1658,23 @@ async function main() {
 
           if (opts.showStats) { printWelcomeHero(); const r = await executeTool('get_system_stats', {}); console.log(JSON.stringify(r, null, 2)); process.exit(0); }
 
-          if (opts.query) {
-            printWelcomeHero();
-            const client = new LLMClient({
+          if (opts.query) {
+            printWelcomeHero();
+            const client = new LLMClient({
               provider: opts.provider || config.activeProvider,
               baseUrl: opts.url,
               apiKey: opts.apiKey,
-              model: opts.model
-            });
-            const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
-            const modelResolution = await modelManager.resolve({ requestedModel: opts.model || client.model });
-            if (!modelResolution.connected || !modelResolution.selectedModel) {
-              throw new Error(modelResolution.error || `No available chat model found for ${client.providerName}`);
-            }
-            if (modelResolution.usedFallback) {
-              console.log(`  ${C.amber}Model ${modelResolution.requestedModel} is unavailable; using ${modelResolution.selectedModel}.${C.reset}\n`);
-            }
-            console.log(`  ${C.bold}${C.gold}QUERY${C.reset} ${C.white}${opts.query}${C.reset}\n`);
+              model: opts.model
+            });
+            const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
+            const modelResolution = await modelManager.resolve({ requestedModel: opts.model || client.model });
+            if (!modelResolution.connected || !modelResolution.selectedModel) {
+              throw new Error(modelResolution.error || `No available chat model found for ${client.providerName}`);
+            }
+            if (modelResolution.usedFallback) {
+              console.log(`  ${C.amber}Model ${modelResolution.requestedModel} is unavailable; using ${modelResolution.selectedModel}.${C.reset}\n`);
+            }
+            console.log(`  ${C.bold}${C.gold}QUERY${C.reset} ${C.white}${opts.query}${C.reset}\n`);
             const agent = new KikuAgent({ client, thinkingMode: opts.thinking });
             await executeQueryWithUI(agent, opts.query, agent.session.thinkingMode === 'show', null, 1);
             process.exit(0);
@@ -1592,7 +1690,7 @@ async function main() {
             apiKey: opts.apiKey,
             model: opts.model
           });
-          const baseUrl = client.baseUrl;
+          let baseUrl = client.baseUrl;
           const agent = new KikuAgent({ client, thinkingMode: opts.thinking });
 
           function cancelActiveQuery() {
@@ -1620,11 +1718,12 @@ async function main() {
             return false;
           }
 
-          const tuiPrompt = new InteractiveTuiPrompt({
+          const tuiPrompt = new InteractiveTuiPrompt({
             prompt: 'Kiku ❯ ',
             agent,
             modelName: opts.model || client.model || 'gemma-4-e4b',
             provider: client.providerName,
+            isConnected: false,
             onCancel: cancelActiveQuery,
             onSigInt: async () => {
               if (activeAbortController || isProcessing) {
@@ -1636,12 +1735,13 @@ async function main() {
                   globalTuiPrompt = null;
                 }
                 exitAlternateScreen();
-                console.log(`\n  ${C.sakura}Goodbye. (鞠躬 ~ 谢谢!)${C.reset}\n`);
-                process.exit(0);
+                process.stdout.write(`\n  ${C.sakura}Goodbye • 再见 (鞠躬 ~ 谢谢!)${C.reset}\n\n`, () => {
+                  process.exit(0);
+                });
               }
             }
-          });
-          const terminalGallery = createTerminalImageGallery();
+          });
+          const terminalGallery = createTerminalImageGallery();
 
           globalTuiPrompt = tuiPrompt;
           setupOutputInterception(tuiPrompt, () => isProcessing);
@@ -1650,57 +1750,84 @@ async function main() {
           let catalogOnlyMode = false;
 
           if (!health.connected) {
-            printRichCard({
-              title: `${client.providerName} Offline`,
-              status: 'offline',
-              lines: [
-                `• Endpoint: ${baseUrl || 'local'} (${health.error || 'unreachable'})`,
-                ...(client.provider === 'lmstudio' ? ['• Action: Attempting auto-start of local LM Studio...'] : []),
-              ],
-            });
+            if (client.provider !== 'lmstudio') {
+              printRichCard({
+                title: `${client.providerName} Unavailable • Auto-Fallback to LM Studio`,
+                status: 'warning',
+                lines: [
+                  `• ${client.providerName} is not ready (${health.error || 'unreachable'}).`,
+                  '• Auto-switching to local LM Studio (google/gemma-4-e4b)...',
+                  'Tip: To configure keys, use /provider setkey <key> or /provider use <name>',
+                ],
+              });
 
-            if (client.provider === 'lmstudio') {
-              const autoHealth = await attemptAutoStartLMStudio(baseUrl, opts.model || client.model);
-              if (autoHealth) {
-                health = autoHealth;
-                printRichCard({
-                  title: 'LM Studio Started',
-                  status: 'ok',
-                  lines: [
-                    'Local LM Studio process started and responding.',
-                  ],
-                });
+              client.switchProvider('lmstudio');
+              if (agent?.client) agent.client.switchProvider('lmstudio');
+              baseUrl = client.baseUrl;
+              tuiPrompt.provider = client.providerName;
+              tuiPrompt.modelName = client.model;
+              tuiPrompt.render();
+
+              health = await client.checkConnection();
+            }
+
+            if (!health.connected) {
+              printRichCard({
+                title: `${client.providerName} Offline`,
+                status: 'offline',
+                lines: [
+                  `• Endpoint: ${baseUrl || 'local'} (${health.error || 'unreachable'})`,
+                  ...(client.provider === 'lmstudio' ? ['• Action: Attempting auto-start of local LM Studio...'] : []),
+                ],
+              });
+
+              if (client.provider === 'lmstudio') {
+                const autoHealth = await attemptAutoStartLMStudio(baseUrl, opts.model || client.model);
+                if (autoHealth) {
+                  health = autoHealth;
+                  printRichCard({
+                    title: 'LM Studio Started',
+                    status: 'ok',
+                    lines: [
+                      'Local LM Studio process started and responding.',
+                    ],
+                  });
+                } else {
+                  catalogOnlyMode = true;
+                  tuiPrompt.isConnected = false;
+                  printRichCard({
+                    title: 'LM Studio Offline • AI Chat Locked',
+                    status: 'offline',
+                    lines: [
+                      'LM Studio is not running. Free-form chat typing is locked to prevent errors.',
+                      'Open LM Studio, load a model (e.g. google/gemma-4-e4b), then type /model reconnect.',
+                      'Offline commands available: /model reconnect, /help, /provider, /doctor, /theme, /exit',
+                    ],
+                  });
+                }
               } else {
                 catalogOnlyMode = true;
+                tuiPrompt.isConnected = false;
                 printRichCard({
-                  title: 'Catalog-Only Mode',
-                  status: 'catalog',
+                  title: `${client.providerName} Offline • AI Chat Locked`,
+                  status: 'offline',
                   lines: [
-                    'Direct database & MCP tools remain available without AI synthesis.',
-                    'Start LM Studio and run /model reconnect to enable conversational chat.',
+                    `${client.providerName} is unreachable. Chat typing is locked to prevent errors.`,
+                    'Verify your provider endpoint/key and use /model reconnect or /provider.',
+                    'Offline commands available: /model reconnect, /help, /provider, /doctor, /theme, /exit',
                   ],
                 });
               }
-            } else {
-              catalogOnlyMode = true;
-              printRichCard({
-                title: 'Catalog-Only Mode',
-                status: 'catalog',
-                lines: [
-                  'Direct database & MCP tools remain available without AI synthesis.',
-                  'Verify your provider endpoint/key and use /model reconnect.',
-                ],
-              });
             }
           }
 
-          const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
+          const modelManager = new ModelManager(client, { requestedModel: opts.model || client.model });
           const modelResolution = catalogOnlyMode
             ? { connected: false, state: 'catalog_only' }
             : await modelManager.resolve({ requestedModel: opts.model || client.model });
           if (!catalogOnlyMode && (!modelResolution.connected || !modelResolution.selectedModel)) {
             printRichCard({
-              title: 'Model Not Loaded',
+              title: 'Model Not Loaded • AI Chat Locked',
               status: 'warning',
               lines: [
                 modelResolution.error || 'No chat-capable model loaded',
@@ -1708,13 +1835,15 @@ async function main() {
               ],
             });
             catalogOnlyMode = true;
+            tuiPrompt.isConnected = false;
           } else if (!catalogOnlyMode && modelResolution.selectedModel) {
+            tuiPrompt.isConnected = true;
             tuiPrompt.modelName = modelResolution.selectedModel;
             printRichCard({
               title: 'Connected & Ready',
               status: 'connected',
               lines: [
-                `• Provider: ${client.providerName}${client.provider === 'lmstudio' ? ' (Local)' : ''}  • Model: ${modelResolution.selectedModel}`,
+                `• Provider: ${client.providerName}${client.provider === 'lmstudio' ? ' (Local)' : ''}  • Model: ${modelResolution.selectedModel}`,
                 `• Status: Chat & Tool DAG Active  • Tools: ${toolsSchema.length} Loaded`,
               ],
             });
@@ -1763,17 +1892,17 @@ async function main() {
 
           const mcpStatus = agent.mcpManager ? agent.mcpManager.getStatus() : null;
           if (mcpStatus && mcpStatus.activeServersCount > 0 && !opts.mcp) {
-            const serverSummaries = mcpStatus.servers
-              .filter(s => s.status === 'connected')
-              .map(s => {
-                const sources = (s.sources || [])
-                  .map(source => String(source).split(/[\\/]/).pop())
-                  .filter(Boolean);
-                const sourceLabel = sources.length > 0
-                  ? ` • source: ${[...new Set(sources)].join(', ')}`
-                  : '';
-                return `• ${s.name} (${s.type}) — ${s.toolsCount} tools${sourceLabel}`;
-              });
+            const serverSummaries = mcpStatus.servers
+              .filter(s => s.status === 'connected')
+              .map(s => {
+                const sources = (s.sources || [])
+                  .map(source => String(source).split(/[\\/]/).pop())
+                  .filter(Boolean);
+                const sourceLabel = sources.length > 0
+                  ? ` • source: ${[...new Set(sources)].join(', ')}`
+                  : '';
+                return `• ${s.name} (${s.type}) — ${s.toolsCount} tools${sourceLabel}`;
+              });
             printRichCard({
               title: 'Persisted MCP Connected',
               status: 'mcp',
@@ -1826,22 +1955,29 @@ async function main() {
             baseUrl,
             modelManager,
             catalogOnlyMode,
-            setCatalogOnlyMode: value => { catalogOnlyMode = Boolean(value); },
+            setCatalogOnlyMode: value => {
+              catalogOnlyMode = Boolean(value);
+              if (tuiPrompt) {
+                tuiPrompt.isConnected = !catalogOnlyMode;
+                tuiPrompt.render();
+              }
+            },
             get lastQuery() { return lastQuery; },
             set lastQuery(value) { lastQuery = value; },
             printHelp,
             printQueryDetails,
-            copyQueryDetails,
-            printWelcome: printWelcomeHero,
-            printAd,
-            showTerminalImage: () => {
-              const imageLines = terminalGallery.maybeRender(queryCount, { force: true });
-              if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
-              return imageLines.length > 0;
-            },
-            cancelActiveQuery,
-            readInput: options => tuiPrompt.readLine(options),
-            enqueueQuery: async (prompt, isRetry) => {
+            copyQueryDetails: (ref) => copyQueryDetails(ref, agent?.session),
+            printWelcome: printWelcomeHero,
+            printAd,
+            showTerminalImage: (count = 2) => {
+              const num = Number(count) || 2;
+              const imageLines = terminalGallery.maybeRender(queryCount, { force: true, count: num });
+              if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
+              return imageLines.length > 0;
+            },
+            cancelActiveQuery,
+            readInput: options => tuiPrompt.readLine(options),
+            enqueueQuery: async (prompt, isRetry) => {
               queryQueue.push({ id: 'q_' + Date.now(), number: nextQueryNumber++, prompt, addedAt: Date.now() });
               triggerQueueProcessing();
             },
@@ -1879,46 +2015,49 @@ async function main() {
 
                   try {
                     if (catalogOnlyMode) {
-                      const targetTool = nextItem.prompt.startsWith('@')
-                        ? nextItem.prompt.slice(1).split(/\s+/)[0]
-                        : 'search_works';
-                      const rawArg = nextItem.prompt.startsWith('@')
-                        ? nextItem.prompt.slice(targetTool.length + 1).trim()
-                        : nextItem.prompt;
-
-                      let queryArgs = {};
-                      try { queryArgs = JSON.parse(rawArg); } catch { queryArgs = { query: rawArg }; }
-
-                      let result;
-                      if (agent.mcpManager?.isMcpTool(targetTool)) {
-                        result = await agent.mcpManager.callTool(targetTool, queryArgs);
+                      if (nextItem.prompt.startsWith('@')) {
+                        const targetTool = nextItem.prompt.slice(1).split(/\s+/)[0];
+                        const rawArg = nextItem.prompt.slice(targetTool.length + 1).trim();
+
+                        let queryArgs = {};
+                        try { queryArgs = JSON.parse(rawArg); } catch { queryArgs = { query: rawArg }; }
+
+                        let result;
+                        if (agent.mcpManager?.isMcpTool(targetTool)) {
+                          result = await agent.mcpManager.callTool(targetTool, queryArgs);
+                        } else {
+                          result = await executeTool(targetTool, queryArgs);
+                        }
+
+                        const serialized = JSON.stringify(result, null, 2);
+                        printSolidPanel({
+                          title: `Direct Tool Result • ${targetTool} • Q${nextItem.number}`,
+                          lines: serialized.split('\n'),
+                        });
                       } else {
-                        result = await executeTool(targetTool, queryArgs);
+                        printRichCard({
+                          title: 'Query Blocked • LM Studio Offline',
+                          status: 'warning',
+                          lines: [
+                            'Cannot execute chat query because LM Studio is offline.',
+                            'Please start LM Studio and run /model reconnect to enable conversational chat.',
+                          ],
+                        });
                       }
-
-                      const serialized = JSON.stringify(result, null, 2);
-                      printSolidPanel({
-                        title: `Direct Tool Result • ${targetTool} • Q${nextItem.number}`,
-                        lines: serialized.split('\n'),
-                      });
                     } else {
                       await executeQueryWithUI(agent, nextItem.prompt, agent.session.thinkingMode === 'show', activeAbortController.signal, nextItem.number);
                     }
                   } catch (err) {
                     if (!isAbortError(err)) {
-                      printRichCard({
-                        title: 'Execution Error',
-                        status: 'error',
-                        lines: [err.message],
-                      });
+                      printRichCard(formatExecutionErrorCard(err, { client: agent.client, provider: agent.client?.provider, model: agent.client?.model }));
                     }
                   } finally {
-                    activeAbortController = null;
-                    queryCount++;
-                    printAd();
-                    const imageLines = terminalGallery.maybeRender(queryCount);
-                    if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
-                    activeQueryNumber = null;
+                    activeAbortController = null;
+                    queryCount++;
+                    printAd();
+                    const imageLines = terminalGallery.maybeRender(queryCount);
+                    if (imageLines.length > 0) tuiPrompt.addViewportLines(imageLines);
+                    activeQueryNumber = null;
                     if (globalTuiPrompt) {
                       globalTuiPrompt.agentState = '';
                       globalTuiPrompt.render();
@@ -2009,6 +2148,75 @@ async function main() {
               continue;
             }
 
+         
+            if (catalogOnlyMode || !tuiPrompt.isConnected) {
+              if (trimmed.startsWith('@')) {
+                const targetTool = trimmed.slice(1).split(/\s+/)[0];
+                const rawArg = trimmed.slice(targetTool.length + 1).trim();
+
+                let queryArgs = {};
+                try { queryArgs = JSON.parse(rawArg); } catch { queryArgs = { query: rawArg }; }
+
+                try {
+                  let result;
+                  if (agent.mcpManager?.isMcpTool(targetTool)) {
+                    result = await agent.mcpManager.callTool(targetTool, queryArgs);
+                  } else {
+                    result = await executeTool(targetTool, queryArgs);
+                  }
+                  const serialized = JSON.stringify(result, null, 2);
+                  printSolidPanel({
+                    title: `Direct Tool Result • ${targetTool}`,
+                    lines: serialized.split('\n'),
+                  });
+                } catch (err) {
+                  printRichCard({
+                    title: 'Tool Error',
+                    status: 'error',
+                    lines: [err.message],
+                  });
+                }
+                continue;
+              }
+
+
+              const lower = trimmed.toLowerCase();
+              if (lower === 'exit' || lower === 'quit' || lower === 'q') {
+                cancelActiveQuery();
+                break;
+              }
+              if (lower === 'help' || lower === 'h' || lower === '?') {
+                await routeCommand('/help', { ...cmdCtx, sub: '', extra: '', parts: ['/help'] });
+                continue;
+              }
+              if (lower === 'reconnect' || lower === 'connect') {
+                await routeCommand('/model', { ...cmdCtx, sub: 'reconnect', extra: '', parts: ['/model', 'reconnect'] });
+                continue;
+              }
+              if (lower === 'doctor') {
+                await routeCommand('/doctor', { ...cmdCtx, sub: '', extra: '', parts: ['/doctor'] });
+                continue;
+              }
+
+           
+              printSolidPanel({
+                title: 'AI Chat Locked • LM Studio Offline',
+                lines: [
+                  `${C.bold}${C.amber}LM Studio is not running or connected.${C.reset}`,
+                  `${C.white}Chat query typing is disabled until the AI server is active.${C.reset}`,
+                  '',
+                  `${C.bold}${C.white}How to unlock & connect:${C.reset}`,
+                  `  1. Open ${C.cyberCyan}LM Studio${C.reset} on your computer`,
+                  `  2. Load model ${C.gold}${opts.model || client.model || 'google/gemma-4-e4b'}${C.reset} and ensure the local server is running (port 1234)`,
+                  `  3. Type ${C.cyberCyan}/model reconnect${C.reset} in this terminal (or type ${C.cyberCyan}reconnect${C.reset})`,
+                  '',
+                  `${C.dim}Offline commands available: /model reconnect, /help, /provider, /doctor, /theme, /exit${C.reset}`,
+                ],
+                bg: C.bgPanel,
+              });
+              continue;
+            }
+
             const { sanitized, warnings } = sanitizeQuery(trimmed);
             if (warnings.length > 0) {
               printRichCard({
@@ -2037,8 +2245,9 @@ async function main() {
             globalTuiPrompt = null;
           }
           exitAlternateScreen();
-          console.log(`\n  ${C.sakura}Goodbye. (鞠躬 ~ 谢谢!)${C.reset}\n`);
-          process.exit(0);
+          process.stdout.write(`\n  ${C.sakura}Goodbye • 再见 (鞠躬 ~ 谢谢!)${C.reset}\n\n`, () => {
+            process.exit(0);
+          });
         }
 
 process.on('exit', () => {