@likec4/language-server 1.48.0 → 1.50.0

package/dist/_chunks/WithMCPServer.mjs

@@ -0,0 +1,1154 @@
+import{Er as e}from"./utils.mjs";import{h as t}from"./libs/remeda.mjs";import{n}from"./workspace.mjs";import{ifilter as r,invariant as i,isSameHierarchy as a}from"@likec4/core/utils";import{loggable as o}from"@likec4/log";import{invariant as s}from"@likec4/core";import{isDeploymentNodeModel as c,modelConnection as l}from"@likec4/core/model";import{URI as u}from"vscode-uri";import{McpServer as d}from"@modelcontextprotocol/sdk/server/mcp.js";import*as f from"zod/v3";import{StdioServerTransport as p}from"@modelcontextprotocol/sdk/server/stdio.js";import{MemoryEventStore as m,StreamableHTTPTransport as h}from"@hono/mcp";import{serve as g}from"@hono/node-server";import{Hono as _}from"hono";import{cors as v}from"hono/cors";const y=e.getChild(`mcp`);function likec4Tool(e,t){let{name:n,description:r,...i}=e;return e=>[n,{description:r?.trim()??``,...i},mkcallTool(n,e,t)]}function mkcallTool(e,t,n){let r=n.bind(null,t);return(async function(t,n){y.debug(`Calling tool {name}, args: {args}`,{name:e,args:t});try{let e=await r.call(null,t,n);return typeof e==`string`?{content:[{type:`text`,text:e}]}:{content:[{type:`text`,text:JSON.stringify(e)}],structuredContent:e}}catch(t){return y.error(`Tool ${e} failed`,{err:t}),{content:[{type:`text`,text:o(t)}],isError:!0}}})}var b=`1.50.0`;const x=f.object({name:f.string().describe(`Project identifier`),title:f.string().optional().describe(`Human-readable project title`),contactPerson:f.string().optional().describe(`Maintainer contact information`),metadata:f.record(f.string(),f.unknown()).optional().describe(`Custom project metadata as key-value pairs`),extends:f.union([f.string(),f.array(f.string())]).optional().describe(`Style inheritance paths`),exclude:f.array(f.string()).optional().describe(`File exclusion patterns`),include:f.object({paths:f.array(f.string()).describe(`Include paths`),maxDepth:f.number().describe(`Maximum directory depth`),fileThreshold:f.number().describe(`File threshold`)}).optional().describe(`Include configuration`),manualLayouts:f.object({outDir:f.string().describe(`Output directory for manual layouts`)}).optional().describe(`Manual layouts configuration`),styles:f.object({hasTheme:f.boolean().describe(`Whether theme customization is defined`),hasDefaults:f.boolean().describe(`Whether default style values are defined`),hasCustomCss:f.boolean().describe(`Whether custom CSS is defined`)}).optional().describe(`Simplified styles configuration (boolean flags)`)});function serializeConfig(e){let t={name:e.name};return e.title!=null&&(t.title=e.title),e.contactPerson!=null&&(t.contactPerson=e.contactPerson),e.metadata&&(t.metadata=e.metadata),e.extends&&(t.extends=e.extends),e.exclude&&(t.exclude=e.exclude),e.include&&(t.include={paths:e.include.paths||[],maxDepth:e.include.maxDepth??3,fileThreshold:e.include.fileThreshold??30}),e.manualLayouts&&(t.manualLayouts={outDir:e.manualLayouts.outDir??`.likec4`}),e.styles&&(t.styles={hasTheme:!!e.styles.theme,hasDefaults:!!e.styles.defaults,hasCustomCss:!!e.styles.customCss}),t}const S=f.object({id:f.string().describe(`Element id (FQN)`),name:f.string().describe(`Element name`),kind:f.string().describe(`Element kind`),title:f.string(),tags:f.array(f.string()),metadata:f.record(f.union([f.string(),f.array(f.string())])),includedInViews:f.array(f.object({id:f.string().describe(`View id`),title:f.string().describe(`View title`),type:f.enum([`element`,`deployment`,`dynamic`]).describe(`View type`)})).describe(`Views that include this element`)});function serializeElement(e){return{id:e.id,name:e.name,kind:e.kind,title:e.title,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())}}function traverseGraph(e,t,n,r,i,a){s(e.findElement(t),`Element "${t}" not found`);let o=new Set,c={},l=0,u=!1,d=[{elementId:t,depth:0}];for(;d.length>0;){let{elementId:t,depth:s}=d.shift();if(s>i||o.has(t))continue;if(o.size>=a){u=!0;break}let f=e.findElement(t);if(!f)continue;o.add(t),l=Math.max(l,s);let p=(n===`incoming`?[...f.incoming(r)]:[...f.outgoing(r)]).map(e=>{let t={elementId:n===`incoming`?e.source.id:e.target.id};return e.title&&(t.relationshipLabel=e.title),e.technology&&(t.technology=e.technology),t});c[t]={...serializeElement(f),neighbors:p,depth:s};for(let e of p)o.has(e.elementId)||d.push({elementId:e.elementId,depth:s+1})}for(let e of Object.values(c))e.neighbors=e.neighbors.filter(e=>e.elementId in c);return{target:t,totalNodes:o.size,maxDepth:l,truncated:u,nodes:c}}const C=f.object({path:f.string().describe(`Path to the file`),range:f.object({start:f.object({line:f.number(),character:f.number()}),end:f.object({line:f.number(),character:f.number()})}).describe(`Range in the file`)}).nullable(),w=f.string().refine(e=>!0).optional().default(n.DefaultProjectId).describe(`Project id (optional, will use "default" if not specified)`),T=f.array(f.object({id:f.string().describe(`View id`),title:f.string().describe(`View title`),type:f.enum([`element`,`deployment`,`dynamic`]).describe(`View type`)})),includedInViews=e=>[...e].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type})),mkLocate=(e,t)=>n=>{try{let r=e.locate({projectId:t,...n});return r?{path:u.parse(r.uri).fsPath,range:r.range}:null}catch(e){return y.debug(`Failed to locate {params}`,{error:e,params:n}),null}},E=S.extend({description:f.string().nullable().describe(`Element description`),technology:f.string().nullable().describe(`Element technology`),shape:f.string().describe(`Rendered shape`),color:f.string().describe(`Rendered color`),children:f.array(f.string()).describe(`Direct child element ids`),incomingCount:f.number().describe(`Number of incoming relationships`),outgoingCount:f.number().describe(`Number of outgoing relationships`)}),D=likec4Tool({name:`batch-read-elements`,description:`
+Read details of multiple elements in a single call, reducing round-trips.
+Returns a compact summary for each element including metadata, description, technology, shape, children, and relationship counts.
+
+Request:
+- ids: string[] — array of element ids (FQNs) to read (max 50)
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response (JSON object):
+- elements: Array of element details, each with:
+  - 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
+  - metadata: Record<string, string | string[]> — element metadata
+  - shape: string — rendered shape
+  - color: string — rendered color
+  - children: string[] — direct child element ids
+  - incomingCount: number — number of incoming relationships
+  - outgoingCount: number — number of outgoing relationships
+  - includedInViews: View[] — views that include this element
+- notFound: string[] — ids that were not found in the project
+
+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.
+- Maximum 50 element ids per call.
+- Elements not found are listed in notFound array (not an error).
+- More efficient than multiple read-element calls when you need summary data for many elements.
+
+Example response:
+{
+  "elements": [
+    {
+      "id": "shop.frontend",
+      "name": "frontend",
+      "kind": "container",
+      "title": "Frontend",
+      "description": "User-facing web app",
+      "technology": "React",
+      "tags": ["public"],
+      "metadata": { "owner": "web-team" },
+      "shape": "browser",
+      "color": "#2F80ED",
+      "children": ["shop.frontend.auth"],
+      "incomingCount": 2,
+      "outgoingCount": 3,
+      "includedInViews": [
+        { "id": "system-overview", "title": "System Overview", "type": "element" }
+      ]
+    }
+  ],
+  "notFound": []
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Batch read elements`},inputSchema:{ids:f.array(f.string()).min(1).max(50).describe(`Array of element ids (FQNs) to read (max 50)`),project:w},outputSchema:{elements:f.array(E),notFound:f.array(f.string()).describe(`Element ids that were not found`)}},async(e,t)=>{s(t.ids.length<=50,`Maximum 50 element ids per call`);let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=[],a=[];for(let e of t.ids){let t=r.findElement(e);if(!t){a.push(e);continue}i.push({...serializeElement(t),description:t.description.text,technology:t.technology,shape:t.shape,color:t.color,children:[...t.children()].map(e=>e.id),incomingCount:t.allIncoming.size,outgoingCount:t.allOutgoing.size})}return{elements:i,notFound:a}}),O=f.object({id:f.string(),kind:f.string(),title:f.string(),description:f.string().nullable(),technology:f.string().nullable(),shape:f.string(),color:f.string()}),k=f.object({element1:O,element2:O,propertyDiffs:f.array(f.object({property:f.string().describe(`Property name`),element1Value:f.string().nullable().describe(`Value in element1`),element2Value:f.string().nullable().describe(`Value in element2`)})).describe(`Properties that differ between the two elements`),tags:f.object({onlyInElement1:f.array(f.string()).describe(`Tags present only in element1`),onlyInElement2:f.array(f.string()).describe(`Tags present only in element2`),common:f.array(f.string()).describe(`Tags present in both elements`)}),metadata:f.object({onlyInElement1:f.record(f.union([f.string(),f.array(f.string())])).describe(`Metadata keys only in element1`),onlyInElement2:f.record(f.union([f.string(),f.array(f.string())])).describe(`Metadata keys only in element2`),different:f.array(f.object({key:f.string(),element1Value:f.union([f.string(),f.array(f.string())]),element2Value:f.union([f.string(),f.array(f.string())])})).describe(`Metadata keys present in both but with different values`),common:f.record(f.union([f.string(),f.array(f.string())])).describe(`Metadata keys with identical values in both`)}),relationships:f.object({incomingOnlyElement1:f.number().describe(`Count of unique source elements sending to element1 only`),incomingOnlyElement2:f.number().describe(`Count of unique source elements sending to element2 only`),incomingShared:f.number().describe(`Count of unique source elements sending to both`),outgoingOnlyElement1:f.number().describe(`Count of unique target elements receiving from element1 only`),outgoingOnlyElement2:f.number().describe(`Count of unique target elements receiving from element2 only`),outgoingShared:f.number().describe(`Count of unique target elements receiving from both`)})}),A=likec4Tool({name:`element-diff`,description:`
+Compare two elements side-by-side, showing differences in properties, tags, metadata, and relationships.
+
+Request:
+- element1Id: string — first element id (FQN)
+- element2Id: string — second element id (FQN)
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response (JSON object):
+- element1: object — snapshot of first element (id, kind, title, description, technology, shape, color)
+- element2: object — snapshot of second element
+- propertyDiffs: Array of { property, element1Value, element2Value } — properties that differ
+- tags: object
+  - onlyInElement1: string[] — tags only in element1
+  - onlyInElement2: string[] — tags only in element2
+  - common: string[] — tags in both
+- metadata: object
+  - onlyInElement1: Record — metadata keys only in element1
+  - onlyInElement2: Record — metadata keys only in element2
+  - different: Array of { key, element1Value, element2Value } — keys present in both but with different values
+  - common: Record — metadata keys with identical values in both
+- relationships: object — relationship count comparison
+  - incomingOnlyElement1/incomingOnlyElement2/incomingShared
+  - outgoingOnlyElement1/outgoingOnlyElement2/outgoingShared
+
+Notes:
+- Read-only, idempotent, no side effects.
+- Safe to call repeatedly.
+- Both elements must exist in the same project.
+- Useful for comparing similar nodes to understand why they have different configurations.
+
+Example response:
+{
+  "element1": { "id": "planner.nodeA", "kind": "cgf-node", "title": "nodeA", ... },
+  "element2": { "id": "planner.nodeB", "kind": "cgf-node", "title": "nodeB", ... },
+  "propertyDiffs": [
+    { "property": "title", "element1Value": "nodeA :dwNodeTypeA", "element2Value": "nodeB :dwNodeTypeB" }
+  ],
+  "tags": {
+    "onlyInElement1": ["target_asil_qm"],
+    "onlyInElement2": ["target_asil_asil_b"],
+    "common": ["is_in_dag", "process_camera_master"]
+  },
+  "metadata": {
+    "onlyInElement1": {},
+    "onlyInElement2": {},
+    "different": [
+      { "key": "target_asil", "element1Value": "QM", "element2Value": "ASIL-B" }
+    ],
+    "common": { "host": "machine0" }
+  },
+  "relationships": {
+    "incomingOnlyElement1": 2,
+    "incomingOnlyElement2": 1,
+    "incomingShared": 3,
+    "outgoingOnlyElement1": 0,
+    "outgoingOnlyElement2": 1,
+    "outgoingShared": 2
+  }
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Compare two elements`},inputSchema:{element1Id:f.string().describe(`First element id (FQN)`),element2Id:f.string().describe(`Second element id (FQN)`),project:w},outputSchema:k.shape},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=r.findElement(t.element1Id);s(i,`Element "${t.element1Id}" not found in project "${n}"`);let a=r.findElement(t.element2Id);s(a,`Element "${t.element2Id}" not found in project "${n}"`);let o=[],c=[{name:`kind`,get:e=>e.kind},{name:`title`,get:e=>e.title},{name:`description`,get:e=>e.description.text},{name:`technology`,get:e=>e.technology},{name:`shape`,get:e=>e.shape},{name:`color`,get:e=>e.color}];for(let e of c){let t=e.get(i),n=e.get(a);t!==n&&o.push({property:e.name,element1Value:t,element2Value:n})}let l=new Set(i.tags),u=new Set(a.tags),d=[],f=[],p=[];for(let e of l)u.has(e)?d.push(e):f.push(e);for(let e of u)l.has(e)||p.push(e);let m=i.getMetadata(),h=a.getMetadata(),g=new Set([...Object.keys(m),...Object.keys(h)]),_={},v={},y=[],b={};for(let e of g){let t=m[e],n=h[e];t!==void 0&&n===void 0?_[e]=t:t===void 0&&n!==void 0?v[e]=n:t!==void 0&&n!==void 0&&(JSON.stringify(t)===JSON.stringify(n)?b[e]=t:y.push({key:e,element1Value:t,element2Value:n}))}let x=new Set([...i.incoming()].map(e=>e.source.id)),S=new Set([...a.incoming()].map(e=>e.source.id)),C=new Set([...i.outgoing()].map(e=>e.target.id)),w=new Set([...a.outgoing()].map(e=>e.target.id)),T=0,E=0,D=0;for(let e of x)S.has(e)?T++:E++;for(let e of S)x.has(e)||D++;let O=0,k=0,A=0;for(let e of C)w.has(e)?O++:k++;for(let e of w)C.has(e)||A++;return{element1:{id:i.id,kind:i.kind,title:i.title,description:i.description.text,technology:i.technology,shape:i.shape,color:i.color},element2:{id:a.id,kind:a.kind,title:a.title,description:a.description.text,technology:a.technology,shape:a.shape,color:a.color},propertyDiffs:o,tags:{onlyInElement1:f,onlyInElement2:p,common:d},metadata:{onlyInElement1:_,onlyInElement2:v,different:y,common:b},relationships:{incomingOnlyElement1:E,incomingOnlyElement2:D,incomingShared:T,outgoingOnlyElement1:k,outgoingOnlyElement2:A,outgoingShared:O}}}),j=likec4Tool({name:`find-relationship-paths`,description:`
+Discover all paths (chains of relationships) between two elements, supporting multi-hop traversal.
+
+Request:
+- sourceId: string — source element FQN
+- targetId: string — target element FQN
+- maxDepth: number (optional, default: 3, max: 5) — maximum path length (number of hops)
+- includeIndirect: boolean (optional, default: false) — include indirect (implied) relationships through nested elements
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Algorithm:
+- Uses breadth-first search (BFS) to find all paths
+- Prevents cycles with visited set per path
+- Paths are sorted by length (shortest first)
+- Limited to 100 paths to avoid overwhelming responses
+
+Response (JSON object):
+- paths: Array of path objects, each with:
+  - length: number — number of hops in the path
+  - steps: Array<Step> — ordered sequence of relationships
+
+Step (object) fields:
+- source: string — source element FQN
+- target: string — target element FQN
+- relationship: object
+  - kind: string|null — relationship kind
+  - title: string|null — relationship title
+  - description: string|null — relationship description
+  - technology: string|null — relationship technology
+  - tags: string[] — relationship tags
+
+Notes:
+- Read-only, idempotent, no side effects.
+- Safe to call repeatedly.
+- Returns empty paths array if no paths exist.
+- Rejects if source equals target.
+- includeIndirect=false (default): only follows direct relationships on each element.
+  includeIndirect=true: also follows implied relationships through nested elements.
+- maxDepth is capped at 5 to prevent excessive computation.
+- Paths are discovered iteratively and sorted by length.
+
+Example response:
+{
+  "paths": [
+    {
+      "length": 1,
+      "steps": [
+        {
+          "source": "shop.frontend",
+          "target": "shop.backend",
+          "relationship": {
+            "kind": "uses",
+            "title": "Calls API",
+            "description": null,
+            "technology": "HTTPS",
+            "tags": []
+          }
+        }
+      ]
+    },
+    {
+      "length": 2,
+      "steps": [
+        {
+          "source": "shop.frontend",
+          "target": "shop.cache",
+          "relationship": {
+            "kind": "uses",
+            "title": "Reads from",
+            "description": null,
+            "technology": "Redis",
+            "tags": []
+          }
+        },
+        {
+          "source": "shop.cache",
+          "target": "shop.backend",
+          "relationship": {
+            "kind": "syncs-with",
+            "title": "Updates",
+            "description": null,
+            "technology": null,
+            "tags": []
+          }
+        }
+      ]
+    }
+  ]
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Find relationship paths`},inputSchema:{sourceId:f.string().describe(`Source element FQN`),targetId:f.string().describe(`Target element FQN`),maxDepth:f.number().int().min(1).max(5).optional().default(3).describe(`Maximum path length (default: 3, max: 5)`),includeIndirect:f.boolean().optional().default(!1).describe(`Include indirect (implied) relationships through nested elements (default: false)`),project:w},outputSchema:{paths:f.array(f.object({length:f.number().describe(`Number of hops in the path`),steps:f.array(f.object({source:f.string().describe(`Source element FQN`),target:f.string().describe(`Target element FQN`),relationship:f.object({kind:f.string().nullable().describe(`Relationship kind`),title:f.string().nullable().describe(`Relationship title`),description:f.string().nullable().describe(`Relationship description`),technology:f.string().nullable().describe(`Relationship technology`),tags:f.array(f.string()).describe(`Relationship tags`)})})).describe(`Ordered sequence of relationships in the path`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=r.findElement(t.sourceId);s(i,`Source element "${t.sourceId}" not found in project "${n}"`);let a=r.findElement(t.targetId);s(a,`Target element "${t.targetId}" not found in project "${n}"`),s(i.id!==a.id,`Source and target must be different elements`);let o=t.maxDepth,c=t.includeIndirect?`all`:`direct`,l=[{elementId:i.id,path:[],visited:new Set([i.id])}],u=[];for(;l.length>0&&u.length<100;){let e=l.shift();if(e.path.length>=o)continue;let t=r.findElement(e.elementId);if(t)for(let n of t.outgoing(c)){let t=n.target.id;if(t===a.id){let t={source:n.source.id,target:n.target.id,relationship:{kind:n.kind,title:n.title,description:n.description.text,technology:n.technology,tags:[...n.tags]}};if(u.push({length:e.path.length+1,steps:[...e.path,t]}),u.length>=100)break;continue}if(e.visited.has(t))continue;let r={source:n.source.id,target:n.target.id,relationship:{kind:n.kind,title:n.title,description:n.description.text,technology:n.technology,tags:[...n.tags]}};l.push({elementId:t,path:[...e.path,r],visited:new Set([...e.visited,t])})}}return u.sort((e,t)=>e.length-t.length),{paths:u}}),M=f.object({id:f.string(),title:f.string(),kind:f.string()}),N=f.object({type:f.enum([`direct`,`indirect`]).describe(`Type of relationship, "direct" for direct relationships, "indirect" for relationships through nested elements`),source:M,target:M,kind:f.string().nullable().describe(`Relationship kind`),title:f.string().nullable().describe(`Relationship title`),description:f.string().nullable().describe(`Relationship description`),technology:f.string().nullable().describe(`Relationship technology`),tags:f.array(f.string()).describe(`Relationship tags`),includedInViews:T.describe(`Views that include this relationship`),sourceLocation:C}),P=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:f.string().describe(`Element ID (FQN)`),element2:f.string().describe(`Element ID (FQN)`),project:w},outputSchema:{found:f.array(N)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project);if(a(t.element1,t.element2))throw Error(`No relationships possible between parent-child`);let r=[],o=await e.computedModel(n),s=o.findElement(t.element1);i(s,`Element "${t.element1}" not found in project "${n}"`);let c=o.findElement(t.element2);i(c,`Element "${t.element2}" not found in project "${n}"`);let u=mkLocate(e,n),d=l.findConnection(s,c,`both`).flatMap(e=>[...e.relations]);for(let e of d){let t=e.source===s&&e.target===c||e.source===c&&e.target===s;r.push({type:t?`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:r}}),F=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:f.array(f.object({id:f.string(),title:f.string(),folder:f.string(),sources:f.array(f.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)}))})),I=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:f.string().describe(`View id (name)`),project:w},outputSchema:{location:C}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findView(t.viewId);if(!r)throw Error(`View with ID '${t.viewId}' not found in project ${n}`);return await e.views.openView(r.id,n),{location:mkLocate(e,n)({view:r.id})}}),L=f.enum([`exact`,`contains`,`exists`]),R=likec4Tool({name:`query-by-metadata`,description:`
+Search elements and deployment nodes by metadata key-value pairs with flexible matching modes.
+
+Request:
+- key: string — metadata key to filter by
+- value: string (optional) — metadata value to match (ignored for 'exists' mode)
+- matchMode: "exact" | "contains" | "exists" (optional, default: "exact")
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Match Modes:
+- exact: Value must match exactly (case-sensitive)
+  Example: key="owner", value="platform-team" matches only exact "platform-team"
+- contains: Value contains the search string (case-insensitive)
+  Example: key="technology", value="aws" matches "AWS Lambda", "aws-s3", etc.
+- exists: Element has the key (value parameter is ignored)
+  Example: key="owner" returns all elements with any "owner" metadata
+
+Response (JSON object):
+- results: Array of matching elements/deployment-nodes, each with:
+  - id: string — element/node id (FQN)
+  - name: string — element/node name
+  - kind: string — element/node kind
+  - title: string — human-readable title
+  - tags: string[] — assigned tags
+  - metadata: Record<string, string | string[]> — all element metadata
+  - matchedValue: string — the metadata value that matched (for reference)
+  - includedInViews: View[] — views that include this element
+
+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.
+- Handles both string and array metadata values.
+- For array values, matches if any element in the array matches.
+- Returns empty array if no matches found.
+- Limited to 50 results to avoid overwhelming responses.
+- Case-sensitive for exact mode, case-insensitive for contains mode.
+
+Example response:
+{
+  "results": [
+    {
+      "id": "shop.frontend",
+      "name": "frontend",
+      "kind": "container",
+      "title": "Frontend",
+      "tags": ["public"],
+      "metadata": {
+        "owner": "platform-team",
+        "tier": "critical"
+      },
+      "matchedValue": "platform-team",
+      "includedInViews": [
+        {
+          "id": "system-overview",
+          "title": "System Overview",
+          "type": "element"
+        }
+      ]
+    }
+  ]
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by metadata`},inputSchema:{key:f.string().describe(`Metadata key to filter by`),value:f.string().optional().describe(`Metadata value to match (ignored for exists mode)`),matchMode:L.optional().default(`exact`).describe(`Matching mode`),project:w},outputSchema:{results:f.array(S.extend({matchedValue:f.string().describe(`The metadata value that matched`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=t.matchMode,a=[],matches=(e,t,n)=>{let r=Array.isArray(e)?e:[e];switch(n){case`exists`:return!0;case`exact`:return t===void 0?!1:r.some(e=>e===t);case`contains`:{if(t===void 0)return!1;let e=t.toLowerCase();return r.some(t=>t.toLowerCase().includes(e))}default:return!1}},getMatchedValue=(e,t,n)=>{let r=Array.isArray(e)?e:[e];if(n===`exists`||t===void 0)return r[0]||``;if(n===`exact`)return r.find(e=>e===t)||r[0]||``;if(n===`contains`){let e=t.toLowerCase();return r.find(t=>t.toLowerCase().includes(e))||r[0]||``}return r[0]||``};for(let e of r.elements()){if(a.length>=50)break;let n=e.getMetadata();if(t.key in n){let r=n[t.key];r!==void 0&&matches(r,t.value,i)&&a.push({...serializeElement(e),matchedValue:getMatchedValue(r,t.value,i)})}}if(a.length<50)for(let e of r.deployment.elements()){if(a.length>=50)break;let n=e.getMetadata();if(t.key in n){let r=n[t.key];r!==void 0&&matches(r,t.value,i)&&a.push({...serializeElement(e),matchedValue:getMatchedValue(r,t.value,i)})}}return{results:a}}),z=likec4Tool({name:`query-by-tag-pattern`,description:`
+Search elements by tag patterns using prefix or substring matching.
+Useful for tag taxonomies with structured naming conventions (e.g., "schedule_*", "*_asil_*").
+
+Request:
+- pattern: string — tag pattern to match
+- matchMode: "prefix" | "contains" | "suffix" (optional, default: "prefix")
+  - prefix: matches tags starting with the pattern (e.g., "target_asil" matches "target_asil_qm", "target_asil_asil_b")
+  - contains: matches tags containing the pattern anywhere (e.g., "asil" matches "target_asil_qm", "unit_asil_b")
+  - suffix: matches tags ending with the pattern (e.g., "_tbc" matches "target_asil_qm__tbc")
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response (JSON object):
+- results: Array of matching elements, each with:
+  - id: string — element id (FQN)
+  - name: string — element name
+  - kind: string — element kind
+  - title: string — human-readable title
+  - tags: string[] — all assigned tags
+  - metadata: Record<string, string | string[]> — element metadata
+  - matchedTags: string[] — the specific tags that matched the pattern
+  - includedInViews: View[] — views that include this element
+- truncated: boolean — true if results were truncated due to exceeding the 50-result limit
+- matchedTagValues: string[] — all unique tag values that matched the pattern across all elements
+
+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.
+- Pattern matching is case-insensitive.
+- Returns empty array if no matches found.
+- Limited to 50 results.
+- matchedTagValues provides a summary of all distinct matching tag values found.
+
+Example response:
+{
+  "results": [
+    {
+      "id": "top.planner.behaviorNode",
+      "name": "behaviorNode",
+      "kind": "cgf-node",
+      "title": "behaviorNode :dwBehaviorPlannerNode",
+      "tags": ["is_in_dag", "target_asil_qm", "process_camera_master"],
+      "metadata": {},
+      "matchedTags": ["target_asil_qm"],
+      "includedInViews": []
+    }
+  ],
+  "truncated": false,
+  "matchedTagValues": ["target_asil_qm", "target_asil_asil_b", "target_asil_qm__tbc"]
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tag pattern`},inputSchema:{pattern:f.string().min(1).describe(`Tag pattern to match`),matchMode:f.enum([`prefix`,`contains`,`suffix`]).optional().default(`prefix`).describe(`Pattern matching mode (default: prefix)`),project:w},outputSchema:{results:f.array(S.extend({matchedTags:f.array(f.string()).describe(`Tags that matched the pattern`)})),truncated:f.boolean().describe(`True if results were truncated`),matchedTagValues:f.array(f.string()).describe(`All unique tag values matching the pattern across all elements`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=t.pattern.toLowerCase(),matchesTag=e=>{let n=e.toLowerCase();switch(t.matchMode){case`prefix`:return n.startsWith(i);case`contains`:return n.includes(i);case`suffix`:return n.endsWith(i)}},a=[],o=!1,s=new Set;for(let e of r.elements()){let t=[...e.tags].filter(matchesTag);if(t.length>0){if(t.forEach(e=>s.add(e)),a.length>=50){o=!0;continue}a.push({...serializeElement(e),matchedTags:t})}}for(let e of r.deployment.elements()){if(!c(e))continue;let t=[...e.tags].filter(matchesTag);if(t.length>0){if(t.forEach(e=>s.add(e)),a.length>=50){o=!0;continue}a.push({...serializeElement(e),matchedTags:t})}}return{results:a,truncated:o,matchedTagValues:[...s].sort((e,t)=>e.localeCompare(t))}}),B=likec4Tool({name:`query-by-tags`,description:`
+Advanced tag filtering with boolean logic (AND, OR, NOT).
+
+Request:
+- allOf: string[] (optional) — element must have ALL these tags (AND logic)
+- anyOf: string[] (optional) — element must have ANY of these tags (OR logic)
+- noneOf: string[] (optional) — element must have NONE of these tags (NOT logic)
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Boolean Logic:
+- All three conditions are combined with AND logic
+- At least one condition must be specified
+- Tags are case-sensitive
+
+Example Queries:
+- Public APIs: {"allOf": ["public", "api"]}
+- Deprecated or legacy: {"anyOf": ["deprecated", "legacy"]}
+- Public but not deprecated: {"allOf": ["public"], "noneOf": ["deprecated"]}
+- Critical services not in migration: {"allOf": ["critical", "service"], "noneOf": ["migration", "deprecated"]}
+
+Response (JSON object):
+- results: Array of matching elements/deployment-nodes, each with:
+  - id: string — element/node id (FQN)
+  - name: string — element/node name
+  - kind: string — element/node kind
+  - title: string — human-readable title
+  - tags: string[] — assigned tags (for reference)
+  - metadata: Record<string, string | string[]> — element metadata
+  - includedInViews: View[] — views that include this element
+
+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.
+- Returns empty array if no matches found.
+- Limited to 50 results to avoid overwhelming responses.
+- Conflicting conditions (e.g., allOf and noneOf with same tag) will return no results.
+
+Example response:
+{
+  "results": [
+    {
+      "id": "shop.api",
+      "name": "api",
+      "kind": "container",
+      "title": "API Gateway",
+      "tags": ["public", "api", "critical"],
+      "metadata": {
+        "owner": "platform-team"
+      },
+      "includedInViews": [
+        {
+          "id": "system-overview",
+          "title": "System Overview",
+          "type": "element"
+        }
+      ]
+    }
+  ]
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tags`},inputSchema:{allOf:f.array(f.string()).optional().describe(`Element must have ALL these tags (AND)`),anyOf:f.array(f.string()).optional().describe(`Element must have ANY of these tags (OR)`),noneOf:f.array(f.string()).optional().describe(`Element must have NONE of these tags (NOT)`),project:w},outputSchema:{results:f.array(S),truncated:f.boolean().describe(`True if results were truncated due to exceeding the 50-result limit`)}},async(e,t)=>{s(t.allOf&&t.allOf.length>0||t.anyOf&&t.anyOf.length>0||t.noneOf&&t.noneOf.length>0,`At least one condition (allOf, anyOf, or noneOf) must be specified with at least one tag`);let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=[],a=!1,matchesTags=e=>{let n=e instanceof Set?e:new Set(e);return!(t.allOf&&t.allOf.length>0&&!t.allOf.every(e=>n.has(e))||t.anyOf&&t.anyOf.length>0&&!t.anyOf.some(e=>n.has(e))||t.noneOf&&t.noneOf.length>0&&t.noneOf.some(e=>n.has(e)))};for(let e of r.elements()){if(i.length>=50){a=!0;break}matchesTags(e.tags)&&i.push(serializeElement(e))}if(!a)for(let e of r.deployment.elements()){if(i.length>=50){a=!0;break}c(e)&&matchesTags(e.tags)&&i.push(serializeElement(e))}return{results:i,truncated:a}}),V=f.enum([`ancestors`,`descendants`,`siblings`,`children`,`parent`,`incomers`,`outgoers`]),H=likec4Tool({name:`query-graph`,description:`
+Query element hierarchy and relationships in the architecture graph.
+
+Request:
+- elementId: string — element id (FQN) to query
+- queryType: "ancestors" | "descendants" | "siblings" | "children" | "parent" | "incomers" | "outgoers"
+- includeIndirect: boolean (optional, default: true) — for incomers/outgoers, include indirect relationships (through nested elements)
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Query Types:
+- ancestors: Returns all parent elements up to the root (hierarchical)
+  Example: shop.frontend.auth.service returns [shop.frontend.auth, shop.frontend, shop]
+- descendants: Returns all child elements recursively (hierarchical)
+  Example: shop.frontend returns all nested elements like shop.frontend.auth, shop.frontend.auth.service
+- siblings: Returns elements at the same hierarchy level with the same parent
+  Example: shop.frontend returns [shop.backend, shop.database] if they're siblings
+- children: Returns direct child elements only (not recursive)
+  Example: shop returns [shop.frontend, shop.backend] but not shop.frontend.auth
+- parent: Returns the direct parent element
+  Example: shop.frontend.auth returns shop.frontend
+- incomers: Returns elements that have outgoing relationships to this element (single hop, not recursive).
+  For recursive upstream traversal, use query-incomers-graph instead.
+  includeIndirect=true: Includes relationships to nested children
+  Example: Elements that depend on this element
+- outgoers: Returns elements that receive incoming relationships from this element (single hop, not recursive).
+  For recursive downstream traversal, use query-outgoers-graph instead.
+  includeIndirect=true: Includes relationships from nested children
+  Example: Elements this element depends on
+
+Response (JSON object):
+- results: Array of elements (max 100), each with:
+  - id: string — element id (FQN)
+  - name: string — element name
+  - kind: string — element kind
+  - title: string — human-readable title
+  - tags: string[] — assigned tags
+  - metadata: Record<string, string> — element metadata
+  - includedInViews: View[] — views that include this element
+- truncated: boolean — true if results were truncated due to exceeding maximum limit (100)
+
+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.
+- For parent query on root element, returns empty array.
+- For hierarchical queries (ancestors, descendants, siblings, children), includeIndirect is ignored.
+
+Example response:
+{
+  "results": [
+    {
+      "id": "shop.frontend",
+      "name": "frontend",
+      "kind": "container",
+      "title": "Frontend",
+      "tags": ["public"],
+      "metadata": { "owner": "web-team" },
+      "includedInViews": [
+        {
+          "id": "system-overview",
+          "title": "System Overview",
+          "type": "element"
+        }
+      ]
+    }
+  ],
+  "truncated": false
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query element graph`},inputSchema:{elementId:f.string().describe(`Element id (FQN) to query`),queryType:V.describe(`Type of graph query`),includeIndirect:f.boolean().optional().default(!0).describe(`For incomers/outgoers: include indirect relationships (default: true)`),project:w},outputSchema:{results:f.array(S),truncated:f.boolean().describe(`True if results were truncated due to exceeding maximum limit`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.elementId);s(r,`Element "${t.elementId}" not found in project "${n}"`);let i=[],a=!1;switch(t.queryType){case`ancestors`:for(let e of r.ancestors()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`descendants`:for(let e of r.descendants()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`siblings`:for(let e of r.siblings()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`children`:for(let e of r.children()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`parent`:{let e=r.parent;e&&i.push(serializeElement(e));break}case`incomers`:{let e=t.includeIndirect?`all`:`direct`;for(let t of r.incomers(e)){if(i.length>=100){a=!0;break}i.push(serializeElement(t))}break}case`outgoers`:{let e=t.includeIndirect?`all`:`direct`;for(let t of r.outgoers(e)){if(i.length>=100){a=!0;break}i.push(serializeElement(t))}break}}return{results:i,truncated:a}}),U=f.object({elementId:f.string().describe(`ID of the incoming element`),relationshipLabel:f.string().optional().describe(`Label on the relationship`),technology:f.string().optional().describe(`Technology specified on the relationship`)}),W=likec4Tool({name:`query-incomers-graph`,description:`
+Query the complete graph of all elements that provide input to the target element (recursive incomers/producers).
+
+This tool performs a breadth-first traversal to discover all upstream dependencies - elements that directly or
+indirectly provide input to the target element. It returns the complete subgraph in a single response,
+making it much more efficient than repeated individual queries.
+
+Request:
+- elementId: string — target element id (FQN) to start from
+- includeIndirect: boolean (optional, default: true) — include relationships through nested elements
+- maxDepth: number (optional, default: 10, max: 50) — maximum traversal depth to prevent infinite recursion
+- maxNodes: number (optional, default: 200, max: 2000) — maximum number of nodes to return
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response Structure:
+{
+  "target": "element.id",
+  "totalNodes": number,
+  "maxDepth": number,
+  "truncated": boolean,
+  "nodes": {
+    "element.id": {
+      "id": "element.id",
+      "name": "name",
+      "kind": "kind",
+      "title": "title",
+      "tags": ["tag1", "tag2"],
+      "metadata": {},
+      "includedInViews": [...],
+      "incomers": [
+        {
+          "elementId": "id1",
+          "relationshipLabel": "uses",
+          "technology": "REST"
+        }
+      ],
+      "depth": number
+    }
+  }
+}
+
+Use Cases:
+- Find all producers/dependencies for an element
+- Trace data lineage upstream
+- Identify root causes and dependencies
+- Build complete dependency trees
+- Answer "what feeds into this?" questions
+
+Notes:
+- Read-only, idempotent, no side effects
+- Cycle detection prevents infinite loops
+- Result size limited to maxNodes to prevent huge responses
+- If truncated=true, increase maxNodes or reduce maxDepth to get more specific results
+
+Example:
+For a database element, this returns all services, APIs, and components that write to it,
+plus all their dependencies, recursively up to maxDepth levels.
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete incomers graph`},inputSchema:{elementId:f.string().describe(`Target element id (FQN) to query incomers for`),includeIndirect:f.boolean().optional().default(!0).describe(`Include indirect relationships through nested elements (default: true)`),maxDepth:f.number().int().positive().max(50).optional().default(10).describe(`Maximum traversal depth (default: 10, max: 50)`),maxNodes:f.number().int().positive().max(2e3).optional().default(200).describe(`Maximum number of nodes to return (default: 200, max: 2000)`),project:w},outputSchema:{target:f.string().describe(`Target element id`),totalNodes:f.number().describe(`Total number of nodes in the graph`),maxDepth:f.number().describe(`Maximum depth reached`),truncated:f.boolean().describe(`True if result was truncated due to maxNodes limit`),nodes:f.record(S.extend({incomers:f.array(U).describe(`Incoming relationships with details`),depth:f.number().describe(`Distance from target element (0 = target)`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n);s(r.findElement(t.elementId),`Element "${t.elementId}" not found in project "${n}"`);let i=t.includeIndirect?`all`:`direct`,a=traverseGraph(r,t.elementId,`incoming`,i,t.maxDepth,t.maxNodes),o={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;o[e]={...r,incomers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:o}}),G=f.object({elementId:f.string().describe(`ID of the outgoing element`),relationshipLabel:f.string().optional().describe(`Label on the relationship`),technology:f.string().optional().describe(`Technology specified on the relationship`)}),K=likec4Tool({name:`query-outgoers-graph`,description:`
+Query the complete graph of all elements that receive output from the target element (recursive outgoers/consumers).
+
+This tool performs a breadth-first traversal to discover all downstream dependencies - elements that directly or
+indirectly consume output from the target element. It returns the complete subgraph in a single response,
+making it much more efficient than repeated individual queries.
+
+Request:
+- elementId: string — target element id (FQN) to start from
+- includeIndirect: boolean (optional, default: true) — include relationships through nested elements
+- maxDepth: number (optional, default: 10, max: 50) — maximum traversal depth to prevent infinite recursion
+- maxNodes: number (optional, default: 200, max: 2000) — maximum number of nodes to return
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response Structure:
+{
+  "target": "element.id",
+  "totalNodes": number,
+  "maxDepth": number,
+  "truncated": boolean,
+  "nodes": {
+    "element.id": {
+      "id": "element.id",
+      "name": "name",
+      "kind": "kind",
+      "title": "title",
+      "tags": ["tag1", "tag2"],
+      "metadata": {},
+      "includedInViews": [...],
+      "outgoers": [
+        {
+          "elementId": "id1",
+          "relationshipLabel": "sends data to",
+          "technology": "Kafka"
+        }
+      ],
+      "depth": number
+    }
+  }
+}
+
+Use Cases:
+- Find all consumers/dependents of an element
+- Trace data lineage downstream
+- Assess impact of changes (blast radius)
+- Build complete consumer trees
+- Answer "what depends on this?" questions
+
+Notes:
+- Read-only, idempotent, no side effects
+- Cycle detection prevents infinite loops
+- Result size limited to maxNodes to prevent huge responses
+- If truncated=true, increase maxNodes or reduce maxDepth to get more specific results
+
+Example:
+For an API service, this returns all clients, services, and systems that consume its output,
+plus all their consumers, recursively up to maxDepth levels.
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete outgoers graph`},inputSchema:{elementId:f.string().describe(`Target element id (FQN) to query outgoers for`),includeIndirect:f.boolean().optional().default(!0).describe(`Include indirect relationships through nested elements (default: true)`),maxDepth:f.number().int().positive().max(50).optional().default(10).describe(`Maximum traversal depth (default: 10, max: 50)`),maxNodes:f.number().int().positive().max(2e3).optional().default(200).describe(`Maximum number of nodes to return (default: 200, max: 2000)`),project:w},outputSchema:{target:f.string().describe(`Target element id`),totalNodes:f.number().describe(`Total number of nodes in the graph`),maxDepth:f.number().describe(`Maximum depth reached`),truncated:f.boolean().describe(`True if result was truncated due to maxNodes limit`),nodes:f.record(S.extend({outgoers:f.array(G).describe(`Outgoing relationships with details`),depth:f.number().describe(`Distance from target element (0 = target)`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n);s(r.findElement(t.elementId),`Element "${t.elementId}" not found in project "${n}"`);let i=t.includeIndirect?`all`:`direct`,a=traverseGraph(r,t.elementId,`outgoing`,i,t.maxDepth,t.maxNodes),o={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;o[e]={...r,outgoers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:o}}),q=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:f.string().describe(`Deployment id (FQN)`),project:w},outputSchema:{type:f.enum([`deployment-node`,`deployed-instance`]),id:f.string().describe(`Deployment id (FQN)`),kind:f.string().describe(`Deployment node kind, or element kind for deployed instances`),name:f.string(),title:f.string(),description:f.string().nullable(),technology:f.string().nullable(),tags:f.array(f.string()),project:f.string(),metadata:f.record(f.union([f.string(),f.array(f.string())])),links:f.array(f.object({title:f.string().nullable().describe(`Optional link title`),url:f.string().describe(`Link URL`),relative:f.string().nullable().describe(`Relative path (if URL is relative to workspace root)`)})).describe(`External links associated with this deployment entity`),shape:f.string(),color:f.string(),children:f.array(f.string()).describe(`Children of this deployment node (Array of Deployment ids)`),includedInViews:T.describe(`Views that include this deployment node`),instanceof:f.object({id:f.string().describe(`Element ID (FQN)`),title:f.string(),kind:f.string()}).nullable().describe(`If type is "deployed-instance", the referenced element`),sourceLocation:C}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).deployment.findElement(t.id);s(r,`Deployment entity "${t.id}" not found in project "${n}"`);let i=mkLocate(e,n);return{type:r.isInstance()?`deployed-instance`:`deployment-node`,id:r.id,name:r.name,kind:r.kind,title:r.title,description:r.description.text,technology:r.technology,tags:[...r.tags],project:n,metadata:r.getMetadata(),links:(r.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:r.shape,color:r.color,children:r.isInstance()?[]:[...r.children()].map(e=>e.id),includedInViews:includedInViews(r.views()),instanceof:r.isInstance()?{id:r.element.id,title:r.element.title,kind:r.element.kind}:null,sourceLocation:i({deployment:r.id})}}),J=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:f.string().describe(`Element id (FQN)`),project:w},outputSchema:{id:f.string().describe(`Element id (FQN)`),kind:f.string().describe(`Element kind`),name:f.string().describe(`Element name`),title:f.string(),description:f.string().nullable(),technology:f.string().nullable(),tags:f.array(f.string()),project:f.string(),metadata:f.record(f.union([f.string(),f.array(f.string())])),links:f.array(f.object({title:f.string().nullable().describe(`Optional link title`),url:f.string().describe(`Link URL`),relative:f.string().nullable().describe(`Relative path (if URL is relative to workspace root)`)})).describe(`External links associated with this element`),shape:f.string(),color:f.string(),children:f.array(f.string()).describe(`Children of this element (Array of FQNs)`),defaultView:f.string().nullable().describe(`Name of the default view of this element`),includedInViews:T.describe(`Views that include this element`),relationships:f.object({incoming:f.array(f.object({source:f.object({id:f.string(),title:f.string(),kind:f.string()}).describe(`Source element of this relationship`),kind:f.string().nullable().describe(`Relationship kind`),target:f.string().describe(`Target element id (FQN), either this element or nested element, if relationship is indirect`),title:f.string().nullable().describe(`Relationship title`),description:f.string().nullable().describe(`Relationship description`),technology:f.string().nullable().describe(`Relationship technology`),tags:f.array(f.string()).describe(`Relationship tags`)})).describe(`Incoming relationships of this element (direct and indirect, incoming to nested elements)`),outgoing:f.array(f.object({source:f.string().describe(`Source element id (FQN), either this element or nested element, if relationship is indirect`),target:f.object({id:f.string(),title:f.string(),kind:f.string()}).describe(`Target element of this relationship`),kind:f.string().nullable().describe(`Relationship kind`),title:f.string().nullable().describe(`Relationship title`),description:f.string().nullable().describe(`Relationship description`),technology:f.string().nullable().describe(`Relationship technology`),tags:f.array(f.string()).describe(`Relationship tags`)})).describe(`Outgoing relationships of this element (direct and indirect, outgoing from nested elements)`)}).describe(`Relationships of this element`),deployedInstances:f.array(f.string()).describe(`Deployed instances of this element (Array of Deployment FQNs)`),sourceLocation:C}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.id);s(r,`Element "${t.id}" not found in project "${n}"`);let i=mkLocate(e,n);return{id:r.id,name:r.name,kind:r.kind,title:r.title,description:r.description.text,technology:r.technology,tags:[...r.tags],project:n,metadata:r.getMetadata(),links:(r.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:r.shape,color:r.color,children:[...r.children()].map(e=>e.id),defaultView:r.defaultView?.id||null,includedInViews:includedInViews(r.views()),relationships:{incoming:[...r.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:[...r.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:[...r.deployments()].map(e=>e.id),sourceLocation:i({element:r.id})}}),Y=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
+- config: object — project configuration
+  - name: string — project identifier
+  - title?: string — human-readable title
+  - contactPerson?: string — maintainer contact
+  - metadata?: object — custom project metadata as key-value pairs
+  - extends?: string | string[] — style inheritance paths
+  - exclude?: string[] — file exclusion patterns
+  - include?: object — include configuration (paths, maxDepth, fileThreshold)
+  - manualLayouts?: object — manual layouts config (outDir)
+  - styles?: object — simplified styles (hasTheme, hasDefaults, hasCustomCss)
+- 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"
+  ],
+  "config": {
+    "name": "cloud-boutique",
+    "title": "Cloud Boutique",
+    "contactPerson": "admin@example.com"
+  },
+  "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": [
+    {
+      "id": "system-overview",
+      "title": "System Overview",
+      "type": "element"
+    }
+  ]
+}
+  `,inputSchema:{project:w},outputSchema:{title:f.string(),folder:f.string(),sources:f.array(f.string()),config:x.describe(`Project configuration`),specification:f.object({elementKinds:f.array(f.string()),relationshipKinds:f.array(f.string()),deploymentKinds:f.array(f.string()),tags:f.array(f.string()),metadataKeys:f.array(f.string())}),elements:f.array(f.object({id:f.string(),kind:f.string(),title:f.string(),tags:f.array(f.string())})).describe(`List of elements in the project`),deployments:f.array(f.discriminatedUnion(`type`,[f.object({type:f.literal(`deployment-node`),id:f.string().describe(`Node ID`),kind:f.string().describe(`Deployment node kind`),title:f.string().describe(`Node title`),tags:f.array(f.string())}),f.object({type:f.literal(`deployed-instance`),id:f.string().describe(`Node ID`),title:f.string().describe(`Node title`),tags:f.array(f.string()),referencedElementId:f.string().describe(`Element ID (FQN)`)})])).describe(`List of deployment nodes and deployed instances in the project`),views:f.array(f.object({id:f.string(),title:f.string(),type:f.enum([`element`,`deployment`,`dynamic`])}))}},async(e,n)=>{let r=e.projectsManager.ensureProjectId(n.project),i=e.project(r),a=await e.computedModel(r);return{title:i.title,folder:i.folder.fsPath,sources:i.documents?.map(e=>e.fsPath)??[],config:serializeConfig(i.config),specification:{elementKinds:t(a.specification.elements),relationshipKinds:t(a.specification.relationships),deploymentKinds:t(a.specification.deployments),tags:[...a.tags],metadataKeys:a.specification.metadataKeys??[]},elements:[...a.elements()].filter(e=>!e.imported).map(e=>({id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]})),deployments:[...a.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:[...a.views()].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type}))}}),modelRef=e=>e.hasElement()?e.element.id:e.hasDeployment()?e.deployment.id:null,X=f.discriminatedUnion(`type`,[f.object({type:f.literal(`element`),id:f.string().describe(`Node ID`),elementId:f.string().describe(`Element ID (FQN)`),kind:f.string().describe(`Element kind`),title:f.string().describe(`Node title`),description:f.string().nullable(),technology:f.string().nullable(),children:f.array(f.string()).describe(`Children nodes, array of node IDs`),shape:f.string().describe(`Rendered shape`),color:f.string().describe(`Rendered color`),tags:f.array(f.string())}),f.object({type:f.literal(`deployment-node`),id:f.string().describe(`Node ID`),deploymentId:f.string().describe(`Deployment entity ID (FQN)`),kind:f.string().describe(`Deployment kind`),title:f.string().describe(`Node title`),description:f.string().nullable(),technology:f.string().nullable(),children:f.array(f.string()).describe(`Children nodes, array of node IDs`),shape:f.string().describe(`Rendered shape`),color:f.string().describe(`Rendered color`),tags:f.array(f.string())}),f.object({type:f.literal(`deployed-instance`),id:f.string().describe(`Node ID`),deploymentId:f.string().describe(`Deployment entity ID (FQN)`),title:f.string().describe(`Node title`),description:f.string().nullable(),technology:f.string().nullable(),referencedElement:f.object({id:f.string().describe(`Element ID (FQN)`),kind:f.string().describe(`Element kind`),title:f.string().describe(`Element title`)}),shape:f.string().describe(`Rendered shape`),color:f.string().describe(`Rendered color`),tags:f.array(f.string())})]),Z=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:f.string().describe(`View id (name)`),project:w},outputSchema:{id:f.string(),type:f.enum([`element`,`deployment`,`dynamic`]).describe(`View type`),title:f.string(),description:f.string().nullable(),tags:f.array(f.string()),project:f.string(),nodes:f.array(X),edges:f.array(f.object({source:f.string().describe(`Source node`),target:f.string().describe(`Target node`),label:f.string().nullable(),description:f.string().nullable(),technology:f.string().nullable(),tags:f.array(f.string())})).describe(`Edge represents relationship between nodes`),sourceLocation:C}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=e.project(n),i=(await e.computedModel(n)).findView(t.viewId);if(!i)throw Error(`View with ID '${t.viewId}' not found in project ${r.id}`);let a=mkLocate(e,r.id);return{id:i.id,type:i.$view._type,title:i.title??i.id,description:i.description.text,tags:[...i.tags],project:r.id,nodes:[...i.nodes()].flatMap(e=>{let t={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()?{...t,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()?{...t,type:`deployment-node`,kind:e.deployment.kind,deploymentId:e.deployment.id,children:[...e.children()].map(e=>e.id)}:e.hasElement()?{...t,type:`element`,elementId:e.element.id,kind:e.element.kind,children:[...e.children()].flatMap(e=>modelRef(e)??[])}:[]}),edges:[...i.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:a({view:i.id})}}),Q=f.array(f.discriminatedUnion(`type`,[f.object({type:f.literal(`element`),project:f.string().describe(`Project ID`),id:f.string().describe(`Element ID (FQN)`),name:f.string().describe(`Element name`),kind:f.string(),title:f.string(),technology:f.string().nullable(),shape:f.string(),includedInViews:T,metadata:f.record(f.union([f.string(),f.array(f.string())])),tags:f.array(f.string())}),f.object({type:f.literal(`deployment-node`),project:f.string().describe(`Project ID`),id:f.string().describe(`Deployment ID (FQN)`),name:f.string().describe(`Deployment name`),kind:f.string(),title:f.string(),technology:f.string().nullable(),shape:f.string(),includedInViews:T,metadata:f.record(f.union([f.string(),f.array(f.string())])),tags:f.array(f.string())})])),$=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:f.string().min(2,`Search must be at least 2 characters long`)},outputSchema:{total:f.number(),found:Q}},async(e,t)=>{let n=e.projects(),i=[],a=t.search.toLowerCase(),predicate;a.startsWith(`kind:`)?(a=a.slice(5),y.debug(`search by kind: {search}`,{search:a}),predicate=e=>e.kind.toLowerCase()===a):a.startsWith(`shape:`)?(a=a.slice(6),y.debug(`search by shape: {search}`,{search:a}),predicate=e=>e.shape.toLowerCase()===a):a.startsWith(`meta:`)?(a=a.slice(5),y.debug(`search by metadata: {search}`,{search:a}),predicate=e=>!!e.getMetadata(a)):a.startsWith(`#`)?(a=a.slice(1),y.debug(`search by tag: {search}`,{search:a}),predicate=e=>e.tags.some(e=>e.toLowerCase().includes(a))):(y.debug(`search by id/title: {search}`,{search:a}),predicate=e=>e.id.toLowerCase().includes(a)||e.title.toLowerCase().includes(a));for(let t of n)try{let n=await e.computedModel(t.id);for(let e of r(n.elements(),e=>!e.imported&&predicate(e)))i.push({type:`element`,project:t.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 r(n.deployment.nodes(),predicate))i.push({type:`deployment-node`,project:t.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){y.error(`Error searching in project ${t.id}:`,{error:e})}return{total:i.length,found:i.slice(0,20)}}),ee=f.object({id:f.string().describe(`Element id (FQN)`),name:f.string().describe(`Element name`),kind:f.string().describe(`Element kind`),title:f.string().describe(`Human-readable title`),depth:f.number().describe(`Depth relative to the root element (1 = direct child)`),tags:f.array(f.string()).describe(`Assigned tags`),metadata:f.record(f.union([f.string(),f.array(f.string())])).describe(`Element metadata`),childCount:f.number().describe(`Number of direct children`),incomingCount:f.number().describe(`Number of incoming relationships`),outgoingCount:f.number().describe(`Number of outgoing relationships`)}),te=likec4Tool({name:`subgraph-summary`,description:`
+Get a compact, table-friendly summary of all descendants of a parent element.
+Returns each descendant with its depth, metadata, tags, and relationship counts in a single call.
+Much more efficient than calling read-element for each descendant individually.
+
+Request:
+- elementId: string — parent element id (FQN) whose descendants to summarize
+- maxDepth: number (optional, default: 10, max: 20) — maximum depth of descendants to include
+- metadataKeys: string[] (optional) — if provided, only include these metadata keys in the response (reduces response size)
+- project: string (optional) — project id. Defaults to "default" if omitted.
+
+Response (JSON object):
+- root: object — the root element summary
+  - id: string — element id
+  - kind: string — element kind
+  - title: string — element title
+  - childCount: number — number of direct children
+- descendants: Array of descendant summaries, each with:
+  - id: string — element id (FQN)
+  - name: string — element name
+  - kind: string — element kind
+  - title: string — human-readable title
+  - depth: number — depth relative to root (1 = direct child)
+  - tags: string[] — assigned tags
+  - metadata: Record<string, string | string[]> — element metadata (filtered by metadataKeys if provided)
+  - childCount: number — number of direct children
+  - incomingCount: number — number of incoming relationships
+  - outgoingCount: number — number of outgoing relationships
+- totalDescendants: number — total number of descendants (may differ from array length if truncated)
+- truncated: boolean — true if results were truncated due to exceeding the 200-result limit
+- truncatedByDepth: boolean — true if deeper descendants exist beyond maxDepth
+
+Notes:
+- Read-only, idempotent, no side effects.
+- Safe to call repeatedly.
+- Limited to 200 descendants in the response.
+- Use metadataKeys to reduce response size when you only need specific metadata.
+- Descendants are returned in breadth-first order (closest to root first).
+- depth=1 means direct child, depth=2 means grandchild, etc.
+
+Example response:
+{
+  "root": {
+    "id": "top.planner",
+    "kind": "subsystem",
+    "title": "Planner Subsystem",
+    "childCount": 5
+  },
+  "descendants": [
+    {
+      "id": "top.planner.nodeA",
+      "name": "nodeA",
+      "kind": "cgf-node",
+      "title": "nodeA :dwNodeTypeA",
+      "depth": 1,
+      "tags": ["is_in_dag", "target_asil_qm"],
+      "metadata": { "target_asil": "QM", "safety_info_unit_asil": "QM" },
+      "childCount": 0,
+      "incomingCount": 3,
+      "outgoingCount": 2
+    }
+  ],
+  "totalDescendants": 5,
+  "truncated": false,
+  "truncatedByDepth": false
+}
+`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Subgraph summary`},inputSchema:{elementId:f.string().describe(`Parent element id (FQN) whose descendants to summarize`),maxDepth:f.number().int().min(1).max(20).optional().default(10).describe(`Maximum depth of descendants to include (default: 10, max: 20)`),metadataKeys:f.array(f.string()).optional().describe(`If provided, only include these metadata keys in the response`),project:w},outputSchema:{root:f.object({id:f.string(),kind:f.string(),title:f.string(),childCount:f.number()}),descendants:f.array(ee),totalDescendants:f.number().describe(`Total number of descendants found`),truncated:f.boolean().describe(`True if results were truncated due to exceeding the limit`),truncatedByDepth:f.boolean().describe(`True if deeper descendants exist beyond maxDepth`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.elementId);s(r,`Element "${t.elementId}" not found in project "${n}"`);let i=t.maxDepth,a=t.metadataKeys,o=[],c=0,l=!1,u=!1,d=[],f=[...r.children()];for(let e of f)d.push({element:e,depth:1});for(;d.length>0;){let{element:e,depth:t}=d.shift();if(t>i){u=!0;continue}c++;let n=[...e.children()];if(o.length<200){let r=e.getMetadata(),i=a?Object.fromEntries(a.filter(e=>e in r).map(e=>[e,r[e]])):r;o.push({id:e.id,name:e.name,kind:e.kind,title:e.title,depth:t,tags:[...e.tags],metadata:i,childCount:n.length,incomingCount:[...e.incoming()].length,outgoingCount:[...e.outgoing()].length})}else l=!0;for(let e of n)d.push({element:e,depth:t+1})}return{root:{id:r.id,kind:r.kind,title:r.title,childCount:f.length},descendants:o,totalDescendants:c,truncated:l,truncatedByDepth:u}});var MCPServerFactory=class{constructor(e){this.services=e}create(t){let n=this.services.shared.lsp.Connection!==void 0,r=new d({name:`LikeC4`,version:b},{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, configuration, 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? }.
+- query-graph — Query element hierarchy (ancestors, descendants, siblings, children, parent) and relationships (incomers, outgoers). Input: { elementId, queryType, includeIndirect?, project? }.
+- query-incomers-graph — Get complete graph of all upstream dependencies/producers (recursive incomers). Much more efficient than repeated query-graph calls. Input: { elementId, includeIndirect?, maxDepth?, maxNodes?, project? }.
+- query-outgoers-graph — Get complete graph of all downstream consumers/dependents (recursive outgoers). Much more efficient than repeated query-graph calls. Input: { elementId, includeIndirect?, maxDepth?, maxNodes?, project? }.
+- query-by-metadata — Search elements by metadata key-value pairs with exact/contains/exists matching. Input: { key, value?, matchMode?, project? }.
+- query-by-tags — Advanced tag filtering with boolean logic (allOf, anyOf, noneOf). Input: { allOf?, anyOf?, noneOf?, project? }.
+- find-relationship-paths — Discover all paths (chains of relationships) between two elements with BFS traversal. Input: { sourceId, targetId, maxDepth?, includeIndirect?, project? }.
+- batch-read-elements — Read details of multiple elements in a single call, reducing round-trips. Input: { ids, project? }.
+- query-by-tag-pattern — Search elements by tag prefix/contains/suffix patterns. Input: { pattern, matchMode?, project? }.
+- element-diff — Compare two elements side-by-side showing differences in properties, tags, metadata, and relationships. Input: { element1Id, element2Id, project? }.
+- subgraph-summary — Compact summary of all descendants of a parent element with metadata, tags, and relationship counts. Input: { elementId, maxDepth?, metadataKeys?, project? }.
+${n?`- 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,...t,capabilities:{tools:{},logging:{},...t?.capabilities}});return r.registerTool(...F(this.services.likec4.LanguageServices)),r.registerTool(...Y(this.services.likec4.LanguageServices)),r.registerTool(...J(this.services.likec4.LanguageServices)),r.registerTool(...q(this.services.likec4.LanguageServices)),r.registerTool(...Z(this.services.likec4.LanguageServices)),r.registerTool(...$(this.services.likec4.LanguageServices)),r.registerTool(...P(this.services.likec4.LanguageServices)),r.registerTool(...H(this.services.likec4.LanguageServices)),r.registerTool(...W(this.services.likec4.LanguageServices)),r.registerTool(...K(this.services.likec4.LanguageServices)),r.registerTool(...R(this.services.likec4.LanguageServices)),r.registerTool(...B(this.services.likec4.LanguageServices)),r.registerTool(...j(this.services.likec4.LanguageServices)),r.registerTool(...D(this.services.likec4.LanguageServices)),r.registerTool(...z(this.services.likec4.LanguageServices)),r.registerTool(...A(this.services.likec4.LanguageServices)),r.registerTool(...te(this.services.likec4.LanguageServices)),n&&r.registerTool(...I(this.services.likec4.LanguageServices)),r.server.onerror=t=>{e.error(o(t))},r}},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||(y.info(`Starting MCP stdio server`),this._mcp=this.services.mcp.ServerFactory.create(),this.transport=new p,await this._mcp.connect(this.transport),y.info(`LikeC4 MCP Server running on stdio`))}async stop(){if(this.transport)try{y.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 t=new _;t.use(`*`,v({origin:`*`,allowHeaders:[`Content-Type`,`mcp-session-id`,`Last-Event-ID`,`mcp-protocol-version`],exposeHeaders:[`mcp-session-id`,`mcp-protocol-version`]})),t.get(`/health`,e=>e.json({status:`ok`}));let n=e.create(),r=new h({eventStore:new m({})});return t.all(`/mcp`,async e=>(n.isConnected()||await n.connect(r),await r.handleRequest(e))),t.notFound(e=>(y.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}))),t.onError((e,t)=>(y.error(o(e)),t.json({jsonrpc:`2.0`,error:{code:-32603,message:`Internal server error`},id:null},{status:500}))),t}async function startServer(e){let{factory:t,port:n}=e,r=await createHonoApp(t);return new Promise((e,t)=>{let i=g({fetch:r.fetch,hostname:`0.0.0.0`,port:n}).prependOnceListener(`error`,t).prependOnceListener(`listening`,()=>{i.removeListener(`error`,t),e(i.unref())})})}var StreamableLikeC4MCPServer=class{server=void 0;constructor(e,t=33335){this.services=e,this._port=t}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()}y.info(`Starting MCP server on port {port}`,{port:e}),this._port=e,this.server=await startServer({factory:this.services.mcp.ServerFactory,port:e}),y.info(`MCP server ready at http://0.0.0.0:{port}/mcp`,{port:e})}stop(){let e=this.server;return e?(y.info(`Stopping MCP server`),this.server=void 0,new Promise(t=>{e.close(e=>{e?y.error(`Failed to stop MCP server`,{err:e}):y.info(`MCP server stopped`),t()})})):(y.info(`MCP server is not running, nothing to stop`),Promise.resolve())}};function streamableLikeC4MCPServer(e,t=33335){y.debug(`Creating StreamableLikeC4MCPServer`);let n=new StreamableLikeC4MCPServer(e,t),r=e.LanguageMetaData.languageId,i=e.shared.lsp.Connection;return e.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate(e=>{if(e.section!==r){y.warn(`Unexpected configuration update: {update}`,{update:e});return}let{enabled:a=!1,port:s=t}=e.configuration.mcp;if(!a){n.stop();return}Promise.resolve().then(()=>n.start(s)).then(()=>{i?.telemetry?.logEvent({eventName:`mcp-server-started`,mcpPort:s})}).catch(e=>{let t=o(e);i?.telemetry?.logEvent({eventName:`mcp-server-start-failed`,mcpPort:s,message:t}),y.warn(`Failed to start LikeC4 MCP Server: \n${t}`),i&&i.window.showErrorMessage(`LikeC4: Failed to start MCP Server\n\n${t}`)})}),n}function stdioLikeC4MCPServer(e){return new StdioLikeC4MCPServer(e)}function WithMCPServer(e=`sse`){return{mcpServer:t=>e===`stdio`?stdioLikeC4MCPServer(t):streamableLikeC4MCPServer(t,typeof e==`object`?e.port:33335),mcpServerFactory:e=>new MCPServerFactory(e)}}export{WithMCPServer as t};