kiku-agent 1.0.0 → 1.0.3

package/server/agent/ui.js

@@ -1,469 +1,760 @@
-import readline from 'node:readline';
-import { stdin as input, stdout as output } from 'node:process';
-import { eventBus, Events } from './eventBus.js';
-import { AgentStates } from './agentState.js';
-import { ansiBackground, ansiForeground, getThemePalette } from './theme.js';
-
-
-export const C = Object.freeze({
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  italic: '\x1b[3m',
-  underline: '\x1b[4m',
-
-  get sakura() { return ansiForeground(getThemePalette().primary); },
-  get roseGlow() { return ansiForeground(getThemePalette().secondary); },
-  get gold() { return ansiForeground(getThemePalette().highlight); },
-  get amber() { return ansiForeground(getThemePalette().warning); },
-  get cyberCyan() { return ansiForeground(getThemePalette().info); },
-  get emerald() { return ansiForeground(getThemePalette().success); },
-  get lavender() { return ansiForeground(getThemePalette().tertiary); },
-  get slate() { return ansiForeground(getThemePalette().muted); },
-  get darkGray() { return ansiForeground(getThemePalette().subdued); },
-  get white() { return ansiForeground(getThemePalette().text); },
-  get red() { return ansiForeground(getThemePalette().error); },
-  get bgPanel() { return ansiBackground(getThemePalette().panel); },
-  get bgPanelHeader() { return ansiBackground(getThemePalette().panelHeader); },
-  get bgDark() { return ansiBackground(getThemePalette().panel); },
-  get bgTool() { return ansiBackground(getThemePalette().panel); },
-  get bgToolResult() { return ansiBackground(getThemePalette().panel); },
-  get bgToolError() { return ansiBackground(getThemePalette().panel); },
-  get bgThinking() { return ansiBackground(getThemePalette().panel); },
-  get bgResponse() { return ansiBackground(getThemePalette().panel); },
-  get bgError() { return ansiBackground(getThemePalette().panel); },
-});
-
-const _rawStdoutWrite = process.stdout.write.bind(process.stdout);
-const _rawConsoleLog = console.log.bind(console);
-const _rawConsoleClear = console.clear.bind(console);
-
-
-
-export const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-export const processingFrames = spinnerFrames;
-export const thinkingFrames = spinnerFrames;
-export const successFrames = ['OK'];
-export const pulseFrames = ['▓', '▒', '░', '▒', '▓', '█', '▓', '▒'];
-export const INPUT_PLACEHOLDER = 'Ask about Ju Jingyi or type / for commands';
-export const UI_ICONS = Object.freeze({
-  help: '📖',
-  music: '🎵',
-  sponsor: '📢',
-});
-
-const fanNames = ['Mìjú / 蜜橘'];
-export function randomFanName() {
-  return fanNames[Math.floor(Math.random() * fanNames.length)];
-}
-
-
-
-const graphemeSegmenter = typeof Intl?.Segmenter === 'function'
-  ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
-  : null;
-
-function fallbackGraphemeSegments(str) {
-  const segments = [];
-  let index = 0;
-
-  for (const char of Array.from(str)) {
-    const isContinuation = segments.length > 0 && (
-      /^\p{Mark}$/u.test(char) ||
-      /^\p{Emoji_Modifier}$/u.test(char) ||
-      char === '\uFE0F' ||
-      char === '\u20E3' ||
-      segments.at(-1).segment.endsWith('\u200D') ||
-      char === '\u200D'
-    );
-
-    if (isContinuation) {
-      segments.at(-1).segment += char;
-      segments.at(-1).end += char.length;
-    } else {
-      segments.push({ segment: char, index, end: index + char.length });
-    }
-    index += char.length;
-  }
-
-  return segments;
-}
-
-
-export function getGraphemeSegments(str) {
-  if (!str) return [];
-  if (!graphemeSegmenter) return fallbackGraphemeSegments(str);
-  return Array.from(graphemeSegmenter.segment(str), ({ segment, index }) => ({
-    segment,
-    index,
-    end: index + segment.length,
-  }));
-}
-
-export function previousGraphemeBoundary(str, cursor) {
-  const safeCursor = Math.max(0, Math.min(str.length, cursor));
-  let previous = 0;
-  for (const item of getGraphemeSegments(str)) {
-    if (item.end >= safeCursor) return item.index;
-    previous = item.end;
-  }
-  return previous;
-}
-
-export function nextGraphemeBoundary(str, cursor) {
-  const safeCursor = Math.max(0, Math.min(str.length, cursor));
-  for (const item of getGraphemeSegments(str)) {
-    if (item.end > safeCursor) return item.end;
-  }
-  return str.length;
-}
-
-function getGraphemeDisplayWidth(segment) {
-  if (/\p{Extended_Pictographic}|\p{Regional_Indicator}/u.test(segment) || /[\uFE0F\u20E3]/u.test(segment)) {
-    return 2;
-  }
-
-  let width = 0;
-  for (const char of Array.from(segment)) {
-    const code = char.codePointAt(0);
-    if (/^\p{Mark}$/u.test(char) || code === 0x200D || (code >= 0xFE00 && code <= 0xFE0F)) continue;
-    if (
-      (code >= 0x1100 && code <= 0x11FF) ||
-      (code >= 0x2E80 && code <= 0x9FFF) ||
-      (code >= 0xAC00 && code <= 0xD7A3) ||
-      (code >= 0xF900 && code <= 0xFAFF) ||
-      (code >= 0xFE30 && code <= 0xFE4F)
-    ) {
-      width += 2;
-    } else {
-      width += 1;
-    }
-  }
-  return width;
-}
-
-
-export function getStringDisplayWidth(str) {
-  if (!str) return 0;
-  const clean = str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
-  return getGraphemeSegments(clean).reduce((width, item) => width + getGraphemeDisplayWidth(item.segment), 0);
-}
-
-
-export function sliceLineForDisplay(str, cursor, maxWidth) {
-  const segments = getGraphemeSegments(str).map(item => ({
-    ...item,
-    width: getGraphemeDisplayWidth(item.segment),
-  }));
-  const safeMaxWidth = Math.max(1, maxWidth);
-  const totalWidth = segments.reduce((sum, item) => sum + item.width, 0);
-  const safeCursor = Math.max(0, Math.min(str.length, cursor));
-
-  let cursorIndex = segments.findIndex(item => item.index >= safeCursor);
-  if (cursorIndex === -1) cursorIndex = segments.length;
-
-  if (totalWidth <= safeMaxWidth) {
-    return {
-      displayLine: str,
-      cursorVisualOffset: segments.slice(0, cursorIndex).reduce((sum, item) => sum + item.width, 0),
-    };
-  }
-
-  let start = cursorIndex;
-  let end = cursorIndex;
-  let contentWidth = 0;
-  let leftWidth = 0;
-  let rightWidth = 0;
-
-  while (true) {
-    const candidates = [];
-    if (start > 0) {
-      const nextStart = start - 1;
-      const markerWidth = (nextStart > 0 ? 1 : 0) + (end < segments.length ? 1 : 0);
-      const width = segments[nextStart].width;
-      if (contentWidth + width + markerWidth <= safeMaxWidth) {
-        candidates.push({ side: 'left', width, balance: leftWidth });
-      }
-    }
-    if (end < segments.length) {
-      const nextEnd = end + 1;
-      const markerWidth = (start > 0 ? 1 : 0) + (nextEnd < segments.length ? 1 : 0);
-      const width = segments[end].width;
-      if (contentWidth + width + markerWidth <= safeMaxWidth) {
-        candidates.push({ side: 'right', width, balance: rightWidth });
-      }
-    }
-    if (candidates.length === 0) break;
-
-    candidates.sort((a, b) => a.balance - b.balance || a.width - b.width);
-    const selected = candidates[0];
-    if (selected.side === 'left') {
-      start--;
-      leftWidth += selected.width;
-    } else {
-      rightWidth += selected.width;
-      end++;
-    }
-    contentWidth += selected.width;
-  }
-
-  const hasLeftEllipsis = start > 0;
-  const hasRightEllipsis = end < segments.length;
-  const displayLine = `${hasLeftEllipsis ? '…' : ''}${segments.slice(start, end).map(item => item.segment).join('')}${hasRightEllipsis ? '…' : ''}`;
-  const cursorVisualOffset = (hasLeftEllipsis ? 1 : 0) + segments
-    .slice(start, cursorIndex)
-    .reduce((sum, item) => sum + item.width, 0);
-
-  return { displayLine, cursorVisualOffset };
-}
-
-export function getFullWidth() {
-  return process.stdout.columns || 80;
-}
-
-
-
-export function wrapText(text, maxWidth = 72) {
-  if (!text) return [];
-  const lines = [];
-  const rawParagraphs = text.split('\n');
-
-  for (const para of rawParagraphs) {
-    if (!para.trim()) {
-      lines.push('');
-      continue;
-    }
-
-    const words = para.split(/\s+/);
-    let currentLine = '';
-
-    for (const word of words) {
-      if (!word) continue;
-      const testLine = currentLine ? (currentLine + ' ' + word) : word;
-      const testWidth = getStringDisplayWidth(testLine);
-
-      if (testWidth <= maxWidth) {
-        currentLine = testLine;
-      } else {
-        if (currentLine) {
-          lines.push(currentLine);
-          currentLine = word;
-        } else {
-          let chunk = '';
-          for (const ch of word) {
-            if (getStringDisplayWidth(chunk + ch) <= maxWidth) {
-              chunk += ch;
-            } else {
-              lines.push(chunk);
-              chunk = ch;
-            }
-          }
-          currentLine = chunk;
-        }
-      }
-    }
-    if (currentLine) {
-      lines.push(currentLine);
-    }
-  }
-  return lines;
-}
-
-
-
-export function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
-}
-
-
-export function fitStyledText(styledText, maxWidth) {
-  const safeWidth = Math.max(0, maxWidth);
-  let result = '';
-  let usedWidth = 0;
-  const tokens = String(styledText || '').split(/(\x1b\[[0-9;]*[a-zA-Z])/g);
-
-  for (const token of tokens) {
-    if (!token) continue;
-    if (/^\x1b\[[0-9;]*[a-zA-Z]$/.test(token)) {
-      result += token;
-      continue;
-    }
-    for (const item of getGraphemeSegments(token)) {
-      const itemWidth = getGraphemeDisplayWidth(item.segment);
-      if (usedWidth + itemWidth > safeWidth) return result;
-      result += item.segment;
-      usedWidth += itemWidth;
-    }
-  }
-  return result;
-}
-
-
-
-export function printSolidBannerRow(styledText, targetWidth, requestedBg = C.bgPanel, indent = '') {
-  const terminalWidth = getFullWidth();
-  const rowWidth = Math.max(1, Math.min(targetWidth || terminalWidth, terminalWidth) - 1);
-  const contentWidth = Math.max(0, rowWidth - getStringDisplayWidth(indent));
-  const fitted = fitStyledText(styledText, contentWidth);
-  const background = requestedBg === C.bgPanelHeader ? C.bgPanelHeader : C.bgPanel;
-  const fixedStyled = fitted.replace(/\x1b\[0m/g, C.reset + background + C.white);
-
-  console.log(indent + background + C.white + fixedStyled + '\x1b[0K' + C.reset);
-}
-
-export function printSolidPanel({ title, lines, width, indent = '' }) {
-  const w = width || getFullWidth();
-  if (title) {
-    printSolidBannerRow(`${indent}  ${C.bold}${C.roseGlow}${title}${C.reset}`, w, C.bgPanelHeader);
-  }
-  for (const raw of lines) {
-    const text = typeof raw === 'string' ? raw : raw.text;
-    printSolidBannerRow(`${indent}  ${text}`, w, C.bgPanel);
-  }
-  console.log('');
-}
-
-
-
-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(/\[([^\]]+)\]\((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}`)
-    .replace(/\*\*([^*]+)\*\*/g, `${C.bold}${C.white}$1${C.reset}`)
-    .replace(/(?<!\*)\*([^\*\n]+)\*(?!\*)/g, `${C.italic}${C.white}$1${C.reset}`)
-    .replace(/`([^`]+)`/g, `${C.cyberCyan}$1${C.reset}`)
-    .replace(/^(\s*)[*•-]\s+/gm, `$1  ${C.sakura}•${C.reset} `)
-    .replace(/^\s*[-*_]{3,}\s*$/gm, `  ${C.slate}${'─'.repeat(Math.max(20, getFullWidth() - 6))}${C.reset}`);
-}
-
-
-export function parseMarkdownTableRow(text) {
-  const trimmed = String(text || '').trim();
-  if (!trimmed.includes('|')) return null;
-
-  const content = trimmed
-    .replace(/^\|/, '')
-    .replace(/\|$/, '');
-  const cells = content
-    .split(/(?<!\\)\|/)
-    .map(cell => cell.trim().replace(/\\\|/g, '|'));
-
-  return cells.length >= 2 ? cells : null;
-}
-
-
-export function isMarkdownTableSeparator(cells) {
-  return Array.isArray(cells)
-    && cells.length > 0
-    && cells.every(cell => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, '')));
-}
-
-
-export function expandMarkdownLinks(text) {
-  return String(text || '').replace(
-    /\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g,
-    '$1: $2'
-  );
-}
-
-
-
-export function printWelcomeHero() {
-  console.log(`\n${C.sakura}  ██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${C.reset}\n${C.sakura}  ██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${C.reset}\n${C.roseGlow}  █████═╝ ██║█████═╝ ██║   ██║    ███████║██║${C.reset}\n${C.roseGlow}  ██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██║██║${C.reset}\n${C.sakura}  ██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${C.reset}\n${C.sakura}  ╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${C.reset}\n\n${C.bold}${C.roseGlow}Example Questions:${C.reset}\n  ${C.dim}•${C.reset} ${C.white}"What are Ju Jingyi's 2026 upcoming drama series?"${C.reset}\n  ${C.dim}•${C.reset} ${C.white}"Tell me about her Global Brand Ambassador roles in 2026."${C.reset}\n  ${C.dim}•${C.reset} ${C.white}"Search the internet for Ju Jingyi's latest news."${C.reset}\n  ${C.dim}•${C.reset} ${C.white}"What OST songs are from The Blooms at Ruyi Pavilion?"${C.reset}\n${C.lavender}Quick Commands:${C.reset} ${C.cyberCyan}/help${C.reset} ${C.dim}•${C.reset} ${C.emerald}/history${C.reset} ${C.dim}•${C.reset} ${C.emerald}/lang${C.reset} ${C.dim}•${C.reset} ${C.emerald}/session${C.reset} ${C.dim}•${C.reset} ${C.emerald}/tool${C.reset} ${C.dim}•${C.reset} ${C.emerald}/mem${C.reset} ${C.dim}•${C.reset} ${C.emerald}/play${C.reset} ${C.dim}•${C.reset} ${C.emerald}/pause${C.reset} ${C.dim}•${C.reset} ${C.emerald}/next${C.reset} ${C.dim}•${C.reset} ${C.emerald}/search${C.reset} ${C.dim}•${C.reset} ${C.emerald}/current${C.reset} ${C.dim}•${C.reset} ${C.emerald}/ads${C.reset} ${C.dim}(Tab or ↑/↓ to navigate / commands)${C.reset}\n`);
-}
-
-
-
-
-export function setupOutputInterception(tuiPrompt, _isProcessingFn) {
-  let isTuiWriting = false;
-  let isReplaying = false;
-  let resizeTimer = null;
-  const transcript = [];
-  const MAX_TRANSCRIPT_ENTRIES = 2500;
-
-  const remember = (entry) => {
-    if (isReplaying) return;
-    transcript.push(entry);
-    if (transcript.length > MAX_TRANSCRIPT_ENTRIES) {
-      transcript.splice(0, transcript.length - MAX_TRANSCRIPT_ENTRIES);
-    }
-  };
-
-  process.stdout.write = function (chunk, encoding, callback) {
-    if (!isTuiWriting && !isReplaying) remember({ type: 'write', chunk: String(chunk) });
-    if (tuiPrompt && tuiPrompt.activeResolve && !isTuiWriting) {
-      isTuiWriting = true;
-      try {
-        tuiPrompt.clearPrompt();
-        return _rawStdoutWrite(chunk, encoding, callback);
-      } finally {
-        tuiPrompt.render();
-        isTuiWriting = false;
-      }
-    }
-    return _rawStdoutWrite(chunk, encoding, callback);
-  };
-
-  console.log = function (...args) {
-    if (!isReplaying) remember({ type: 'log', args: [...args] });
-    if (tuiPrompt && tuiPrompt.activeResolve && !isTuiWriting) {
-      isTuiWriting = true;
-      try {
-        tuiPrompt.clearPrompt();
-        _rawConsoleLog(...args);
-      } finally {
-        tuiPrompt.render();
-        isTuiWriting = false;
-      }
-    } else {
-      const wasTuiWriting = isTuiWriting;
-      isTuiWriting = true;
-      try { _rawConsoleLog(...args); }
-      finally { isTuiWriting = wasTuiWriting; }
-    }
-  };
-
-  console.clear = function () {
-    transcript.length = 0;
-    _rawConsoleClear();
-  };
-
-  process.stdout.on('resize', () => {
-    if (resizeTimer) clearTimeout(resizeTimer);
-    resizeTimer = setTimeout(() => {
-      resizeTimer = null;
-      if (!tuiPrompt || !tuiPrompt.activeResolve) return;
-
-      isTuiWriting = true;
-      isReplaying = true;
-      try {
-        tuiPrompt.lastRenderedLines = 0;
-        tuiPrompt.hasTopPadding = false;
-        _rawStdoutWrite('\x1b[?25l\x1b[2J\x1b[H');
-        printWelcomeHero();
-        for (const entry of transcript) {
-          if (entry.type === 'log') _rawConsoleLog(...entry.args);
-          else _rawStdoutWrite(entry.chunk);
-        }
-        tuiPrompt.render();
-      } finally {
-        _rawStdoutWrite('\x1b[?25h');
-        isReplaying = false;
-        isTuiWriting = false;
-      }
-    }, 120);
-  });
-}
-
-export function restoreOutput() {
-  process.stdout.write = _rawStdoutWrite;
-  console.log = _rawConsoleLog;
-  console.clear = _rawConsoleClear;
-}
-
-export { _rawStdoutWrite as rawWrite, _rawConsoleLog as rawLog };
+import readline from 'node:readline';
+import { stdin as input, stdout as output } from 'node:process';
+import { eventBus, Events } from './eventBus.js';
+import { AgentStates } from './agentState.js';
+import { ansiBackground, ansiForeground, getThemePalette } from './theme.js';
+
+
+export const C = Object.freeze({
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  underline: '\x1b[4m',
+
+  get sakura() { return ansiForeground(getThemePalette().primary); },
+  get roseGlow() { return ansiForeground(getThemePalette().secondary); },
+  get gold() { return ansiForeground(getThemePalette().highlight); },
+  get amber() { return ansiForeground(getThemePalette().warning); },
+  get cyberCyan() { return ansiForeground(getThemePalette().info); },
+  get emerald() { return ansiForeground(getThemePalette().success); },
+  get lavender() { return ansiForeground(getThemePalette().tertiary); },
+  get slate() { return ansiForeground(getThemePalette().muted); },
+  get darkGray() { return ansiForeground(getThemePalette().subdued); },
+  get white() { return ansiForeground(getThemePalette().text); },
+  get red() { return ansiForeground(getThemePalette().error); },
+  get bgPanel() { return ansiBackground(getThemePalette().panel); },
+  get bgPanelHeader() { return ansiBackground(getThemePalette().panelHeader); },
+  get bgDark() { return ansiBackground(getThemePalette().panel); },
+  get bgTool() { return ansiBackground(getThemePalette().panel); },
+  get bgToolResult() { return ansiBackground(getThemePalette().panel); },
+  get bgToolError() { return ansiBackground(getThemePalette().panel); },
+  get bgThinking() { return ansiBackground(getThemePalette().panel); },
+  get bgResponse() { return ansiBackground(getThemePalette().panel); },
+  get bgError() { return ansiBackground(getThemePalette().panel); },
+});
+
+const _rawStdoutWrite = process.stdout.write.bind(process.stdout);
+const _rawConsoleLog = console.log.bind(console);
+const _rawConsoleClear = console.clear.bind(console);
+
+
+
+export const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+export const processingFrames = spinnerFrames;
+export const thinkingFrames = spinnerFrames;
+export const successFrames = ['OK'];
+export const pulseFrames = ['▓', '▒', '░', '▒', '▓', '█', '▓', '▒'];
+export const INPUT_PLACEHOLDER = 'Ask about Ju Jingyi or type / for commands';
+export const UI_ICONS = Object.freeze({
+  help: '📖',
+  music: '🎵',
+  sponsor: '📢',
+});
+
+const fanNames = ['Mìjú / 蜜橘'];
+export function randomFanName() {
+  return fanNames[Math.floor(Math.random() * fanNames.length)];
+}
+
+
+
+const graphemeSegmenter = typeof Intl?.Segmenter === 'function'
+  ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
+  : null;
+
+function fallbackGraphemeSegments(str) {
+  const segments = [];
+  let index = 0;
+
+  for (const char of Array.from(str)) {
+    const isContinuation = segments.length > 0 && (
+      /^\p{Mark}$/u.test(char) ||
+      /^\p{Emoji_Modifier}$/u.test(char) ||
+      char === '\uFE0F' ||
+      char === '\u20E3' ||
+      segments.at(-1).segment.endsWith('\u200D') ||
+      char === '\u200D'
+    );
+
+    if (isContinuation) {
+      segments.at(-1).segment += char;
+      segments.at(-1).end += char.length;
+    } else {
+      segments.push({ segment: char, index, end: index + char.length });
+    }
+    index += char.length;
+  }
+
+  return segments;
+}
+
+
+export function getGraphemeSegments(str) {
+  if (!str) return [];
+  if (!graphemeSegmenter) return fallbackGraphemeSegments(str);
+  return Array.from(graphemeSegmenter.segment(str), ({ segment, index }) => ({
+    segment,
+    index,
+    end: index + segment.length,
+  }));
+}
+
+export function previousGraphemeBoundary(str, cursor) {
+  const safeCursor = Math.max(0, Math.min(str.length, cursor));
+  let previous = 0;
+  for (const item of getGraphemeSegments(str)) {
+    if (item.end >= safeCursor) return item.index;
+    previous = item.end;
+  }
+  return previous;
+}
+
+export function nextGraphemeBoundary(str, cursor) {
+  const safeCursor = Math.max(0, Math.min(str.length, cursor));
+  for (const item of getGraphemeSegments(str)) {
+    if (item.end > safeCursor) return item.end;
+  }
+  return str.length;
+}
+
+function getGraphemeDisplayWidth(segment) {
+  if (/\p{Extended_Pictographic}|\p{Regional_Indicator}/u.test(segment) || /[\uFE0F\u20E3]/u.test(segment)) {
+    return 2;
+  }
+
+  let width = 0;
+  for (const char of Array.from(segment)) {
+    const code = char.codePointAt(0);
+    if (/^\p{Mark}$/u.test(char) || code === 0x200D || (code >= 0xFE00 && code <= 0xFE0F)) continue;
+    if (
+      (code >= 0x1100 && code <= 0x11FF) ||
+      (code >= 0x2E80 && code <= 0x9FFF) ||
+      (code >= 0xAC00 && code <= 0xD7A3) ||
+      (code >= 0xF900 && code <= 0xFAFF) ||
+      (code >= 0xFE30 && code <= 0xFE4F)
+    ) {
+      width += 2;
+    } else {
+      width += 1;
+    }
+  }
+  return width;
+}
+
+
+export function getStringDisplayWidth(str) {
+  if (!str) return 0;
+  const clean = str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
+  return getGraphemeSegments(clean).reduce((width, item) => width + getGraphemeDisplayWidth(item.segment), 0);
+}
+
+
+export function sliceLineForDisplay(str, cursor, maxWidth) {
+  const segments = getGraphemeSegments(str).map(item => ({
+    ...item,
+    width: getGraphemeDisplayWidth(item.segment),
+  }));
+  const safeMaxWidth = Math.max(1, maxWidth);
+  const totalWidth = segments.reduce((sum, item) => sum + item.width, 0);
+  const safeCursor = Math.max(0, Math.min(str.length, cursor));
+
+  let cursorIndex = segments.findIndex(item => item.index >= safeCursor);
+  if (cursorIndex === -1) cursorIndex = segments.length;
+
+  if (totalWidth <= safeMaxWidth) {
+    return {
+      displayLine: str,
+      cursorVisualOffset: segments.slice(0, cursorIndex).reduce((sum, item) => sum + item.width, 0),
+    };
+  }
+
+  let start = cursorIndex;
+  let end = cursorIndex;
+  let contentWidth = 0;
+  let leftWidth = 0;
+  let rightWidth = 0;
+
+  while (true) {
+    const candidates = [];
+    if (start > 0) {
+      const nextStart = start - 1;
+      const markerWidth = (nextStart > 0 ? 1 : 0) + (end < segments.length ? 1 : 0);
+      const width = segments[nextStart].width;
+      if (contentWidth + width + markerWidth <= safeMaxWidth) {
+        candidates.push({ side: 'left', width, balance: leftWidth });
+      }
+    }
+    if (end < segments.length) {
+      const nextEnd = end + 1;
+      const markerWidth = (start > 0 ? 1 : 0) + (nextEnd < segments.length ? 1 : 0);
+      const width = segments[end].width;
+      if (contentWidth + width + markerWidth <= safeMaxWidth) {
+        candidates.push({ side: 'right', width, balance: rightWidth });
+      }
+    }
+    if (candidates.length === 0) break;
+
+    candidates.sort((a, b) => a.balance - b.balance || a.width - b.width);
+    const selected = candidates[0];
+    if (selected.side === 'left') {
+      start--;
+      leftWidth += selected.width;
+    } else {
+      rightWidth += selected.width;
+      end++;
+    }
+    contentWidth += selected.width;
+  }
+
+  const hasLeftEllipsis = start > 0;
+  const hasRightEllipsis = end < segments.length;
+  const displayLine = `${hasLeftEllipsis ? '…' : ''}${segments.slice(start, end).map(item => item.segment).join('')}${hasRightEllipsis ? '…' : ''}`;
+  const cursorVisualOffset = (hasLeftEllipsis ? 1 : 0) + segments
+    .slice(start, cursorIndex)
+    .reduce((sum, item) => sum + item.width, 0);
+
+  return { displayLine, cursorVisualOffset };
+}
+
+export function getFullWidth() {
+  return process.stdout.columns || 80;
+}
+
+
+
+export function wrapText(text, maxWidth = 72) {
+  if (!text) return [];
+  const lines = [];
+  const rawParagraphs = text.split('\n');
+
+  for (const para of rawParagraphs) {
+    if (!para.trim()) {
+      lines.push('');
+      continue;
+    }
+
+    const words = para.split(/\s+/);
+    let currentLine = '';
+
+    for (const word of words) {
+      if (!word) continue;
+      const testLine = currentLine ? (currentLine + ' ' + word) : word;
+      const testWidth = getStringDisplayWidth(testLine);
+
+      if (testWidth <= maxWidth) {
+        currentLine = testLine;
+      } else {
+        if (currentLine) {
+          lines.push(currentLine);
+          currentLine = word;
+        } else {
+          let chunk = '';
+          for (const ch of word) {
+            if (getStringDisplayWidth(chunk + ch) <= maxWidth) {
+              chunk += ch;
+            } else {
+              lines.push(chunk);
+              chunk = ch;
+            }
+          }
+          currentLine = chunk;
+        }
+      }
+    }
+    if (currentLine) {
+      lines.push(currentLine);
+    }
+  }
+  return lines;
+}
+
+
+
+export function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+
+export function fitStyledText(styledText, maxWidth) {
+  const safeWidth = Math.max(0, maxWidth);
+  let result = '';
+  let usedWidth = 0;
+  const tokens = String(styledText || '').split(/(\x1b\[[0-9;]*[a-zA-Z])/g);
+
+  for (const token of tokens) {
+    if (!token) continue;
+    if (/^\x1b\[[0-9;]*[a-zA-Z]$/.test(token)) {
+      result += token;
+      continue;
+    }
+    for (const item of getGraphemeSegments(token)) {
+      const itemWidth = getGraphemeDisplayWidth(item.segment);
+      if (usedWidth + itemWidth > safeWidth) return result;
+      result += item.segment;
+      usedWidth += itemWidth;
+    }
+  }
+  return result;
+}
+
+
+
+export function printSolidBannerRow(styledText, targetWidth, requestedBg = C.bgPanel, indent = '') {
+  const terminalWidth = getFullWidth();
+  const rowWidth = Math.max(1, Math.min(targetWidth || terminalWidth, terminalWidth) - 1);
+  const contentWidth = Math.max(0, rowWidth - getStringDisplayWidth(indent));
+  const fitted = fitStyledText(styledText, contentWidth);
+  const background = requestedBg === C.bgPanelHeader ? C.bgPanelHeader : C.bgPanel;
+  const fixedStyled = fitted.replace(/\x1b\[0m/g, C.reset + background + C.white);
+
+  console.log(indent + background + C.white + fixedStyled + '\x1b[0K' + C.reset);
+}
+
+export function createProgressRunner({
+  badge = 'RUN',
+  title = 'Processing...',
+  step = '',
+  badgeBg = '\x1b[48;2;14;165;233m\x1b[38;2;15;23;42m',
+} = {}) {
+  const startTime = Date.now();
+  let currentStep = step;
+  let currentTitle = title;
+  let frameIdx = 0;
+  let timer = null;
+  let isStopped = false;
+
+  const renderFrame = () => {
+    if (isStopped) return;
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+    const spinner = spinnerFrames[frameIdx % spinnerFrames.length];
+    frameIdx++;
+
+    const badgeStr = `${badgeBg}${C.bold} ${badge} ${C.reset}`;
+    const spinStr = `${C.sakura}${spinner}${C.reset}`;
+    const titleStr = `${C.bold}${C.white}${currentTitle}${C.reset}`;
+    const stepStr = currentStep ? ` ${C.dim}▸ ${currentStep}${C.reset}` : '';
+    const timeStr = ` ${C.gold}(${elapsed}s)${C.reset}`;
+
+    const line = `  ${badgeStr} ${spinStr} ${titleStr}${stepStr}${timeStr}`;
+    const termWidth = getFullWidth();
+    const fitted = fitStyledText(line, termWidth - 1);
+
+    _rawStdoutWrite(`\r\x1b[2K${fitted}`);
+  };
+
+  timer = setInterval(renderFrame, 80);
+  if (timer.unref) timer.unref();
+  renderFrame();
+
+  return {
+    update({ title: newTitle, step: newStep } = {}) {
+      if (newTitle !== undefined) currentTitle = newTitle;
+      if (newStep !== undefined) currentStep = newStep;
+      renderFrame();
+    },
+    stop() {
+      if (isStopped) return;
+      isStopped = true;
+      if (timer) {
+        clearInterval(timer);
+        timer = null;
+      }
+      _rawStdoutWrite('\r\x1b[2K');
+    },
+    done(options = {}) {
+      this.stop();
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
+      if (typeof options === 'string') {
+        console.log(`\n  \x1b[48;2;16;185;129m\x1b[38;2;15;23;42m${C.bold} OK ${C.reset} ${C.emerald}${options}${C.reset} ${C.dim}(${elapsed}s)${C.reset}\n`);
+      } else if (options && options.panel) {
+        console.log('');
+        printSolidPanel(options.panel);
+      } else if (options && options.title) {
+        console.log('');
+        const lines = options.lines || [];
+        printSolidPanel({
+          title: `${options.title} • ${elapsed}s`,
+          lines,
+          headerBg: options.headerBg,
+          bg: options.bg,
+        });
+      } else if (options && options.message) {
+        console.log(`\n  \x1b[48;2;16;185;129m\x1b[38;2;15;23;42m${C.bold} OK ${C.reset} ${C.emerald}${options.message}${C.reset} ${C.dim}(${elapsed}s)${C.reset}\n`);
+      }
+    },
+    fail(error) {
+      this.stop();
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
+      const errMsg = error?.message || String(error || 'Failed');
+      console.log(`\n  \x1b[48;2;239;68;68m\x1b[38;2;255;255;255m${C.bold} FAILED ${C.reset} ${C.red}${errMsg}${C.reset} ${C.dim}(${elapsed}s)${C.reset}\n`);
+    }
+  };
+}
+
+export function formatSolidPanelLines({ title, lines, width, indent = '', headerBg, bg }) {
+  const w = width || getFullWidth();
+  const rows = [];
+  if (title) {
+    const rawTitle = `${indent}  ${C.bold}${C.roseGlow}${title}${C.reset}`;
+    const fitted = fitStyledText(rawTitle, w);
+    const pad = Math.max(0, w - getStringDisplayWidth(fitted));
+    const hBg = headerBg || C.bgPanelHeader;
+    const themed = fitted.replace(/\x1b\[0m/g, C.reset + hBg + C.white);
+    rows.push(`${hBg}${C.white}${themed}${' '.repeat(pad)}${C.reset}`);
+  }
+  const bodyBg = bg || C.bgPanel;
+  for (const raw of (lines || [])) {
+    const text = typeof raw === 'string' ? raw : (raw?.text ?? '');
+    const sublines = String(text).split('\n');
+    for (const subline of sublines) {
+      const rowText = `${indent}  ${subline}`;
+      const fitted = fitStyledText(rowText, w);
+      const pad = Math.max(0, w - getStringDisplayWidth(fitted));
+      const themed = fitted.replace(/\x1b\[0m/g, C.reset + bodyBg + C.white);
+      rows.push(`${bodyBg}${C.white}${themed}${' '.repeat(pad)}${C.reset}`);
+    }
+  }
+  return rows;
+}
+
+export function printSolidPanel(options) {
+  const rows = formatSolidPanelLines(options);
+  for (const row of rows) {
+    console.log(row);
+  }
+  console.log('');
+}
+
+
+
+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(/\[([^\]]+)\]\((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}`)
+    .replace(/\*\*([^*]+)\*\*/g, `${C.bold}${C.white}$1${C.reset}`)
+    .replace(/(?<!\*)\*([^\*\n]+)\*(?!\*)/g, `${C.italic}${C.white}$1${C.reset}`)
+    .replace(/`([^`]+)`/g, `${C.cyberCyan}$1${C.reset}`)
+    .replace(/^(\s*)[*•-]\s+/gm, `$1  ${C.sakura}•${C.reset} `)
+    .replace(/^\s*[-*_]{3,}\s*$/gm, `  ${C.slate}${'─'.repeat(Math.max(20, getFullWidth() - 6))}${C.reset}`);
+}
+
+
+export function parseMarkdownTableRow(text) {
+  const trimmed = String(text || '').trim();
+  if (!trimmed.includes('|')) return null;
+
+  const content = trimmed
+    .replace(/^\|/, '')
+    .replace(/\|$/, '');
+  const cells = content
+    .split(/(?<!\\)\|/)
+    .map(cell => cell.trim().replace(/\\\|/g, '|'));
+
+  return cells.length >= 2 ? cells : null;
+}
+
+
+export function isMarkdownTableSeparator(cells) {
+  return Array.isArray(cells)
+    && cells.length > 0
+    && cells.every(cell => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, '')));
+}
+
+export function expandMarkdownLinks(text) {
+  return String(text || '').replace(
+    /\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g,
+    '$1: $2'
+  );
+}
+
+export function getWelcomeHeroLines() {
+  return [
+    '',
+    `  ${C.sakura}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${C.reset}   ${C.bold}${C.white}Kiku AI Terminal Agent${C.reset}`,
+    `  ${C.sakura}██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${C.reset}   ${C.gold}v1.0.3${C.reset} ${C.slate}• Intelligent Fan Portal${C.reset}`,
+    `  ${C.roseGlow}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${C.reset}   ${C.cyberCyan}SSOT • DAG • Dynamic Tools${C.reset}`,
+    `  ${C.roseGlow}██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██╗██║${C.reset}   ${C.emerald}LM Studio / Cloud Providers${C.reset}`,
+    `  ${C.sakura}██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${C.reset}`,
+    `  ${C.sakura}╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${C.reset}`,
+    '',
+    `  ${C.bold}${C.gold}Suggested Queries & Topics:${C.reset}`,
+    `  ${C.sakura}• 2026 Works${C.reset}    ${C.white}"What are Ju Jingyi's 2026 upcoming dramas?"${C.reset}`,
+    `  ${C.cyberCyan}• Music & OST${C.reset}   ${C.white}"OSTs from In Blossom & Ruyi Pavilion, /play Ginkgo"${C.reset}`,
+    `  ${C.emerald}• Endorsements${C.reset}  ${C.white}"Versace Global Ambassador & fashion partnerships"${C.reset}`,
+    `  ${C.lavender}• Tools / MCP${C.reset}   ${C.white}"@search_works 2026, /mcp list, /stats, /help"${C.reset}`,
+    '',
+    `  ${C.slate}Shortcuts: [Tab] Autocomplete • [↑/↓] History • [PgUp/PgDn] Scroll • [F2] Details • [Ctrl+C] Exit${C.reset}`,
+    '',
+  ];
+}
+
+export function printWelcomeHero() {
+  const rows = getWelcomeHeroLines();
+  console.log(rows.join('\n'));
+}
+
+
+
+
+export function setupOutputInterception(tuiPrompt, _isProcessingFn) {
+  let isTuiWriting = false;
+  let isReplaying = false;
+  let resizeTimer = null;
+  const transcript = [];
+  const MAX_TRANSCRIPT_ENTRIES = 2500;
+
+  const remember = (entry) => {
+    if (isReplaying) return;
+    transcript.push(entry);
+    if (transcript.length > MAX_TRANSCRIPT_ENTRIES) {
+      transcript.splice(0, transcript.length - MAX_TRANSCRIPT_ENTRIES);
+    }
+  };
+
+  const onResize = () => {
+    if (resizeTimer) clearTimeout(resizeTimer);
+    resizeTimer = setTimeout(() => {
+      resizeTimer = null;
+      if (tuiPrompt && !tuiPrompt.isDisposed && tuiPrompt.screenBuffer) {
+        tuiPrompt.render();
+      }
+    }, 80);
+  };
+
+  process.stdout.on('resize', onResize);
+
+  process.stdout.write = function (chunk, encoding, callback) {
+    if (tuiPrompt && tuiPrompt.screenBuffer && !tuiPrompt.isDisposed && !isTuiWriting) {
+      const str = String(chunk);
+      if (
+        str.startsWith('\x1b[H') ||
+        str.startsWith('\x1b[?1049') ||
+        str.startsWith('\x1b[?25') ||
+        str.startsWith('\x1b[?1000') ||
+        str.startsWith('\x1b[?1002') ||
+        str.startsWith('\x1b[?1006')
+      ) {
+        return _rawStdoutWrite(chunk, encoding, callback);
+      }
+      isTuiWriting = true;
+      try {
+        tuiPrompt.addViewportLines(str);
+      } finally {
+        isTuiWriting = false;
+      }
+      if (typeof callback === 'function') callback();
+      return true;
+    }
+    if (!isTuiWriting && !isReplaying) remember({ type: 'write', chunk: String(chunk) });
+    return _rawStdoutWrite(chunk, encoding, callback);
+  };
+
+  console.log = function (...args) {
+    if (tuiPrompt && tuiPrompt.screenBuffer && !tuiPrompt.isDisposed && !isTuiWriting) {
+      isTuiWriting = true;
+      try {
+        const text = args.map(a => (typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a))).join(' ');
+        tuiPrompt.addViewportLines(text);
+      } finally {
+        isTuiWriting = false;
+      }
+      return;
+    }
+    if (!isReplaying) remember({ type: 'log', args: [...args] });
+    _rawConsoleLog(...args);
+  };
+
+  console.clear = function () {
+    if (tuiPrompt && tuiPrompt.screenBuffer && !tuiPrompt.isDisposed) {
+      tuiPrompt.clearViewport();
+      return;
+    }
+    transcript.length = 0;
+    _rawConsoleClear();
+  };
+
+  return () => {
+    process.stdout.removeListener('resize', onResize);
+    process.stdout.write = _rawStdoutWrite;
+    console.log = _rawConsoleLog;
+    console.clear = _rawConsoleClear;
+  };
+}
+
+export function formatTaskPlanBanner(plan) {
+  if (!plan || !plan.steps || plan.steps.length === 0) return '';
+  const completed = plan.steps.filter(s => s.state === 'complete').length;
+  const total = plan.steps.length;
+  const pct = Math.round((completed / total) * 100);
+  const barFilled = Math.round((completed / total) * 10);
+  const barEmpty = 10 - barFilled;
+  const progressBar = `[${'█'.repeat(barFilled)}${'░'.repeat(barEmpty)}] ${pct}%`;
+
+  const termWidth = Math.min(80, Math.max(20, getFullWidth() - 2));
+  const bg = C.bgPanel;
+  const bgHeader = C.bgPanelHeader;
+
+  const headerText = `  ${C.bold}${C.sakura}◆ Task Plan${C.reset} ${C.slate}•${C.reset} ${C.gold}${progressBar}${C.reset} ${C.slate}(${completed}/${total})${C.reset}`;
+  const rows = [];
+  rows.push(fitStyledText(headerText, termWidth));
+
+  if (plan.question) {
+    const goalText = `  ${C.slate}│${C.reset}  ${C.slate}Goal: "${plan.question.slice(0, 48)}${plan.question.length > 48 ? '…' : ''}"${C.reset}`;
+    rows.push(fitStyledText(goalText, termWidth));
+  }
+
+  for (let i = 0; i < plan.steps.length; i++) {
+    const s = plan.steps[i];
+    const isLast = i === plan.steps.length - 1;
+    const branch = isLast ? '└─' : '├─';
+
+    let icon = `${C.slate}○${C.reset}`;
+    let stateLabel = `${C.slate}pending${C.reset}`;
+
+    if (s.state === 'complete') {
+      icon = `${C.emerald}✓${C.reset}`;
+      stateLabel = `${C.emerald}done${C.reset}`;
+    } else if (s.state === 'running') {
+      icon = `${C.cyberCyan}●${C.reset}`;
+      stateLabel = `${C.cyberCyan}active${C.reset}`;
+    } else if (s.state === 'failed') {
+      icon = `${C.red}✕${C.reset}`;
+      stateLabel = `${C.red}failed${C.reset}`;
+    }
+
+    const stepNum = `${C.slate}Step ${i + 1}:${C.reset}`;
+    const stepTitle = `${C.white}${s.label || s.id}${C.reset}`;
+    const maxObjLen = Math.max(10, termWidth - getStringDisplayWidth(s.label || s.id) - 36);
+    const objText = s.objective && maxObjLen > 6 ? ` ${C.slate}— ${s.objective.slice(0, maxObjLen)}${s.objective.length > maxObjLen ? '…' : ''}${C.reset}` : '';
+
+    const lineText = `  ${C.slate}${branch}${C.reset} ${icon} ${stepNum} ${stepTitle}${objText} ${C.slate}[${C.reset}${stateLabel}${C.slate}]${C.reset}`;
+    rows.push(fitStyledText(lineText, termWidth));
+  }
+
+  return rows.map((r, idx) => {
+    const currentBg = idx === 0 ? bgHeader : bg;
+    const padding = Math.max(0, termWidth - getStringDisplayWidth(r));
+    const styled = r.replace(/\x1b\[0m/g, C.reset + currentBg + C.white);
+    return `${currentBg}${C.white}${styled}${' '.repeat(padding)}${C.reset}`;
+  }).join('\n');
+}
+
+export function enterAlternateScreen() {
+  if (process.stdout.isTTY) {
+    _rawStdoutWrite('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1005l\x1b[?1006l\x1b[?25l\x1b[H\x1b[2J');
+  }
+}
+
+export function exitAlternateScreen() {
+  if (process.stdout.isTTY) {
+    _rawStdoutWrite('\x1b[?1006l\x1b[?1005l\x1b[?1003l\x1b[?1002l\x1b[?1000l\x1b[?1049l\x1b[?25h\x1b[0m\r\n');
+  }
+}
+
+export class VirtualScreenBuffer {
+  constructor(width = 80, height = 24, writer = null) {
+    this.width = Math.max(10, width);
+    this.height = Math.max(5, height);
+    this.writer = writer || _rawStdoutWrite;
+    this.rows = new Array(this.height).fill('');
+    this.prevRows = new Array(this.height).fill('');
+    this.cursorRow = 0;
+    this.cursorCol = 0;
+    this.showCursor = true;
+    this.prevCursorRow = -1;
+    this.prevCursorCol = -1;
+    this.prevShowCursor = false;
+    this.forceFullRedraw = true;
+  }
+
+  resize(width, height) {
+    const newWidth = Math.max(10, width);
+    const newHeight = Math.max(5, height);
+    if (newWidth !== this.width || newHeight !== this.height) {
+      this.width = newWidth;
+      this.height = newHeight;
+      this.rows = new Array(this.height).fill('');
+      this.prevRows = new Array(this.height).fill('');
+      this.forceFullRedraw = true;
+    }
+  }
+
+  clear(bg = '') {
+    const safeW = Math.max(1, this.width - 1);
+    const blank = bg ? `${bg}${' '.repeat(safeW)}${C.reset}` : ' '.repeat(safeW);
+    this.rows.fill(blank);
+  }
+
+  setRow(y, styledText, bg = '') {
+    if (y < 0 || y >= this.height) return;
+    const safeW = Math.max(1, this.width - 1);
+    const fitted = fitStyledText(styledText, safeW);
+    const textWidth = getStringDisplayWidth(fitted);
+    const pad = Math.max(0, safeW - textWidth);
+    if (bg) {
+      const themed = fitted.replace(/\x1b\[0m/g, C.reset + bg + C.white);
+      this.rows[y] = `${bg}${C.white}${themed}${' '.repeat(pad)}${C.reset}`;
+    } else {
+      this.rows[y] = `${fitted}${' '.repeat(pad)}${C.reset}`;
+    }
+  }
+
+  setCursor(row, col, visible = true) {
+    this.cursorRow = Math.max(0, Math.min(this.height - 1, row));
+    this.cursorCol = Math.max(0, Math.min(this.width - 1, col));
+    this.showCursor = visible;
+  }
+
+  render() {
+    let output = '';
+    let hasChanges = false;
+
+    if (this.forceFullRedraw) {
+      output += '\x1b[?25l';
+      for (let i = 0; i < this.height; i++) {
+        output += `\x1b[${i + 1};1H${this.rows[i] || ''}`;
+        this.prevRows[i] = this.rows[i];
+      }
+      this.forceFullRedraw = false;
+      hasChanges = true;
+    } else {
+      for (let i = 0; i < this.height; i++) {
+        if (this.rows[i] !== this.prevRows[i]) {
+          if (!hasChanges) {
+            output += '\x1b[?25l';
+            hasChanges = true;
+          }
+          output += `\x1b[${i + 1};1H${this.rows[i] || ''}`;
+          this.prevRows[i] = this.rows[i];
+        }
+      }
+    }
+
+    const cursorChanged =
+      this.cursorRow !== this.prevCursorRow ||
+      this.cursorCol !== this.prevCursorCol ||
+      this.showCursor !== this.prevShowCursor;
+
+    if (hasChanges || cursorChanged) {
+      if (this.showCursor) {
+        output += `\x1b[${this.cursorRow + 1};${this.cursorCol + 1}H\x1b[?25h`;
+      } else if (!this.showCursor && hasChanges) {
+        output += '\x1b[?25l';
+      }
+      this.prevCursorRow = this.cursorRow;
+      this.prevCursorCol = this.cursorCol;
+      this.prevShowCursor = this.showCursor;
+    }
+
+    if (output) {
+      this.writer(output);
+    }
+  }
+}
+
+export { _rawStdoutWrite as rawWrite, _rawConsoleLog as rawLog };