linco-connect 1.0.0

package/src/session.js

@@ -0,0 +1,359 @@
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+const { ensureDir } = require('./config');
+const { stopOutboxWatcher } = require('./outgoingAttachmentHandler');
+const { createTextStreamBuffer, resetTextStream } = require('./streamBuffer');
+
+const MAX_EXTERNAL_SESSION_ID_LENGTH = 256;
+const SESSION_METADATA_FILE = 'session.json';
+
+function createStreamState() {
+  return createTextStreamBuffer();
+}
+
+function createSession(config, { externalSessionId, agentType = 'claude' } = {}) {
+  const normalizedAgentType = normalizeAgentType(agentType);
+  const normalizedExternalId = normalizeExternalSessionId(externalSessionId);
+  const id = normalizedExternalId || createFallbackSessionId();
+  const idSource = normalizedExternalId ? 'im' : 'generated';
+  const storageId = deriveStorageId(id);
+  const runtimeDir = resolveSessionRuntimeDir(config, normalizedAgentType, storageId);
+  const defaultWorkspace = path.join(runtimeDir, 'workspace');
+  const attachmentsDir = resolveRuntimeSubdir(runtimeDir, config.attachmentsDirName || 'attachments');
+  const outboxDir = resolveRuntimeSubdir(runtimeDir, config.outboxDirName || 'outbox');
+
+  ensureDir(runtimeDir);
+  ensureDir(defaultWorkspace);
+  ensureDir(attachmentsDir);
+  ensureDir(outboxDir);
+
+  const metadata = loadSessionMetadata(runtimeDir);
+  const legacyMetadata = normalizedAgentType === 'claude' ? loadSessionMetadata(path.join(config.sessionsDir, storageId)) : {};
+  const workspace = resolveSavedWorkspace(metadata.workspace || legacyMetadata.workspace, defaultWorkspace);
+  const agentSessionId = metadata.agentSessionId || metadata.claudeSessionId || legacyMetadata.agentSessionId || legacyMetadata.claudeSessionId || null;
+  const agentSessionHistory = metadata.agentSessionHistory || [];
+
+  const activeEntry = agentSessionHistory.find(e => e.id === agentSessionId);
+  const messageCount = activeEntry?.messageCount ?? 0;
+  const usage = activeEntry ? { ...activeEntry.usage } : { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+
+  return {
+    id,
+    idSource,
+    agentType: normalizedAgentType,
+    activeKey: activeSessionKey(normalizedAgentType, id),
+    storageId,
+    runtimeDir,
+    workspace,
+    attachmentsDir,
+    outboxDir,
+    agentSessionId,
+    claudeSessionId: agentSessionId,
+    agentSessionHistory,
+    messageCount,
+    usage,
+    agentProcess: null,
+    claudeProcess: null,
+    stdoutBuffer: '',
+    isTurnActive: false,
+    currentInputForNoOutput: null,
+    messageQueue: [],
+    pendingDanger: null,
+    pendingPermission: null,
+    streamState: createStreamState(),
+    sawPartialAssistantText: false,
+    outgoingAttachments: new Map(),
+    outboxSeen: new Set(),
+    outboxTimer: null,
+  };
+}
+
+function normalizeExternalSessionId(value) {
+  if (value == null) return '';
+  const id = String(value).trim();
+  if (!id) return '';
+  if (id.length > MAX_EXTERNAL_SESSION_ID_LENGTH) {
+    throw new Error(`session_id 长度不能超过 ${MAX_EXTERNAL_SESSION_ID_LENGTH}`);
+  }
+  if (/[\x00-\x1F\x7F]/.test(id)) {
+    throw new Error('session_id 不能包含控制字符');
+  }
+  return id;
+}
+
+function createFallbackSessionId() {
+  return crypto.randomUUID().slice(0, 8);
+}
+
+function deriveStorageId(sessionId) {
+  return `sid_${crypto.createHash('sha256').update(sessionId).digest('hex').slice(0, 32)}`;
+}
+
+function normalizeAgentType(value) {
+  const type = String(value || 'claude').trim().toLowerCase();
+  if (!/^[a-z0-9_-]+$/.test(type)) {
+    throw new Error('agentType 只能包含字母、数字、下划线或中划线');
+  }
+  return type;
+}
+
+function activeSessionKey(agentType, sessionId) {
+  return `${normalizeAgentType(agentType)}:${sessionId}`;
+}
+
+function resolveSessionRuntimeDir(config, agentType, storageId) {
+  return path.join(config.lincoHome, normalizeAgentType(agentType), 'sessions', storageId);
+}
+
+function resolveRuntimeSubdir(runtimeDir, dirName) {
+  const name = String(dirName || '').trim();
+  if (!name || path.isAbsolute(name)) {
+    throw new Error('运行目录子路径必须是相对路径');
+  }
+
+  const resolved = path.resolve(runtimeDir, name);
+  if (!isInsideOrSame(resolved, runtimeDir)) {
+    throw new Error('运行目录子路径不能跳出当前会话目录');
+  }
+  return resolved;
+}
+
+function isInsideOrSame(filePath, dir) {
+  const relative = path.relative(dir, filePath);
+  return !relative || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
+
+function resolveSavedWorkspace(savedWorkspace, defaultWorkspace) {
+  if (!savedWorkspace || typeof savedWorkspace !== 'string') return defaultWorkspace;
+  if (!path.isAbsolute(savedWorkspace)) return defaultWorkspace;
+  if (!fs.existsSync(savedWorkspace)) return defaultWorkspace;
+
+  try {
+    return fs.statSync(savedWorkspace).isDirectory() ? savedWorkspace : defaultWorkspace;
+  } catch {
+    return defaultWorkspace;
+  }
+}
+
+function clearStreamState(session) {
+  resetTextStream(session.streamState);
+  session.streamState = createStreamState();
+}
+
+function sessionMetadataPath(sessionOrRuntimeDir) {
+  const runtimeDir = typeof sessionOrRuntimeDir === 'string'
+    ? sessionOrRuntimeDir
+    : sessionOrRuntimeDir?.runtimeDir;
+  return path.join(runtimeDir, SESSION_METADATA_FILE);
+}
+
+function loadSessionMetadata(runtimeDir) {
+  const file = sessionMetadataPath(runtimeDir);
+  if (!fs.existsSync(file)) return {};
+
+  try {
+    const metadata = JSON.parse(fs.readFileSync(file, 'utf8'));
+    return metadata && typeof metadata === 'object' ? metadata : {};
+  } catch {
+    return {};
+  }
+}
+
+function saveSessionMetadata(session) {
+  const metadata = {
+    sessionId: session.id,
+    storageId: session.storageId,
+    workspace: session.workspace,
+    agentType: session.agentType || 'claude',
+    agentSessionId: session.agentSessionId || session.claudeSessionId || null,
+    claudeSessionId: session.agentType === 'claude' ? (session.agentSessionId || session.claudeSessionId || null) : null,
+    agentSessionHistory: session.agentSessionHistory || [],
+    updatedAt: new Date().toISOString(),
+  };
+  fs.writeFileSync(sessionMetadataPath(session), `${JSON.stringify(metadata, null, 2)}\n`);
+}
+
+function createAgentSessionEntry(session, id, firstMessage = '') {
+  return {
+    id,
+    agentType: session.agentType || 'claude',
+    createdAt: new Date().toISOString(),
+    lastActiveAt: new Date().toISOString(),
+    workspace: session.workspace,
+    firstMessage: String(firstMessage || '').slice(0, 200),
+    messageCount: 0,
+    usage: {
+      inputTokens: 0,
+      outputTokens: 0,
+      cacheReadTokens: 0,
+      cacheCreationTokens: 0,
+    },
+  };
+}
+
+function recordAgentSession(session, firstMessage = '') {
+  if (!session.agentSessionHistory) session.agentSessionHistory = [];
+
+  const existing = session.agentSessionHistory.find(e => e.id === session.agentSessionId);
+  if (existing) {
+    existing.lastActiveAt = new Date().toISOString();
+    existing.isActive = true;
+    saveSessionMetadata(session);
+    return;
+  }
+
+  if (session.agentSessionId) {
+    for (const entry of session.agentSessionHistory) {
+      entry.isActive = false;
+    }
+
+    const entry = createAgentSessionEntry(session, session.agentSessionId, firstMessage);
+    entry.isActive = true;
+    session.agentSessionHistory.push(entry);
+    saveSessionMetadata(session);
+  }
+}
+
+function updateAgentSessionHistory(session) {
+  if (!session.agentSessionHistory || !session.agentSessionId) return;
+
+  const entry = session.agentSessionHistory.find(e => e.id === session.agentSessionId);
+  if (entry) {
+    entry.lastActiveAt = new Date().toISOString();
+    if (session.messageCount != null) entry.messageCount = session.messageCount;
+    if (session.usage) {
+      entry.usage = { ...entry.usage, ...session.usage };
+    }
+  }
+  saveSessionMetadata(session);
+}
+
+function removeAgentSessionFromHistory(session, targetId) {
+  if (!session.agentSessionHistory) return false;
+
+  const idx = session.agentSessionHistory.findIndex(e => e.id === targetId);
+  if (idx === -1) return false;
+
+  const removed = session.agentSessionHistory[idx];
+  session.agentSessionHistory.splice(idx, 1);
+
+  if (removed.isActive || session.agentSessionId === targetId) {
+    session.agentSessionId = null;
+    session.claudeSessionId = null;
+    session.messageCount = 0;
+    session.usage = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+  }
+
+  saveSessionMetadata(session);
+  return true;
+}
+function extractText(input) {
+  if (!Array.isArray(input)) return String(input || '');
+  return input
+    .filter(block => block?.type === 'text')
+    .map(block => block.text || '')
+    .join('\n');
+}
+
+function persistAgentSessionId(session, agentSessionId) {
+  const nextId = String(agentSessionId || '').trim();
+  if (!nextId || session.agentSessionId === nextId) return;
+  const isNew = !session.agentSessionId;
+  session.agentSessionId = nextId;
+  if (session.agentType === 'claude') session.claudeSessionId = nextId;
+  if (isNew) {
+    recordAgentSession(session, extractText(session.currentInputForNoOutput));
+  } else {
+    saveSessionMetadata(session);
+  }
+}
+
+function clearPersistedAgentSession(session) {
+  session.agentSessionId = null;
+  session.claudeSessionId = null;
+  saveSessionMetadata(session);
+}
+
+function persistClaudeSessionId(session, claudeSessionId) {
+  persistAgentSessionId(session, claudeSessionId);
+}
+
+function clearPersistedClaudeSession(session) {
+  clearPersistedAgentSession(session);
+}
+
+function resetConversationState(session, { clearAgentSession = true, clearClaudeSession } = {}) {
+  const shouldClearAgentSession = clearClaudeSession == null ? clearAgentSession : clearClaudeSession;
+  if (shouldClearAgentSession) {
+    clearPersistedAgentSession(session);
+  }
+  session.stdoutBuffer = '';
+  session.isTurnActive = false;
+  session.currentInputForNoOutput = null;
+  session.messageQueue = [];
+  session.pendingDanger = null;
+  session.pendingPermission = null;
+  session.sawPartialAssistantText = false;
+  clearStreamState(session);
+}
+
+function stopAgentProcess(session, { clearAgentSession = false, clearClaudeSession } = {}) {
+  const shouldClearAgentSession = clearClaudeSession == null ? clearAgentSession : clearClaudeSession;
+  const child = session.agentProcess || session.claudeProcess;
+  session.agentProcess = null;
+  session.claudeProcess = null;
+
+  if (child) {
+    try {
+      if (!child.stdin.destroyed) child.stdin.end();
+    } catch {}
+
+    if (!child.killed && child.exitCode === null) {
+      setTimeout(() => {
+        if (!child.killed && child.exitCode === null) {
+          child.kill();
+        }
+      }, 3000).unref?.();
+    }
+  }
+
+  resetConversationState(session, { clearAgentSession: shouldClearAgentSession });
+}
+
+function stopClaudeProcess(session, { clearClaudeSession = false } = {}) {
+  stopAgentProcess(session, { clearAgentSession: clearClaudeSession });
+}
+
+function killCurrentProcess(session) {
+  stopAgentProcess(session, { clearAgentSession: false });
+}
+
+function cleanupSession(session) {
+  stopOutboxWatcher(session);
+  stopAgentProcess(session, { clearAgentSession: false });
+}
+
+module.exports = {
+  activeSessionKey,
+  cleanupSession,
+  clearPersistedAgentSession,
+  clearPersistedClaudeSession,
+  clearStreamState,
+  createAgentSessionEntry,
+  createSession,
+  deriveStorageId,
+  killCurrentProcess,
+  loadSessionMetadata,
+  normalizeAgentType,
+  normalizeExternalSessionId,
+  persistAgentSessionId,
+  persistClaudeSessionId,
+  recordAgentSession,
+  removeAgentSessionFromHistory,
+  resetConversationState,
+  saveSessionMetadata,
+  stopAgentProcess,
+  stopClaudeProcess,
+  updateAgentSessionHistory,
+};

package/src/slashCommands.js

@@ -0,0 +1,349 @@
+const fs = require('fs');
+const path = require('path');
+const { resetOutgoingAttachments, startOutboxWatcher, stopOutboxWatcher } = require('./outgoingAttachmentHandler');
+const { sendError, sendSystem } = require('./protocol');
+const { removeAgentSessionFromHistory, saveSessionMetadata, stopAgentProcess } = require('./session');
+
+function localCommandsHelp() {
+  return `📋 Linco 本地命令：
+/help          - 显示快速帮助
+/commands      - 显示命令说明
+/status        - 显示当前会话状态
+/pwd           - 显示当前工作目录
+/cd <路径>     - 切换工作目录并开启新 Agent 会话
+/cd            - 列出当前目录内容
+/new           - 开启新 Agent 会话（清除上下文）
+/stop          - 停止当前 Agent 进程，保留可恢复会话 ID
+/base          - 显示 Linco 运行目录信息
+/list [条数]   - 列出当前 IM 会话下最近的 Agent Session 历史（默认 10 条）
+/switch <序号> - 切换到指定 Agent Session（恢复上下文）
+/delete <序号> - 从历史记录中删除指定 Agent Session
+/usage         - 显示 Token 用量统计`;
+}
+
+function handleSlashCommand(text, ws, session, config) {
+  const parts = text.trim().split(/\s+/);
+  const cmd = parts[0].toLowerCase();
+
+  switch (cmd) {
+    case '/help':
+      sendSystem(ws, `${localCommandsHelp()}
+
+📎 支持附件：默认允许普通文件（如 csv、xlsx、sql、txt、md、pdf、docx 等），高风险可执行/脚本文件默认拦截
+📤 Agent 生成文件后可放入当前会话 outbox 目录自动发送到对话框
+🔁 其他 /xxx 命令会透传给当前 Agent，优先使用当前 Agent 原生斜杠命令能力`);
+      return true;
+
+    case '/commands':
+      sendSystem(ws, `${localCommandsHelp()}
+
+🔁 Agent 原生命令：
+除上述本地命令外，其他 /xxx 会直接发送给当前 Agent，例如 /model、/status、/memory、/compact 等。
+
+⚠️ 注意：部分 Agent 原生命令只在交互式 CLI/TUI 中更新界面；在 Linco 的 stream-json 模式下可能返回“无输出”或提示当前环境不可用。遇到这种情况不是连接失败，而是该命令不适合当前桥接模式。`);
+      return true;
+
+    case '/status':
+      sendStatus(ws, session);
+      return true;
+
+    case '/pwd':
+      sendSystem(ws, `📂 ${session.workspace}`);
+      return true;
+
+    case '/cd':
+      handleCd(parts[1], ws, session, config);
+      return true;
+
+    case '/new':
+      stopAgentProcess(session, { clearAgentSession: true });
+      resetOutgoingAttachments(session, config);
+      sendSystem(ws, '🆕 已开启新会话，之前上下文已清除。');
+      return true;
+
+    case '/stop':
+      stopAgentProcess(session, { clearAgentSession: false });
+      sendSystem(ws, '⏹️ 已停止当前 Agent 进程，下次消息会尝试恢复当前会话。');
+      return true;
+
+    case '/base':
+      sendSystem(ws, `🗄️ Linco 运行信息：
+当前工作目录: ${session.workspace}
+Linco Home: ${config.lincoHome}
+会话运行目录: ${session.runtimeDir}
+附件目录: ${session.attachmentsDir}
+outbox 目录: ${session.outboxDir}`);
+      return true;
+
+    case '/list':
+      handleList(parts[1], ws, session);
+      return true;
+
+    case '/switch':
+      handleSwitch(parts[1], ws, session, config);
+      return true;
+
+    case '/delete':
+      handleDelete(parts[1], ws, session);
+      return true;
+
+    case '/usage':
+      handleUsage(ws, session);
+      return true;
+
+    default:
+      return false;
+  }
+}
+
+function sendStatus(ws, session) {
+  const processRunning = !!(
+    (session.agentProcess || session.claudeProcess) &&
+    (session.agentProcess || session.claudeProcess).exitCode === null &&
+    !(session.agentProcess || session.claudeProcess).killed
+  );
+
+  const historyCount = session.agentSessionHistory?.length || 0;
+  const activeEntry = session.agentSessionHistory?.find(e => e.isActive);
+
+  sendSystem(ws, `📊 当前会话状态：
+工作目录: ${session.workspace}
+会话 ID: ${session.id}
+存储 ID: ${session.storageId}
+Agent 类型: ${session.agentType || 'claude'}
+Agent session: ${session.agentSessionId || session.claudeSessionId || '(尚未建立)'}
+活跃历史条目: ${activeEntry ? `"${activeEntry.firstMessage?.slice(0, 40) || '(无)'}" (${activeEntry.id})` : '无'}
+历史总数: ${historyCount}
+Agent 进程: ${processRunning ? '运行中' : '未运行'}
+当前 turn: ${session.isTurnActive ? '进行中' : '空闲'}
+排队消息: ${session.messageQueue.length}
+待确认: ${session.pendingPermission ? '工具权限' : session.pendingDanger ? '危险操作' : '无'}`);
+}
+
+function handleCd(targetPath, ws, session, config) {
+  if (!targetPath) {
+    try {
+      const files = fs.readdirSync(session.workspace);
+      const fileList = files.length > 0
+        ? files.map(file => {
+            const fullPath = path.join(session.workspace, file);
+            const isDir = fs.statSync(fullPath).isDirectory();
+            return isDir ? `📁 ${file}/` : `📄 ${file}`;
+          }).join('\n')
+        : '(空目录)';
+      sendSystem(ws, `📂 ${session.workspace}\n\n${fileList}`);
+    } catch (err) {
+      sendError(ws, `❌ 无法列出目录: ${err.message}`);
+    }
+    return;
+  }
+
+  const newPath = path.isAbsolute(targetPath)
+    ? targetPath
+    : path.resolve(session.workspace, targetPath);
+
+  try {
+    if (!fs.existsSync(newPath)) {
+      sendError(ws, `❌ 目录不存在: ${newPath}`);
+      return;
+    }
+
+    const stat = fs.statSync(newPath);
+    if (!stat.isDirectory()) {
+      sendError(ws, `❌ 不是目录: ${newPath}`);
+      return;
+    }
+
+    stopAgentProcess(session, { clearAgentSession: true });
+    stopOutboxWatcher(session);
+    session.workspace = newPath;
+    saveSessionMetadata(session);
+    resetOutgoingAttachments(session);
+    startOutboxWatcher(ws, session, config);
+    sendSystem(ws, `📂 工作目录已切换至: ${newPath}\n🆕 已开启新 Agent 会话。`);
+  } catch (err) {
+    sendError(ws, `❌ 切换目录失败: ${err.message}`);
+  }
+}
+
+function formatTokenCount(n) {
+  if (!n) return '0';
+  return n.toLocaleString();
+}
+
+function formatTimeShort(isoString) {
+  if (!isoString) return '-';
+  const d = new Date(isoString);
+  const mm = String(d.getMonth() + 1).padStart(2, '0');
+  const dd = String(d.getDate()).padStart(2, '0');
+  const hh = String(d.getHours()).padStart(2, '0');
+  const mi = String(d.getMinutes()).padStart(2, '0');
+  return `${mm}-${dd} ${hh}:${mi}`;
+}
+
+function findEntryByIndexOrId(indexOrId, history) {
+  const idx = parseInt(indexOrId, 10);
+  if (!isNaN(idx) && idx >= 1 && idx <= history.length) {
+    return { entry: history[idx - 1], index: idx };
+  }
+  const entry = history.find(e => e.id === indexOrId);
+  if (entry) return { entry, index: history.indexOf(entry) + 1 };
+  return null;
+}
+
+function handleList(limitArg, ws, session) {
+  const history = session.agentSessionHistory;
+  if (!history || history.length === 0) {
+    sendSystem(ws, '📋 当前 IM 会话下尚无 Agent Session 记录。');
+    return;
+  }
+
+  const limit = limitArg === undefined ? 10 : parseInt(limitArg, 10);
+  if (!Number.isInteger(limit) || limit < 1) {
+    sendError(ws, '❌ /list 参数必须是大于 0 的数字，例如 /list 20。');
+    return;
+  }
+
+  const start = Math.max(history.length - limit, 0);
+  const visibleHistory = history.slice(start);
+  const lines = visibleHistory.map((entry, i) => {
+    const num = start + i + 1;
+    const summary = entry.firstMessage ? entry.firstMessage.slice(0, 40) : '(新会话)';
+    const msgs = entry.messageCount || 0;
+    const inTokens = formatTokenCount(entry.usage?.inputTokens);
+    const outTokens = formatTokenCount(entry.usage?.outputTokens);
+    const time = formatTimeShort(entry.lastActiveAt || entry.createdAt);
+    const marker = entry.isActive ? '📌' : '  ';
+    const showUsage = (entry.agentType || session.agentType || 'claude') !== 'codex';
+    const usageText = showUsage ? ` · ${inTokens} in / ${outTokens} out` : '';
+    return `${marker} ${num}. ${summary} · ${msgs} msgs${usageText} · ${time}`;
+  }).join('\n');
+
+  sendSystem(ws, `📋 当前 IM 会话的 Agent Session 历史（最近 ${visibleHistory.length} / 共 ${history.length} 条）：\n\n${lines}`);
+}
+
+function handleSwitch(indexOrId, ws, session, config) {
+  const history = session.agentSessionHistory;
+  if (!history || history.length === 0) {
+    sendError(ws, '❌ 当前 IM 会话下没有 Agent Session 记录，请先发送消息或执行 /new。');
+    return;
+  }
+
+  if (!indexOrId) {
+    sendError(ws, '❌ 请指定要切换的 Session 序号或 ID。使用 /list 查看可用 Session。');
+    return;
+  }
+
+  const result = findEntryByIndexOrId(indexOrId, history);
+  if (!result) {
+    sendError(ws, `❌ 未找到匹配的 Session，序号范围: 1-${history.length}。`);
+    return;
+  }
+
+  const { entry, index } = result;
+
+  for (const e of history) e.isActive = false;
+  entry.isActive = true;
+
+  session.agentSessionId = entry.id;
+  if (session.agentType === 'claude') session.claudeSessionId = entry.id;
+  session.messageCount = entry.messageCount || 0;
+  session.usage = entry.usage ? { ...entry.usage } : { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+  saveSessionMetadata(session);
+
+  const child = session.agentProcess || session.claudeProcess;
+  if (child && !child.killed && child.exitCode === null) {
+    stopAgentProcess(session, { clearAgentSession: false });
+  } else {
+    session.isTurnActive = false;
+    session.currentInputForNoOutput = null;
+    session.messageQueue = [];
+    session.pendingDanger = null;
+    session.pendingPermission = null;
+  }
+
+  // Verify the change persisted correctly
+  config.logger?.info('switch: verification', {
+    sessionId: session.id,
+    agentSessionId: session.agentSessionId,
+    claudeSessionId: session.claudeSessionId,
+    entryId: entry.id,
+    match: session.agentSessionId === entry.id,
+  });
+
+  const summary = entry.firstMessage ? entry.firstMessage.slice(0, 40) : '(新会话)';
+  sendSystem(ws, `🔄 已切换到第 ${index} 个 Session: "${summary}"\n下次消息将使用 --resume 恢复该会话上下文。\nResume ID: ${entry.id}`);
+}
+
+function handleDelete(indexOrId, ws, session) {
+  const history = session.agentSessionHistory;
+  if (!history || history.length === 0) {
+    sendError(ws, '❌ 当前 IM 会话下没有 Agent Session 记录。');
+    return;
+  }
+
+  if (!indexOrId) {
+    sendError(ws, '❌ 请指定要删除的 Session 序号或 ID。使用 /list 查看可用 Session。');
+    return;
+  }
+
+  const result = findEntryByIndexOrId(indexOrId, history);
+  if (!result) {
+    sendError(ws, `❌ 未找到匹配的 Session，序号范围: 1-${history.length}。`);
+    return;
+  }
+
+  const { entry, index } = result;
+  const wasActive = entry.isActive || session.agentSessionId === entry.id;
+
+  removeAgentSessionFromHistory(session, entry.id);
+
+  const remaining = session.agentSessionHistory?.length || 0;
+  if (wasActive) {
+    sendSystem(ws, `🗑️ 已删除第 ${index} 个 Session（当前活跃会话），剩余 ${remaining} 个历史记录。`);
+  } else {
+    sendSystem(ws, `🗑️ 已删除第 ${index} 个 Session，剩余 ${remaining} 个历史记录。`);
+  }
+}
+
+function handleUsage(ws, session) {
+  if ((session.agentType || 'claude') === 'codex') {
+    sendSystem(ws, '📊 Codex 当前暂不提供 Token 用量统计。');
+    return;
+  }
+
+  const history = session.agentSessionHistory || [];
+
+  const activeEntry = history.find(e => e.isActive) || (session.agentSessionId ? history.find(e => e.id === session.agentSessionId) : null);
+
+  const current = session.usage || { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+  const total = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+  for (const entry of history) {
+    total.inputTokens += entry.usage?.inputTokens || 0;
+    total.outputTokens += entry.usage?.outputTokens || 0;
+    total.cacheReadTokens += entry.usage?.cacheReadTokens || 0;
+    total.cacheCreationTokens += entry.usage?.cacheCreationTokens || 0;
+  }
+
+  const grandTotal = total.inputTokens + total.outputTokens + total.cacheReadTokens + total.cacheCreationTokens;
+
+  let text = `📊 Token 用量统计：\n\n`;
+  text += `当前 Session:\n`;
+  text += `  Input: ${formatTokenCount(current.inputTokens)} | Output: ${formatTokenCount(current.outputTokens)}`;
+  if (current.cacheReadTokens || current.cacheCreationTokens) {
+    text += ` | Cache Read: ${formatTokenCount(current.cacheReadTokens)} | Cache Create: ${formatTokenCount(current.cacheCreationTokens)}`;
+  }
+  text += `\n\n`;
+  text += `全部 Session 累计:\n`;
+  text += `  Input: ${formatTokenCount(total.inputTokens)} | Output: ${formatTokenCount(total.outputTokens)}`;
+  if (total.cacheReadTokens || total.cacheCreationTokens) {
+    text += ` | Cache Read: ${formatTokenCount(total.cacheReadTokens)} | Cache Create: ${formatTokenCount(total.cacheCreationTokens)}`;
+  }
+  text += `\n  总计: ${formatTokenCount(grandTotal)} tokens`;
+
+  sendSystem(ws, text);
+}
+
+module.exports = {
+  handleSlashCommand,
+};