@likec4/language-server 1.49.0 → 1.51.0

package/dist/_chunks/WithMCPServer.mjs

@@ -1,481 +0,0 @@
-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};