@likec4/language-server 1.42.1 → 1.44.0

package/dist/mcp/tools/read-element.mjs

@@ -1,198 +0,0 @@
-import { invariant } from "@likec4/core";
-import z from "zod";
-import { likec4Tool } from "../utils.mjs";
-import { includedInViews, includedInViewsSchema, locationSchema, mkLocate, projectIdSchema } from "./_common.mjs";
-export const readElement = likec4Tool({
-  name: "read-element",
-  description: `
-Read detailed information about a LikeC4 element.
-
-Request:
-- id: string \u2014 element id (FQN)
-- project: string (optional) \u2014 project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- id: string \u2014 element id (FQN)
-- name: string \u2014 element name
-- kind: string \u2014 element kind
-- title: string \u2014 human-readable title
-- description: string|null \u2014 optional description
-- technology: string|null \u2014 optional technology
-- tags: string[] \u2014 assigned tags
-- project: string \u2014 project id this element belongs to
-- metadata: Record<string, string> \u2014 element metadata
-- shape: string \u2014 rendered shape
-- color: string \u2014 rendered color
-- children: string[] \u2014 ids (FQNs) of direct child elements
-- defaultView: string|null \u2014 default view name if set
-- includedInViews: View[] \u2014 views that include this element
-- relationships: object \u2014 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[] \u2014 deployed instance ids (Deployment FQNs)
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null \u2014 source location if available
-
-View (object) fields:
-- id: string \u2014 view identifier
-- title: string \u2014 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" },
-  "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.string()),
-    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(),
-    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 })
-  };
-});

package/dist/mcp/tools/read-project-summary.mjs

@@ -1,178 +0,0 @@
-import { keys } from "remeda";
-import z from "zod";
-import { likec4Tool } from "../utils.mjs";
-import { projectIdSchema } from "./_common.mjs";
-export const readProjectSummary = likec4Tool({
-  name: "read-project-summary",
-  annotations: {
-    readOnlyHint: true,
-    idempotentHint: true,
-    title: "Read project summary"
-  },
-  description: `
-Request:
-- project: string (optional) \u2014 project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- title: string \u2014 human-readable project title
-- folder: string \u2014 absolute path to the project root
-- sources: string[] \u2014 absolute file paths of model documents
-- specification: object
-  - elementKinds: string[] \u2014 all element kinds
-  - relationshipKinds: string[] \u2014 all relationship kinds
-  - deploymentKinds: string[] \u2014 all deployment kinds
-  - tags: string[] \u2014 all tags
-  - metadataKeys: string[] \u2014 used metadata keys
-- elements: Element[] \u2014 list of elements
-- deployments: Deployment[] \u2014 list of deployment entities
-- views: View[] \u2014 list of views defined in the model
-
-Element (object) fields:
-- id: string \u2014 element id (FQN)
-- kind: string \u2014 element kind
-- title: string \u2014 element title
-- tags: string[] \u2014 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 \u2014 view identifier
-- title: string \u2014 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: keys(model.specification.elements),
-      relationshipKinds: keys(model.specification.relationships),
-      deploymentKinds: keys(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) ?? []
-  };
-});

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

@@ -1,205 +0,0 @@
-import z from "zod";
-import { likec4Tool } from "../utils.mjs";
-import { locationSchema, mkLocate, projectIdSchema } from "./_common.mjs";
-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 \u2014 view id (name)
-- project: string (optional) \u2014 project id. Defaults to "default" if omitted.
-
-Response (JSON object):
-- id: string \u2014 view id
-- type: "element" | "deployment" | "dynamic" \u2014 view type
-- title: string \u2014 view title (falls back to id if not set)
-- description: string|null \u2014 optional description
-- tags: string[] \u2014 view tags
-- project: string \u2014 project id this view belongs to
-- nodes: Node[] \u2014 nodes included in the view
-- edges: Edge[] \u2014 relationships between nodes
-- sourceLocation: { path: string, range: { start: { line: number, character: number }, end: { line: number, character: number } } } | null \u2014 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 })
-  };
-});