@likec4/language-server 1.48.0 → 1.49.0

package/dist/_chunks/WithMCPServer.mjs

@@ -0,0 +1,481 @@
+import{i as logger$2}from"./logger.mjs";import{h as t}from"./libs/remeda.mjs";import{t as ProjectsManager}from"./ProjectsManager.mjs";import{ifilter,invariant,isSameHierarchy}from"@likec4/core/utils";import{loggable}from"@likec4/log";import{invariant as invariant$1}from"@likec4/core";import{modelConnection}from"@likec4/core/model";import{URI}from"vscode-uri";import{McpServer}from"@modelcontextprotocol/sdk/server/mcp.js";import*as z from"zod/v3";import{StdioServerTransport}from"@modelcontextprotocol/sdk/server/stdio.js";import{MemoryEventStore,StreamableHTTPTransport}from"@hono/mcp";import{serve}from"@hono/node-server";import{Hono}from"hono";import{cors}from"hono/cors";const logger$1=logger$2.getChild(`mcp`);function likec4Tool(e,n){let{name:r,description:i,...a}=e;return e=>[r,{description:i?.trim()??``,...a},mkcallTool(r,e,n)]}function mkcallTool(e,n,r){let i=r.bind(null,n);return(async function(n,r){logger$1.debug(`Calling tool {name}, args: {args}`,{name:e,args:n});try{let e=await i.call(null,n,r);return typeof e==`string`?{content:[{type:`text`,text:e}]}:{content:[{type:`text`,text:JSON.stringify(e)}],structuredContent:e}}catch(n){return logger$1.error(`Tool ${e} failed`,{err:n}),{content:[{type:`text`,text:loggable(n)}],isError:!0}}})}var version=`1.49.0`;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(),projectIdSchema=z.string().refine(e=>!0).optional().default(ProjectsManager.DefaultProjectId).describe(`Project id (optional, will use "default" if not specified)`),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`)})),includedInViews=e=>[...e].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type})),mkLocate=(e,n)=>r=>{try{let i=e.locate({projectId:n,...r});return i?{path:URI.parse(i.uri).fsPath,range:i.range}:null}catch(e){return logger$1.debug(`Failed to locate {params}`,{error:e,params:r}),null}},endpointSchema=z.object({id:z.string(),title:z.string(),kind:z.string()}),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}),findRelationships=likec4Tool({name:`find-relationships`,annotations:{readOnlyHint:!0,idempotentHint:!0,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(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project);if(isSameHierarchy(n.element1,n.element2))throw Error(`No relationships possible between parent-child`);let i=[],s=await e.computedModel(r),c=s.findElement(n.element1);invariant(c,`Element "${n.element1}" not found in project "${r}"`);let l=s.findElement(n.element2);invariant(l,`Element "${n.element2}" not found in project "${r}"`);let u=mkLocate(e,r),d=modelConnection.findConnection(c,l,`both`).flatMap(e=>[...e.relations]);for(let e of d){let n=e.source===c&&e.target===l||e.source===l&&e.target===c;i.push({type:n?`direct`:`indirect`,source:{id:e.source.id,title:e.source.title,kind:e.source.kind},target:{id:e.target.id,title:e.target.title,kind:e.target.kind},kind:e.kind,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags],includedInViews:includedInViews(e.views()),sourceLocation:u({relation:e.id})})}return{found:i}}),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:!0,idempotentHint:!0,title:`List projects`},outputSchema:{projects:z.array(z.object({id:z.string(),title:z.string(),folder:z.string(),sources:z.array(z.string())}))}},async e=>({projects:e.projects().map(e=>({id:e.id,title:e.title,folder:e.folder.fsPath,sources:e.documents.map(e=>e.fsPath)}))})),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:!0,idempotentHint:!0,title:`Open view in preview panel`},inputSchema:{viewId:z.string().describe(`View id (name)`),project:projectIdSchema},outputSchema:{location:locationSchema}},async(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project),i=(await e.computedModel(r)).findView(n.viewId);if(!i)throw Error(`View with ID '${n.viewId}' not found in project ${r}`);return await e.views.openView(i.id,r),{location:mkLocate(e,r)({view:i.id})}}),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:!0,idempotentHint:!0,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(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project),i=(await e.computedModel(r)).deployment.findElement(n.id);invariant$1(i,`Deployment entity "${n.id}" not found in project "${r}"`);let a=mkLocate(e,r);return{type:i.isInstance()?`deployed-instance`:`deployment-node`,id:i.id,name:i.name,kind:i.kind,title:i.title,description:i.description.text,technology:i.technology,tags:[...i.tags],project:r,metadata:i.getMetadata(),links:(i.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:i.shape,color:i.color,children:i.isInstance()?[]:[...i.children()].map(e=>e.id),includedInViews:includedInViews(i.views()),instanceof:i.isInstance()?{id:i.element.id,title:i.element.title,kind:i.element.kind}:null,sourceLocation:a({deployment:i.id})}}),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:!0,idempotentHint:!0,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(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project),i=(await e.computedModel(r)).findElement(n.id);invariant$1(i,`Element "${n.id}" not found in project "${r}"`);let a=mkLocate(e,r);return{id:i.id,name:i.name,kind:i.kind,title:i.title,description:i.description.text,technology:i.technology,tags:[...i.tags],project:r,metadata:i.getMetadata(),links:(i.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:i.shape,color:i.color,children:[...i.children()].map(e=>e.id),defaultView:i.defaultView?.id||null,includedInViews:includedInViews(i.views()),relationships:{incoming:[...i.incoming()].map(e=>({source:{id:e.source.id,title:e.source.title,kind:e.source.kind},kind:e.kind,target:e.target.id,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags]})),outgoing:[...i.outgoing()].map(e=>({source:e.source.id,target:{id:e.target.id,title:e.target.title,kind:e.target.kind},kind:e.kind,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags]}))},deployedInstances:[...i.deployments()].map(e=>e.id),sourceLocation:a({element:i.id})}}),readProjectSummary=likec4Tool({name:`read-project-summary`,annotations:{readOnlyHint:!0,idempotentHint:!0,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(e,r)=>{let i=e.projectsManager.ensureProjectId(r.project),a=e.project(i),o=await e.computedModel(i);return{title:a.title,folder:a.folder.fsPath,specification:{elementKinds:t(o.specification.elements),relationshipKinds:t(o.specification.relationships),deploymentKinds:t(o.specification.deployments),tags:[...o.tags],metadataKeys:o.specification.metadataKeys??[]},elements:[...o.elements()].filter(e=>!e.imported).map(e=>({id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]})),deployments:[...o.deployment.elements()].map(e=>e.isInstance()?{type:`deployed-instance`,id:e.id,title:e.title,tags:[...e.tags],referencedElementId:e.element.id}:{type:`deployment-node`,id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]}),views:[...o.views()].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type})),sources:a.documents?.map(e=>e.fsPath)??[]}}),modelRef=e=>e.hasElement()?e.element.id:e.hasDeployment()?e.deployment.id:null,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())})]),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:!0,idempotentHint:!0,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(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project),i=e.project(r),a=(await e.computedModel(r)).findView(n.viewId);if(!a)throw Error(`View with ID '${n.viewId}' not found in project ${i.id}`);let o=mkLocate(e,i.id);return{id:a.id,type:a.$view._type,title:a.title??a.id,description:a.description.text,tags:[...a.tags],project:i.id,nodes:[...a.nodes()].flatMap(e=>{let n={id:e.id,title:e.title,description:e.description.text,technology:e.technology,shape:e.shape,color:e.color,tags:[...e.tags]};return e.hasDeployedInstance()?{...n,type:`deployed-instance`,deploymentId:e.deployment.id,referencedElement:{id:e.deployment.element.id,kind:e.deployment.element.kind,title:e.deployment.element.title}}:e.hasDeployment()?{...n,type:`deployment-node`,kind:e.deployment.kind,deploymentId:e.deployment.id,children:[...e.children()].map(e=>e.id)}:e.hasElement()?{...n,type:`element`,elementId:e.element.id,kind:e.element.kind,children:[...e.children()].flatMap(e=>modelRef(e)??[])}:[]}),edges:[...a.edges()].map(e=>({source:e.source.id,target:e.target.id,label:e.label,description:e.description.text,technology:e.technology,tags:[...e.tags]})),sourceLocation:o({view:a.id})}}),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())})])),searchElement=likec4Tool({name:`search-element`,annotations:{readOnlyHint:!0,idempotentHint:!0,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(e,n)=>{let r=e.projects(),a=[],o=n.search.toLowerCase(),predicate;o.startsWith(`kind:`)?(o=o.slice(5),logger$1.debug(`search by kind: {search}`,{search:o}),predicate=e=>e.kind.toLowerCase()===o):o.startsWith(`shape:`)?(o=o.slice(6),logger$1.debug(`search by shape: {search}`,{search:o}),predicate=e=>e.shape.toLowerCase()===o):o.startsWith(`meta:`)?(o=o.slice(5),logger$1.debug(`search by metadata: {search}`,{search:o}),predicate=e=>!!e.getMetadata(o)):o.startsWith(`#`)?(o=o.slice(1),logger$1.debug(`search by tag: {search}`,{search:o}),predicate=e=>e.tags.some(e=>e.toLowerCase().includes(o))):(logger$1.debug(`search by id/title: {search}`,{search:o}),predicate=e=>e.id.toLowerCase().includes(o)||e.title.toLowerCase().includes(o));for(let n of r)try{let r=await e.computedModel(n.id);for(let e of ifilter(r.elements(),e=>!e.imported&&predicate(e)))a.push({type:`element`,project:n.id,id:e.id,name:e.name,kind:e.kind,title:e.title,technology:e.technology,shape:e.shape,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())});for(let e of ifilter(r.deployment.nodes(),predicate))a.push({type:`deployment-node`,project:n.id,id:e.id,name:e.name,kind:e.kind,title:e.title,technology:e.technology,shape:e.shape,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())})}catch(e){logger$1.error(`Error searching in project ${n.id}:`,{error:e})}return{total:a.length,found:a.slice(0,20)}});var MCPServerFactory=class{constructor(e){this.services=e}create(n){let r=this.services.shared.lsp.Connection!==void 0,i=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? }.
+${r?`- 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:!0,...n,capabilities:{tools:{},logging:{},...n?.capabilities}});return i.registerTool(...listProjects(this.services.likec4.LanguageServices)),i.registerTool(...readProjectSummary(this.services.likec4.LanguageServices)),i.registerTool(...readElement(this.services.likec4.LanguageServices)),i.registerTool(...readDeployment(this.services.likec4.LanguageServices)),i.registerTool(...readView(this.services.likec4.LanguageServices)),i.registerTool(...searchElement(this.services.likec4.LanguageServices)),i.registerTool(...findRelationships(this.services.likec4.LanguageServices)),r&&i.registerTool(...openView(this.services.likec4.LanguageServices)),i.server.onerror=n=>{logger$2.error(loggable(n))},i}},StdioLikeC4MCPServer=class{transport=void 0;_mcp=void 0;constructor(e){this.services=e}get mcp(){if(!this._mcp)throw 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(){this.transport||(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)try{logger$1.info(`Stopping MCP stdio server`),await this.transport.close(),this._mcp&&await this._mcp.close()}finally{this._mcp=void 0,this.transport=void 0}}};async function createHonoApp(e){let n=new Hono;n.use(`*`,cors({origin:`*`,allowHeaders:[`Content-Type`,`mcp-session-id`,`Last-Event-ID`,`mcp-protocol-version`],exposeHeaders:[`mcp-session-id`,`mcp-protocol-version`]})),n.get(`/health`,e=>e.json({status:`ok`}));let r=e.create(),i=new StreamableHTTPTransport({eventStore:new MemoryEventStore({})});return n.all(`/mcp`,async e=>(r.isConnected()||await r.connect(i),await i.handleRequest(e))),n.notFound(e=>(logger$1.debug(`${e.req.method} ${e.req.url} not found`),e.json({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not found.`},id:null},{status:404}))),n.onError((e,n)=>(logger$1.error(loggable(e)),n.json({jsonrpc:`2.0`,error:{code:-32603,message:`Internal server error`},id:null},{status:500}))),n}async function startServer(e){let{factory:n,port:r}=e,i=await createHonoApp(n);return new Promise((e,n)=>{let a=serve({fetch:i.fetch,hostname:`0.0.0.0`,port:r}).prependOnceListener(`error`,n).prependOnceListener(`listening`,()=>{a.removeListener(`error`,n),e(a.unref())})})}var StreamableLikeC4MCPServer=class{server=void 0;constructor(e,n=33335){this.services=e,this._port=n}get mcp(){throw Error(`StreamableLikeC4MCPServer has access to McpServer only during the request`)}get isStarted(){return this.server?.listening===!0}get port(){return this._port}async dispose(){await this.stop()}async start(e=this._port){if(this.server){if(this.port===e)return;await this.stop()}logger$1.info(`Starting MCP server on port {port}`,{port:e}),this._port=e,this.server=await startServer({factory:this.services.mcp.ServerFactory,port:e}),logger$1.info(`MCP server ready at http://0.0.0.0:{port}/mcp`,{port:e})}stop(){let e=this.server;return e?(logger$1.info(`Stopping MCP server`),this.server=void 0,new Promise(n=>{e.close(e=>{e?logger$1.error(`Failed to stop MCP server`,{err:e}):logger$1.info(`MCP server stopped`),n()})})):(logger$1.info(`MCP server is not running, nothing to stop`),Promise.resolve())}};function streamableLikeC4MCPServer(e,n=33335){logger$1.debug(`Creating StreamableLikeC4MCPServer`);let r=new StreamableLikeC4MCPServer(e,n),i=e.LanguageMetaData.languageId,a=e.shared.lsp.Connection;return e.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate(e=>{if(e.section!==i){logger$1.warn(`Unexpected configuration update: {update}`,{update:e});return}let{enabled:o=!1,port:c=n}=e.configuration.mcp;if(!o){r.stop();return}Promise.resolve().then(()=>r.start(c)).then(()=>{a?.telemetry?.logEvent({eventName:`mcp-server-started`,mcpPort:c})}).catch(e=>{let n=loggable(e);a?.telemetry?.logEvent({eventName:`mcp-server-start-failed`,mcpPort:c,message:n}),logger$1.warn(`Failed to start LikeC4 MCP Server: \n${n}`),a&&a.window.showErrorMessage(`LikeC4: Failed to start MCP Server\n\n${n}`)})}),r}function stdioLikeC4MCPServer(e){return new StdioLikeC4MCPServer(e)}function WithMCPServer(e=`sse`){return{mcpServer:n=>e===`stdio`?stdioLikeC4MCPServer(n):streamableLikeC4MCPServer(n,typeof e==`object`?e.port:33335),mcpServerFactory:e=>new MCPServerFactory(e)}}export{WithMCPServer as t};