@lingxiao-office/sdk 1.0.0

package/dist/tools/LspClient.d.ts

@@ -0,0 +1,94 @@
+export interface LspServerConfig {
+    command: string[];
+    /** Working directory for the LSP server process */
+    rootUri?: string;
+}
+export interface LspLocation {
+    uri: string;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+export interface LspSymbol {
+    name: string;
+    kind: number;
+    location?: LspLocation;
+    containerName?: string;
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    selectionRange?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+export interface LspHoverResult {
+    contents: string;
+}
+export declare function getSymbolKindName(kind: number): string;
+export declare function formatLocation(loc: LspLocation): string;
+export declare function formatSymbol(sym: LspSymbol): string;
+export declare function detectLanguage(filePath: string): string | null;
+export declare function getDefaultConfig(language: string): string[] | null;
+export declare class LspConnection {
+    private process;
+    private buffer;
+    private nextId;
+    private pendingRequests;
+    private initialized;
+    readonly language: string;
+    readonly rootUri: string;
+    private config;
+    constructor(language: string, rootUri: string, config?: string[]);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * 统一的进程终结例程(C3/C4):已死则跳过 kill;先 SIGTERM,2s 后 SIGKILL;无条件 destroy stdio 释放 fd。
+     * 幂等——多次调用(stop/onError/onExit 重叠)安全。
+     */
+    private killProcess;
+    isReady(): boolean;
+    hasPendingRequests(): boolean;
+    goToDefinition(filePath: string, line: number, character: number): Promise<LspLocation[]>;
+    findReferences(filePath: string, line: number, character: number): Promise<LspLocation[]>;
+    hover(filePath: string, line: number, character: number): Promise<LspHoverResult | null>;
+    documentSymbol(filePath: string): Promise<LspSymbol[]>;
+    workspaceSymbol(query: string): Promise<LspSymbol[]>;
+    private makeTextDocumentPositionParams;
+    private initialize;
+    private sendNotification;
+    private sendRequest;
+    private writeMessage;
+    private onData;
+    private handleMessage;
+    private onProcessError;
+    private onProcessExit;
+    private rejectAllPending;
+    private normalizeLocations;
+    private normalizeSymbols;
+    private extractHoverContents;
+}
+export declare function getOrCreateConnection(language: string, rootUri: string, config?: string[]): Promise<LspConnection>;
+export declare function stopAllConnections(): Promise<void>;
+export declare function getActiveConnectionCount(): number;
+//# sourceMappingURL=LspClient.d.ts.map

package/dist/tools/LspClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LspClient.d.ts","sourceRoot":"","sources":["../../src/tools/LspClient.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACjG;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACjG,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC3G;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAcD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAKvD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAWnD;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAElE;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,eAAe,CAAoF;IAC3G,OAAO,CAAC,WAAW,CAAS;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,MAAM,CAAW;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;IAM1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAenB,OAAO,IAAI,OAAO;IAIlB,kBAAkB,IAAI,OAAO;IAMvB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMzF,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASzF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAOxF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMtD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAO1D,OAAO,CAAC,8BAA8B;YAOxB,UAAU;IAoBxB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB;CAU7B;AA0ED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKxD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}

package/dist/tools/LspClient.js

@@ -0,0 +1,429 @@
+/**
+ * LSP Client — manages Language Server Protocol server connections and requests.
+ *
+ * Experimental: gated behind LINGXIAO_EXPERIMENTAL_LSP=1
+ */
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { registerCleanup } from '../core/CleanupRegistry.js';
+// ── Default configs per language ─────────────────────────────────────────────
+const DEFAULT_CONFIGS = {
+    typescript: ['typescript-language-server', '--stdio'],
+    javascript: ['typescript-language-server', '--stdio'],
+    python: ['pylsp'],
+    rust: ['rust-analyzer'],
+    go: ['gopls', 'serve'],
+};
+const MAX_ACTIVE_CONNECTIONS = 8;
+const CONNECTION_IDLE_TTL_MS = 10 * 60_000;
+const CONNECTION_CLEANUP_INTERVAL_MS = 60_000;
+// ── LSP Symbol kinds ─────────────────────────────────────────────────────────
+const SYMBOL_KIND_NAMES = {
+    1: 'File', 2: 'Module', 3: 'Namespace', 4: 'Package', 5: 'Class',
+    6: 'Method', 7: 'Property', 8: 'Field', 9: 'Constructor', 10: 'Enum',
+    11: 'Interface', 12: 'Function', 13: 'Variable', 14: 'Constant',
+    15: 'String', 16: 'Number', 17: 'Boolean', 18: 'Array', 19: 'Object',
+    20: 'Key', 21: 'Null', 22: 'EnumMember', 23: 'Struct', 24: 'Event',
+    25: 'Operator', 26: 'TypeParameter',
+};
+export function getSymbolKindName(kind) {
+    return SYMBOL_KIND_NAMES[kind] || `Unknown(${kind})`;
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function filePathToUri(filePath) {
+    const abs = resolve(filePath);
+    return `file://${abs}`;
+}
+function uriToFilePath(uri) {
+    if (uri.startsWith('file://'))
+        return uri.slice(7);
+    return uri;
+}
+export function formatLocation(loc) {
+    const file = uriToFilePath(loc.uri);
+    const line = loc.range.start.line + 1;
+    const col = loc.range.start.character + 1;
+    return `${file}:${line}:${col}`;
+}
+export function formatSymbol(sym) {
+    const kind = getSymbolKindName(sym.kind);
+    if (sym.location) {
+        return `${sym.name} [${kind}] ${formatLocation(sym.location)}`;
+    }
+    if (sym.range) {
+        const line = sym.range.start.line + 1;
+        const col = sym.range.start.character + 1;
+        return `${sym.name} [${kind}] line ${line}:${col}`;
+    }
+    return `${sym.name} [${kind}]`;
+}
+// ── Language detection ───────────────────────────────────────────────────────
+export function detectLanguage(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase();
+    switch (ext) {
+        case 'ts':
+        case 'tsx':
+        case 'mts':
+        case 'cts': return 'typescript';
+        case 'js':
+        case 'jsx':
+        case 'mjs':
+        case 'cjs': return 'javascript';
+        case 'py':
+        case 'pyi': return 'python';
+        case 'rs': return 'rust';
+        case 'go': return 'go';
+        default: return null;
+    }
+}
+export function getDefaultConfig(language) {
+    return DEFAULT_CONFIGS[language] ?? null;
+}
+// ── LSP Connection ───────────────────────────────────────────────────────────
+export class LspConnection {
+    process = null;
+    buffer = '';
+    nextId = 1;
+    pendingRequests = new Map();
+    initialized = false;
+    language;
+    rootUri;
+    config;
+    constructor(language, rootUri, config) {
+        this.language = language;
+        this.rootUri = rootUri;
+        this.config = config ?? getDefaultConfig(language) ?? [];
+    }
+    async start() {
+        if (this.config.length === 0) {
+            throw new Error(`No LSP server configured for language: ${this.language}`);
+        }
+        const [cmd, ...args] = this.config;
+        this.process = spawn(cmd, args, {
+            cwd: this.rootUri,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.process.stdout.on('data', (chunk) => this.onData(chunk));
+        this.process.stderr.on('data', () => { });
+        this.process.on('error', (err) => this.onProcessError(err));
+        this.process.on('exit', () => this.onProcessExit());
+        try {
+            await this.initialize();
+        }
+        catch (err) {
+            // C3: initialize 失败(30s 超时/协议错/server 立即退出)→ 显式 kill 刚 spawn 的进程并释放 stdio fd,
+            // 否则 getOrCreateConnection 因 start() reject 不将其入 activeConnections → 孤子进程泄漏。
+            const proc = this.process;
+            this.process = null;
+            this.initialized = false;
+            this.killProcess(proc);
+            this.rejectAllPending(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+    }
+    async stop() {
+        const proc = this.process;
+        if (!proc)
+            return;
+        // 优雅关闭协议(shutdown → exit notification),失败容忍(进程可能已死)。
+        try {
+            await this.sendRequest('shutdown', null);
+            this.sendNotification('exit', null);
+        }
+        catch { /* ignore */ }
+        this.process = null;
+        this.initialized = false;
+        // C4: SIGTERM + 2s 后 SIGKILL 兜底 + destroy stdio,确保子进程与 fd 不泄漏。
+        this.killProcess(proc);
+        this.rejectAllPending(new Error('LSP server stopped'));
+    }
+    /**
+     * 统一的进程终结例程(C3/C4):已死则跳过 kill;先 SIGTERM,2s 后 SIGKILL;无条件 destroy stdio 释放 fd。
+     * 幂等——多次调用(stop/onError/onExit 重叠)安全。
+     */
+    killProcess(proc) {
+        if (!proc)
+            return;
+        const alreadyDead = proc.exitCode !== null || proc.signalCode !== null;
+        if (!alreadyDead) {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { /* tolerate */ }
+            const killTimer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch { /* already reaped */ }
+            }, 2000);
+            killTimer.unref?.();
+        }
+        for (const stream of [proc.stdin, proc.stdout, proc.stderr]) {
+            try {
+                stream?.destroy();
+            }
+            catch { /* tolerate */ }
+        }
+    }
+    isReady() {
+        return this.initialized && this.process !== null;
+    }
+    hasPendingRequests() {
+        return this.pendingRequests.size > 0;
+    }
+    // ── LSP Operations ──────────────────────────────────────────────────────
+    async goToDefinition(filePath, line, character) {
+        const params = this.makeTextDocumentPositionParams(filePath, line, character);
+        const result = await this.sendRequest('textDocument/definition', params);
+        return this.normalizeLocations(result);
+    }
+    async findReferences(filePath, line, character) {
+        const params = {
+            ...this.makeTextDocumentPositionParams(filePath, line, character),
+            context: { includeDeclaration: true },
+        };
+        const result = await this.sendRequest('textDocument/references', params);
+        return this.normalizeLocations(result);
+    }
+    async hover(filePath, line, character) {
+        const params = this.makeTextDocumentPositionParams(filePath, line, character);
+        const result = await this.sendRequest('textDocument/hover', params);
+        if (!result || !result.contents)
+            return null;
+        return { contents: this.extractHoverContents(result.contents) };
+    }
+    async documentSymbol(filePath) {
+        const params = { textDocument: { uri: filePathToUri(filePath) } };
+        const result = await this.sendRequest('textDocument/documentSymbol', params);
+        return this.normalizeSymbols(result);
+    }
+    async workspaceSymbol(query) {
+        const result = await this.sendRequest('workspace/symbol', { query });
+        return this.normalizeSymbols(result);
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    makeTextDocumentPositionParams(filePath, line, character) {
+        return {
+            textDocument: { uri: filePathToUri(filePath) },
+            position: { line: line - 1, character: character - 1 }, // convert 1-based to 0-based
+        };
+    }
+    async initialize() {
+        const initParams = {
+            processId: process.pid,
+            capabilities: {
+                textDocument: {
+                    definition: { dynamicRegistration: false },
+                    references: { dynamicRegistration: false },
+                    hover: { dynamicRegistration: false, contentFormat: ['plaintext', 'markdown'] },
+                    documentSymbol: { dynamicRegistration: false },
+                },
+                workspace: { symbol: { dynamicRegistration: false } },
+            },
+            rootUri: filePathToUri(this.rootUri),
+            workspaceFolders: [{ uri: filePathToUri(this.rootUri), name: 'workspace' }],
+        };
+        await this.sendRequest('initialize', initParams);
+        this.sendNotification('initialized', {});
+        this.initialized = true;
+    }
+    sendNotification(method, params) {
+        const message = { jsonrpc: '2.0', method, params };
+        this.writeMessage(message);
+    }
+    sendRequest(method, params) {
+        const id = this.nextId++;
+        const message = { jsonrpc: '2.0', id, method, params };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`LSP request "${method}" timed out after 30s`));
+            }, 30_000);
+            this.pendingRequests.set(id, {
+                resolve: (v) => { clearTimeout(timeout); resolve(v); },
+                reject: (e) => { clearTimeout(timeout); reject(e); },
+            });
+            this.writeMessage(message);
+        });
+    }
+    writeMessage(msg) {
+        if (!this.process?.stdin?.writable)
+            return;
+        const body = JSON.stringify(msg);
+        const header = `Content-Length: ${Buffer.byteLength(body)}\r\n\r\n`;
+        this.process.stdin.write(header + body);
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString('utf8');
+        while (true) {
+            const headerEnd = this.buffer.indexOf('\r\n\r\n');
+            if (headerEnd === -1)
+                break;
+            const header = this.buffer.slice(0, headerEnd);
+            const match = header.match(/Content-Length:\s*(\d+)/i);
+            if (!match) {
+                this.buffer = this.buffer.slice(headerEnd + 4);
+                continue;
+            }
+            const contentLength = parseInt(match[1], 10);
+            const bodyStart = headerEnd + 4;
+            if (this.buffer.length < bodyStart + contentLength)
+                break;
+            const body = this.buffer.slice(bodyStart, bodyStart + contentLength);
+            this.buffer = this.buffer.slice(bodyStart + contentLength);
+            this.handleMessage(body);
+        }
+    }
+    handleMessage(body) {
+        try {
+            const msg = JSON.parse(body);
+            if (msg.id !== undefined && this.pendingRequests.has(msg.id)) {
+                const pending = this.pendingRequests.get(msg.id);
+                this.pendingRequests.delete(msg.id);
+                if (msg.error) {
+                    pending.reject(new Error(msg.error.message));
+                }
+                else {
+                    pending.resolve(msg.result ?? null);
+                }
+            }
+        }
+        catch { /* malformed JSON — ignore */ }
+    }
+    onProcessError(err) {
+        this.rejectAllPending(err);
+        const proc = this.process;
+        this.process = null;
+        this.initialized = false;
+        // C3: spawn 'error'(如 ENOENT 找不到 server)也要兜底 kill+destroy stdio,不留半成品。
+        this.killProcess(proc);
+    }
+    onProcessExit() {
+        this.rejectAllPending(new Error('LSP server process exited'));
+        const proc = this.process;
+        this.process = null;
+        this.initialized = false;
+        this.killProcess(proc);
+    }
+    rejectAllPending(err) {
+        for (const pending of this.pendingRequests.values()) {
+            pending.reject(err);
+        }
+        this.pendingRequests.clear();
+    }
+    normalizeLocations(result) {
+        if (!result)
+            return [];
+        if (Array.isArray(result))
+            return result;
+        if (typeof result === 'object' && result !== null && 'uri' in result)
+            return [result];
+        return [];
+    }
+    normalizeSymbols(result) {
+        if (!result || !Array.isArray(result))
+            return [];
+        return result;
+    }
+    extractHoverContents(contents) {
+        if (typeof contents === 'string')
+            return contents;
+        if (Array.isArray(contents)) {
+            return contents.map((c) => (typeof c === 'string' ? c : c.value ?? '')).join('\n');
+        }
+        if (typeof contents === 'object' && contents !== null) {
+            return contents.value ?? JSON.stringify(contents);
+        }
+        return String(contents);
+    }
+}
+const activeConnections = new Map();
+let cleanupTimer = null;
+function connectionKey(language, rootUri) {
+    return `${language}:${rootUri}`;
+}
+function scheduleConnectionCleanup() {
+    if (cleanupTimer)
+        return;
+    cleanupTimer = setInterval(() => {
+        void pruneIdleConnections(Date.now()).catch(() => { });
+    }, CONNECTION_CLEANUP_INTERVAL_MS);
+    cleanupTimer.unref?.();
+}
+function stopConnectionCleanupIfIdle() {
+    if (activeConnections.size > 0 || !cleanupTimer)
+        return;
+    clearInterval(cleanupTimer);
+    cleanupTimer = null;
+}
+async function stopManagedConnection(key, managed) {
+    activeConnections.delete(key);
+    await managed.connection.stop().catch(() => { });
+    stopConnectionCleanupIfIdle();
+}
+async function pruneIdleConnections(now) {
+    const stale = [];
+    for (const [key, managed] of activeConnections.entries()) {
+        const isIdle = now - managed.lastUsedAt >= CONNECTION_IDLE_TTL_MS;
+        if (!managed.connection.isReady() || (isIdle && !managed.connection.hasPendingRequests())) {
+            stale.push([key, managed]);
+        }
+    }
+    await Promise.all(stale.map(([key, managed]) => stopManagedConnection(key, managed)));
+}
+async function evictLeastRecentlyUsedConnection(exemptKey) {
+    let oldest;
+    for (const entry of activeConnections.entries()) {
+        const [key, managed] = entry;
+        if (key === exemptKey || managed.connection.hasPendingRequests())
+            continue;
+        if (!oldest || managed.lastUsedAt < oldest[1].lastUsedAt) {
+            oldest = entry;
+        }
+    }
+    if (oldest) {
+        await stopManagedConnection(oldest[0], oldest[1]);
+    }
+}
+async function enforceConnectionLimit(exemptKey) {
+    while (activeConnections.size >= MAX_ACTIVE_CONNECTIONS) {
+        const before = activeConnections.size;
+        await evictLeastRecentlyUsedConnection(exemptKey);
+        if (activeConnections.size === before) {
+            throw new Error(`LSP connection limit reached (${MAX_ACTIVE_CONNECTIONS}); all connections are busy`);
+        }
+    }
+}
+export async function getOrCreateConnection(language, rootUri, config) {
+    const key = connectionKey(language, rootUri);
+    const now = Date.now();
+    await pruneIdleConnections(now);
+    const existing = activeConnections.get(key);
+    if (existing?.connection.isReady()) {
+        existing.lastUsedAt = now;
+        return existing.connection;
+    }
+    // Clean up stale connection
+    if (existing) {
+        await stopManagedConnection(key, existing);
+    }
+    await enforceConnectionLimit(key);
+    const conn = new LspConnection(language, rootUri, config);
+    await conn.start();
+    activeConnections.set(key, { connection: conn, lastUsedAt: Date.now() });
+    scheduleConnectionCleanup();
+    return conn;
+}
+export async function stopAllConnections() {
+    const stops = Array.from(activeConnections.values()).map((c) => c.connection.stop().catch(() => { }));
+    await Promise.all(stops);
+    activeConnections.clear();
+    stopConnectionCleanupIfIdle();
+}
+export function getActiveConnectionCount() {
+    return activeConnections.size;
+}
+// C2: 进程级清理——gracefulShutdown/runAllCleanups 时 kill 所有 LSP 子进程,
+// 防止 orphan LSP server 泄漏。与 BrowserManager.registerCleanup 同口径;无连接时为 no-op。
+registerCleanup(() => stopAllConnections(), 19);
+//# sourceMappingURL=LspClient.js.map

package/dist/tools/LspClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LspClient.js","sourceRoot":"","sources":["../../src/tools/LspClient.ts"],"names":[],"mappings":"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"}

package/dist/tools/MetaTool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MetaTool — Leader 内部元工具基类
+ *
+ * 与普通 Tool 的区别：
+ * 1. 使用 schema 直接提供 JSON Schema（不走 Zod 转换）
+ * 2. 标记 visibility: 'leader' — 仅 Leader 可见
+ * 3. execute() 通过 context.leaderToolsExecutor 委托给 LeaderToolsExecutor
+ */
+import type { JsonSchema, ToolContract, ToolContext, ToolResult } from '../contracts/types/Tool.js';
+import type { ToolMetadata } from './ToolMetadata.js';
+export declare abstract class MetaTool implements ToolContract {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    /** JSON Schema 定义 — 直接提供给 LLM，不走 Zod 转换 */
+    abstract readonly schema: JsonSchema;
+    readonly scope: "leader";
+    readonly metadata: ToolMetadata;
+    getSchema(): JsonSchema;
+    abstract execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default MetaTool;
+//# sourceMappingURL=MetaTool.d.ts.map

package/dist/tools/MetaTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaTool.d.ts","sourceRoot":"","sources":["../../src/tools/MetaTool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,8BAAsB,QAAS,YAAW,YAAY;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAG,QAAQ,CAAU;IAEnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAI7B;IAEF,SAAS,IAAI,UAAU;IAIvB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAC5E;AAED,eAAe,QAAQ,CAAC"}

package/dist/tools/MetaTool.js

@@ -0,0 +1,21 @@
+/**
+ * MetaTool — Leader 内部元工具基类
+ *
+ * 与普通 Tool 的区别：
+ * 1. 使用 schema 直接提供 JSON Schema（不走 Zod 转换）
+ * 2. 标记 visibility: 'leader' — 仅 Leader 可见
+ * 3. execute() 通过 context.leaderToolsExecutor 委托给 LeaderToolsExecutor
+ */
+export class MetaTool {
+    scope = 'leader';
+    metadata = {
+        tier: 'execute',
+        category: 'orchestration',
+        visibility: 'leader',
+    };
+    getSchema() {
+        return this.schema;
+    }
+}
+export default MetaTool;
+//# sourceMappingURL=MetaTool.js.map

package/dist/tools/MetaTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaTool.js","sourceRoot":"","sources":["../../src/tools/MetaTool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,OAAgB,QAAQ;IAOnB,KAAK,GAAG,QAAiB,CAAC;IAE1B,QAAQ,GAAiB;QAChC,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,QAAQ;KACrB,CAAC;IAEF,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CAGF;AAED,eAAe,QAAQ,CAAC"}