sysmledgraph 0.7.0

package/dist/src/parser/lsp-client.js

@@ -0,0 +1,230 @@
+/**
+ * SysML LSP integration: stdio client (JSON-RPC over Content-Length framing).
+ *
+ * **MCP Client Pattern**: This follows MCP client lifecycle (initialize → initialized → requests),
+ * but uses LSP protocol messages (textDocument/documentSymbol) instead of MCP tools/call.
+ * The server uses Content-Length framing (LSP-style), not newline-delimited (MCP SDK style),
+ * so we implement a custom transport rather than using @modelcontextprotocol/sdk StdioClientTransport.
+ *
+ * Reference: https://github.com/andrea9293/mcp-client-template for MCP client patterns.
+ *
+ * Spawns an external **server.js** — this repo does **not** bundle sysml-v2-lsp.
+ * Set **SYSMLLSP_SERVER_PATH** to a built [daltskin/sysml-v2-lsp](https://github.com/daltskin/sysml-v2-lsp)
+ * `dist/server/server.js` (from a separate install or wherever your SysML MCP/LSP provides it).
+ */
+import { spawn } from 'child_process';
+import { pathToFileURL } from 'url';
+import { dirname, resolve } from 'path';
+import { getDefaultLspServerPath } from './lsp-server-path.js';
+/** Absolute path to LSP server script, or null if none found. Uses getDefaultLspServerPath (env → lsp/ → root). */
+export function resolveLspServerPath() {
+    return getDefaultLspServerPath();
+}
+function sendLspMessage(proc, body) {
+    const buf = Buffer.from(body, 'utf8');
+    proc.stdin?.write(`Content-Length: ${buf.length}\r\n\r\n`, 'utf8');
+    proc.stdin?.write(buf, 'utf8');
+}
+/** Create a reader that yields one LSP message at a time from stdout. Rejects on stream close/error or process exit. */
+function createMessageReader(proc) {
+    let buffer = '';
+    let contentLength = null;
+    let waiting = null;
+    function rejectWaiting(err) {
+        if (waiting) {
+            waiting.reject(err);
+            waiting = null;
+        }
+    }
+    proc.stdout?.setEncoding('utf8');
+    proc.stdout?.on('data', (chunk) => {
+        buffer += chunk;
+        for (;;) {
+            if (contentLength === null) {
+                const idx = buffer.indexOf('\r\n\r\n');
+                if (idx === -1)
+                    break;
+                const header = buffer.slice(0, idx);
+                const m = header.match(/Content-Length:\s*(\d+)/i);
+                contentLength = m ? parseInt(m[1], 10) : 0;
+                buffer = buffer.slice(idx + 4);
+            }
+            if (contentLength !== null && buffer.length >= contentLength) {
+                const body = buffer.slice(0, contentLength);
+                buffer = buffer.slice(contentLength);
+                contentLength = null;
+                if (waiting) {
+                    waiting.resolve(body);
+                    waiting = null;
+                }
+            }
+            else
+                break;
+        }
+    });
+    proc.stdout?.on('close', () => rejectWaiting(new Error('LSP stdout closed')));
+    proc.stdout?.on('error', (err) => rejectWaiting(err instanceof Error ? err : new Error(String(err))));
+    proc.on('exit', (code, signal) => {
+        rejectWaiting(new Error(`LSP process exited (code=${code}, signal=${signal})`));
+    });
+    proc.on('error', (err) => rejectWaiting(err instanceof Error ? err : new Error(String(err))));
+    return () => new Promise((resolve, reject) => {
+        if (buffer.length > 0 && contentLength !== null && buffer.length >= contentLength) {
+            const body = buffer.slice(0, contentLength);
+            buffer = buffer.slice(contentLength);
+            contentLength = null;
+            resolve(body);
+            return;
+        }
+        waiting = { resolve, reject };
+    });
+}
+const LSP_REQUEST_TIMEOUT_MS = 30000;
+function runLspRequest(proc, readNext, method, params, id, onNotification) {
+    const body = JSON.stringify({ jsonrpc: '2.0', id, method, params });
+    sendLspMessage(proc, body);
+    return (async () => {
+        const deadline = Date.now() + LSP_REQUEST_TIMEOUT_MS;
+        for (;;) {
+            const raw = await Promise.race([
+                readNext(),
+                new Promise((_, rej) => setTimeout(() => rej(new Error(`LSP ${method} timeout after ${LSP_REQUEST_TIMEOUT_MS}ms`)), Math.max(100, deadline - Date.now()))),
+            ]);
+            let msg;
+            try {
+                msg = JSON.parse(raw);
+            }
+            catch {
+                continue; // skip malformed message (e.g. server log line)
+            }
+            if (msg.id === id) {
+                if (msg.error)
+                    throw new Error(msg.error.message || JSON.stringify(msg.error));
+                return msg.result;
+            }
+            // Server sent a notification (no id) or response for another request
+            if (msg.id === undefined && msg.method && onNotification) {
+                onNotification(msg.method, msg.params ?? {});
+            }
+        }
+    })();
+}
+function sendNotification(proc, method, params) {
+    sendLspMessage(proc, JSON.stringify({ jsonrpc: '2.0', method, params }));
+}
+let requestId = 1;
+function nextId() {
+    return requestId++;
+}
+export async function createLspClient() {
+    const path = resolveLspServerPath();
+    if (!path) {
+        throw new Error('SysML LSP server path not set. Set SYSMLLSP_SERVER_PATH to the absolute or cwd-relative path ' +
+            'to sysml-v2-lsp dist/server/server.js (install [daltskin/sysml-v2-lsp](https://github.com/daltskin/sysml-v2-lsp) ' +
+            'separately or via your SysML MCP setup). This package no longer bundles sysml-v2-lsp.');
+    }
+    // Run from package root when path is .../dist/server/server.js so sysml-v2-lsp finds sysml.library.
+    // If path is under repo/lsp/node_modules/..., use repo/lsp as cwd (dedicated LSP init folder).
+    const serverDir = dirname(path);
+    const pathNorm = path.replace(/\\/g, '/');
+    const lspNodeModules = '/lsp/node_modules/';
+    const lspNodeModulesWin = '\\lsp\\node_modules\\';
+    const underLsp = pathNorm.includes(lspNodeModules) ||
+        path.includes(lspNodeModulesWin);
+    const distServer = 'dist' + (serverDir.includes('\\') ? '\\' : '/') + 'server';
+    const cwd = underLsp
+        ? resolve(process.cwd(), 'lsp')
+        : serverDir.endsWith(distServer)
+            ? dirname(serverDir)
+            : serverDir;
+    // On Windows, spawn via cmd /c so Node runs the script (avoids "open with" for .js)
+    const isWin = process.platform === 'win32';
+    const proc = isWin
+        ? spawn('cmd', ['/c', process.execPath, path, '--stdio'], { stdio: ['pipe', 'pipe', 'pipe'], cwd })
+        : spawn(process.execPath, [path, '--stdio'], { stdio: ['pipe', 'pipe', 'pipe'], cwd });
+    proc.stderr?.on('data', () => { });
+    const readNext = createMessageReader(proc);
+    const onNotification = (method, params) => {
+        if (process.env.DEBUG_LSP_NOTIFICATIONS === '1' && (method === 'window/logMessage' || method === 'window/showMessage')) {
+            const p = params;
+            process.stderr.write(`[LSP ${method}] ${p?.message ?? JSON.stringify(params)}\n`);
+        }
+    };
+    // MCP client lifecycle: 1) initialize request
+    const rootUri = pathToFileURL(resolve(cwd, '.')).href;
+    await runLspRequest(proc, readNext, 'initialize', {
+        processId: process.pid,
+        rootUri,
+        capabilities: {
+            textDocument: {
+                documentSymbol: { hierarchicalDocumentSymbolSupport: true },
+            },
+        },
+        workspaceFolders: [{ uri: rootUri, name: 'workspace' }],
+    }, nextId(), onNotification);
+    // MCP client lifecycle: 2) initialized notification (after initialize response)
+    sendNotification(proc, 'initialized', {});
+    await new Promise((r) => setTimeout(r, 200));
+    async function getDocumentSymbols(uri, content) {
+        const docUri = uri.startsWith('file:') ? uri : pathToFileURL(uri).href;
+        sendNotification(proc, 'textDocument/didOpen', {
+            textDocument: { uri: docUri, languageId: 'sysml', version: 1, text: content },
+        });
+        await new Promise((r) => setTimeout(r, 500));
+        const result = await runLspRequest(proc, readNext, 'textDocument/documentSymbol', { textDocument: { uri: docUri } }, nextId(), onNotification);
+        if (result == null)
+            return [];
+        let arr = [];
+        if (Array.isArray(result))
+            arr = result;
+        else if (typeof result === 'object' && 'data' in result && Array.isArray(result.data)) {
+            arr = result.data;
+        }
+        if (arr.length === 0)
+            return [];
+        // Normalize SymbolInformation (location, name, kind, containerName) → DocumentSymbol-like (range, name, kind)
+        const first = arr[0];
+        if (first?.location && !first?.range) {
+            return arr.map((item) => {
+                const i = item;
+                return {
+                    name: String(i.name ?? ''),
+                    detail: i.detail != null ? String(i.detail) : undefined,
+                    kind: Number(i.kind ?? 0),
+                    range: i.location?.range ?? { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } },
+                    selectionRange: i.location?.range,
+                    children: undefined,
+                    containerName: i.containerName != null ? String(i.containerName) : undefined,
+                };
+            });
+        }
+        return arr;
+    }
+    function close() {
+        proc.kill('SIGTERM');
+    }
+    return { getDocumentSymbols, close };
+}
+let sharedClient = null;
+const LSP_INIT_RETRY_DELAY_MS = 1500;
+/** Spawns external LSP (SYSMLLSP_SERVER_PATH). Throws if unset or startup fails. Retries once on transient failure. */
+export async function getDocumentSymbolsFromLsp(filePath, content) {
+    if (!sharedClient) {
+        try {
+            sharedClient = await createLspClient();
+        }
+        catch (firstErr) {
+            await new Promise((r) => setTimeout(r, LSP_INIT_RETRY_DELAY_MS));
+            sharedClient = await createLspClient();
+        }
+    }
+    const uri = pathToFileURL(filePath).href;
+    return await sharedClient.getDocumentSymbols(uri, content);
+}
+export function closeLspClient() {
+    if (sharedClient) {
+        sharedClient.close();
+        sharedClient = null;
+    }
+}
+//# sourceMappingURL=lsp-client.js.map

package/dist/src/parser/lsp-client.js.map

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

package/dist/src/parser/lsp-server-path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Default LSP server path: env override, then lsp/ then root node_modules.
+ * Single source for "independent LSP" used only by sysmledgraph (see docs/PLAN_INDEPENDENT_LSP.md).
+ */
+/**
+ * Resolved path to the LSP server script, or null if none found.
+ * Order: SYSMLLSP_SERVER_PATH (if set) → lsp/.../server.js → root node_modules/.../server.js.
+ */
+export declare function getDefaultLspServerPath(): string | null;
+//# sourceMappingURL=lsp-server-path.d.ts.map

package/dist/src/parser/lsp-server-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-server-path.d.ts","sourceRoot":"","sources":["../../../src/parser/lsp-server-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAYvD"}

package/dist/src/parser/lsp-server-path.js

@@ -0,0 +1,29 @@
+/**
+ * Default LSP server path: env override, then lsp/ then root node_modules.
+ * Single source for "independent LSP" used only by sysmledgraph (see docs/PLAN_INDEPENDENT_LSP.md).
+ */
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+const LSP_RELATIVE_PATHS = [
+    'lsp/node_modules/sysml-v2-lsp/dist/server/server.js',
+    'node_modules/sysml-v2-lsp/dist/server/server.js',
+];
+/**
+ * Resolved path to the LSP server script, or null if none found.
+ * Order: SYSMLLSP_SERVER_PATH (if set) → lsp/.../server.js → root node_modules/.../server.js.
+ */
+export function getDefaultLspServerPath() {
+    const env = process.env.SYSMLLSP_SERVER_PATH?.trim();
+    if (env) {
+        const isAbsolute = env.startsWith('/') || /^[A-Za-z]:[/\\]/.test(env);
+        return isAbsolute ? env : resolve(process.cwd(), env);
+    }
+    const cwd = process.cwd();
+    for (const rel of LSP_RELATIVE_PATHS) {
+        const p = resolve(cwd, rel);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+//# sourceMappingURL=lsp-server-path.js.map

package/dist/src/parser/lsp-server-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-server-path.js","sourceRoot":"","sources":["../../../src/parser/lsp-server-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,MAAM,kBAAkB,GAAG;IACzB,qDAAqD;IACrD,iDAAiD;CACzC,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACrD,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/parser/symbols.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Normalized symbol/relation shape for the graph.
+ * Maps LSP DocumentSymbol → NormalizedSymbol. LSP is an external process (SYSMLLSP_SERVER_PATH); not bundled.
+ */
+import type { NormalizedSymbol } from '../types.js';
+/**
+ * Get symbols and relations for a single file. Tries LSP documentSymbol first when SYSMLLSP_SERVER_PATH is set;
+ * if LSP returns no symbols (or is unset), uses MCP getSymbols (one shared client per index run).
+ */
+export declare function getSymbolsForFile(filePath: string, content?: string): Promise<NormalizedSymbol[]>;
+/** Call after indexing to close the shared LSP and MCP clients. */
+export declare function closeLspClient(): void;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/src/parser/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/parser/symbols.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAA0C,MAAM,aAAa,CAAC;AA2G5F;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgCvG;AAUD,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/src/parser/symbols.js

@@ -0,0 +1,150 @@
+/**
+ * Normalized symbol/relation shape for the graph.
+ * Maps LSP DocumentSymbol → NormalizedSymbol. LSP is an external process (SYSMLLSP_SERVER_PATH); not bundled.
+ */
+import { readFile } from 'fs/promises';
+import { symbolKindToNodeLabel, lspSymbolKindToNodeLabel } from '../symbol-to-graph/mapping.js';
+import { getDocumentSymbolsFromLsp, closeLspClient as closeLspClientImpl, resolveLspServerPath, } from './lsp-client.js';
+function flattenSymbols(symbols, parentQualifiedName) {
+    const out = [];
+    for (const sym of symbols) {
+        const qualifiedName = parentQualifiedName ? `${parentQualifiedName}::${sym.name}` : sym.name;
+        out.push({ sym, qualifiedName });
+        if (sym.children && sym.children.length > 0) {
+            out.push(...flattenSymbols(sym.children, qualifiedName));
+        }
+    }
+    return out;
+}
+/**
+ * Map LSP DocumentSymbol to NormalizedSymbol (label, props, relations).
+ * Uses detail (metaclass name) for label; builds IN_PACKAGE to parent.
+ */
+function documentSymbolToNormalized(item, documentPath, parentQualifiedName) {
+    const label = symbolKindToNodeLabel(item.sym.detail ?? '') ??
+        (typeof item.sym.kind === 'number' ? lspSymbolKindToNodeLabel(item.sym.kind) : undefined);
+    if (!label)
+        return null;
+    const props = {
+        name: item.sym.name,
+        qualifiedName: item.qualifiedName,
+        path: documentPath,
+    };
+    const relations = [];
+    relations.push({ from: item.qualifiedName, to: documentPath, type: 'IN_DOCUMENT' });
+    const parent = parentQualifiedName ?? item.sym.containerName;
+    if (parent) {
+        relations.push({ from: item.qualifiedName, to: parent, type: 'IN_PACKAGE' });
+    }
+    return { label, props, relations };
+}
+let sharedMcpClient = null;
+async function createMcpClient() {
+    const { createSysmlMcpClient, getMcpServerPath } = await import('./sysml-mcp-client.js');
+    const serverPath = getMcpServerPath();
+    if (!serverPath)
+        return null;
+    const client = await createSysmlMcpClient({ serverPath, initTimeout: 60000 });
+    return {
+        async getSymbols(content, uri, filePath) {
+            const { symbols } = await client.getSymbols(content, uri);
+            const normalized = [];
+            for (const sym of symbols ?? []) {
+                const label = symbolKindToNodeLabel(sym.kind ?? '');
+                if (!label)
+                    continue;
+                const qualifiedName = sym.qualifiedName ?? sym.name;
+                const relations = [{ from: qualifiedName, to: filePath, type: 'IN_DOCUMENT' }];
+                if (sym.parent)
+                    relations.push({ from: qualifiedName, to: sym.parent, type: 'IN_PACKAGE' });
+                normalized.push({
+                    label,
+                    props: { name: sym.name, qualifiedName, path: filePath },
+                    relations,
+                });
+            }
+            return normalized;
+        },
+        close: () => {
+            client.close();
+        },
+    };
+}
+const MCP_RETRY_DELAY_MS = 1000;
+/** Use shared MCP client for getSymbols (one init per index run). Returns [] if MCP unavailable or fails. Retries once on failure. */
+async function getSymbolsFromMcp(filePath, content) {
+    const attempt = async () => {
+        if (!sharedMcpClient)
+            sharedMcpClient = await createMcpClient();
+        if (!sharedMcpClient)
+            return [];
+        const uri = `file:///${filePath.replace(/\\/g, '/')}`;
+        return await sharedMcpClient.getSymbols(content, uri, filePath);
+    };
+    try {
+        return await attempt();
+    }
+    catch {
+        await new Promise((r) => setTimeout(r, MCP_RETRY_DELAY_MS));
+        try {
+            return await attempt();
+        }
+        catch {
+            return [];
+        }
+    }
+}
+/** When set, log to stderr whether symbols came from LSP or MCP (per file). */
+const DEBUG_SYMBOL_SOURCE = process.env.DEBUG_SYSMLEGRAPH_SYMBOLS === '1';
+/**
+ * Get symbols and relations for a single file. Tries LSP documentSymbol first when SYSMLLSP_SERVER_PATH is set;
+ * if LSP returns no symbols (or is unset), uses MCP getSymbols (one shared client per index run).
+ */
+export async function getSymbolsForFile(filePath, content) {
+    const text = content ?? await readFile(filePath, 'utf-8').catch(() => '');
+    const LSP_SYMBOL_TIMEOUT_MS = 20000;
+    if (resolveLspServerPath()) {
+        try {
+            const lspSymbols = await Promise.race([
+                getDocumentSymbolsFromLsp(filePath, text),
+                new Promise((_, rej) => setTimeout(() => rej(new Error('LSP documentSymbol timeout')), LSP_SYMBOL_TIMEOUT_MS)),
+            ]);
+            if (lspSymbols.length > 0) {
+                if (DEBUG_SYMBOL_SOURCE)
+                    process.stderr.write(`[sysmledgraph] symbols from LSP: ${filePath}\n`);
+                const flat = flattenSymbols(lspSymbols, null);
+                const normalized = [];
+                for (const item of flat) {
+                    const qualifiedName = item.sym.containerName
+                        ? `${item.sym.containerName}::${item.sym.name}`
+                        : item.qualifiedName;
+                    const parentQ = qualifiedName.includes('::') ? qualifiedName.slice(0, qualifiedName.lastIndexOf('::')) : null;
+                    const n = documentSymbolToNormalized({ sym: item.sym, qualifiedName }, filePath, parentQ);
+                    if (n)
+                        normalized.push(n);
+                }
+                return normalized;
+            }
+        }
+        catch {
+            // LSP failed or unavailable; fall through to MCP
+        }
+    }
+    const mcpSymbols = await getSymbolsFromMcp(filePath, text);
+    if (DEBUG_SYMBOL_SOURCE)
+        process.stderr.write(`[sysmledgraph] symbols from MCP: ${filePath} (${mcpSymbols.length})\n`);
+    return mcpSymbols;
+}
+/** Close shared MCP client (used when LSP returned no symbols). */
+function closeMcpClient() {
+    if (sharedMcpClient) {
+        sharedMcpClient.close();
+        sharedMcpClient = null;
+    }
+}
+/** Call after indexing to close the shared LSP and MCP clients. */
+export function closeLspClient() {
+    closeMcpClient();
+    closeLspClientImpl();
+}
+//# sourceMappingURL=symbols.js.map

package/dist/src/parser/symbols.js.map

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

package/dist/src/parser/sysml-mcp-client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * SysML MCP client: spawns sysml-v2-lsp MCP server and exposes tools as a callable API.
+ * Use this when you want to call parse, validate, getSymbols, etc. from code (e.g. tests or scripts).
+ *
+ * Requires sysml-v2-lsp as a dependency. Uses the same Content-Length framing as the MCP server.
+ */
+/** Resolved path to mcpServer.js (from sysml-v2-lsp package). */
+export declare function getMcpServerPath(): string;
+export interface SysmlMcpClientOptions {
+    /** Override path to mcpServer.js. Default: from sysml-v2-lsp package. */
+    serverPath?: string;
+    /** Timeout in ms for initialize. Default 20000. */
+    initTimeout?: number;
+    /** Log raw stdout/stderr for debugging. */
+    debug?: boolean;
+}
+export interface ParseResult {
+    uri: string;
+    symbolCount: number;
+    errorCount: number;
+    timing?: {
+        lex: number;
+        parse: number;
+    };
+    errors?: Array<{
+        line: number;
+        column: number;
+        message: string;
+        length?: number;
+    }>;
+    topLevelElements?: string[];
+}
+export interface ValidateResult {
+    valid: boolean;
+    syntaxErrors: Array<{
+        line: number;
+        column: number;
+        message: string;
+        length?: number;
+    }>;
+    semanticIssues: Array<{
+        line: number;
+        column: number;
+        message: string;
+        severity?: string;
+        code?: string;
+    }>;
+    totalIssues: number;
+}
+export interface SymbolInfo {
+    name: string;
+    kind: string;
+    qualifiedName?: string;
+    documentation?: string;
+    parent?: string;
+    location?: {
+        uri: string;
+        range: {
+            start: {
+                line: number;
+                character: number;
+            };
+            end: {
+                line: number;
+                character: number;
+            };
+        };
+    };
+}
+export interface GetSymbolsResult {
+    count: number;
+    symbols: SymbolInfo[];
+}
+/**
+ * Client that talks to sysml-v2-lsp MCP server over stdio.
+ * Call createSysmlMcpClient(), then use the returned methods, then close().
+ */
+export declare function createSysmlMcpClient(options?: SysmlMcpClientOptions): Promise<{
+    parse: (code: string, uri?: string) => Promise<ParseResult>;
+    validate: (code: string, uri?: string) => Promise<ValidateResult>;
+    getDiagnostics: (code: string, uri?: string) => Promise<{
+        uri: string;
+        diagnostics: unknown[];
+        summary?: Record<string, number>;
+    }>;
+    validateFile: (code: string, uri?: string) => Promise<ValidateResult>;
+    getSymbols: (code: string, uri?: string) => Promise<GetSymbolsResult>;
+    getDefinition: (name: string, code: string, uri?: string) => Promise<{
+        found: boolean;
+        count: number;
+        symbols: SymbolInfo[];
+    }>;
+    getReferences: (name: string, code: string, uri?: string) => Promise<{
+        name: string;
+        referenceCount: number;
+        references: SymbolInfo[];
+    }>;
+    getHierarchy: (name: string, code: string, uri?: string) => Promise<{
+        element: unknown;
+        ancestors: unknown[];
+        children: unknown[];
+    }>;
+    getModelSummary: (code: string, uri?: string) => Promise<unknown>;
+    getComplexity: (code: string, uri?: string) => Promise<unknown>;
+    preview: (code: string, uri?: string) => Promise<unknown>;
+    callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    close: () => void;
+}>;
+//# sourceMappingURL=sysml-mcp-client.d.ts.map

package/dist/src/parser/sysml-mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sysml-mcp-client.d.ts","sourceRoot":"","sources":["../../../src/parser/sysml-mcp-client.ts"],"names":[],"mappings":"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"}