@likec4/language-server 1.47.0 → 1.48.0

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

@@ -1,150 +0,0 @@
-// SPDX-License-Identifier: MIT
-//
-// Copyright (c) 2023-2025 Denis Davydkov
-// Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
-//
-// Portions of this file have been modified by NVIDIA CORPORATION & AFFILIATES.
-import { invariant } from '@likec4/core';
-import * as z from 'zod/v3';
-import { likec4Tool } from '../utils';
-import { includedInViews, includedInViewsSchema, locationSchema, mkLocate, projectIdSchema } from './_common';
-export 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 model = await languageServices.computedModel(projectId);
-    const element = model.deployment.findElement(args.id);
-    invariant(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 }),
-    };
-});

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

@@ -1,200 +0,0 @@
-import * as z from 'zod/v3';
-export declare const readElement: (languageServices: import("../..").LikeC4LanguageServices) => [string, {
-    inputSchema?: {
-        id: 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<{
-    id: 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/read-element.js

@@ -1,218 +0,0 @@
-// SPDX-License-Identifier: MIT
-//
-// Copyright (c) 2023-2025 Denis Davydkov
-// Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
-//
-// Portions of this file have been modified by NVIDIA CORPORATION & AFFILIATES.
-import { invariant } from '@likec4/core';
-import * as z from 'zod/v3';
-import { likec4Tool } from '../utils';
-import { includedInViews, includedInViewsSchema, locationSchema, mkLocate, projectIdSchema } from './_common';
-export 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 model = await languageServices.computedModel(projectId);
-    const element = model.findElement(args.id);
-    invariant(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 }),
-    };
-});