@bolloon/bolloon-agent 0.3.15 → 0.3.17

package/dist/electron-preload.js

@@ -1,32 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Electron Preload 脚本
  * 在渲染进程和主进程之间建立安全的通信桥梁
  * contextIsolation: true, nodeIntegration: false — 只能通过这里暴露的 API 触达主进程
  */
-const electron_1 = require("electron");
-electron_1.contextBridge.exposeInMainWorld('electronAPI', {
+import { contextBridge, ipcRenderer } from 'electron';
+contextBridge.exposeInMainWorld('electronAPI', {
     // === 原有 (保留) ===
-    getVersion: () => electron_1.ipcRenderer.invoke('get-version'),
-    getUserDataPath: () => electron_1.ipcRenderer.invoke('get-user-data-path'),
-    openExternal: (url) => electron_1.ipcRenderer.invoke('open-external', url),
+    getVersion: () => ipcRenderer.invoke('get-version'),
+    getUserDataPath: () => ipcRenderer.invoke('get-user-data-path'),
+    openExternal: (url) => ipcRenderer.invoke('open-external', url),
     // === 新增: 数据目录 ===
-    getDataPath: () => electron_1.ipcRenderer.invoke('get-data-path'),
+    getDataPath: () => ipcRenderer.invoke('get-data-path'),
     // === 新增: 文件 dialog ===
-    openFile: (opts) => electron_1.ipcRenderer.invoke('dialog:open-file', opts),
-    saveFile: (opts) => electron_1.ipcRenderer.invoke('dialog:save-file', opts),
-    openDirectory: (opts) => electron_1.ipcRenderer.invoke('dialog:open-directory', opts),
+    openFile: (opts) => ipcRenderer.invoke('dialog:open-file', opts),
+    saveFile: (opts) => ipcRenderer.invoke('dialog:save-file', opts),
+    openDirectory: (opts) => ipcRenderer.invoke('dialog:open-directory', opts),
     // === 新增: 文件系统 (限大小, 主进程守卫) ===
-    readTextFile: (opts) => electron_1.ipcRenderer.invoke('fs:read-text-file', opts),
-    writeTextFile: (opts) => electron_1.ipcRenderer.invoke('fs:write-text-file', opts),
-    pathExists: (opts) => electron_1.ipcRenderer.invoke('fs:path-exists', opts),
+    readTextFile: (opts) => ipcRenderer.invoke('fs:read-text-file', opts),
+    writeTextFile: (opts) => ipcRenderer.invoke('fs:write-text-file', opts),
+    pathExists: (opts) => ipcRenderer.invoke('fs:path-exists', opts),
     // === 新增: 首启引导 ===
-    getFirstRunSeen: () => electron_1.ipcRenderer.invoke('first-run:seen'),
-    markFirstRunSeen: () => electron_1.ipcRenderer.invoke('first-run:mark-seen'),
-    getDataPathSync: () => electron_1.ipcRenderer.invoke('first-run:data-dir'),
-    getLogsPathSync: () => electron_1.ipcRenderer.invoke('first-run:logs-dir'),
+    getFirstRunSeen: () => ipcRenderer.invoke('first-run:seen'),
+    markFirstRunSeen: () => ipcRenderer.invoke('first-run:mark-seen'),
+    getDataPathSync: () => ipcRenderer.invoke('first-run:data-dir'),
+    getLogsPathSync: () => ipcRenderer.invoke('first-run:logs-dir'),
     // === 元数据 ===
     platform: process.platform,
 });
-//# sourceMappingURL=electron-preload.js.map

package/dist/electron.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Electron 入口 shim — 真正逻辑在 src/electron/main.ts
  * (保留 src/electron.ts 平铺入口, 不动 package.json 的 dist/electron.js 解析)
  */
-require("./electron/main");
-//# sourceMappingURL=electron.js.map
+import './electron/main';

package/dist/external-engines/discovery.js

@@ -124,6 +124,17 @@ const KNOWN_ENGINES = [
         models: OPENCODE_MODELS,
         delegateArgs: (p) => ['prompt', p],
     },
+    {
+        id: 'opencli',
+        displayName: 'OpenCLI',
+        binaries: ['opencli', 'open-cli'],
+        configFiles: ['.opencli/config.json', '.config/opencli/config.json'],
+        envKeys: ['OPENCLI_API_KEY', 'OPENAI_API_KEY', 'ANTHROPIC_API_KEY'],
+        providerHint: 'openai',
+        models: OPENCODE_MODELS,
+        modelFlag: '-m',
+        delegateArgs: (p) => ['exec', p],
+    },
 ];
 // ====================== 默认 deps (真实 IO) ======================
 function realWhichImpl(name) {

package/dist/index.js

@@ -4,8 +4,10 @@ import { HybridMessenger } from './network/hybrid-messenger.js';
 import * as ed25519 from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2.js';
 import * as fs from 'fs/promises';
+import { existsSync, mkdirSync } from 'fs';
 import * as path from 'path';
 import { spawn } from 'child_process';
+import * as os from 'os';
 import { documentReader } from './documents/reader.js';
 import { initMinimax } from './constraints/index.js';
 import { createAgentSession } from './agents/pi-sdk.js';
@@ -28,13 +30,22 @@ const _BOLLOON_VERSION = (() => {
 const RESET = '\x1b[0m';
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[2m';
-const CYAN = '\x1b[36m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const BLUE = '\x1b[34m';
-const MAGENTA = '\x1b[35m';
-const WHITE = '\x1b[37m';
-const GRAY = '\x1b[90m';
+// Bolloon Web UI 配色 truecolor ANSI — 与 loading-tui.ts 一致
+function fg(r, g, b) { return `\x1b[38;2;${r};${g};${b}m`; }
+const C_ACCENT = fg(0xc4, 0xd6, 0x40); // #c4d640
+const C_TEXT = fg(0xd8, 0xd8, 0xc8); // #d8d8c8
+const C_DIM = fg(0x90, 0x90, 0x88); // #909088
+const C_OK = fg(0x22, 0xc5, 0x5e); // #22c55e
+const C_ERROR = fg(0xef, 0x44, 0x44); // #ef4444
+const C_WARN = fg(0xf5, 0x9e, 0x0b); // #f59e0b
+// 向下兼容 — 旧名映射到新色
+const CYAN = C_ACCENT;
+const GREEN = C_OK;
+const YELLOW = C_WARN;
+const MAGENTA = C_ERROR;
+const WHITE = C_TEXT;
+const GRAY = C_DIM;
+const BLUE = C_DIM;
 const BG_WHITE = '\x1b[47m';
 const BG_BLUE = '\x1b[44m';
 const BLACK = '\x1b[30m';
@@ -128,14 +139,30 @@ function getUserName() {
 }
 async function bootstrapIdentity() {
     s.step(1, 5, '生成 DIAP 身份', 'loading');
-    const kp = KeyManager.generate();
+    const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir?.() || '.';
+    const identityPath = path.join(homeDir, '.bolloon', 'identity.json');
+    let kp;
+    let reused = false;
+    try {
+        if (existsSync(identityPath)) {
+            kp = await KeyManager.fromFile(identityPath);
+            reused = true;
+        }
+        else
+            throw 0;
+    }
+    catch {
+        kp = KeyManager.generate();
+        mkdirSync(path.dirname(identityPath), { recursive: true });
+        await KeyManager.saveToFile(kp, identityPath);
+    }
     const did = kp.did;
     const username = getUserName();
     const suffix = did.split(':').pop()?.substring(0, 4);
     const name = `blln-${username}-${suffix}`;
-    console.log(`     ${GRAY}DID:${RESET} ${did}`);
+    console.log(`     ${reused ? GRAY + '复用 ' : ''}${GRAY}DID:${RESET} ${did}`);
     console.log(`     ${GRAY}名称:${RESET} ${name}`);
-    s.step(1, 5, '生成 DIAP 身份', 'ok');
+    s.step(1, 5, reused ? '复用 DIAP 身份' : '生成 DIAP 身份', 'ok');
     return { keypair: kp, did, name };
 }
 function publishDID(name, kp) {
@@ -328,27 +355,68 @@ const MOVE_UP_1 = '\x1b[1A';
 let isRunning = false;
 let currentInput = '';
 let promptVisible = false;
+let queueMode = false;
+const pendingQueue = [];
+// 底部状态栏数据
+let cliStartTime = 0;
+let cliModelName = '…';
+let cliAgentName = '…';
+let cliContextPct = 0; // 0-100
 function getTermHeight() {
     return process.stdout.rows || 24;
 }
-function moveCursorToBottom() {
+function moveCursorToBottom(lines = 1) {
     const height = getTermHeight();
-    process.stdout.write(`\x1b[${height};1H`);
+    process.stdout.write(`\x1b[${height - lines + 1};1H`);
+}
+function fmtDuration(ms) {
+    const s = Math.floor(ms / 1000);
+    const m = Math.floor(s / 60);
+    const h = Math.floor(m / 60);
+    if (h > 0)
+        return `${h}h${m % 60}m`;
+    if (m > 0)
+        return `${m}m${s % 60}s`;
+    return `${s}s`;
+}
+function statusBarLine() {
+    const dur = cliStartTime ? fmtDuration(Date.now() - cliStartTime) : '0s';
+    const barLen = 12;
+    const filled = Math.round((cliContextPct / 100) * barLen);
+    const bar = C_OK + '█'.repeat(filled) + C_DIM + '░'.repeat(barLen - filled) + RESET;
+    return `${C_DIM}${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ ${C_ACCENT}${dur}${RESET} ${C_DIM}│${RESET} ${bar} ${C_DIM}${cliContextPct}%${RESET}`;
 }
 function showBottomPrompt() {
     if (!isRunning)
         return;
     promptVisible = true;
     process.stdout.write(SAVE_CURSOR);
-    moveCursorToBottom();
-    process.stdout.write(`${CYAN}❯ ${RESET}${currentInput}${HIDE_CURSOR_SEQ}`);
+    moveCursorToBottom(2);
+    // 第 1 行: 状态栏 (从屏幕底上数第 2 行)
+    process.stdout.write(CLEAR_LINE + statusBarLine() + '\n');
+    // 第 2 行: 输入框
+    process.stdout.write(CLEAR_LINE);
+    const hint = currentInput.length === 0 && !queueMode
+        ? ` ${C_DIM}!cmd${RESET}  ${C_DIM}/queue${RESET}  ${C_DIM}/help${RESET}`
+        : queueMode ? ` ${C_WARN}[队列${pendingQueue.length}]${RESET}` : '';
+    const prefix = queueMode ? `${C_WARN}▸${RESET}` : `${C_ACCENT}❯${RESET}`;
+    const tw = process.stdout.columns || 80;
+    process.stdout.write(`${C_DIM}${'─'.repeat(tw)}${RESET}\n`);
+    process.stdout.write(`${prefix} ${currentInput}${hint}${HIDE_CURSOR_SEQ}`);
+    process.stdout.write(`\n${C_DIM}${'─'.repeat(tw)}${RESET}`);
     process.stdout.write(RESTORE_CURSOR);
 }
 function clearPromptLine() {
     if (!promptVisible)
         return;
     process.stdout.write(SAVE_CURSOR);
-    moveCursorToBottom();
+    moveCursorToBottom(4);
+    process.stdout.write(CLEAR_LINE);
+    process.stdout.write('\n');
+    process.stdout.write(CLEAR_LINE);
+    process.stdout.write('\n');
+    process.stdout.write(CLEAR_LINE);
+    process.stdout.write('\n');
     process.stdout.write(CLEAR_LINE);
     process.stdout.write(RESTORE_CURSOR);
     promptVisible = false;
@@ -371,6 +439,21 @@ function startCLI(comm) {
         peerCount = comm.getConnections().length;
     }
     catch { /* */ }
+    // 读取 LLM 模型名 (支持多 provider)
+    const providerNames = [
+        ['OPENAI_API_KEY', 'OpenAI'],
+        ['ANTHROPIC_API_KEY', 'Anthropic'],
+        ['DEEPSEEK_API_KEY', 'DeepSeek'],
+        ['GOOGLE_API_KEY', 'Google'],
+        ['GROQ_API_KEY', 'Groq'],
+        ['MINIMAX_API_KEY', 'MiniMax'],
+        ['XAI_API_KEY', 'xAI'],
+        ['TOGETHER_API_KEY', 'Together'],
+    ];
+    const foundProvider = providerNames.find(([k]) => process.env[k]);
+    cliModelName = foundProvider ? foundProvider[1] : '未配置';
+    cliAgentName = agentIdentity?.name || 'bolloon';
+    cliStartTime = Date.now();
     const llmName = process.env.MINIMAX_API_KEY ? 'MiniMax'
         : process.env.OPENAI_API_KEY ? 'OpenAI'
             : process.env.ANTHROPIC_API_KEY ? 'Anthropic'
@@ -452,6 +535,63 @@ function startCLI(comm) {
 }
 async function processInput(input, comm) {
     const trimmed = input.trim();
+    // !command — 直接执行终端命令
+    if (trimmed.startsWith('!')) {
+        const cmd = trimmed.slice(1).trim();
+        if (!cmd) {
+            process.stdout.write(`${C_DIM}!<命令> 执行终端命令, 如 !ls -la${RESET}\n`);
+            return;
+        }
+        process.stdout.write(`${C_DIM}── $ ${cmd}${RESET}\n`);
+        try {
+            const { execSync } = await import('child_process');
+            const out = execSync(cmd, { timeout: 30000, encoding: 'utf-8', cwd: process.cwd() });
+            process.stdout.write(`${C_DIM}${out || '(无输出)'}${RESET}`);
+        }
+        catch (e) {
+            process.stdout.write(`${C_ERROR}${e.stderr || e.message}${RESET}\n`);
+        }
+        process.stdout.write(`${C_DIM}──${RESET}\n`);
+        return;
+    }
+    // /queue — 切换队列模式
+    if (trimmed.toLowerCase() === '/queue') {
+        queueMode = !queueMode;
+        process.stdout.write(`${C_WARN}队列 ${queueMode ? '开启' : '关闭'}${RESET} (${pendingQueue.length} 条)\n`);
+        return;
+    }
+    // /dequeue — 出队一条
+    if (trimmed.toLowerCase() === '/dequeue' || trimmed.toLowerCase() === '/dq') {
+        const next = pendingQueue.shift();
+        if (next)
+            process.stdout.write(`${C_WARN}出队:${RESET} ${next}\n`);
+        else
+            process.stdout.write(`${C_DIM}队列为空${RESET}\n`);
+        return;
+    }
+    // 队列模式: 入队
+    if (queueMode) {
+        pendingQueue.push(trimmed);
+        process.stdout.write(`${C_WARN}[${pendingQueue.length}]${RESET} 已入队\n`);
+        return;
+    }
+    // 队列非空: 也入队末尾 (排队执行)
+    if (pendingQueue.length > 0) {
+        pendingQueue.push(trimmed);
+        process.stdout.write(`${C_WARN}[队列 ${pendingQueue.length}]${RESET} 已入队, 执行完当前后自动运行\n`);
+        return;
+    }
+    if (trimmed.toLowerCase() === '/help' || trimmed === 'help') {
+        process.stdout.write(`${C_DIM}命令:${RESET}\n`);
+        process.stdout.write(`  ${C_ACCENT}!<cmd>${RESET}  执行终端命令  ${C_DIM}如 !ls -la${RESET}\n`);
+        process.stdout.write(`  ${C_ACCENT}/queue${RESET}  切换队列模式  ${C_DIM}输入排队, 当前结束后自动执行${RESET}\n`);
+        process.stdout.write(`  ${C_ACCENT}/dequeue${RESET} 出队一条\n`);
+        process.stdout.write(`  ${C_ACCENT}peers${RESET}   查看 P2P 节点\n`);
+        process.stdout.write(`  ${C_ACCENT}iroh${RESET}    查看 iroh 状态\n`);
+        process.stdout.write(`  ${C_ACCENT}add_friend${RESET} 添加好友\n`);
+        process.stdout.write(`  ${C_ACCENT}exit${RESET}    退出\n`);
+        return;
+    }
     if (trimmed === '退出' || trimmed === 'exit' || trimmed === 'quit') {
         clearPromptLine();
         process.stdout.write(`${CYAN}👋 再见！${RESET}\n`);
@@ -515,6 +655,8 @@ async function processInput(input, comm) {
         return;
     }
     try {
+        // 双横线分割
+        process.stdout.write(`${C_DIM}${'─'.repeat(8)} · ${'─'.repeat(8)}${RESET}\n`);
         // 已发送消息框
         process.stdout.write(renderUserMessage(trimmed) + '\n');
         const a = await getAgent();
@@ -552,6 +694,21 @@ async function processInput(input, comm) {
         clearThinking();
         // 智能体回复框 (圆角)
         process.stdout.write(renderAgentMessage(response) + '\n');
+        // 更新底部状态栏: 上下文进度
+        try {
+            // 用 messageHistory 长度推断上下文占用
+            const msgLen = JSON.stringify(a.messageHistory ?? []).length;
+            cliContextPct = Math.min(100, Math.round((msgLen / 240_000) * 100));
+        }
+        catch { /* 降级容忍 */ }
+        // 双横线分隔 + 自动消费队列
+        process.stdout.write(`${C_DIM}${'─'.repeat(8)} · ${'─'.repeat(8)}${RESET}\n`);
+        if (pendingQueue.length > 0) {
+            const next = pendingQueue.shift();
+            process.stdout.write(`${C_WARN}⏩ 自动执行队列 [${pendingQueue.length + 1}/${pendingQueue.length + 1}]${RESET}\n`);
+            await processInput(next, comm);
+            return;
+        }
     }
     catch (e) {
         if (!e.message?.includes('ERR_USE_AFTER_CLOSE') && !e.message?.includes('write after end')) {

package/dist/lsp/lsp-manager.js

@@ -0,0 +1,281 @@
+/**
+ * lsp/lsp-manager.ts — LSP 服务器发现 + 生命周期管理
+ *
+ * 检测本机已安装的语言服务器, 管理启动/关闭,
+ * 通过 JSON-RPC over stdio 与 LSP 服务器通信.
+ */
+import { spawn } from 'child_process';
+import * as path from 'path';
+import { createInterface } from 'readline';
+// ==================== 已知 LSP 服务器规格 ====================
+const KNOWN_LSP_SERVERS = [
+    {
+        language: 'typescript',
+        displayName: 'TypeScript Language Server',
+        binary: 'typescript-language-server',
+        args: ['--stdio'],
+        fileExtensions: ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'],
+    },
+    {
+        language: 'rust',
+        displayName: 'rust-analyzer',
+        binary: 'rust-analyzer',
+        args: [],
+        fileExtensions: ['.rs'],
+    },
+    {
+        language: 'python',
+        displayName: 'Pyright',
+        binary: 'pyright-langserver',
+        args: ['--stdio'],
+        fileExtensions: ['.py'],
+    },
+    {
+        language: 'css',
+        displayName: 'CSS Language Server',
+        binary: 'vscode-css-language-server',
+        args: ['--stdio'],
+        fileExtensions: ['.css', '.scss', '.less'],
+    },
+    {
+        language: 'json',
+        displayName: 'JSON Language Server',
+        binary: 'vscode-json-language-server',
+        args: ['--stdio'],
+        fileExtensions: ['.json', '.jsonc'],
+    },
+];
+// ==================== 服务器实例缓存 ====================
+const instances = new Map();
+// ==================== 发现 ====================
+/** 检测已安装的 LSP 服务器 (哪些二进制在 PATH 上) */
+export async function detectInstalledLspServers() {
+    const results = [];
+    for (const spec of KNOWN_LSP_SERVERS) {
+        try {
+            const exists = await checkBinary(spec.binary);
+            if (exists)
+                results.push(spec);
+        }
+        catch {
+            // 静默跳过
+        }
+    }
+    return results;
+}
+function checkBinary(name) {
+    return new Promise((resolve) => {
+        const p = spawn('sh', ['-c', `command -v ${JSON.stringify(name)}`], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let out = '';
+        p.stdout?.on('data', (d) => (out += d.toString()));
+        p.on('close', () => resolve(out.trim().length > 0));
+        p.on('error', () => resolve(false));
+    });
+}
+// ==================== 生命周期 ====================
+/** 启动一个 LSP 服务器 (如果尚未启动则启动) */
+export async function startLspServer(language) {
+    // 已有实例, 返回缓存
+    const existing = instances.get(language);
+    if (existing && existing.process.exitCode === null)
+        return existing;
+    // 查找规格
+    const spec = KNOWN_LSP_SERVERS.find(s => s.language === language)
+        || (await detectInstalledLspServers()).find(s => s.language === language);
+    if (!spec)
+        return null;
+    // spawn 进程
+    const proc = spawn(spec.binary, spec.args, {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: { ...process.env },
+    });
+    const instance = { spec, process: proc, nextId: 1 };
+    instances.set(language, instance);
+    // 发送 initialize 请求
+    await sendRequest(instance, 'initialize', {
+        processId: process.pid,
+        capabilities: {},
+        rootUri: null,
+    });
+    // 发送 initialized 通知
+    sendNotification(instance, 'initialized', {});
+    return instance;
+}
+/** 关闭 LSP 服务器 */
+export async function stopLspServer(language) {
+    const inst = instances.get(language);
+    if (!inst)
+        return;
+    try {
+        sendNotification(inst, 'shutdown', {});
+        sendNotification(inst, 'exit', {});
+    }
+    catch { /* ignore */ }
+    setTimeout(() => {
+        try {
+            inst.process.kill('SIGKILL');
+        }
+        catch { /* ignore */ }
+    }, 2000).unref();
+    instances.delete(language);
+}
+/** 关闭所有 LSP 服务器 */
+export function stopAllLspServers() {
+    for (const lang of instances.keys()) {
+        stopLspServer(lang);
+    }
+}
+// ==================== JSON-RPC 通信 ====================
+function sendRequest(inst, method, params) {
+    return new Promise((resolve, reject) => {
+        const id = inst.nextId++;
+        const req = { jsonrpc: '2.0', id, method, params };
+        const body = JSON.stringify(req);
+        const header = `Content-Length: ${Buffer.byteLength(body, 'utf-8')}\r\n\r\n`;
+        const rl = createInterface({ input: inst.process.stdout });
+        const onLine = (line) => {
+            try {
+                const resp = JSON.parse(line);
+                if (resp.id === id) {
+                    rl.close();
+                    if (resp.error)
+                        reject(new Error(resp.error.message));
+                    else
+                        resolve(resp.result);
+                }
+            }
+            catch { /* skip non-JSON lines (content-length headers) */ }
+        };
+        // LSP 响应是 header + body, 先读 Content-Length 头再读 body
+        let buffer = '';
+        let contentLength = -1;
+        const onData = (chunk) => {
+            buffer += chunk.toString();
+            while (true) {
+                if (contentLength < 0) {
+                    const headerEnd = buffer.indexOf('\r\n\r\n');
+                    if (headerEnd === -1)
+                        break;
+                    const headerPart = buffer.substring(0, headerEnd);
+                    const lenMatch = headerPart.match(/Content-Length:\s*(\d+)/i);
+                    if (lenMatch)
+                        contentLength = parseInt(lenMatch[1], 10);
+                    buffer = buffer.substring(headerEnd + 4);
+                }
+                if (contentLength > 0 && buffer.length >= contentLength) {
+                    const bodyStr = buffer.substring(0, contentLength);
+                    buffer = buffer.substring(contentLength);
+                    contentLength = -1;
+                    try {
+                        const resp = JSON.parse(bodyStr);
+                        if (resp.id === id) {
+                            inst.process.stdout.removeListener('data', onData);
+                            if (resp.error)
+                                reject(new Error(resp.error.message));
+                            else
+                                resolve(resp.result);
+                            return;
+                        }
+                    }
+                    catch { /* skip malformed */ }
+                }
+                else
+                    break;
+            }
+        };
+        inst.process.stdout.on('data', onData);
+        inst.process.stdin.write(header + body);
+    });
+}
+function sendNotification(inst, method, params) {
+    const req = { jsonrpc: '2.0', method, params };
+    const body = JSON.stringify(req);
+    const header = `Content-Length: ${Buffer.byteLength(body, 'utf-8')}\r\n\r\n`;
+    inst.process.stdin.write(header + body);
+}
+/** 打开文档 (textDocument/didOpen) */
+export function lspDidOpen(inst, filePath, content) {
+    const uri = pathToUri(filePath);
+    sendNotification(inst, 'textDocument/didOpen', {
+        textDocument: { uri, languageId: inst.spec.language, version: 1, text: content },
+    });
+}
+/** 悬停 (textDocument/hover) */
+export async function lspHover(inst, filePath, line, character) {
+    const uri = pathToUri(filePath);
+    const result = await sendRequest(inst, 'textDocument/hover', {
+        textDocument: { uri },
+        position: { line, character },
+    });
+    if (!result || !result.contents)
+        return null;
+    const contents = Array.isArray(result.contents)
+        ? result.contents.map((c) => typeof c === 'string' ? c : c.value || '').join('\n---\n')
+        : typeof result.contents === 'object' ? (result.contents.value || JSON.stringify(result.contents))
+            : String(result.contents);
+    return { contents, range: result.range };
+}
+/** 补全 (textDocument/completion) */
+export async function lspCompletion(inst, filePath, line, character) {
+    const uri = pathToUri(filePath);
+    const result = await sendRequest(inst, 'textDocument/completion', {
+        textDocument: { uri },
+        position: { line, character },
+    });
+    const items = Array.isArray(result)
+        ? result
+        : (result?.items || []);
+    return {
+        items: items.map((item) => ({
+            label: typeof item === 'string' ? item : (item.label || item.insertText || ''),
+            kind: item.kind,
+            detail: item.detail,
+        })),
+    };
+}
+/** 诊断 (textDocument/diagnostic — 需要拉模式) */
+export async function lspDiagnostics(inst, filePath) {
+    const uri = pathToUri(filePath);
+    // 先触发分析: didChange 或 didOpen
+    try {
+        const result = await sendRequest(inst, 'textDocument/diagnostic', {
+            textDocument: { uri },
+        });
+        return { diagnostics: result?.diagnostics || result?.items || [] };
+    }
+    catch {
+        return { diagnostics: [] };
+    }
+}
+/** 转到定义 (textDocument/definition) */
+export async function lspGoToDefinition(inst, filePath, line, character) {
+    const uri = pathToUri(filePath);
+    try {
+        const result = await sendRequest(inst, 'textDocument/definition', {
+            textDocument: { uri },
+            position: { line, character },
+        });
+        if (!result)
+            return null;
+        // 可能返回 Location 或 Location[]
+        const loc = Array.isArray(result) ? result[0] : result;
+        if (!loc || !loc.uri)
+            return null;
+        return { uri: loc.uri, range: loc.range };
+    }
+    catch {
+        return null;
+    }
+}
+// ==================== 工具 ====================
+function pathToUri(filePath) {
+    const abs = path.resolve(filePath);
+    return `file://${abs.startsWith('/') ? '' : '/'}${abs}`;
+}
+/** 根据文件扩展名找到合适的 LSP 服务器 */
+export function findLspForFile(filePath, specs) {
+    const ext = path.extname(filePath).toLowerCase();
+    return specs.find(s => s.fileExtensions.includes(ext));
+}