kiku-agent 1.0.9 → 1.0.11

package/server/agent/terminalImage.js

@@ -196,7 +196,7 @@ export function renderJpegFile(filePath, options = {}) {
   return renderJpegToAnsi(readFileSync(filePath), options);
 }
 
-function discoverImages(directory) {
+export function discoverImages(directory) {
   try {
     return readdirSync(directory, { withFileTypes: true })
       .filter(entry => entry.isFile() && /\.jpe?g$/i.test(entry.name))
@@ -207,6 +207,89 @@ function discoverImages(directory) {
   }
 }
 
+export function renderTwoImagesSideBySide(filePath1, filePath2, {
+  columns = process.stdout.columns || 80,
+  rows = process.stdout.rows || 24,
+  maxRows = 14,
+} = {}) {
+  const availableWidth = Math.max(20, Math.floor(columns));
+  const sideBySide = availableWidth >= 76;
+  const singleMaxWidth = sideBySide ? Math.min(34, Math.floor((availableWidth - 8) / 2)) : Math.min(50, availableWidth - 4);
+
+  const img1 = renderJpegFile(filePath1, {
+    columns: singleMaxWidth + 4,
+    rows,
+    maxWidth: singleMaxWidth,
+    maxRows,
+    indent: '',
+  });
+
+  const img2 = renderJpegFile(filePath2, {
+    columns: singleMaxWidth + 4,
+    rows,
+    maxWidth: singleMaxWidth,
+    maxRows,
+    indent: '',
+  });
+
+  if (!sideBySide) {
+    return [
+      ...img1.map(line => `  ${line}`),
+      '',
+      ...img2.map(line => `  ${line}`),
+    ];
+  }
+
+  const maxLines = Math.max(img1.length, img2.length);
+  const combined = [];
+  const gap = '    ';
+
+  for (let i = 0; i < maxLines; i++) {
+    const line1 = img1[i] || '';
+    const line2 = img2[i] || '';
+    combined.push(`  ${line1}${gap}${line2}`);
+  }
+
+  return combined;
+}
+
+export function getWelcomeGalleryLines(count = 2, {
+  directory = DEFAULT_IMAGE_DIRECTORY,
+  env = process.env,
+  isTTY = process.stdout.isTTY,
+  columns = process.stdout.columns || 80,
+  rows = process.stdout.rows || 24,
+} = {}) {
+  const images = discoverImages(directory);
+  if (images.length === 0 || !supportsTerminalImages({ env, isTTY })) return [];
+
+  if (count >= 2 && images.length >= 2) {
+    try {
+      const pairLines = renderTwoImagesSideBySide(images[0], images[1], { columns, rows, maxRows: 14 });
+      return [
+        '',
+        `  \x1b[1m\x1b[38;2;255;126;179m◆ JU JINGYI • 鞠婧祎 GALLERY\x1b[0m \x1b[38;2;148;163;184m• Featured Visuals (1 & 2 / ${images.length})\x1b[0m`,
+        ...pairLines,
+        '',
+      ];
+    } catch {
+      return [];
+    }
+  }
+
+  try {
+    const singleLines = renderJpegFile(images[0], { columns, rows, maxWidth: 44, maxRows: 14 });
+    return [
+      '',
+      `  \x1b[1m\x1b[38;2;255;126;179m◆ JU JINGYI • 鞠婧祎 GALLERY\x1b[0m \x1b[38;2;148;163;184m• Featured Visual (1/${images.length})\x1b[0m`,
+      ...singleLines,
+      '',
+    ];
+  } catch {
+    return [];
+  }
+}
+
 export function createTerminalImageGallery({
   directory = DEFAULT_IMAGE_DIRECTORY,
   frequency = 3,
@@ -222,10 +305,32 @@ export function createTerminalImageGallery({
   return {
     enabled,
     imageCount: images.length,
-    maybeRender(completedQueries = 0, { force = false } = {}) {
+    maybeRender(completedQueries = 0, { force = false, count = 1 } = {}) {
       const cadence = Math.max(1, Math.floor(frequency));
       if (!enabled || (!force && (completedQueries <= 0 || completedQueries % cadence !== 0))) return [];
 
+      if (count >= 2 && images.length >= 2) {
+        const idx1 = imageIndex % images.length;
+        const idx2 = (imageIndex + 1) % images.length;
+        const path1 = images[idx1];
+        const path2 = images[idx2];
+        try {
+          const pairLines = renderTwoImagesSideBySide(path1, path2, {
+            columns: getColumns(),
+            rows: getRows(),
+          });
+          imageIndex = (imageIndex + 2) % images.length;
+          return [
+            '',
+            `  \x1b[1m\x1b[38;2;255;126;179m◆ KIKU GALLERY\x1b[0m \x1b[38;2;148;163;184m• Photos ${idx1 + 1} & ${idx2 + 1}/${images.length}\x1b[0m`,
+            ...pairLines,
+            '',
+          ];
+        } catch {
+          return [];
+        }
+      }
+
       const currentIndex = imageIndex % images.length;
       const filePath = images[currentIndex];
       try {
@@ -246,3 +351,4 @@ export function createTerminalImageGallery({
     },
   };
 }
+

package/server/agent/ui.js

@@ -130,9 +130,13 @@ function getGraphemeDisplayWidth(segment) {
     if (
       (code >= 0x1100 && code <= 0x11FF) ||
       (code >= 0x2E80 && code <= 0x9FFF) ||
+      (code >= 0x3000 && code <= 0x303F) ||
       (code >= 0xAC00 && code <= 0xD7A3) ||
       (code >= 0xF900 && code <= 0xFAFF) ||
-      (code >= 0xFE30 && code <= 0xFE4F)
+      (code >= 0xFE30 && code <= 0xFE4F) ||
+      (code >= 0xFF01 && code <= 0xFF60) ||  
+      (code >= 0xFFE0 && code <= 0xFFE6) ||
+      (code >= 0x20000 && code <= 0x3FFFF) 
     ) {
       width += 2;
     } else {
@@ -297,7 +301,7 @@ export function wrapText(text, maxWidth = 72) {
 
 
 export function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
+  return String(str ?? '').replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))/g, '');
 }
 
 export function sanitizeTerminalText(value, maxLength = 2000) {
@@ -751,8 +755,8 @@ export function formatTerminalMarkdown(text) {
   if (!text) return '';
   return text
     .replace(/^###\s*(.+)$/gm, `${C.bold}${C.gold}✦ $1${C.reset}`)
-    .replace(/^##\s*(.+)$/gm, `\n${C.bold}${C.roseGlow}■ $1${C.reset}`)
-    .replace(/^#\s*(.+)$/gm, `\n${C.bold}${C.sakura}━━━ $1 ━━━${C.reset}`)
+    .replace(/^##\s*(.+)$/gm, `${C.bold}${C.roseGlow}■ $1${C.reset}`)
+    .replace(/^#\s*(.+)$/gm, `${C.bold}${C.sakura}━━━ $1 ━━━${C.reset}`)
     .replace(/^>\s*(.+)$/gm, `  ${C.slate}│${C.reset} ${C.italic}${C.white}$1${C.reset}`)
     .replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, `${C.bold}${C.cyberCyan}$1${C.reset} ➔ ${C.underline}${C.roseGlow}$2${C.reset}`)
     .replace(/\*{3}([^*]+)\*{3}/g, `${C.bold}${C.italic}${C.white}$1${C.reset}`)
@@ -854,7 +858,7 @@ export function formatMarkdownLines(text, maxWidth = getFullWidth() - 8) {
   return result;
 }
 
-export function getWelcomeHeroLines() {
+export function getWelcomeHeroLines() {
   const p = C.sakura;
   const r = C.roseGlow;
   const g = C.gold;
@@ -866,8 +870,8 @@ export function getWelcomeHeroLines() {
   const b = C.bold;
   const d = C.dim;
   const rst = C.reset;
-  const boxWidth = Math.min(84, Math.max(50, getFullWidth() - 4));
-  const compact = getFullWidth() < 120;
+  const boxWidth = Math.min(84, Math.max(50, getFullWidth() - 4));
+  const compact = getFullWidth() < 120;
   const headerTitle = 'Suggested Topics & Queries';
   const topDashCount = Math.max(2, boxWidth - getStringDisplayWidth(headerTitle) - 6);
   const innerWidth = boxWidth - 2;
@@ -880,28 +884,30 @@ export function getWelcomeHeroLines() {
     return `  ${s}│${rst}  ${icon} ${tag}${rst}${' '.repeat(Math.max(0, tagWidth - getStringDisplayWidth(tag)))}  ${w}${text}${rst}${' '.repeat(pad)}${s}│${rst}`;
   };
 
-  const heroLines = compact ? [
-    `  ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
-    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}`,
-    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}`,
-  ] : [
-    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}   ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
-    `  ${p}██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${rst}   ${d}${s}Interactive Fan Knowledge Base & Autonomous Agent${rst}`,
-    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}   ${d}${s}Filmography • Discography • Fashion & Awards${rst}`,
-    `  ${r}██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██╗██║${rst}   ${c}● Live Ready${rst} ${s}• Multilingual (CN / EN / TH)${rst}`,
-    `  ${p}██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${rst}`,
-    `  ${p}╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${rst}`,
-  ];
-  const shortcutLines = compact ? [
-    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Commands • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[F2]${rst} ${s}Details${rst}`,
-    `  ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
-  ] : [
-    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Autocomplete • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[F2]${rst} ${s}Details • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
-  ];
-
-  return [
-    ...(compact ? [] : ['']),
-    ...heroLines,
+  const heroLines = compact ? [
+    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}`,
+    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}`,
+    `  ${p}██║  ██║██║██║  ██║╚██████╔╝    ██║  ██║██║${rst}`,
+  ] : [
+    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}`,
+    `  ${p}██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${rst}`,
+    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}`,
+    `  ${r}██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██╗██║${rst}`,
+    `  ${p}██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${rst}`,
+    `  ${p}╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${rst}`,
+  ];
+  const shortcutLines = compact ? [
+    `  ${s}Keys: ${b}${w}[Tab]${rst} ${s}Cmds • ${b}${w}[↑/↓]${rst} ${s}Hist • ${b}${w}[F1]${rst} ${s}Help • ${b}${w}[F2]${rst} ${s}Details${rst}`,
+    `  ${b}${w}[F3]${rst} ${s}Think • ${b}${w}[F4]${rst} ${s}Tools • ${b}${w}[F5]${rst} ${s}Copy • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
+  ] : [
+    `  ${s}Keys:  ${b}${w}[Tab]${rst} ${s}Autocomplete • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
+    `  ${s}F-Keys: ${b}${w}[F1]${rst} ${s}Help • ${b}${w}[F2]${rst} ${s}Details • ${b}${w}[F3]${rst} ${s}Thinking • ${b}${w}[F4]${rst} ${s}Tools • ${b}${w}[F5]${rst} ${s}Copy • ${b}${w}[F6]${rst} ${s}Gallery • ${b}${w}[F7]${rst} ${s}Theme${rst}`,
+    `  ${s}Ctrl:  ${b}${w}[Ctrl+T]${rst} ${s}Toggle Think • ${b}${w}[Ctrl+R]${rst} ${s}Retry • ${b}${w}[Ctrl+S]${rst} ${s}Save • ${b}${w}[Ctrl+G]${rst} ${s}Gallery${rst}`,
+  ];
+
+  return [
+    ...(compact ? [] : ['']),
+    ...heroLines,
     '',
     `  ${s}╭──${rst} ${b}${g}${headerTitle}${rst} ${s}${'─'.repeat(topDashCount)}╮${rst}`,
     padItem(p + '◆', '2026 Works', '"What are Ju Jingyi\'s 2026 upcoming dramas?"'),
@@ -910,7 +916,7 @@ export function getWelcomeHeroLines() {
     padItem(l + '◆', 'Tools / MCP', '"@search_works 2026, /mcp list, /stats, /help"'),
     `  ${s}╰${'─'.repeat(boxWidth)}╯${rst}`,
     '',
-    ...shortcutLines,
+    ...shortcutLines,
     '',
   ];
 }
@@ -1068,19 +1074,23 @@ export function formatTaskPlanBanner(plan) {
   }).join('\n');
 }
 
+let isAlternateScreenActive = false;
+
 export function enterAlternateScreen() {
-  if (process.stdout.isTTY) {
+  if (process.stdout.isTTY && !isAlternateScreenActive) {
+    isAlternateScreenActive = true;
     _rawStdoutWrite('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1005l\x1b[?1006l\x1b[?1015l\x1b[?25l\x1b[H\x1b[2J');
   }
 }
 
 export function exitAlternateScreen() {
-  if (process.stdout.isTTY) {
-    _rawStdoutWrite('\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1005l\x1b[?1006l\x1b[?1015l\x1b[?1049l\x1b[?25h\x1b[0m\r\n');
+  if (process.stdout.isTTY && isAlternateScreenActive) {
+    isAlternateScreenActive = false;
+    _rawStdoutWrite('\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1005l\x1b[?1006l\x1b[?1015l\x1b[?1049l\x1b[?25h\x1b[0m');
   }
 }
 
-export function getTuiViewportLayout(termRows = 24) {
+export function getTuiViewportLayout(termRows = 24) {
   const parsedRows = Number(termRows);
   const rows = Math.max(10, Number.isFinite(parsedRows) ? Math.floor(parsedRows) : 24);
   const viewportStartRow = 1;
@@ -1095,16 +1105,16 @@ export function getTuiViewportLayout(termRows = 24) {
     statusBarRow,
     promptRow,
     separatorRow,
-  };
-}
-
-export function getNewOutputScrollOffset(addedLineCount, termRows = 24, currentOffset = 0) {
-  const added = Math.max(0, Number.isFinite(Number(addedLineCount)) ? Math.floor(Number(addedLineCount)) : 0);
-  if (currentOffset > 0) return currentOffset + added;
-  return Math.max(0, added - getTuiViewportLayout(termRows).viewportHeight);
-}
-
-export class VirtualScreenBuffer {
+  };
+}
+
+export function getNewOutputScrollOffset(addedLineCount, termRows = 24, currentOffset = 0) {
+  const added = Math.max(0, Number.isFinite(Number(addedLineCount)) ? Math.floor(Number(addedLineCount)) : 0);
+  if (currentOffset > 0) return currentOffset + added;
+  return Math.max(0, added - getTuiViewportLayout(termRows).viewportHeight);
+}
+
+export class VirtualScreenBuffer {
   constructor(width = 80, height = 24, writer = null) {
     this.width = Math.max(10, width);
     this.height = Math.max(5, height);