@likec4/language-server 1.48.0 → 1.49.0

package/dist/_chunks/ConfigurableLayouter.mjs

@@ -1,1956 +1 @@
-import { t as LibIcons } from "./icons.mjs";
-import { r as isLikeC4Builtin } from "./likec4lib.mjs";
-import { n as ProjectsManager, o as logger$4 } from "./LikeC4LanguageServices.mjs";
-import { t as PQueue } from "./libs/p-queue.mjs";
-import { C as t, f as t$1, o as e, y as e$1 } from "./libs/remeda.mjs";
-import { r as LikeC4LanguageMetaData } from "./module.mjs";
-import { n as NoFileSystemWatcher } from "./filesystem.mjs";
-import { t as serve } from "./libs/@hono/node-server.mjs";
-import { n as Hono, t as cors } from "./libs/hono.mjs";
-import { loggable } from "@likec4/log";
-import { isLikeC4Config, loadConfig } from "@likec4/config/node";
-import { fdir } from "fdir";
-import { DocumentState, URI, UriUtils, WorkspaceCache } from "langium";
-import { NodeFileSystemProvider } from "langium/node";
-import { mkdirSync } from "node:fs";
-import { stat, unlink, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
-import { compareNaturalHierarchically, ifilter, invariant, isSameHierarchy } from "@likec4/core/utils";
-import chokidar from "chokidar";
-import JSON5 from "json5";
-import { Position, Range } from "vscode-languageserver-types";
-import { isLikeC4Config as isLikeC4Config$1 } from "@likec4/config";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { modelConnection } from "@likec4/core/model";
-import * as z from "zod/v3";
-import { URI as URI$2 } from "vscode-uri";
-import { invariant as invariant$1 } from "@likec4/core";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import { nanoid } from "nanoid";
-import { GraphvizWasmAdapter, QueueGraphvizLayoter } from "@likec4/layouts";
-import { GraphvizBinaryAdapter } from "@likec4/layouts/graphviz/binary";
-import which from "which";
-
-//#region src/filesystem/LikeC4ManualLayouts.ts
-const layoutsLogger = logger$4.getChild("manual-layouts");
-/**
-* @todo sync with vscode extension watchers
-*       (search for ".likec4.snap" references)
-*/
-const isManualLayoutFile = (path) => path.endsWith(".likec4.snap");
-function fileName(view) {
-	return `${view}.likec4.snap`;
-}
-function getManualLayoutsOutDir(project) {
-	return UriUtils.resolvePath(project.folderUri, project.config.manualLayouts?.outDir ?? ".likec4");
-}
-const WithLikeC4ManualLayouts = { manualLayouts: (services) => new DefaultLikeC4ManualLayouts(services) };
-const RELATIVE_PATH_PREFIX = "file://./";
-var DefaultLikeC4ManualLayouts = class {
-	cache;
-	constructor(services) {
-		this.services = services;
-		this.cache = new WorkspaceCache(services, DocumentState.Validated);
-	}
-	async read(project) {
-		return await this.cache.get(project.id, async () => {
-			const logger = layoutsLogger.getChild(project.id);
-			const fs = this.services.workspace.FileSystemProvider;
-			const outDir = getManualLayoutsOutDir(project);
-			const manualLayouts = [];
-			try {
-				const files = await fs.scanDirectory(outDir, isManualLayoutFile);
-				if (files.length === 0) return null;
-				for (const file of files) if (file.isFile) try {
-					const content = await fs.readFile(file.uri);
-					const parsed = JSON5.parse(content);
-					const resolved = this.resolveIconPathsAfterRead(parsed, project.folderUri);
-					manualLayouts.push({
-						...resolved,
-						_layout: "manual"
-					});
-				} catch (err) {
-					logger.warn(`Failed to read view snapshot ${file.uri.fsPath}`, { err });
-				}
-				if (manualLayouts.length) logger.debug`read manual layouts for ${project.id}, found ${manualLayouts.length}`;
-			} catch (err) {
-				logger.warn(`Failed to read manual layouts for ${project.folderUri.fsPath}`, { err });
-			}
-			if (manualLayouts.length === 0) return null;
-			return t(manualLayouts, e("id"));
-		});
-	}
-	async write(project, layouted) {
-		const logger = layoutsLogger.getChild(project.id);
-		const outDir = getManualLayoutsOutDir(project);
-		const file = UriUtils.joinPath(outDir, fileName(layouted.id));
-		if ("manualLayout" in layouted) {
-			const { manualLayout: _, ...rest } = layouted;
-			layouted = rest;
-		}
-		const content = JSON5.stringify(this.normalizeIconPathsForWrite(layouted, project.folderUri), {
-			space: 2,
-			quote: "'"
-		});
-		const location = {
-			uri: file.toString(),
-			range: Range.create(Position.create(0, 0), Position.create(content.split("\n").length - 1, 1))
-		};
-		logger.debug`write snapshot of ${layouted.id} in project ${project.id} to ${file.fsPath}`;
-		const fs = this.services.workspace.FileSystemProvider;
-		try {
-			await fs.writeFile(file, content + "\n");
-		} catch (err) {
-			logger.warn(`Failed to write snapshot ${layouted.id} to ${file.fsPath}`, { err });
-		}
-		const projectCachesPromise = this.cache.get(project.id);
-		if (projectCachesPromise) {
-			const projectCaches = await projectCachesPromise;
-			if (projectCaches) {
-				logger.debug`update snapshot cache of ${layouted.id} in project ${project.id}`;
-				projectCaches[layouted.id] = layouted;
-			} else {
-				logger.debug`clean cache of project ${project.id}`;
-				this.cache.delete(project.id);
-			}
-		}
-		return location;
-	}
-	async remove(project, view) {
-		const logger = layoutsLogger.getChild(project.id);
-		const outDir = getManualLayoutsOutDir(project);
-		const file = UriUtils.joinPath(outDir, fileName(view));
-		logger.debug`delete snapshot of ${view} in project ${project.id}. File: ${file.fsPath}`;
-		const location = {
-			uri: file.toString(),
-			range: Range.create(0, 0, 0, 0)
-		};
-		try {
-			if (!await this.services.workspace.FileSystemProvider.deleteFile(file)) {
-				logger.warn`Snapshot ${view} did not exist at ${file.fsPath}`;
-				return null;
-			}
-		} catch (err) {
-			logger.warn(`Failed to delete snapshot ${view} from ${file.fsPath}`, { err });
-		}
-		const projectCachesPromise = this.cache.get(project.id);
-		if (projectCachesPromise) {
-			const projectCaches = await projectCachesPromise;
-			if (projectCaches) {
-				logger.debug`clean cached view ${view} in project ${project.id}`;
-				delete projectCaches[view];
-			} else {
-				logger.debug`reset empty cache of project ${project.id}`;
-				this.cache.delete(project.id);
-			}
-		}
-		return location;
-	}
-	clearCaches() {
-		layoutsLogger.debug`clear caches`;
-		this.cache.clear();
-	}
-	/**
-	* When we save snapshot - it may contain fullpath to icons on the machine it was created,
-	* that is wrong when opened on another.
-	*
-	* Prepares a snapshot for writing by converting absolute icon paths to relative paths.
-	* Absolute paths starting with 'file://' are converted to relative paths prefixed with 'file://./'
-	*/
-	normalizeIconPathsForWrite(layouted, projectUri) {
-		const nodes = layouted.nodes.map((node) => {
-			if (!node.icon || typeof node.icon !== "string") return node;
-			if (node.icon.startsWith("file://")) {
-				const iconUri = URI.parse(node.icon);
-				const relativePath = UriUtils.relative(projectUri, iconUri);
-				if (relativePath.startsWith("..")) return node;
-				return {
-					...node,
-					icon: `${RELATIVE_PATH_PREFIX}${relativePath}`
-				};
-			}
-			return node;
-		});
-		return {
-			...layouted,
-			nodes
-		};
-	}
-	/**
-	* Postprocesses a snapshot after reading by converting relative icon paths back to absolute paths.
-	* Relative paths prefixed with 'file://./' are converted to absolute paths based on project folder.
-	*/
-	resolveIconPathsAfterRead(layouted, projectUri) {
-		const nodes = layouted.nodes.map((node) => {
-			if (!node.icon || typeof node.icon !== "string") return node;
-			if (node.icon.startsWith(RELATIVE_PATH_PREFIX)) {
-				const relativePath = node.icon.substring(9);
-				const absoluteUri = UriUtils.joinPath(projectUri, relativePath);
-				return {
-					...node,
-					icon: absoluteUri.toString()
-				};
-			}
-			return node;
-		});
-		return {
-			...layouted,
-			nodes
-		};
-	}
-};
-
-//#endregion
-//#region src/filesystem/utils.ts
-function isLikeC4File(path, isDirectory = false) {
-	return !isDirectory && LikeC4LanguageMetaData.fileExtensions.some((ext) => path.endsWith(ext));
-}
-function isLikeC4ConfigFile(path, isDirectory) {
-	return !isDirectory && isLikeC4Config$1(path);
-}
-function excludeNodeModules(dirName) {
-	return [
-		"node_modules",
-		".git",
-		".svn",
-		".yarn",
-		".pnpm"
-	].includes(dirName);
-}
-/**
-* Compare function for document paths to ensure consistent order
-*/
-const compare = compareNaturalHierarchically("/");
-function ensureOrder(a, b) {
-	return compare(a.uri.path, b.uri.path);
-}
-
-//#endregion
-//#region src/filesystem/ChokidarWatcher.ts
-const logger$3 = logger$4.getChild("chokidar");
-const WithChokidarWatcher = { fileSystemWatcher: (services) => new ChokidarFileSystemWatcher(services) };
-const isAnyLikeC4File = (path) => isLikeC4File(path) || isLikeC4Config(path) || isManualLayoutFile(path);
-/**
-* A no-op file system watcher.
-*/
-var ChokidarFileSystemWatcher = class {
-	watcher;
-	queue = new PQueue({
-		concurrency: 1,
-		timeout: 5e3
-	});
-	constructor(services) {
-		this.services = services;
-	}
-	watch(folder) {
-		if (this.watcher) {
-			logger$3.debug`add watching folder: ${folder}`;
-			this.watcher.add(folder);
-			return;
-		}
-		this.watcher = this.createWatcher(folder);
-	}
-	async dispose() {
-		if (this.watcher) {
-			const watcher = this.watcher;
-			this.watcher = void 0;
-			await watcher.close();
-		}
-	}
-	createWatcher(folder) {
-		logger$3.debug`create watcher for folder: ${folder}`;
-		let watcher = chokidar.watch(folder, {
-			ignored: [(path) => path.includes("node_modules") || path.includes(".git"), (path, stats) => !!stats && stats.isFile() && !isAnyLikeC4File(path)],
-			followSymlinks: true,
-			ignoreInitial: true
-		});
-		const onAddOrChange = (path, stats) => {
-			if (stats?.isDirectory()) return;
-			this.enqueueFileOp("addOrChange: " + path, async () => {
-				await this.onAddOrChange(path);
-			});
-		};
-		const onRemove = (path, stats) => {
-			if (stats?.isDirectory()) return;
-			this.enqueueFileOp("remove: " + path, async () => {
-				await this.onRemove(path);
-			});
-		};
-		watcher.on("add", onAddOrChange).on("change", onAddOrChange).on("unlink", onRemove).on("unlinkDir", (path) => {
-			this.enqueueFileOp("removeDir: " + path, async () => {
-				await this.onRemoveDir(path);
-			});
-		});
-		return watcher;
-	}
-	enqueueFileOp(fileop, fn) {
-		this.queue.add(async () => {
-			try {
-				await fn();
-			} catch (error) {
-				logger$3.warn(`Failed on ${fileop}`, { error });
-			}
-		}).catch((error) => {
-			logger$3.error(`Error on ${fileop}`, { error });
-		});
-	}
-	async onAddOrChange(path) {
-		const workspace = this.services.workspace;
-		switch (true) {
-			case isLikeC4Config(path):
-				logger$3.debug`project file changed: ${path}`;
-				await workspace.ProjectsManager.registerConfigFile(URI.file(path));
-				break;
-			case isLikeC4File(path):
-				logger$3.debug`file changed: ${path}`;
-				await workspace.DocumentBuilder.update([URI.file(path)], []);
-				break;
-			case isManualLayoutFile(path): {
-				logger$3.debug`manual layout file changed: ${path}`;
-				workspace.ManualLayouts.clearCaches();
-				const projectId = workspace.ProjectsManager.belongsTo(URI.file(path));
-				await workspace.ProjectsManager.rebuidProject(projectId);
-				break;
-			}
-			default: logger$3.warn`Unknown file change: ${path}`;
-		}
-	}
-	async onRemove(path) {
-		const workspace = this.services.workspace;
-		switch (true) {
-			case isLikeC4Config(path):
-				logger$3.debug`project file removed: ${path}`;
-				await workspace.ProjectsManager.reloadProjects();
-				break;
-			case isLikeC4File(path):
-				logger$3.debug`file removed: ${path}`;
-				await workspace.DocumentBuilder.update([], [URI.file(path)]);
-				break;
-			case isManualLayoutFile(path): {
-				logger$3.debug`manual layout file removed: ${path}`;
-				const project = workspace.ProjectsManager.belongsTo(path);
-				workspace.ManualLayouts.clearCaches();
-				await workspace.ProjectsManager.rebuidProject(project);
-				break;
-			}
-			default: logger$3.warn`Unknown file removal: ${path}`;
-		}
-	}
-	async onRemoveDir(path) {
-		logger$3.debug`directory removed: ${path}`;
-		const workspace = this.services.workspace;
-		if (workspace.ProjectsManager.findAllProjectsByFolder(path).length > 0) {
-			workspace.ManualLayouts.clearCaches();
-			await workspace.ProjectsManager.reloadProjects();
-		}
-	}
-};
-
-//#endregion
-//#region src/filesystem/LikeC4FileSystem.ts
-const logger$2 = logger$4.getChild("filesystem");
-const WithFileSystem = (ehableWatcher = true) => ({
-	fileSystemProvider: () => new SymLinkTraversingFileSystemProvider(),
-	...ehableWatcher ? WithChokidarWatcher : NoFileSystemWatcher
-});
-/**
-* A file system provider that follows symbolic links.
-* @see https://github.com/likec4/likec4/pull/1213
-*/
-var SymLinkTraversingFileSystemProvider = class extends NodeFileSystemProvider {
-	async readFile(uri) {
-		if (isLikeC4Builtin(uri)) return Promise.resolve(LibIcons);
-		try {
-			return await super.readFile(uri);
-		} catch (error) {
-			logger$2.warn(`Failed to read file ${uri.fsPath}`, { error });
-			return "";
-		}
-	}
-	async readDirectory(folderPath, opts) {
-		const recursive = opts?.recursive ?? true;
-		const maxDepth = opts?.maxDepth ?? Infinity;
-		const entries = [];
-		try {
-			let crawler = new fdir().withSymlinks({ resolvePaths: false }).exclude(excludeNodeModules).filter(isLikeC4File).withFullPaths();
-			if (!recursive) crawler = crawler.withMaxDepth(1);
-			else if (maxDepth !== Infinity) crawler = crawler.withMaxDepth(maxDepth);
-			const crawled = await crawler.crawl(folderPath.fsPath).withPromise();
-			for (const path of crawled) entries.push({
-				isFile: true,
-				isDirectory: false,
-				uri: URI.file(path)
-			});
-		} catch (error) {
-			logger$2.warn(`Failed to read directory ${folderPath.fsPath}`, { error });
-		}
-		return entries.sort(ensureOrder);
-	}
-	async scanProjectFiles(folderUri) {
-		return await this.scanDirectory(folderUri, isLikeC4ConfigFile);
-	}
-	async scanDirectory(directory, filter) {
-		const entries = [];
-		try {
-			const crawled = await new fdir().withSymlinks({ resolvePaths: false }).withFullPaths().filter(filter).exclude(excludeNodeModules).crawl(directory.fsPath).withPromise();
-			for (const path of crawled) entries.push({
-				isFile: true,
-				isDirectory: false,
-				uri: URI.file(path)
-			});
-		} catch (error) {
-			logger$2.warn(`Failed to scan directory ${directory.fsPath}`, { error });
-		}
-		return entries.sort(ensureOrder);
-	}
-	async loadProjectConfig(filepath) {
-		return await loadConfig(filepath);
-	}
-	async writeFile(uri, content) {
-		const dir = dirname(uri.fsPath);
-		const exists = await stat(dir).catch(() => null);
-		if (exists?.isFile()) throw new Error(`Cannot create directory ${dir} because a file with the same name exists.`);
-		if (!exists) {
-			logger$2.debug("creating directory {path}", { path: dir });
-			mkdirSync(dir, { recursive: true });
-		}
-		logger$2.debug("writing file {path}", { path: uri.fsPath });
-		return await writeFile(uri.fsPath, content, { encoding: "utf-8" });
-	}
-	async deleteFile(uri) {
-		try {
-			const path = uri.fsPath;
-			const exists = await stat(path);
-			if (exists.isFile() || exists.isSymbolicLink()) {
-				await unlink(path);
-				logger$2.debug("deleted file {path}", { path });
-				return true;
-			} else logger$2.warn("deleteFile failed: {path} does not exist, or is not a file", { path });
-		} catch (error) {
-			logger$2.warn(`Failed to delete file ${uri.fsPath}`, { error });
-		}
-		return false;
-	}
-};
-
-//#endregion
-//#region src/mcp/utils.ts
-const logger$1 = logger$4.getChild("mcp");
-function likec4Tool(config, cb) {
-	const { name, description, ...rest } = config;
-	return (languageServices) => [
-		name,
-		{
-			description: description?.trim() ?? "",
-			...rest
-		},
-		mkcallTool(name, languageServices, cb)
-	];
-}
-function mkcallTool(name, languageServices, cb) {
-	const tool = cb.bind(null, languageServices);
-	return (async function callTool(args, extra) {
-		logger$1.debug("Calling tool {name}, args: {args}", {
-			name,
-			args
-		});
-		try {
-			const result = await tool.call(null, args, extra);
-			if (typeof result === "string") return { content: [{
-				type: "text",
-				text: result
-			}] };
-			return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(result)
-				}],
-				structuredContent: result
-			};
-		} catch (err) {
-			logger$1.error(`Tool ${name} failed`, { err });
-			return {
-				content: [{
-					type: "text",
-					text: loggable(err)
-				}],
-				isError: true
-			};
-		}
-	});
-}
-
-//#endregion
-//#region package.json
-var version = "1.48.0";
-
-//#endregion
-//#region src/mcp/tools/_common.ts
-const locationSchema = z.object({
-	path: z.string().describe("Path to the file"),
-	range: z.object({
-		start: z.object({
-			line: z.number(),
-			character: z.number()
-		}),
-		end: z.object({
-			line: z.number(),
-			character: z.number()
-		})
-	}).describe("Range in the file")
-}).nullable();
-const projectIdSchema = z.string().refine((_v) => true).optional().default(ProjectsManager.DefaultProjectId).describe("Project id (optional, will use \"default\" if not specified)");
-const includedInViewsSchema = z.array(z.object({
-	id: z.string().describe("View id"),
-	title: z.string().describe("View title"),
-	type: z.enum([
-		"element",
-		"deployment",
-		"dynamic"
-	]).describe("View type")
-}));
-const includedInViews = (views) => {
-	return [...views].map((v) => ({
-		id: v.id,
-		title: v.titleOrId,
-		type: v.$view._type
-	}));
-};
-const mkLocate = (languageServices, projectId) => (params) => {
-	try {
-		const loc = languageServices.locate({
-			projectId,
-			...params
-		});
-		return loc ? {
-			path: URI$2.parse(loc.uri).fsPath,
-			range: loc.range
-		} : null;
-	} catch (e) {
-		logger$1.debug(`Failed to locate {params}`, {
-			error: e,
-			params
-		});
-		return null;
-	}
-};
-
-//#endregion
-//#region src/mcp/tools/find-relationships.ts
-const endpointSchema = z.object({
-	id: z.string(),
-	title: z.string(),
-	kind: z.string()
-});
-const searchResultSchema$1 = z.object({
-	type: z.enum(["direct", "indirect"]).describe("Type of relationship, \"direct\" for direct relationships, \"indirect\" for relationships through nested elements"),
-	source: endpointSchema,
-	target: endpointSchema,
-	kind: z.string().nullable().describe("Relationship kind"),
-	title: z.string().nullable().describe("Relationship title"),
-	description: z.string().nullable().describe("Relationship description"),
-	technology: z.string().nullable().describe("Relationship technology"),
-	tags: z.array(z.string()).describe("Relationship tags"),
-	includedInViews: includedInViewsSchema.describe("Views that include this relationship"),
-	sourceLocation: locationSchema
-});
-const findRelationships = likec4Tool({
-	name: "find-relationships",
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Find relationships between two elements"
-	},
-	description: `
-Find relationships between two LikeC4 elements within a project.
-
-What it does:
-- Finds both direct relationships (element1 ↔ element2) and indirect ones that arise via containment (e.g. via nested elements).
-- Returns rich metadata for each relationship and where it appears in views.
-
-Inputs:
-- element1: string — Element ID (FQN)
-- element2: string — Element ID (FQN)
-- project: string (optional, defaults to "default") — Project id
-
-Output:
-- found: Relationship[]
-
-Relationship (object) fields:
-- type: "direct" | "indirect" — direct is between the specified endpoints; indirect is via nested elements
-- source: Endpoint
-- target: Endpoint
-- kind: string|null — relationship kind from the model
-- title: string|null — relationship title if provided
-- description: string|null — relationship description text
-- technology: string|null — relationship technology
-- tags: string[] — relationship tags
-- includedInViews: View[] — views where this relationship appears
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null
-
-Endpoint (object) fields:
-- id: string — Element ID (FQN)
-- title: string — element title
-- kind: string — element kind
-
-View (object) fields:
-- id: string — view identifier
-- title: string — view title
-- type: "element" | "deployment" | "dynamic"
-
-Notes:
-- Read-only, idempotent; does not mutate the model. May trigger UI navigation in supporting clients.
-- The order of results is not guaranteed.
-
-Example:
-Request:
-{
-  "element1": "shop.frontend",
-  "element2": "shop.backend",
-  "project": "default"
-}
-
-Response:
-{
-  "found": [
-    {
-      "type": "direct",
-      "source": { "id": "shop.frontend", "title": "Frontend", "kind": "component" },
-      "target": { "id": "shop.backend", "title": "Backend", "kind": "component" },
-      "kind": "sync",
-      "title": "Calls",
-      "description": "Frontend calls Backend",
-      "technology": "HTTP",
-      "tags": ["public"],
-      "includedInViews": [
-        { "id": "system-overview", "title": "System Overview", "type": "element" }
-      ],
-      "sourceLocation": {
-        "path": "/abs/path/project/model.c4",
-        "range": { "start": { "line": 12, "character": 0 }, "end": { "line": 14, "character": 0 } }
-      }
-    }
-  ]
-}
-`,
-	inputSchema: {
-		element1: z.string().describe("Element ID (FQN)"),
-		element2: z.string().describe("Element ID (FQN)"),
-		project: projectIdSchema
-	},
-	outputSchema: { found: z.array(searchResultSchema$1) }
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	if (isSameHierarchy(args.element1, args.element2)) throw new Error("No relationships possible between parent-child");
-	const found = [];
-	const model = await languageServices.computedModel(projectId);
-	const el1 = model.findElement(args.element1);
-	invariant(el1, `Element "${args.element1}" not found in project "${projectId}"`);
-	const el2 = model.findElement(args.element2);
-	invariant(el2, `Element "${args.element2}" not found in project "${projectId}"`);
-	const locate = mkLocate(languageServices, projectId);
-	const relationships = modelConnection.findConnection(el1, el2, "both").flatMap((c) => [...c.relations]);
-	for (const relationship of relationships) {
-		const isDirect = relationship.source === el1 && relationship.target === el2 || relationship.source === el2 && relationship.target === el1;
-		found.push({
-			type: isDirect ? "direct" : "indirect",
-			source: {
-				id: relationship.source.id,
-				title: relationship.source.title,
-				kind: relationship.source.kind
-			},
-			target: {
-				id: relationship.target.id,
-				title: relationship.target.title,
-				kind: relationship.target.kind
-			},
-			kind: relationship.kind,
-			title: relationship.title,
-			description: relationship.description.text,
-			technology: relationship.technology,
-			tags: [...relationship.tags],
-			includedInViews: includedInViews(relationship.views()),
-			sourceLocation: locate({ relation: relationship.id })
-		});
-	}
-	return { found };
-});
-
-//#endregion
-//#region src/mcp/tools/list-projects.ts
-const listProjects = likec4Tool({
-	name: "list-projects",
-	description: `
-List LikeC4 projects discoverable in the current workspace.
-
-Request:
-- No input parameters.
-
-Response (JSON object):
-- projects: Project[]
-
-Project (object) fields:
-- id: string — stable project identifier
-- title: string — human-readable project title
-- folder: string — absolute path to the project root
-- sources: string[] — absolute file paths of related documents
-
-Notes:
-- Read-only, idempotent, no side effects.
-- Safe to call repeatedly.
-
-Example response:
-{
-  "projects": [
-    {
-      "id": "docs",
-      "title": "Documentation",
-      "folder": "/abs/path/to/workspace/docs",
-      "sources": [
-        "/abs/path/to/workspace/docs/model/contexts.likec4",
-        "/abs/path/to/workspace/docs/model/relations.likec4"
-      ]
-    }
-  ]
-}
-`,
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "List projects"
-	},
-	outputSchema: { projects: z.array(z.object({
-		id: z.string(),
-		title: z.string(),
-		folder: z.string(),
-		sources: z.array(z.string())
-	})) }
-}, async (languageServices) => {
-	return { projects: languageServices.projects().map((p) => ({
-		id: p.id,
-		title: p.title,
-		folder: p.folder.fsPath,
-		sources: p.documents.map((d) => d.fsPath)
-	})) };
-});
-
-//#endregion
-//#region src/mcp/tools/open-view.ts
-const openView = likec4Tool({
-	name: "open-view",
-	description: `
-Open a LikeC4 view in the editor's preview panel.
-
-Request:
-- viewId: string — view id (name)
-- project: string (optional) — project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- location: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null — source location of the view if available
-
-Notes:
-- Read-only and idempotent with respect to the project model. Triggers a UI action in the editor.
-- Only one preview panel can be open at a time.
-
-Example response:
-{
-  "location": {
-    "path": "/abs/path/project/model.c4",
-    "range": { "start": { "line": 10, "character": 0 }, "end": { "line": 30, "character": 0 } }
-  }
-}
-`,
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Open view in preview panel"
-	},
-	inputSchema: {
-		viewId: z.string().describe("View id (name)"),
-		project: projectIdSchema
-	},
-	outputSchema: { location: locationSchema }
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	const view = (await languageServices.computedModel(projectId)).findView(args.viewId);
-	if (!view) throw new Error(`View with ID '${args.viewId}' not found in project ${projectId}`);
-	await languageServices.views.openView(view.id, projectId);
-	return { location: mkLocate(languageServices, projectId)({ view: view.id }) };
-});
-
-//#endregion
-//#region src/mcp/tools/read-deployment.ts
-const readDeployment = likec4Tool({
-	name: "read-deployment",
-	description: `
-Read details about a deployment node or a deployed instance in a LikeC4 project.
-
-What it does:
-- Returns metadata about a deployment entity (node or instance), including kind, tags, color/shape, children, which views include it, and its source location.
-
-Inputs:
-- id: string — Deployment id (FQN)
-- project: string (optional, defaults to "default") — Project id
-
-Output fields:
-- type: "deployment-node" | "deployed-instance"
-- id: string — Deployment id (FQN)
-- kind: string — Deployment node kind, or element kind for deployed instances
-- name: string — Name of the deployment entity
-- title: string — Title of the deployment entity
-- description: string|null — Description text
-- technology: string|null — Technology info, if any
-- tags: string[] — Tags assigned to this entity
-- project: string — Project id
-- metadata: Record<string, string>
-- links: Array<{ title: string|null, url: string, relative: string|null }> — external links associated with this deployment entity
-- shape: string — Rendered shape
-- color: string — Rendered color
-- children: string[] — Child deployment ids (empty for instances)
-- includedInViews: View[] — Views that include this entity
-- instanceof: { id: string, title: string, kind: string } | null — If type is "deployed-instance", the referenced element
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null
-
-View (object) fields:
-- id: string — view identifier
-- title: string — view title
-- type: "element" | "deployment" | "dynamic"
-
-Notes:
-- Read-only, idempotent; does not mutate the model.
-
-Example request:
-{ "id": "k8s.cluster.frontend", "project": "default" }
-
-Example response (deployed instance):
-{
-  "type": "deployed-instance",
-  "id": "k8s.cluster.frontend",
-  "kind": "k8s.pod",
-  "name": "frontend",
-  "title": "Frontend Pod",
-  "description": null,
-  "technology": "Kubernetes",
-  "tags": ["prod"],
-  "project": "default",
-  "metadata": {},
-  "links": [],
-  "shape": "rectangle",
-  "color": "#2F80ED",
-  "children": [],
-  "includedInViews": [
-    { "id": "runtime-overview", "title": "Runtime Overview", "type": "deployment" }
-  ],
-  "instanceof": { "id": "shop.frontend", "title": "Frontend", "kind": "component" },
-  "sourceLocation": {
-    "path": "/abs/path/project/model.c4",
-    "range": { "start": { "line": 10, "character": 0 }, "end": { "line": 25, "character": 0 } }
-  }
-}
-`,
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Read deployment entity"
-	},
-	inputSchema: {
-		id: z.string().describe("Deployment id (FQN)"),
-		project: projectIdSchema
-	},
-	outputSchema: {
-		type: z.enum(["deployment-node", "deployed-instance"]),
-		id: z.string().describe("Deployment id (FQN)"),
-		kind: z.string().describe("Deployment node kind, or element kind for deployed instances"),
-		name: z.string(),
-		title: z.string(),
-		description: z.string().nullable(),
-		technology: z.string().nullable(),
-		tags: z.array(z.string()),
-		project: z.string(),
-		metadata: z.record(z.union([z.string(), z.array(z.string())])),
-		links: z.array(z.object({
-			title: z.string().nullable().describe("Optional link title"),
-			url: z.string().describe("Link URL"),
-			relative: z.string().nullable().describe("Relative path (if URL is relative to workspace root)")
-		})).describe("External links associated with this deployment entity"),
-		shape: z.string(),
-		color: z.string(),
-		children: z.array(z.string()).describe("Children of this deployment node (Array of Deployment ids)"),
-		includedInViews: includedInViewsSchema.describe("Views that include this deployment node"),
-		instanceof: z.object({
-			id: z.string().describe("Element ID (FQN)"),
-			title: z.string(),
-			kind: z.string()
-		}).nullable().describe("If type is \"deployed-instance\", the referenced element"),
-		sourceLocation: locationSchema
-	}
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	const element = (await languageServices.computedModel(projectId)).deployment.findElement(args.id);
-	invariant$1(element, `Deployment entity "${args.id}" not found in project "${projectId}"`);
-	const locate = mkLocate(languageServices, projectId);
-	return {
-		type: element.isInstance() ? "deployed-instance" : "deployment-node",
-		id: element.id,
-		name: element.name,
-		kind: element.kind,
-		title: element.title,
-		description: element.description.text,
-		technology: element.technology,
-		tags: [...element.tags],
-		project: projectId,
-		metadata: element.getMetadata(),
-		links: (element.links ?? []).map((link) => ({
-			title: link.title ?? null,
-			url: link.url,
-			relative: link.relative ?? null
-		})),
-		shape: element.shape,
-		color: element.color,
-		children: element.isInstance() ? [] : [...element.children()].map((c) => c.id),
-		includedInViews: includedInViews(element.views()),
-		instanceof: element.isInstance() ? {
-			id: element.element.id,
-			title: element.element.title,
-			kind: element.element.kind
-		} : null,
-		sourceLocation: locate({ deployment: element.id })
-	};
-});
-
-//#endregion
-//#region src/mcp/tools/read-element.ts
-const readElement = likec4Tool({
-	name: "read-element",
-	description: `
-Read detailed information about a LikeC4 element.
-
-Request:
-- id: string — element id (FQN)
-- project: string (optional) — project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- id: string — element id (FQN)
-- name: string — element name
-- kind: string — element kind
-- title: string — human-readable title
-- description: string|null — optional description
-- technology: string|null — optional technology
-- tags: string[] — assigned tags
-- project: string — project id this element belongs to
-- metadata: Record<string, string> — element metadata
-- links: Array<{ title: string|null, url: string, relative: string|null }> — external links associated with this element
-- shape: string — rendered shape
-- color: string — rendered color
-- children: string[] — ids (FQNs) of direct child elements
-- defaultView: string|null — default view name if set
-- includedInViews: View[] — views that include this element
-- relationships: object — relationships of this element (direct and indirect)
-  - incoming: Array<{ source: { id: string, title: string, kind: string }, kind: string|null, target: string, title: string|null, description: string|null, technology: string|null, tags: string[] }>
-  - outgoing: Array<{ source: string, target: { id: string, title: string, kind: string }, kind: string|null, title: string|null, description: string|null, technology: string|null, tags: string[] }>
-- deployedInstances: string[] — deployed instance ids (Deployment FQNs)
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null — source location if available
-
-View (object) fields:
-- id: string — view identifier
-- title: string — view title
-- type: "element" | "deployment" | "dynamic"
-
-Notes:
-- Read-only, idempotent, no side effects.
-- Safe to call repeatedly.
-
-Example response:
-{
-  "id": "shop.frontend",
-  "name": "frontend",
-  "kind": "container",
-  "title": "Frontend",
-  "description": "User-facing web app",
-  "technology": "React",
-  "tags": ["public"],
-  "project": "default",
-  "metadata": { "owner": "web" },
-  "links": [
-    {
-      "title": "Documentation",
-      "url": "https://docs.example.com/frontend",
-      "relative": null
-    }
-  ],
-  "shape": "rounded-rectangle",
-  "color": "#2F80ED",
-  "children": ["shop.frontend.auth"],
-  "defaultView": "frontend-overview",
-  "includedInViews": [
-    {
-      "id": "frontend-overview",
-      "title": "Frontend Overview",
-      "type": "element"
-    }
-  ],
-  "relationships": {
-    "incoming": [
-      {
-        "source": { "id": "shop.api", "title": "API", "kind": "container" },
-        "kind": "uses",
-        "target": "shop.frontend",
-        "title": "Calls",
-        "description": null,
-        "technology": "HTTPS",
-        "tags": []
-      }
-    ],
-    "outgoing": []
-  },
-  "deployedInstances": ["k8s.cluster.frontend"],
-  "sourceLocation": {
-    "path": "/abs/path/project/model.c4",
-    "range": { "start": { "line": 10, "character": 0 }, "end": { "line": 25, "character": 0 } }
-  }
-}
-`,
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Read element"
-	},
-	inputSchema: {
-		id: z.string().describe("Element id (FQN)"),
-		project: projectIdSchema
-	},
-	outputSchema: {
-		id: z.string().describe("Element id (FQN)"),
-		kind: z.string().describe("Element kind"),
-		name: z.string().describe("Element name"),
-		title: z.string(),
-		description: z.string().nullable(),
-		technology: z.string().nullable(),
-		tags: z.array(z.string()),
-		project: z.string(),
-		metadata: z.record(z.union([z.string(), z.array(z.string())])),
-		links: z.array(z.object({
-			title: z.string().nullable().describe("Optional link title"),
-			url: z.string().describe("Link URL"),
-			relative: z.string().nullable().describe("Relative path (if URL is relative to workspace root)")
-		})).describe("External links associated with this element"),
-		shape: z.string(),
-		color: z.string(),
-		children: z.array(z.string()).describe("Children of this element (Array of FQNs)"),
-		defaultView: z.string().nullable().describe("Name of the default view of this element"),
-		includedInViews: includedInViewsSchema.describe("Views that include this element"),
-		relationships: z.object({
-			incoming: z.array(z.object({
-				source: z.object({
-					id: z.string(),
-					title: z.string(),
-					kind: z.string()
-				}).describe("Source element of this relationship"),
-				kind: z.string().nullable().describe("Relationship kind"),
-				target: z.string().describe("Target element id (FQN), either this element or nested element, if relationship is indirect"),
-				title: z.string().nullable().describe("Relationship title"),
-				description: z.string().nullable().describe("Relationship description"),
-				technology: z.string().nullable().describe("Relationship technology"),
-				tags: z.array(z.string()).describe("Relationship tags")
-			})).describe("Incoming relationships of this element (direct and indirect, incoming to nested elements)"),
-			outgoing: z.array(z.object({
-				source: z.string().describe("Source element id (FQN), either this element or nested element, if relationship is indirect"),
-				target: z.object({
-					id: z.string(),
-					title: z.string(),
-					kind: z.string()
-				}).describe("Target element of this relationship"),
-				kind: z.string().nullable().describe("Relationship kind"),
-				title: z.string().nullable().describe("Relationship title"),
-				description: z.string().nullable().describe("Relationship description"),
-				technology: z.string().nullable().describe("Relationship technology"),
-				tags: z.array(z.string()).describe("Relationship tags")
-			})).describe("Outgoing relationships of this element (direct and indirect, outgoing from nested elements)")
-		}).describe("Relationships of this element"),
-		deployedInstances: z.array(z.string()).describe("Deployed instances of this element (Array of Deployment FQNs)"),
-		sourceLocation: locationSchema
-	}
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	const element = (await languageServices.computedModel(projectId)).findElement(args.id);
-	invariant$1(element, `Element "${args.id}" not found in project "${projectId}"`);
-	const locate = mkLocate(languageServices, projectId);
-	return {
-		id: element.id,
-		name: element.name,
-		kind: element.kind,
-		title: element.title,
-		description: element.description.text,
-		technology: element.technology,
-		tags: [...element.tags],
-		project: projectId,
-		metadata: element.getMetadata(),
-		links: (element.links ?? []).map((link) => ({
-			title: link.title ?? null,
-			url: link.url,
-			relative: link.relative ?? null
-		})),
-		shape: element.shape,
-		color: element.color,
-		children: [...element.children()].map((c) => c.id),
-		defaultView: element.defaultView?.id || null,
-		includedInViews: includedInViews(element.views()),
-		relationships: {
-			incoming: [...element.incoming()].map((r) => ({
-				source: {
-					id: r.source.id,
-					title: r.source.title,
-					kind: r.source.kind
-				},
-				kind: r.kind,
-				target: r.target.id,
-				title: r.title,
-				description: r.description.text,
-				technology: r.technology,
-				tags: [...r.tags]
-			})),
-			outgoing: [...element.outgoing()].map((r) => ({
-				source: r.source.id,
-				target: {
-					id: r.target.id,
-					title: r.target.title,
-					kind: r.target.kind
-				},
-				kind: r.kind,
-				title: r.title,
-				description: r.description.text,
-				technology: r.technology,
-				tags: [...r.tags]
-			}))
-		},
-		deployedInstances: [...element.deployments()].map((i) => i.id),
-		sourceLocation: locate({ element: element.id })
-	};
-});
-
-//#endregion
-//#region src/mcp/tools/read-project-summary.ts
-const readProjectSummary = likec4Tool({
-	name: "read-project-summary",
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Read project summary"
-	},
-	description: `
-Request:
-- project: string (optional) — project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- title: string — human-readable project title
-- folder: string — absolute path to the project root
-- sources: string[] — absolute file paths of model documents
-- specification: object
-  - elementKinds: string[] — all element kinds
-  - relationshipKinds: string[] — all relationship kinds
-  - deploymentKinds: string[] — all deployment kinds
-  - tags: string[] — all tags
-  - metadataKeys: string[] — used metadata keys
-- elements: Element[] — list of elements
-- deployments: Deployment[] — list of deployment entities
-- views: View[] — list of views defined in the model
-
-Element (object) fields:
-- id: string — element id (FQN)
-- kind: string — element kind
-- title: string — element title
-- tags: string[] — element tags
-
-Deployment (object) fields:
-- type = "deployment-node": { id: string, kind: string, title: string, tags: string[] }
-- type = "deployed-instance": { id: string, title: string, tags: string[], referencedElementId: string }
-
-View (object) fields:
-- id: string — view identifier
-- title: string — view title
-- type: "element" | "deployment" | "dynamic"
-
-Notes:
-- Read-only, idempotent, no side effects.
-- Safe to call repeatedly.
-
-Example response:
-{
-  "title": "Cloud Boutique",
-  "folder": "/abs/path/to/workspace/examples/cloud-system",
-  "sources": [
-    "/abs/path/to/workspace/examples/cloud-system/model.c4"
-  ],
-  "specification": {
-    "elementKinds": ["system", "container", "component"],
-    "relationshipKinds": ["uses", "depends-on"],
-    "deploymentKinds": ["node", "cluster"],
-    "tags": ["public", "internal"],
-    "metadataKeys": ["owner", "tier"]
-  },
-  "elements": [
-    {
-      "id": "shop.frontend",
-      "kind": "component",
-      "title": "Frontend",
-      "tags": ["public"]
-    }
-  ],
-  "deployments": [
-    {
-      "type": "deployment-node",
-      "id": "k8s.shop.frontend",
-      "kind": "cluster",
-      "title": "Frontend",
-      "tags": []
-    }
-  ],
-  "views": [
-    {
-      "name": "system-overview",
-      "title": "System Overview",
-      "type": "element"
-    }
-  ]
-}
-  `,
-	inputSchema: { project: projectIdSchema },
-	outputSchema: {
-		title: z.string(),
-		folder: z.string(),
-		sources: z.array(z.string()),
-		specification: z.object({
-			elementKinds: z.array(z.string()),
-			relationshipKinds: z.array(z.string()),
-			deploymentKinds: z.array(z.string()),
-			tags: z.array(z.string()),
-			metadataKeys: z.array(z.string())
-		}),
-		elements: z.array(z.object({
-			id: z.string(),
-			kind: z.string(),
-			title: z.string(),
-			tags: z.array(z.string())
-		})).describe("List of elements in the project"),
-		deployments: z.array(z.discriminatedUnion("type", [z.object({
-			type: z.literal("deployment-node"),
-			id: z.string().describe("Node ID"),
-			kind: z.string().describe("Deployment node kind"),
-			title: z.string().describe("Node title"),
-			tags: z.array(z.string())
-		}), z.object({
-			type: z.literal("deployed-instance"),
-			id: z.string().describe("Node ID"),
-			title: z.string().describe("Node title"),
-			tags: z.array(z.string()),
-			referencedElementId: z.string().describe("Element ID (FQN)")
-		})])).describe("List of deployment nodes and deployed instances in the project"),
-		views: z.array(z.object({
-			id: z.string(),
-			title: z.string(),
-			type: z.enum([
-				"element",
-				"deployment",
-				"dynamic"
-			])
-		}))
-	}
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	const project = languageServices.project(projectId);
-	const model = await languageServices.computedModel(projectId);
-	return {
-		title: project.title,
-		folder: project.folder.fsPath,
-		specification: {
-			elementKinds: t$1(model.specification.elements),
-			relationshipKinds: t$1(model.specification.relationships),
-			deploymentKinds: t$1(model.specification.deployments),
-			tags: [...model.tags],
-			metadataKeys: model.specification.metadataKeys ?? []
-		},
-		elements: [...model.elements()].filter((e) => !e.imported).map((e) => ({
-			id: e.id,
-			kind: e.kind,
-			title: e.title,
-			tags: [...e.tags]
-		})),
-		deployments: [...model.deployment.elements()].map((d) => {
-			if (d.isInstance()) return {
-				type: "deployed-instance",
-				id: d.id,
-				title: d.title,
-				tags: [...d.tags],
-				referencedElementId: d.element.id
-			};
-			return {
-				type: "deployment-node",
-				id: d.id,
-				kind: d.kind,
-				title: d.title,
-				tags: [...d.tags]
-			};
-		}),
-		views: [...model.views()].map((v) => ({
-			id: v.id,
-			title: v.titleOrId,
-			type: v.$view._type
-		})),
-		sources: project.documents?.map((d) => d.fsPath) ?? []
-	};
-});
-
-//#endregion
-//#region src/mcp/tools/read-view.ts
-const modelRef = (node) => {
-	if (node.hasElement()) return node.element.id;
-	if (node.hasDeployment()) return node.deployment.id;
-	return null;
-};
-const nodeSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("element"),
-		id: z.string().describe("Node ID"),
-		elementId: z.string().describe("Element ID (FQN)"),
-		kind: z.string().describe("Element kind"),
-		title: z.string().describe("Node title"),
-		description: z.string().nullable(),
-		technology: z.string().nullable(),
-		children: z.array(z.string()).describe("Children nodes, array of node IDs"),
-		shape: z.string().describe("Rendered shape"),
-		color: z.string().describe("Rendered color"),
-		tags: z.array(z.string())
-	}),
-	z.object({
-		type: z.literal("deployment-node"),
-		id: z.string().describe("Node ID"),
-		deploymentId: z.string().describe("Deployment entity ID (FQN)"),
-		kind: z.string().describe("Deployment kind"),
-		title: z.string().describe("Node title"),
-		description: z.string().nullable(),
-		technology: z.string().nullable(),
-		children: z.array(z.string()).describe("Children nodes, array of node IDs"),
-		shape: z.string().describe("Rendered shape"),
-		color: z.string().describe("Rendered color"),
-		tags: z.array(z.string())
-	}),
-	z.object({
-		type: z.literal("deployed-instance"),
-		id: z.string().describe("Node ID"),
-		deploymentId: z.string().describe("Deployment entity ID (FQN)"),
-		title: z.string().describe("Node title"),
-		description: z.string().nullable(),
-		technology: z.string().nullable(),
-		referencedElement: z.object({
-			id: z.string().describe("Element ID (FQN)"),
-			kind: z.string().describe("Element kind"),
-			title: z.string().describe("Element title")
-		}),
-		shape: z.string().describe("Rendered shape"),
-		color: z.string().describe("Rendered color"),
-		tags: z.array(z.string())
-	})
-]);
-const readView = likec4Tool({
-	name: "read-view",
-	description: `
-Read detailed information about a LikeC4 view.
-
-Request:
-- viewId: string — view id (name)
-- project: string (optional) — project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- id: string — view id
-- type: "element" | "deployment" | "dynamic" — view type
-- title: string — view title (falls back to id if not set)
-- description: string|null — optional description
-- tags: string[] — view tags
-- project: string — project id this view belongs to
-- nodes: Node[] — nodes included in the view
-- edges: Edge[] — relationships between nodes
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null — source location if available
-
-Node (discriminated union by "type"):
-- type = "element": { id: string, elementId: string, kind: string, title: string, description: string|null, technology: string|null, children: string[], shape: string, color: string, tags: string[] }
-- type = "deployment-node": { id: string, deploymentId: string, kind: string, title: string, description: string|null, technology: string|null, children: string[], shape: string, color: string, tags: string[] }
-- type = "deployed-instance": { id: string, deploymentId: string, title: string, description: string|null, technology: string|null, referencedElement: { id: string, kind: string, title: string }, shape: string, color: string, tags: string[] }
-
-Edge object:
-- { source: string, target: string, label: string|null, description: string|null, technology: string|null, tags: string[] }
-
-Notes:
-- Read-only, idempotent, no side effects.
-
-Example response:
-{
-  "id": "system-overview",
-  "type": "element",
-  "title": "System Overview",
-  "description": null,
-  "tags": [],
-  "project": "default",
-  "nodes": [
-    { "type": "logical", "id": "n1", "elementId": "shop.frontend", "kind": "container", "title": "Frontend", "description": null, "technology": "React", "children": [], "shape": "rounded-rectangle", "color": "#2F80ED", "tags": [] }
-  ],
-  "edges": [
-    { "source": "n1", "target": "n2", "label": "calls", "description": null, "technology": "HTTPS", "tags": [] }
-  ],
-  "sourceLocation": {
-    "path": "/abs/path/project/model.c4",
-    "range": { "start": { "line": 10, "character": 0 }, "end": { "line": 30, "character": 0 } }
-  }
-}
-`,
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Read view"
-	},
-	inputSchema: {
-		viewId: z.string().describe("View id (name)"),
-		project: projectIdSchema
-	},
-	outputSchema: {
-		id: z.string(),
-		type: z.enum([
-			"element",
-			"deployment",
-			"dynamic"
-		]).describe("View type"),
-		title: z.string(),
-		description: z.string().nullable(),
-		tags: z.array(z.string()),
-		project: z.string(),
-		nodes: z.array(nodeSchema),
-		edges: z.array(z.object({
-			source: z.string().describe("Source node"),
-			target: z.string().describe("Target node"),
-			label: z.string().nullable(),
-			description: z.string().nullable(),
-			technology: z.string().nullable(),
-			tags: z.array(z.string())
-		})).describe("Edge represents relationship between nodes"),
-		sourceLocation: locationSchema
-	}
-}, async (languageServices, args) => {
-	const projectId = languageServices.projectsManager.ensureProjectId(args.project);
-	const project = languageServices.project(projectId);
-	const view = (await languageServices.computedModel(projectId)).findView(args.viewId);
-	if (!view) throw new Error(`View with ID '${args.viewId}' not found in project ${project.id}`);
-	const locate = mkLocate(languageServices, project.id);
-	return {
-		id: view.id,
-		type: view.$view._type,
-		title: view.title ?? view.id,
-		description: view.description.text,
-		tags: [...view.tags],
-		project: project.id,
-		nodes: [...view.nodes()].flatMap((node) => {
-			const base = {
-				id: node.id,
-				title: node.title,
-				description: node.description.text,
-				technology: node.technology,
-				shape: node.shape,
-				color: node.color,
-				tags: [...node.tags]
-			};
-			if (node.hasDeployedInstance()) return {
-				...base,
-				type: "deployed-instance",
-				deploymentId: node.deployment.id,
-				referencedElement: {
-					id: node.deployment.element.id,
-					kind: node.deployment.element.kind,
-					title: node.deployment.element.title
-				}
-			};
-			if (node.hasDeployment()) return {
-				...base,
-				type: "deployment-node",
-				kind: node.deployment.kind,
-				deploymentId: node.deployment.id,
-				children: [...node.children()].map((c) => c.id)
-			};
-			if (node.hasElement()) return {
-				...base,
-				type: "element",
-				elementId: node.element.id,
-				kind: node.element.kind,
-				children: [...node.children()].flatMap((c) => modelRef(c) ?? [])
-			};
-			return [];
-		}),
-		edges: [...view.edges()].map((r) => ({
-			source: r.source.id,
-			target: r.target.id,
-			label: r.label,
-			description: r.description.text,
-			technology: r.technology,
-			tags: [...r.tags]
-		})),
-		sourceLocation: locate({ view: view.id })
-	};
-});
-
-//#endregion
-//#region src/mcp/tools/search-element.ts
-const searchResultSchema = z.array(z.discriminatedUnion("type", [z.object({
-	type: z.literal("element"),
-	project: z.string().describe("Project ID"),
-	id: z.string().describe("Element ID (FQN)"),
-	name: z.string().describe("Element name"),
-	kind: z.string(),
-	title: z.string(),
-	technology: z.string().nullable(),
-	shape: z.string(),
-	includedInViews: includedInViewsSchema,
-	metadata: z.record(z.union([z.string(), z.array(z.string())])),
-	tags: z.array(z.string())
-}), z.object({
-	type: z.literal("deployment-node"),
-	project: z.string().describe("Project ID"),
-	id: z.string().describe("Deployment ID (FQN)"),
-	name: z.string().describe("Deployment name"),
-	kind: z.string(),
-	title: z.string(),
-	technology: z.string().nullable(),
-	shape: z.string(),
-	includedInViews: includedInViewsSchema,
-	metadata: z.record(z.union([z.string(), z.array(z.string())])),
-	tags: z.array(z.string())
-})]));
-const searchElement = likec4Tool({
-	name: "search-element",
-	annotations: {
-		readOnlyHint: true,
-		idempotentHint: true,
-		title: "Search elements"
-	},
-	description: `
-Search LikeC4 elements and deployment nodes across all projects.
-
-Query syntax (case-insensitive):
-- kind:<value>  filters by kind
-- shape:<value> filters by shape
-- meta:<key>    filters by having metadata with the given key
-- #<value>      matches assigned tags
-- <value>       matches id (FQN) or title
-
-Request:
-- search: string — at least 2 characters
-
-Response (JSON object):
-- total: number - total number of results
-- found: Result[] - returns top 20 results
-
-Result (discriminated union by "type"):
-- type = "element": { id: string, name: string, kind: string, title: string, technology: string|null, shape: string, project: string, includedInViews: View[], tags: string[], metadata: Record<string, string> }
-- type = "deployment-node": { id: string, name: string, kind: string, title: string, technology: string|null, shape: string, project: string, includedInViews: View[], tags: string[], metadata: Record<string, string> }
-
-View (object) fields:
-- id: string — view identifier
-- title: string — view title
-- type: "element" | "deployment" | "dynamic"
-
-Notes:
-- Read-only, idempotent.
-- Use results as input to other tools (e.g., read-element, read-view).
-
-Example response:
-{
-  "total": 1,
-  "found": [
-    {
-      "type": "logical",
-      "project": "default",
-      "id": "shop.frontend",
-      "name": "frontend",
-      "kind": "container",
-      "title": "Frontend",
-      "technology": "React",
-      "shape": "rectangle",      
-      "includedInViews": [
-        {
-          "id": "system-overview",
-          "title": "System Overview",
-          "type": "element"
-        }
-      ],
-      "tags": ["public"],
-      "metadata": {}
-    }
-  ]
-}
-`,
-	inputSchema: { search: z.string().min(2, "Search must be at least 2 characters long") },
-	outputSchema: {
-		total: z.number(),
-		found: searchResultSchema
-	}
-}, async (languageServices, args) => {
-	const projects = languageServices.projects();
-	const found = [];
-	let search = args.search.toLowerCase();
-	let predicate;
-	if (search.startsWith("kind:")) {
-		search = search.slice(5);
-		logger$1.debug("search by kind: {search}", { search });
-		predicate = (el) => el.kind.toLowerCase() === search;
-	} else if (search.startsWith("shape:")) {
-		search = search.slice(6);
-		logger$1.debug("search by shape: {search}", { search });
-		predicate = (el) => el.shape.toLowerCase() === search;
-	} else if (search.startsWith("meta:")) {
-		search = search.slice(5);
-		logger$1.debug("search by metadata: {search}", { search });
-		predicate = (el) => !!el.getMetadata(search);
-	} else if (search.startsWith("#")) {
-		search = search.slice(1);
-		logger$1.debug("search by tag: {search}", { search });
-		predicate = (el) => el.tags.some((tag) => tag.toLowerCase().includes(search));
-	} else {
-		logger$1.debug("search by id/title: {search}", { search });
-		predicate = (el) => el.id.toLowerCase().includes(search) || el.title.toLowerCase().includes(search);
-	}
-	for (const project of projects) try {
-		const model = await languageServices.computedModel(project.id);
-		for (const el of ifilter(model.elements(), (e) => !e.imported && predicate(e))) found.push({
-			type: "element",
-			project: project.id,
-			id: el.id,
-			name: el.name,
-			kind: el.kind,
-			title: el.title,
-			technology: el.technology,
-			shape: el.shape,
-			tags: [...el.tags],
-			metadata: el.getMetadata(),
-			includedInViews: includedInViews(el.views())
-		});
-		for (const el of ifilter(model.deployment.nodes(), predicate)) found.push({
-			type: "deployment-node",
-			project: project.id,
-			id: el.id,
-			name: el.name,
-			kind: el.kind,
-			title: el.title,
-			technology: el.technology,
-			shape: el.shape,
-			tags: [...el.tags],
-			metadata: el.getMetadata(),
-			includedInViews: includedInViews(el.views())
-		});
-	} catch (error) {
-		logger$1.error(`Error searching in project ${project.id}:`, { error });
-	}
-	return {
-		total: found.length,
-		found: found.slice(0, 20)
-	};
-});
-
-//#endregion
-//#region src/mcp/server/MCPServerFactory.ts
-var MCPServerFactory = class {
-	constructor(services) {
-		this.services = services;
-	}
-	create(options) {
-		const isInEditor = this.services.shared.lsp.Connection !== void 0;
-		const mcp = new McpServer({
-			name: "LikeC4",
-			version
-		}, {
-			instructions: `LikeC4 MCP – query and navigate LikeC4 models.
-
-Conventions:
-- All tools are read-only and idempotent.
-- "project" is optional and defaults to "default".
-
-Available tools:
-- list-projects — List all LikeC4 projects in the workspace.
-- read-project-summary — Project specification (element kinds, deployment node kinds, tags, metadata keys), all elements, deployment nodes and views. Input: { project? }.
-- search-element — Search elements and deployment nodes across all projects by id/title/kind/shape/tags/metadata. Input: { search }.
-- read-element — Full element details including relationships, includedInViews, deployedInstances, metadata and sourceLocation. Input: { id, project? }.
-- read-deployment — Details of a deployment node or deployed instance. Input: { id, project? }.
-- read-view — Full view details (nodes/edges) and sourceLocation. Input: { viewId, project? }.
-- find-relationships — Direct and indirect relationships between two elements in a project. Input: { element1, element2, project? }.
-${isInEditor ? "- open-view — Opens the LikeC4 view panel in the editor. Triggers UI; at most one preview panel at a time. Input: { viewId, project? }." : ""}
-
-Instructions:
-- Identify the project first  
-  - Use "search-element" to find elements by id/title/kind/shape/tags/metadata and select the project
-  - Use "read-project-summary" to find all elements and deployment nodes inside the project, what kinds, tags, metadata keys are available
-  - Use "list-projects" to list all available projects
-- If response returns "sourceLocation", provide link to this location in the editor
-
-Full documentation: https://likec4.dev/llms-full.txt
-`,
-			enforceStrictCapabilities: true,
-			...options,
-			capabilities: {
-				tools: {},
-				...options?.capabilities
-			}
-		});
-		mcp.registerTool(...listProjects(this.services.likec4.LanguageServices));
-		mcp.registerTool(...readProjectSummary(this.services.likec4.LanguageServices));
-		mcp.registerTool(...readElement(this.services.likec4.LanguageServices));
-		mcp.registerTool(...readDeployment(this.services.likec4.LanguageServices));
-		mcp.registerTool(...readView(this.services.likec4.LanguageServices));
-		mcp.registerTool(...searchElement(this.services.likec4.LanguageServices));
-		mcp.registerTool(...findRelationships(this.services.likec4.LanguageServices));
-		if (isInEditor) mcp.registerTool(...openView(this.services.likec4.LanguageServices));
-		mcp.server.onerror = (err) => {
-			logger$4.error(loggable(err));
-		};
-		return mcp;
-	}
-};
-
-//#endregion
-//#region src/mcp/server/StdioLikeC4MCPServer.ts
-var StdioLikeC4MCPServer = class {
-	transport = void 0;
-	_mcp = void 0;
-	constructor(services) {
-		this.services = services;
-	}
-	get mcp() {
-		if (!this._mcp) throw new Error("MCP server is not started");
-		return this._mcp;
-	}
-	get isStarted() {
-		return this.transport !== void 0;
-	}
-	get port() {
-		return NaN;
-	}
-	async dispose() {
-		await this.stop();
-	}
-	async start() {
-		if (this.transport) return;
-		logger$1.info("Starting MCP stdio server");
-		this._mcp = this.services.mcp.ServerFactory.create();
-		this.transport = new StdioServerTransport();
-		await this._mcp.connect(this.transport);
-		logger$1.info("LikeC4 MCP Server running on stdio");
-	}
-	async stop() {
-		if (!this.transport) return;
-		try {
-			logger$1.info("Stopping MCP stdio server");
-			await this.transport.close();
-			if (this._mcp) await this._mcp.close();
-		} finally {
-			this._mcp = void 0;
-			this.transport = void 0;
-		}
-	}
-};
-
-//#endregion
-//#region src/mcp/server/StreamableLikeC4MCPServer.ts
-async function createHonoApp(factory) {
-	const mcp = factory.create();
-	const transport = new WebStandardStreamableHTTPServerTransport({ sessionIdGenerator: () => nanoid() });
-	const app = new Hono();
-	app.use("*", cors({
-		origin: "*",
-		allowHeaders: [
-			"Content-Type",
-			"mcp-session-id",
-			"Last-Event-ID",
-			"mcp-protocol-version"
-		],
-		exposeHeaders: ["mcp-session-id", "mcp-protocol-version"]
-	}));
-	app.get("/health", (c) => c.json({ status: "ok" }));
-	app.all("/mcp", (c) => transport.handleRequest(c.req.raw));
-	app.notFound((c) => {
-		logger$1.debug(`${c.req.method} ${c.req.url} not found`);
-		return c.json({
-			jsonrpc: "2.0",
-			error: {
-				code: -32e3,
-				message: "Method not found."
-			},
-			id: null
-		}, { status: 404 });
-	});
-	app.onError((e, c) => {
-		logger$1.error(loggable(e));
-		return c.json({
-			jsonrpc: "2.0",
-			error: {
-				code: -32603,
-				message: "Internal server error"
-			},
-			id: null
-		}, { status: 500 });
-	});
-	await mcp.connect(transport);
-	return app;
-}
-async function startServer(params) {
-	const { factory, port } = params;
-	const app = await createHonoApp(factory);
-	return new Promise((resolve, reject) => {
-		const server = serve({
-			fetch: app.fetch,
-			hostname: "0.0.0.0",
-			port
-		}).prependOnceListener("error", reject).prependOnceListener("listening", () => {
-			server.removeListener("error", reject);
-			resolve(server.unref());
-		});
-	});
-}
-var StreamableLikeC4MCPServer = class {
-	server = void 0;
-	constructor(services, _port = 33335) {
-		this.services = services;
-		this._port = _port;
-	}
-	get mcp() {
-		throw new Error("StreamableLikeC4MCPServer has access to McpServer only during the request");
-	}
-	get isStarted() {
-		return this.server?.listening === true;
-	}
-	get port() {
-		return this._port;
-	}
-	async dispose() {
-		await this.stop();
-	}
-	async start(port = this._port) {
-		if (this.server) {
-			if (this.port === port) return;
-			await this.stop();
-		}
-		logger$1.info("Starting MCP server on port {port}", { port });
-		this._port = port;
-		this.server = await startServer({
-			factory: this.services.mcp.ServerFactory,
-			port
-		});
-		logger$1.info("MCP server ready at http://0.0.0.0:{port}/mcp", { port });
-	}
-	stop() {
-		const server = this.server;
-		if (!server) {
-			logger$1.info("MCP server is not running, nothing to stop");
-			return Promise.resolve();
-		}
-		logger$1.info("Stopping MCP server");
-		this.server = void 0;
-		return new Promise((resolve) => {
-			server.close((err) => {
-				if (err) logger$1.error("Failed to stop MCP server", { err });
-				else logger$1.info("MCP server stopped");
-				resolve();
-			});
-		});
-	}
-};
-
-//#endregion
-//#region src/mcp/server/WithMCPServer.ts
-function streamableLikeC4MCPServer(services, defaultPort = 33335) {
-	logger$1.debug("Creating StreamableLikeC4MCPServer");
-	const server = new StreamableLikeC4MCPServer(services, defaultPort);
-	const langId = services.LanguageMetaData.languageId;
-	const connection = services.shared.lsp.Connection;
-	services.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate((update) => {
-		if (update.section !== langId) {
-			logger$1.warn("Unexpected configuration update: {update}", { update });
-			return;
-		}
-		const { enabled = false, port = defaultPort } = update.configuration.mcp;
-		if (!enabled) {
-			server.stop();
-			return;
-		}
-		Promise.resolve().then(() => server.start(port)).then(() => {
-			connection?.telemetry?.logEvent({
-				eventName: "mcp-server-started",
-				mcpPort: port
-			});
-		}).catch((err) => {
-			const message = loggable(err);
-			connection?.telemetry?.logEvent({
-				eventName: "mcp-server-start-failed",
-				mcpPort: port,
-				message
-			});
-			logger$1.warn(`Failed to start LikeC4 MCP Server: \n${message}`);
-			if (connection) connection.window.showErrorMessage(`LikeC4: Failed to start MCP Server\n\n${message}`);
-		});
-	});
-	return server;
-}
-function stdioLikeC4MCPServer(services) {
-	return new StdioLikeC4MCPServer(services);
-}
-function WithMCPServer(type = "sse") {
-	return {
-		mcpServer: (services) => {
-			if (type === "stdio") return stdioLikeC4MCPServer(services);
-			return streamableLikeC4MCPServer(services, typeof type === "object" ? type.port : 33335);
-		},
-		mcpServerFactory: (services) => {
-			return new MCPServerFactory(services);
-		}
-	};
-}
-
-//#endregion
-//#region src/views/ConfigurableLayouter.ts
-function graphvizBinPath() {
-	try {
-		return which.sync("dot");
-	} catch (error) {
-		logger$4.error("Error checking for native Graphviz:", { error });
-		return null;
-	}
-}
-const ConfigurableLayouter = { likec4: { Layouter(services) {
-	logger$4.debug("Creating ConfigurableLayouter");
-	const layouter = new QueueGraphvizLayoter();
-	services.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate((update) => {
-		logger$4.debug("Configuration update: {update}", { update });
-		if (update.section !== services.LanguageMetaData.languageId) {
-			logger$4.debug(`Ignoring configuration update as it is not for ${services.LanguageMetaData.languageId}`);
-			return;
-		}
-		try {
-			const { mode, path } = update.configuration.graphviz ?? {
-				mode: "wasm",
-				path: ""
-			};
-			if (mode !== "wasm") {
-				let binaryPath = e$1(path) ? graphvizBinPath() : path;
-				if (!e$1(binaryPath)) {
-					layouter.changePort(new GraphvizBinaryAdapter(binaryPath));
-					logger$4.info`use graphviz binary: ${binaryPath}`;
-					return;
-				}
-				logger$4.warn(`No Graphviz binaries found on PATH, use graphviz wasm`);
-				services.shared.lsp.Connection?.window.showWarningMessage("No Graphviz binaries found on PATH, set path to binaries in settings.");
-			}
-			layouter.changePort(new GraphvizWasmAdapter());
-			logger$4.info("use graphviz wasm");
-		} catch (error) {
-			logger$4.error("Failed to update configuration", { error });
-		}
-	});
-	return layouter;
-} } };
-
-//#endregion
-export { WithLikeC4ManualLayouts as i, WithMCPServer as n, WithFileSystem as r, ConfigurableLayouter as t };
+import{i as logger}from"./logger.mjs";import{C as e}from"./libs/remeda.mjs";import{GraphvizWasmAdapter,QueueGraphvizLayoter}from"@likec4/layouts";import{GraphvizBinaryAdapter}from"@likec4/layouts/graphviz/binary";import which from"which";function graphvizBinPath(){try{return which.sync(`dot`)}catch(t){return logger.error(`Error checking for native Graphviz:`,{error:t}),null}}const ConfigurableLayouter={likec4:{Layouter(i){logger.debug(`Creating ConfigurableLayouter`);let a=new QueueGraphvizLayoter;return i.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate(r=>{if(logger.debug(`Configuration update: {update}`,{update:r}),r.section!==i.LanguageMetaData.languageId){logger.debug(`Ignoring configuration update as it is not for ${i.LanguageMetaData.languageId}`);return}try{let{mode:o,path:s}=r.configuration.graphviz??{mode:`wasm`,path:``};if(o!==`wasm`){let n=e(s)?graphvizBinPath():s;if(!e(n)){a.changePort(new GraphvizBinaryAdapter(n)),logger.info`use graphviz binary: ${n}`;return}logger.warn(`No Graphviz binaries found on PATH, use graphviz wasm`),i.shared.lsp.Connection?.window.showWarningMessage(`No Graphviz binaries found on PATH, set path to binaries in settings.`)}a.changePort(new GraphvizWasmAdapter),logger.info(`use graphviz wasm`)}catch(t){logger.error(`Failed to update configuration`,{error:t})}}),a}}};export{ConfigurableLayouter as t};