@likec4/language-server 1.54.0 → 1.55.0

package/dist/_chunks/mcp.mjs

@@ -1,1154 +0,0 @@
-import{l as e,oi as t}from"./utils.mjs";import{ifilter as n,invariant as r,isSameHierarchy as i}from"@likec4/core/utils";import{loggable as a}from"@likec4/log";import{invariant as o}from"@likec4/core";import{keys as s}from"remeda";import{URI as c}from"vscode-uri";import{isDeploymentNodeModel as l,modelConnection as u}from"@likec4/core/model";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=t.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:a(t)}],isError:!0}}})}var b=`1.54.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){o(e.findElement(t),`Element "${t}" not found`);let s=new Set,c={},l=0,u=!1,d=[{elementId:t,depth:0}];for(;d.length>0;){let{elementId:t,depth:o}=d.shift();if(o>i||s.has(t))continue;if(s.size>=a){u=!0;break}let f=e.findElement(t);if(!f)continue;s.add(t),l=Math.max(l,o);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:o};for(let e of p)s.has(e.elementId)||d.push({elementId:e.elementId,depth:o+1})}for(let e of Object.values(c))e.neighbors=e.neighbors.filter(e=>e.elementId in c);return{target:t,totalNodes:s.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(e.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:c.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)=>{o(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);o(i,`Element "${t.element1Id}" not found in project "${n}"`);let a=r.findElement(t.element2Id);o(a,`Element "${t.element2Id}" not found in project "${n}"`);let s=[],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&&s.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:s,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);o(i,`Source element "${t.sourceId}" not found in project "${n}"`);let a=r.findElement(t.targetId);o(a,`Target element "${t.targetId}" not found in project "${n}"`),o(i.id!==a.id,`Source and target must be different elements`);let s=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>=s)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(i(t.element1,t.element2))throw Error(`No relationships possible between parent-child`);let a=[],o=await e.computedModel(n),s=o.findElement(t.element1);r(s,`Element "${t.element1}" not found in project "${n}"`);let c=o.findElement(t.element2);r(c,`Element "${t.element2}" not found in project "${n}"`);let l=mkLocate(e,n),d=u.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;a.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:l({relation:e.id})})}return{found:a}}),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(!l(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)=>{o(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}l(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);o(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);o(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),s={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;s[e]={...r,incomers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:s}}),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);o(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),s={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;s[e]={...r,outgoers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:s}}),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);o(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);o(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,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=e.project(n),i=await e.computedModel(n);return{title:r.title,folder:r.folder.fsPath,sources:r.documents?.map(e=>e.fsPath)??[],config:serializeConfig(r.config),specification:{elementKinds:s(i.specification.elements),relationshipKinds:s(i.specification.relationships),deploymentKinds:s(i.specification.deployments),tags:[...i.tags],metadataKeys:i.specification.metadataKeys??[]},elements:[...i.elements()].filter(e=>!e.imported).map(e=>({id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]})),deployments:[...i.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:[...i.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 r=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 r)try{let r=await e.computedModel(t.id);for(let e of n(r.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 n(r.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);o(r,`Element "${t.elementId}" not found in project "${n}"`);let i=t.maxDepth,a=t.metadataKeys,s=[],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(s.length<200){let r=e.getMetadata(),i=a?Object.fromEntries(a.filter(e=>e in r).map(e=>[e,r[e]])):r;s.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:s,totalDescendants:c,truncated:l,truncatedByDepth:u}});var MCPServerFactory=class{constructor(e){this.services=e}create(e){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,...e,capabilities:{tools:{},logging:{},...e?.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=e=>{t.error(a(e))},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(a(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:o=!1,port:s=t}=e.configuration.mcp;if(!o){n.stop();return}Promise.resolve().then(()=>n.start(s)).then(()=>{i?.telemetry?.logEvent({eventName:`mcp-server-started`,mcpPort:s})}).catch(e=>{let t=a(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};