@bolloon/bolloon-agent 0.3.16 → 0.3.17

package/dist/lsp/lsp-tools.js

@@ -0,0 +1,222 @@
+/**
+ * lsp/lsp-tools.ts — 注册 LSP 工具到 Bolloon agent 工具系统
+ *
+ * 暴露 6 个工具:
+ *   - lsp_detect: 检测本机已安装的语言服务器
+ *   - lsp_hover: 悬停查看类型/文档
+ *   - lsp_completion: 代码补全
+ *   - lsp_diagnostics: 诊断当前文件
+ *   - lsp_go_to_definition: 跳转到定义
+ *   - lsp_start / lsp_stop: 手动管理 LSP 服务器生命周期
+ */
+import { detectInstalledLspServers, startLspServer, stopLspServer, stopAllLspServers, findLspForFile, lspDidOpen, lspHover, lspCompletion, lspDiagnostics, lspGoToDefinition, } from './lsp-manager.js';
+/** 已检测到的 LSP 服务器列表 (缓存) */
+let cachedSpecs = null;
+async function getSpecs() {
+    if (!cachedSpecs)
+        cachedSpecs = await detectInstalledLspServers();
+    return cachedSpecs;
+}
+/**
+ * 注册 6 个 LSP 工具到 Bolloon agent 的工具系统.
+ * 在 registerBuiltinTools 内部调用.
+ */
+export function registerLspTools(ctx) {
+    ctx.tools.set('lsp_detect', {
+        name: 'lsp_detect',
+        description: '检测本机已安装的 LSP (Language Server Protocol) 服务器, 返回可用的语言列表',
+        parameters: {},
+        execute: async (_args) => {
+            try {
+                const specs = await getSpecs();
+                if (specs.length === 0) {
+                    return { success: true, output: '⚠️ 未检测到任何 LSP 服务器。可安装:\n  npm install -g typescript-language-server\n  cargo install rust-analyzer' };
+                }
+                const lines = specs.map(s => `  ✅ ${s.displayName} (${s.language}): ${s.fileExtensions.join(', ')}`);
+                return { success: true, output: `已检测到 ${specs.length} 个 LSP 服务器:\n${lines.join('\n')}` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_start', {
+        name: 'lsp_start',
+        description: '启动指定语言的语言服务器 (如 typescript / rust / python)',
+        parameters: { language: '语言 id, 如 typescript / rust / python (必填)' },
+        execute: async (args) => {
+            try {
+                const language = String(args.language || '').trim().toLowerCase();
+                if (!language)
+                    return { success: false, error: 'language 必填' };
+                const inst = await startLspServer(language);
+                if (!inst)
+                    return { success: false, error: `未找到 ${language} 的 LSP 服务器, 请先安装` };
+                return { success: true, output: `✅ ${inst.spec.displayName} 已启动` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_hover', {
+        name: 'lsp_hover',
+        description: '在文件某位置悬停, 查看类型/文档 (需要先 lsp_start)',
+        parameters: {
+            file: '文件路径 (必填)',
+            line: '行号 (从 0 开始)',
+            character: '列号 (从 0 开始)',
+            content: '文件内容 (可选, 首次需要以触发 didOpen)',
+        },
+        execute: async (args) => {
+            try {
+                const file = String(args.file || '').trim();
+                if (!file)
+                    return { success: false, error: 'file 必填' };
+                const line = parseInt(String(args.line || '0'), 10);
+                const character = parseInt(String(args.character || '0'), 10);
+                const content = args.content ? String(args.content) : undefined;
+                const specs = await getSpecs();
+                const spec = findLspForFile(file, specs);
+                if (!spec)
+                    return { success: false, error: `未找到 ${file} 对应的 LSP 服务器` };
+                const inst = await startLspServer(spec.language);
+                if (!inst)
+                    return { success: false, error: `LSP ${spec.language} 启动失败` };
+                if (content)
+                    lspDidOpen(inst, file, content);
+                const result = await lspHover(inst, file, line, character);
+                if (!result)
+                    return { success: true, output: '(无悬停信息)' };
+                return { success: true, output: result.contents };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_completion', {
+        name: 'lsp_completion',
+        description: '在文件某位置获取代码补全建议 (需要先 lsp_start)',
+        parameters: {
+            file: '文件路径 (必填)',
+            line: '行号 (从 0 开始)',
+            character: '列号 (从 0 开始)',
+            content: '文件内容 (可选)',
+        },
+        execute: async (args) => {
+            try {
+                const file = String(args.file || '').trim();
+                if (!file)
+                    return { success: false, error: 'file 必填' };
+                const line = parseInt(String(args.line || '0'), 10);
+                const character = parseInt(String(args.character || '0'), 10);
+                const content = args.content ? String(args.content) : undefined;
+                const specs = await getSpecs();
+                const spec = findLspForFile(file, specs);
+                if (!spec)
+                    return { success: false, error: `未找到 ${file} 对应的 LSP 服务器` };
+                const inst = await startLspServer(spec.language);
+                if (!inst)
+                    return { success: false, error: `LSP ${spec.language} 启动失败` };
+                if (content)
+                    lspDidOpen(inst, file, content);
+                const result = await lspCompletion(inst, file, line, character);
+                if (result.items.length === 0)
+                    return { success: true, output: '(无补全建议)' };
+                const items = result.items.slice(0, 20).map(i => `  ${i.label}${i.detail ? ` — ${i.detail}` : ''}`);
+                return { success: true, output: `补全建议 (显示前 20 条):\n${items.join('\n')}` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_diagnostics', {
+        name: 'lsp_diagnostics',
+        description: '获取文件的诊断结果 (错误/警告)',
+        parameters: { file: '文件路径 (必填)', content: '文件内容 (可选)' },
+        execute: async (args) => {
+            try {
+                const file = String(args.file || '').trim();
+                if (!file)
+                    return { success: false, error: 'file 必填' };
+                const content = args.content ? String(args.content) : undefined;
+                const specs = await getSpecs();
+                const spec = findLspForFile(file, specs);
+                if (!spec)
+                    return { success: false, error: `未找到 ${file} 对应的 LSP 服务器` };
+                const inst = await startLspServer(spec.language);
+                if (!inst)
+                    return { success: false, error: `LSP ${spec.language} 启动失败` };
+                if (content)
+                    lspDidOpen(inst, file, content);
+                const result = await lspDiagnostics(inst, file);
+                if (result.diagnostics.length === 0)
+                    return { success: true, output: '✅ 无诊断问题' };
+                const lines = result.diagnostics.map(d => {
+                    const sev = ['', '错误', '警告', '信息', '提示'][d.severity || 0] || '未知';
+                    const pos = `L${d.range.start.line}:${d.range.start.character}`;
+                    return `  ${sev === '错误' ? '❌' : sev === '警告' ? '⚠️' : 'ℹ️'} [${pos}] ${sev}: ${d.message}`;
+                });
+                return { success: true, output: `诊断结果 (${result.diagnostics.length} 条):\n${lines.join('\n')}` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_go_to_definition', {
+        name: 'lsp_go_to_definition',
+        description: '跳转到符号定义的位置',
+        parameters: {
+            file: '当前文件路径 (必填)',
+            line: '行号 (从 0 开始)',
+            character: '列号 (从 0 开始)',
+        },
+        execute: async (args) => {
+            try {
+                const file = String(args.file || '').trim();
+                if (!file)
+                    return { success: false, error: 'file 必填' };
+                const line = parseInt(String(args.line || '0'), 10);
+                const character = parseInt(String(args.character || '0'), 10);
+                const specs = await getSpecs();
+                const spec = findLspForFile(file, specs);
+                if (!spec)
+                    return { success: false, error: `未找到 ${file} 对应的 LSP 服务器` };
+                const inst = await startLspServer(spec.language);
+                if (!inst)
+                    return { success: false, error: `LSP ${spec.language} 启动失败` };
+                const loc = await lspGoToDefinition(inst, file, line, character);
+                if (!loc)
+                    return { success: true, output: '(未找到定义位置)' };
+                return { success: true, output: `定义位置: ${loc.uri} (L${loc.range.start.line}:${loc.range.start.character})` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+    ctx.tools.set('lsp_stop', {
+        name: 'lsp_stop',
+        description: '关闭指定语言的语言服务器 (或 all 关闭所有)',
+        parameters: { language: '语言 id, 如 typescript, 或 all 关闭全部' },
+        execute: async (args) => {
+            try {
+                const language = String(args.language || '').trim().toLowerCase();
+                if (!language)
+                    return { success: false, error: 'language 必填 (或 "all")' };
+                if (language === 'all') {
+                    stopAllLspServers();
+                    return { success: true, output: '✅ 所有 LSP 服务器已关闭' };
+                }
+                await stopLspServer(language);
+                return { success: true, output: `✅ ${language} LSP 服务器已关闭` };
+            }
+            catch (e) {
+                return { success: false, error: String(e) };
+            }
+        },
+    });
+}

package/dist/utils/auto-update.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * npm 自动更新检查器
  *
@@ -14,48 +13,11 @@
  *   开发态下若 cwd 的 package.json 就是本包则回退到 cwd，不受任意工作目录影响。
  * - 检查频率受节流缓存约束（默认 24h 一次），不会每次启动都打 npm。
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkAndUpdate = checkAndUpdate;
-exports.checkForUpdates = checkForUpdates;
-exports.performUpdate = performUpdate;
-const child_process_1 = require("child_process");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const https = __importStar(require("https"));
-const http = __importStar(require("http"));
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as https from 'https';
+import * as http from 'http';
 // ANSI 颜色
 const RESET = '\x1b[0m';
 const BOLD = '\x1b[1m';
@@ -113,7 +75,7 @@ function getGlobalBolloonDir() {
     const candidates = [];
     // 1. npm root -g（最可靠）
     try {
-        const npmRoot = (0, child_process_1.execSync)('npm root -g', { encoding: 'utf-8', timeout: 8000 }).trim();
+        const npmRoot = execSync('npm root -g', { encoding: 'utf-8', timeout: 8000 }).trim();
         if (npmRoot)
             candidates.push(path.join(npmRoot, '@bolloon', 'bolloon-agent'));
     }
@@ -122,7 +84,7 @@ function getGlobalBolloonDir() {
     }
     // 2. npm prefix -g
     try {
-        const npmPrefix = (0, child_process_1.execSync)('npm prefix -g', { encoding: 'utf-8', timeout: 8000 }).trim();
+        const npmPrefix = execSync('npm prefix -g', { encoding: 'utf-8', timeout: 8000 }).trim();
         if (npmPrefix)
             candidates.push(path.join(npmPrefix, 'lib', 'node_modules', '@bolloon', 'bolloon-agent'));
     }
@@ -280,7 +242,7 @@ async function checkBolloonUpdates() {
  */
 function checkNpmOutdated() {
     try {
-        const output = (0, child_process_1.execSync)('npm outdated --json', {
+        const output = execSync('npm outdated --json', {
             encoding: 'utf-8',
             timeout: 30000,
             maxBuffer: 10 * 1024 * 1024,
@@ -344,7 +306,7 @@ async function updatePackagesWithVersion(packagesWithVersion) {
     const args = ['npm', 'install', '-g', ...packagesWithVersion];
     notify(`\n${CYAN}📦 正在更新包...${RESET}\n`, RESET);
     try {
-        (0, child_process_1.execSync)(args.join(' '), {
+        execSync(args.join(' '), {
             encoding: 'utf-8',
             timeout: 300000,
             stdio: 'inherit',
@@ -462,7 +424,7 @@ function resolveAutoUpdatePolicy() {
  *                       例如 Electron 用 app.relaunch()，Node 用 detached 重新 spawn）。
  *                       若未提供或 autoRestart=false，则仅提示用户手动重启。
  */
-async function checkAndUpdate(opts = {}) {
+export async function checkAndUpdate(opts = {}) {
     const policy = resolveAutoUpdatePolicy();
     if (policy.blocked) {
         return { hasUpdate: false, info: null, updated: false, message: '跳过更新检查（已显式禁用）' };
@@ -566,13 +528,13 @@ async function checkAndUpdate(opts = {}) {
 /**
  * 仅检查更新，不自动安装
  */
-async function checkForUpdates() {
+export async function checkForUpdates() {
     return await checkBolloonUpdates();
 }
 /**
  * 手动触发更新
  */
-async function performUpdate(packages) {
+export async function performUpdate(packages) {
     return await updatePackages(packages);
 }
 // CLI 入口
@@ -595,4 +557,3 @@ if (process.argv[1]?.includes('auto-update')) {
         }
     })();
 }
-//# sourceMappingURL=auto-update.js.map