xshat-lite 1.0.0

package/src/modules/response-pipeline.mjs

@@ -0,0 +1,211 @@
+import {
+  isStructuredResponseIncomplete,
+  parseAgentResponse
+} from './response-parser.mjs';
+import { getAgentRoleLabel } from './multi-agent.mjs';
+
+const INTERNAL_COMMANDS = new Set([
+  'get_app_state',
+  'read_agent_page',
+  'extract_selector_text',
+  'inspect_dom'
+]);
+
+function normalizeDisplayLine(line) {
+  const value = String(line ?? '').replace(/[ \t]+$/g, '');
+
+  if (/^\s*[•●▪◦·‣]\s+/.test(value)) {
+    return value.replace(/^(\s*)[•●▪◦·‣]\s+/, '$1- ');
+  }
+
+  if (/^\s*\d+[\)\]]\s+/.test(value)) {
+    return value.replace(/^(\s*)(\d+)[\)\]]\s+/, '$1$2. ');
+  }
+
+  return value;
+}
+
+function isFillerLine(line) {
+  const value = String(line ?? '').trim();
+  if (!value || value.length > 20) {
+    return false;
+  }
+
+  return [
+    /^(当然可以|可以|好的|好|没问题|行|如下)[。！!：:]*$/i,
+    /^(下面是|以下是)(结果|说明|整理|内容)?[：:]*$/i,
+    /^(sure|certainly|okay|ok)[.!:]*$/i,
+    /^(here(?:'s| is))( the)?( result| summary| answer)?[.:]*$/i
+  ].some((pattern) => pattern.test(value));
+}
+
+function isWeakClosingLine(line) {
+  const value = String(line ?? '').trim();
+  if (!value || value.length > 36) {
+    return false;
+  }
+
+  return [
+    /^希望这对你有帮助[。！!]*$/i,
+    /^有需要.*(继续|再调|再改|告诉我)[。！!]*$/i,
+    /^如果你需要.*(继续|细化|展开|补充)[。！!]*$/i,
+    /^如需.*(继续|细化|展开|补充)[。！!]*$/i,
+    /^(hope this helps)[.!]*$/i,
+    /^(let me know|tell me) if you (want|need).*[.!]*$/i
+  ].some((pattern) => pattern.test(value));
+}
+
+function pruneFillerLines(text = '') {
+  const lines = String(text ?? '').split('\n');
+
+  while (lines.length > 1 && isFillerLine(lines[0])) {
+    lines.shift();
+  }
+
+  while (lines.length > 1 && isWeakClosingLine(lines.at(-1))) {
+    lines.pop();
+  }
+
+  return lines.join('\n');
+}
+
+function normalizeDisplayText(text = '') {
+  const normalized = pruneFillerLines(
+    String(text ?? '')
+  )
+    .replace(/\u200B/g, '')
+    .replace(/\r/g, '')
+    .replace(/[ \t]+\n/g, '\n')
+    .split('\n')
+    .map((line) => normalizeDisplayLine(line))
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+
+  return normalized;
+}
+
+function containsMarkdownMarkers(text = '') {
+  const value = String(text ?? '');
+  return (
+    /(^|\n)```/.test(value) ||
+    /(^|\n)#{1,6}\s+/.test(value) ||
+    /(^|\n)>\s+/.test(value) ||
+    /(^|\n)[*-]\s+/.test(value) ||
+    /(^|\n)\d+\.\s+/.test(value) ||
+    /(^|\n)\|.+\|/.test(value) ||
+    /(^|\n)-{3,}($|\n)/.test(value)
+  );
+}
+
+function splitNaturalSentences(text = '') {
+  return String(text ?? '')
+    .match(/[^。！？!?；;]+[。！？!?；;]?/g)?.map((part) => part.trim()).filter(Boolean) || [];
+}
+
+function formatCliFriendlyText(text = '') {
+  const value = normalizeDisplayText(text);
+
+  if (!value || value.includes('\n') || containsMarkdownMarkers(value)) {
+    return value;
+  }
+
+  if (value.length < 90 || value.length > 520) {
+    return value;
+  }
+
+  const sentences = splitNaturalSentences(value);
+  if (sentences.length < 3 || sentences.length > 6) {
+    return value;
+  }
+
+  if (sentences.some((sentence) => sentence.length < 4 || sentence.length > 88)) {
+    return value;
+  }
+
+  return sentences.map((sentence) => `- ${sentence}`).join('\n');
+}
+
+function detectMarkdown(text) {
+  const value = normalizeDisplayText(text);
+  return containsMarkdownMarkers(value);
+}
+
+function shouldPreferInline(text, renderAs) {
+  const value = normalizeDisplayText(text);
+  if (!value || renderAs !== 'text') {
+    return false;
+  }
+
+  return !value.includes('\n') && value.length <= 88;
+}
+
+function shouldStreamAsMarkdown(text = '') {
+  const value = normalizeDisplayText(text);
+  if (!value) {
+    return false;
+  }
+
+  return (
+    value.includes('\n') ||
+    /(^|\n)#{1,6}\s+/.test(value) ||
+    /(^|\n)[*-]\s+/.test(value) ||
+    /(^|\n)\d+\.\s+/.test(value) ||
+    /(^|\n)>\s+/.test(value) ||
+    /(^|\n)```/.test(value)
+  );
+}
+
+export function isInterruptedTurnResponse(text = '') {
+  const value = String(text ?? '').trim();
+  if (!value) {
+    return false;
+  }
+
+  return [
+    /你已让系统停止这条回答/,
+    /你已停止这条回答/,
+    /you stopped this response/i,
+    /response was stopped/i,
+    /stopped generating/i
+  ].some((pattern) => pattern.test(value));
+}
+
+export function normalizeResponseEnvelope(rawText, {
+  agentMode = false
+} = {}) {
+  const parsed = parseAgentResponse(rawText);
+  const text = formatCliFriendlyText(parsed.text || '');
+  const renderAs = detectMarkdown(text) ? 'markdown' : 'text';
+  const incompleteStructured = isStructuredResponseIncomplete(rawText);
+  const consoleBaseText =
+    incompleteStructured
+      ? '正在等待网页模型补全结构化回复...'
+      : parsed.command && INTERNAL_COMMANDS.has(parsed.command.name)
+        ? ''
+        : text;
+  const consoleText = formatCliFriendlyText(consoleBaseText);
+  const consoleTextRenderAs = detectMarkdown(consoleText) ? 'markdown' : 'text';
+  const kind = parsed.command
+    ? 'command'
+    : parsed.type === 'handoff'
+      ? 'handoff'
+      : 'message';
+
+  return {
+    ...parsed,
+    text,
+    displayText: text,
+    agentMode,
+    kind,
+    agentLabel: parsed.agent ? getAgentRoleLabel(parsed.agent) : '',
+    consoleText,
+    consoleTextRenderAs,
+    incompleteStructured,
+    renderAs,
+    inlinePreferred: shouldPreferInline(text, renderAs),
+    consoleInlinePreferred: shouldPreferInline(consoleText, consoleTextRenderAs),
+    streamMarkdownPreferred: shouldStreamAsMarkdown(text),
+    consoleStreamMarkdownPreferred: shouldStreamAsMarkdown(consoleText)
+  };
+}

package/src/modules/runtime-maintenance.mjs

@@ -0,0 +1,195 @@
+import fs from 'node:fs/promises';
+import { basename, dirname, extname, resolve } from 'node:path';
+import config from '../utils/config.mjs';
+
+function nowStamp() {
+  return new Date().toISOString().replace(/[:.]/g, '-');
+}
+
+async function ensureDir(path) {
+  await fs.mkdir(path, { recursive: true });
+}
+
+async function pathExists(path) {
+  try {
+    await fs.access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function getDirectoryEntries(dir, {
+  skip = new Set()
+} = {}) {
+  try {
+    const names = await fs.readdir(dir);
+    return names.filter((name) => !skip.has(name));
+  } catch {
+    return [];
+  }
+}
+
+async function getFileStatSafe(path) {
+  try {
+    return await fs.stat(path);
+  } catch {
+    return null;
+  }
+}
+
+async function removeTempFiles(dir) {
+  const entries = await getDirectoryEntries(dir);
+  let removed = 0;
+
+  for (const name of entries) {
+    if (!name.endsWith('.tmp')) {
+      continue;
+    }
+
+    try {
+      await fs.rm(resolve(dir, name), { force: true });
+      removed++;
+    } catch {
+      // ignore cleanup failure
+    }
+  }
+
+  return removed;
+}
+
+async function archiveOverflowFiles(sourceDir, archiveRoot, bucketName, retention, {
+  skip = new Set()
+} = {}) {
+  const names = await getDirectoryEntries(sourceDir, { skip });
+  const files = [];
+
+  for (const name of names) {
+    const fullPath = resolve(sourceDir, name);
+    const stat = await getFileStatSafe(fullPath);
+    if (!stat?.isFile()) {
+      continue;
+    }
+
+    files.push({
+      name,
+      path: fullPath,
+      mtimeMs: stat.mtimeMs
+    });
+  }
+
+  files.sort((a, b) => b.mtimeMs - a.mtimeMs);
+  const overflow = files.slice(Math.max(0, retention));
+  if (!overflow.length) {
+    return 0;
+  }
+
+  const archiveDir = resolve(archiveRoot, bucketName);
+  await ensureDir(archiveDir);
+  let moved = 0;
+
+  for (const file of overflow) {
+    const ext = extname(file.name);
+    const base = basename(file.name, ext);
+    const target = resolve(archiveDir, `${base}.${nowStamp()}${ext}`);
+    try {
+      await fs.rename(file.path, target);
+      moved++;
+    } catch {
+      // ignore single-file archive failure
+    }
+  }
+
+  return moved;
+}
+
+async function calculateDirSize(dir) {
+  let total = 0;
+  const stack = [dir];
+
+  while (stack.length > 0) {
+    const current = stack.pop();
+    let entries = [];
+
+    try {
+      entries = await fs.readdir(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+
+    for (const entry of entries) {
+      const fullPath = resolve(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+
+      try {
+        const stat = await fs.stat(fullPath);
+        total += stat.size;
+      } catch {
+        // ignore broken files
+      }
+    }
+  }
+
+  return total;
+}
+
+export async function runRuntimeMaintenance() {
+  const summary = {
+    tempRemoved: 0,
+    sessionsArchived: 0,
+    tasksArchived: 0,
+    profileWarning: null
+  };
+
+  if (!config.storage?.cleanupOnStart) {
+    return summary;
+  }
+
+  const archiveRoot = config.storage.archiveDir;
+  await ensureDir(archiveRoot);
+
+  if (config.storage.removeTempFilesOnStart) {
+    summary.tempRemoved += await removeTempFiles(config.session.dir);
+    summary.tempRemoved += await removeTempFiles(config.tasks.dir);
+    summary.tempRemoved += await removeTempFiles(dirname(resolve(config.logger.dir, config.logger.filename)));
+  }
+
+  summary.sessionsArchived = await archiveOverflowFiles(
+    config.session.dir,
+    archiveRoot,
+    'sessions',
+    Math.max(0, Number(config.storage.sessionRetention) || 0),
+    { skip: new Set(['_index.json']) }
+  );
+
+  summary.tasksArchived = await archiveOverflowFiles(
+    config.tasks.dir,
+    archiveRoot,
+    'tasks',
+    Math.max(0, Number(config.storage.taskRetention) || 0),
+    { skip: new Set(['_index.json']) }
+  );
+
+  if (await pathExists(config.browser.userDataDir)) {
+    const bytes = await calculateDirSize(config.browser.userDataDir);
+    const sizeMb = bytes / (1024 * 1024);
+    const thresholdMb = Math.max(1, Number(config.storage.profileWarningSizeMb) || 1024);
+
+    if (sizeMb >= thresholdMb) {
+      summary.profileWarning = {
+        sizeMb: Number(sizeMb.toFixed(1)),
+        thresholdMb
+      };
+    }
+  }
+
+  return summary;
+}
+
+export default {
+  runRuntimeMaintenance
+};
+

package/src/modules/session-browser.mjs

@@ -0,0 +1,180 @@
+import { confirm, input as promptInput, select } from '@inquirer/prompts';
+import { waitForKeypress } from '../utils/key-input.mjs';
+
+function formatSessionLine(session, globalIndex) {
+  const date = new Date(session.updatedAt).toLocaleString('zh-CN', {
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false
+  });
+  return `[${String(globalIndex).padStart(2)}] ${session.title} | ${session.provider} | ${session.messageCount}条 | ${date}`;
+}
+
+export async function browseSessions({
+  sessionManager,
+  ui,
+  initialKeyword = ''
+}) {
+  let keyword = initialKeyword;
+  let selectedIndex = 0;
+  const pageSize = 10;
+
+  while (true) {
+    const sessions = await sessionManager.search(keyword);
+    const totalPages = Math.max(1, Math.ceil(Math.max(sessions.length, 1) / pageSize));
+    selectedIndex = Math.min(Math.max(selectedIndex, 0), Math.max(0, sessions.length - 1));
+    const currentPage = Math.floor(selectedIndex / pageSize) + 1;
+    const start = (currentPage - 1) * pageSize;
+    const pageSessions = sessions.slice(start, start + pageSize);
+    const localIndex = Math.max(0, selectedIndex - start);
+
+    ui.clear();
+    ui.printTitle(keyword ? `历史会话 · 搜索 "${keyword}"` : '历史会话');
+    ui.printNewline();
+    ui.printInputHints([
+      'W/S 或 ↑↓ 选择',
+      'A/D 或 ←→ 翻页',
+      'Enter/R 恢复',
+      'P 预览',
+      'F 搜索',
+      'C 清空搜索',
+      'E 重命名',
+      'X 删除',
+      'Q/Esc 返回'
+    ]);
+    ui.printNewline();
+
+    if (sessions.length === 0) {
+      ui.printInfo('没有匹配的会话。按 F 搜索，按 C 清空搜索，按 Q 返回。');
+      const emptyKey = await waitForKeypress();
+      if (emptyKey === 'f') {
+        keyword = (await promptInput({
+          message: '输入关键字（留空查看全部）',
+          default: keyword
+        })).trim();
+        selectedIndex = 0;
+      }
+      if (emptyKey === 'c') {
+        keyword = '';
+        selectedIndex = 0;
+      }
+      if (emptyKey === 'q' || emptyKey === 'escape') {
+        return null;
+      }
+      continue;
+    }
+
+    ui.printSelectableList(
+      `会话列表 · 第 ${currentPage}/${totalPages} 页，共 ${sessions.length} 条`,
+      pageSessions.map((session, index) => formatSessionLine(session, start + index + 1)),
+      localIndex
+    );
+    ui.printNewline();
+
+    const key = await waitForKeypress();
+    const meta = sessions[selectedIndex];
+
+    if (key === 'up' || key === 'w') {
+      selectedIndex = Math.max(0, selectedIndex - 1);
+      continue;
+    }
+
+    if (key === 'down' || key === 's') {
+      selectedIndex = Math.min(sessions.length - 1, selectedIndex + 1);
+      continue;
+    }
+
+    if (key === 'left' || key === 'a') {
+      selectedIndex = Math.max(0, selectedIndex - pageSize);
+      continue;
+    }
+
+    if (key === 'right' || key === 'd') {
+      selectedIndex = Math.min(sessions.length - 1, selectedIndex + pageSize);
+      continue;
+    }
+
+    if (key === 'enter' || key === 'r') {
+      return meta;
+    }
+
+    if (key === 'p') {
+      const details = await sessionManager.load(meta.id);
+      ui.clear();
+      ui.printTitle('会话预览');
+      ui.printNewline();
+      ui.printSessionPreview(meta, details);
+      if (Array.isArray(details?.messages) && details.messages.length > 0) {
+        const previewLines = details.messages
+          .slice(-4)
+          .map((item) => `${item.role === 'user' ? 'User' : 'Assistant'}: ${String(item.content || '').replace(/\s+/g, ' ').slice(0, 120)}`);
+        ui.printNewline();
+        ui.printPanel('最近消息', previewLines);
+      }
+      ui.printNewline();
+      ui.printInfo('按任意键返回列表...');
+      await waitForKeypress();
+      continue;
+    }
+
+    if (key === 'f') {
+      keyword = (await promptInput({
+        message: '输入关键字（留空查看全部）',
+        default: keyword
+      })).trim();
+      selectedIndex = 0;
+      continue;
+    }
+
+    if (key === 'c') {
+      keyword = '';
+      selectedIndex = 0;
+      continue;
+    }
+
+    if (key === 'e') {
+      const nextTitle = await promptInput({
+        message: '输入新的会话标题',
+        default: meta.title
+      });
+      if (nextTitle.trim()) {
+        const renamed = await sessionManager.rename(meta.id, nextTitle);
+        if (renamed) {
+          ui.printSuccess('会话标题已更新');
+          await new Promise((resolve) => setTimeout(resolve, 700));
+        }
+      }
+      continue;
+    }
+
+    if (key === 'x') {
+      const approved = await confirm({
+        message: `确认删除会话“${meta.title}”？`,
+        default: false
+      });
+      if (approved) {
+        await sessionManager.delete(meta.id);
+        ui.printSuccess('会话已删除');
+        await new Promise((resolve) => setTimeout(resolve, 700));
+          selectedIndex = Math.max(0, Math.min(selectedIndex, Math.max(0, sessions.length - 2)));
+      }
+      continue;
+    }
+
+    if (key === 'q' || key === 'escape') {
+      return null;
+    }
+  }
+}
+
+export async function resumeLatestSession(sessionManager) {
+  const sessions = await sessionManager.list();
+  return sessions[0] || null;
+}
+
+export default {
+  browseSessions,
+  resumeLatestSession
+};