@likec4/language-server 1.47.0 → 1.48.0

package/dist/mcp/tools/read-view.js

@@ -1,203 +0,0 @@
-import * as z from 'zod/v3';
-import { likec4Tool } from '../utils';
-import { locationSchema, mkLocate, projectIdSchema } from './_common';
-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()),
-    }),
-]);
-export 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 model = await languageServices.computedModel(projectId);
-    const view = model.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 }),
-    };
-});

package/dist/mcp/tools/search-element.d.ts

@@ -1,198 +0,0 @@
-import * as z from 'zod/v3';
-export declare const searchElement: (languageServices: import("../..").LikeC4LanguageServices) => [string, {
-    inputSchema?: {
-        search: z.ZodString;
-    };
-}, (args: import("@modelcontextprotocol/sdk/server/zod-compat.js").ShapeOutput<{
-    search: z.ZodString;
-}>, 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/search-element.js

@@ -1,177 +0,0 @@
-import { ifilter } from '@likec4/core/utils';
-import * as z from 'zod/v3';
-import { likec4Tool, logger } from '../utils';
-import { includedInViews, includedInViewsSchema } from './_common';
-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()),
-    }),
-]));
-export 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.debug('search by kind: {search}', { search });
-        predicate = (el) => el.kind.toLowerCase() === search;
-    }
-    else if (search.startsWith('shape:')) {
-        search = search.slice(6);
-        logger.debug('search by shape: {search}', { search });
-        predicate = (el) => el.shape.toLowerCase() === search;
-    }
-    else if (search.startsWith('meta:')) {
-        search = search.slice(5);
-        logger.debug('search by metadata: {search}', { search });
-        predicate = (el) => !!el.getMetadata(search);
-    }
-    else if (search.startsWith('#')) {
-        search = search.slice(1);
-        logger.debug('search by tag: {search}', { search });
-        predicate = (el) => el.tags.some(tag => tag.toLowerCase().includes(search));
-    }
-    else {
-        logger.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);
-            // filter elements
-            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()),
-                });
-            }
-            // filter deployment nodes
-            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.error(`Error searching in project ${project.id}:`, { error });
-        }
-    }
-    return {
-        total: found.length,
-        found: found.slice(0, 20),
-    };
-});

package/dist/mcp/utils.d.ts

@@ -1,18 +0,0 @@
-import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import type { ServerNotification, ServerRequest, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
-import type { z, ZodRawShape, ZodTypeAny } from 'zod/v3';
-import type { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { LikeC4LanguageServices } from '../LikeC4LanguageServices';
-export declare const logger: import("@logtape/logtape").Logger;
-type ToolResult<Out extends undefined | ZodRawShape = undefined> = Out extends ZodRawShape ? z.objectOutputType<Out, ZodTypeAny> : string;
-type LikeC4ToolCallback<Args extends undefined | ZodRawShape, Out extends undefined | ZodRawShape> = Args extends ZodRawShape ? (languageServices: LikeC4LanguageServices, args: z.objectOutputType<Args, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<ToolResult<Out>> : (languageServices: LikeC4LanguageServices, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<ToolResult<Out>>;
-export declare function likec4Tool<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape, Cb extends LikeC4ToolCallback<InputArgs, OutputArgs>>(config: {
-    name: string;
-    description?: string;
-    inputSchema?: InputArgs;
-    outputSchema?: OutputArgs;
-    annotations?: ToolAnnotations;
-}, cb: Cb): (languageServices: LikeC4LanguageServices) => [string, {
-    inputSchema?: InputArgs;
-}, ToolCallback<InputArgs>];
-export {};

package/dist/mcp/utils.js

@@ -1,48 +0,0 @@
-import { loggable } from '@likec4/log';
-import { logger as mainLogger } from '../logger';
-export const logger = mainLogger.getChild('mcp');
-export 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.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.error(`Tool ${name} failed`, { err });
-            return {
-                content: [{
-                        type: 'text',
-                        text: loggable(err),
-                    }],
-                isError: true,
-            };
-        }
-    });
-}

package/dist/model/builder/MergedExtends.d.ts

@@ -1,13 +0,0 @@
-import type * as c4 from '@likec4/core';
-import type { ParsedAstExtend } from '../../ast';
-export declare class MergedExtends {
-    private mergedData;
-    private mergeMetadata;
-    merge(parsedExtends: ParsedAstExtend[]): void;
-    applyExtended<E extends {
-        id: string;
-        tags?: readonly string[] | null;
-        links?: readonly c4.Link[] | null;
-        metadata?: Record<string, string | string[]>;
-    }>(el: E): E;
-}