@likec4/language-server 1.47.0 → 1.48.0

package/dist/mcp/server/WithMCPServer.js

@@ -1,54 +0,0 @@
-import { loggable } from '@likec4/log';
-import { logger } from '../utils';
-import { StdioLikeC4MCPServer } from './StdioLikeC4MCPServer';
-import { StreamableLikeC4MCPServer } from './StreamableLikeC4MCPServer';
-const streamableLikeC4MCPServer = (services, defaultPort = 33335) => {
-    logger.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.warn('Unexpected configuration update: {update}', { update });
-            return;
-        }
-        const { enabled = false, port = defaultPort, } = update.configuration.mcp;
-        if (!enabled) {
-            void server.stop();
-            return;
-        }
-        void 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.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;
-};
-const stdioLikeC4MCPServer = (services) => {
-    return new StdioLikeC4MCPServer(services);
-};
-export const WithMCPServer = (type = 'sse') => ({
-    mcpServer: (services) => {
-        if (type === 'stdio') {
-            return stdioLikeC4MCPServer(services);
-        }
-        const port = typeof type === 'object' ? type.port : 33335;
-        return streamableLikeC4MCPServer(services, port);
-    },
-});

package/dist/mcp/tools/_common.d.ts

@@ -1,88 +0,0 @@
-import type { LikeC4ViewModel } from '@likec4/core/model';
-import type { ProjectId } from '@likec4/core/types';
-import * as z from 'zod/v3';
-import type { LikeC4LanguageServices } from '../../LikeC4LanguageServices';
-import type { Locate } from '../../protocol';
-export declare const locationSchema: z.ZodNullable<z.ZodObject<{
-    path: z.ZodString;
-    range: z.ZodObject<{
-        start: z.ZodObject<{
-            line: z.ZodNumber;
-            character: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            line: number;
-            character: number;
-        }, {
-            line: number;
-            character: number;
-        }>;
-        end: z.ZodObject<{
-            line: z.ZodNumber;
-            character: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            line: number;
-            character: number;
-        }, {
-            line: number;
-            character: number;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        start: {
-            line: number;
-            character: number;
-        };
-        end: {
-            line: number;
-            character: number;
-        };
-    }, {
-        start: {
-            line: number;
-            character: number;
-        };
-        end: {
-            line: number;
-            character: number;
-        };
-    }>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    range: {
-        start: {
-            line: number;
-            character: number;
-        };
-        end: {
-            line: number;
-            character: number;
-        };
-    };
-}, {
-    path: string;
-    range: {
-        start: {
-            line: number;
-            character: number;
-        };
-        end: {
-            line: number;
-            character: number;
-        };
-    };
-}>>;
-export declare const projectIdSchema: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, ProjectId, string>>>;
-export declare const includedInViewsSchema: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    type: z.ZodEnum<["element", "deployment", "dynamic"]>;
-}, "strip", z.ZodTypeAny, {
-    type: "element" | "deployment" | "dynamic";
-    id: string;
-    title: string;
-}, {
-    type: "element" | "deployment" | "dynamic";
-    id: string;
-    title: string;
-}>, "many">;
-export declare const includedInViews: (views: Iterable<LikeC4ViewModel>) => z.infer<typeof includedInViewsSchema>;
-export declare const mkLocate: (languageServices: LikeC4LanguageServices, projectId: string) => (params: Locate.Params) => z.infer<typeof locationSchema>;

package/dist/mcp/tools/_common.js

@@ -1,49 +0,0 @@
-import { URI } from 'vscode-uri';
-import * as z from 'zod/v3';
-import { ProjectsManager } from '../../workspace';
-import { logger } from '../utils';
-export 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();
-export const projectIdSchema = z.string()
-    .refine((_v) => true)
-    .optional()
-    .default(ProjectsManager.DefaultProjectId)
-    .describe('Project id (optional, will use "default" if not specified)');
-export 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'),
-}));
-export const includedInViews = (views) => {
-    return [...views].map(v => ({
-        id: v.id,
-        title: v.titleOrId,
-        type: v.$view._type,
-    }));
-};
-export const mkLocate = (languageServices, projectId) => (params) => {
-    try {
-        const loc = languageServices.locate({ projectId, ...params });
-        return loc
-            ? {
-                path: URI.parse(loc.uri).fsPath,
-                range: loc.range,
-            }
-            : null;
-    }
-    catch (e) {
-        logger.debug(`Failed to locate {params}`, { error: e, params });
-        return null;
-    }
-};

package/dist/mcp/tools/find-relationships.d.ts

@@ -1,202 +0,0 @@
-import * as z from 'zod/v3';
-export declare const findRelationships: (languageServices: import("../..").LikeC4LanguageServices) => [string, {
-    inputSchema?: {
-        element1: z.ZodString;
-        element2: z.ZodString;
-        project: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, import("@likec4/core").ProjectId, string>>>;
-    };
-}, (args: import("@modelcontextprotocol/sdk/server/zod-compat.js").ShapeOutput<{
-    element1: z.ZodString;
-    element2: z.ZodString;
-    project: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, import("@likec4/core").ProjectId, string>>>;
-}>, extra: import("@modelcontextprotocol/sdk/shared/protocol.js").RequestHandlerExtra<import("@modelcontextprotocol/sdk/types.js").ServerRequest, import("@modelcontextprotocol/sdk/types.js").ServerNotification>) => {
-    [x: string]: unknown;
-    content: ({
-        type: "text";
-        text: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        type: "image";
-        data: string;
-        mimeType: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        type: "audio";
-        data: string;
-        mimeType: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        uri: string;
-        name: string;
-        type: "resource_link";
-        description?: string | undefined;
-        mimeType?: string | undefined;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    } | {
-        type: "resource";
-        resource: {
-            uri: string;
-            text: string;
-            mimeType?: string | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            blob: string;
-            mimeType?: string | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        };
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    })[];
-    _meta?: {
-        [x: string]: unknown;
-        progressToken?: string | number | undefined;
-        "io.modelcontextprotocol/related-task"?: {
-            taskId: string;
-        } | undefined;
-    } | undefined;
-    structuredContent?: {
-        [x: string]: unknown;
-    } | undefined;
-    isError?: boolean | undefined;
-} | Promise<{
-    [x: string]: unknown;
-    content: ({
-        type: "text";
-        text: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        type: "image";
-        data: string;
-        mimeType: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        type: "audio";
-        data: string;
-        mimeType: string;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    } | {
-        uri: string;
-        name: string;
-        type: "resource_link";
-        description?: string | undefined;
-        mimeType?: string | undefined;
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        icons?: {
-            src: string;
-            mimeType?: string | undefined;
-            sizes?: string[] | undefined;
-            theme?: "light" | "dark" | undefined;
-        }[] | undefined;
-        title?: string | undefined;
-    } | {
-        type: "resource";
-        resource: {
-            uri: string;
-            text: string;
-            mimeType?: string | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            blob: string;
-            mimeType?: string | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        };
-        annotations?: {
-            audience?: ("user" | "assistant")[] | undefined;
-            priority?: number | undefined;
-            lastModified?: string | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-    })[];
-    _meta?: {
-        [x: string]: unknown;
-        progressToken?: string | number | undefined;
-        "io.modelcontextprotocol/related-task"?: {
-            taskId: string;
-        } | undefined;
-    } | undefined;
-    structuredContent?: {
-        [x: string]: unknown;
-    } | undefined;
-    isError?: boolean | undefined;
-}>];

package/dist/mcp/tools/find-relationships.js

@@ -1,150 +0,0 @@
-import { modelConnection } from '@likec4/core/model';
-import { invariant, isSameHierarchy } from '@likec4/core/utils';
-import * as z from 'zod/v3';
-import { likec4Tool } from '../utils';
-import { includedInViews, includedInViewsSchema, locationSchema, mkLocate, projectIdSchema } from './_common';
-const endpointSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    kind: z.string(),
-});
-const searchResultSchema = 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,
-});
-export 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),
-    },
-}, 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,
-    };
-});