archdraw-mcp-server 1.0.0

package/dist/tools/export-diagram.d.ts

@@ -0,0 +1,36 @@
+export declare function exportDiagram(input: unknown): Promise<{
+    success: boolean;
+    error: string;
+    format?: undefined;
+    nodes?: undefined;
+    edges?: undefined;
+    label?: undefined;
+    message?: undefined;
+    editorUrl?: undefined;
+    instructions?: undefined;
+} | {
+    success: boolean;
+    format: string;
+    nodes: import("../types/index.js").ReactFlowNode[];
+    edges: import("../types/index.js").ReactFlowEdge[];
+    label: string;
+    message: string;
+    error?: undefined;
+    editorUrl?: undefined;
+    instructions?: undefined;
+} | {
+    success: boolean;
+    format: "png" | "svg";
+    message: string;
+    editorUrl: string | undefined;
+    instructions: {
+        json: string;
+        png: string;
+        svg: string;
+    };
+    error?: undefined;
+    nodes?: undefined;
+    edges?: undefined;
+    label?: undefined;
+}>;
+//# sourceMappingURL=export-diagram.d.ts.map

package/dist/tools/export-diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-diagram.d.ts","sourceRoot":"","sources":["../../src/tools/export-diagram.ts"],"names":[],"mappings":"AAMA,wBAAsB,aAAa,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEjD"}

package/dist/tools/export-diagram.js

@@ -0,0 +1,65 @@
+import { getDiagramState } from '../lib/diagram-state.js';
+import { ExportDiagramInputSchema } from '../lib/schema.js';
+import { fetchWithTimeout } from '../lib/http.js';
+const API_BASE = process.env.API_BASE_URL || 'http://localhost:3000';
+export async function exportDiagram(input) {
+    const validated = ExportDiagramInputSchema.parse(input);
+    const format = validated.format;
+    const sessionId = validated.sessionId || getDiagramState().sessionId;
+    const state = getDiagramState();
+    if (state.nodes.length === 0) {
+        return {
+            success: false,
+            error: 'No diagram loaded. Generate or load a diagram first.',
+        };
+    }
+    if (format === 'json') {
+        return {
+            success: true,
+            format: 'json',
+            nodes: state.nodes,
+            edges: state.edges,
+            label: 'ArchDraw Diagram',
+            message: 'Diagram exported as JSON. You can save this data to a file.',
+        };
+    }
+    if (!sessionId) {
+        return {
+            success: false,
+            error: 'No sessionId available for this diagram. Export as JSON instead, or generate a diagram first.',
+        };
+    }
+    try {
+        const response = await fetchWithTimeout(`${API_BASE}/api/diagram/export`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ sessionId, format }),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            return {
+                success: false,
+                error: errorData.error || `Export failed: ${response.status}`,
+            };
+        }
+        const data = await response.json();
+        return {
+            success: true,
+            format,
+            message: `To export as ${format.toUpperCase()}, open the editor URL in your browser and use the export button.`,
+            editorUrl: data.editorUrl,
+            instructions: {
+                json: 'Use format: "json" to get raw diagram data',
+                png: 'Open editor and click Export → PNG',
+                svg: 'Open editor and click Export → SVG',
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Export failed',
+        };
+    }
+}
+//# sourceMappingURL=export-diagram.js.map

package/dist/tools/export-diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-diagram.js","sourceRoot":"","sources":["../../src/tools/export-diagram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,uBAAuB,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAc;IAChD,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAChC,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,eAAe,EAAE,CAAC,SAAS,CAAC;IAErE,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sDAAsD;SAC9D,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,6DAA6D;SACvE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,+FAA+F;SACvG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,QAAQ,qBAAqB,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAuB,CAAC;YAChF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,kBAAkB,QAAQ,CAAC,MAAM,EAAE;aAC9D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAkF,CAAC;QAEnH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM;YACN,OAAO,EAAE,gBAAgB,MAAM,CAAC,WAAW,EAAE,kEAAkE;YAC/G,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE;gBACZ,IAAI,EAAE,4CAA4C;gBAClD,GAAG,EAAE,oCAAoC;gBACzC,GAAG,EAAE,oCAAoC;aAC1C;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/fix-layout.d.ts

@@ -0,0 +1,19 @@
+import type { FixLayoutInput } from '../lib/schema.js';
+export declare function fixLayout(input: FixLayoutInput): Promise<{
+    success: boolean;
+    elkPositions: Array<{
+        id: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    metadata: {
+        nodeCount: number;
+        edgeCount: number;
+        layoutAlgorithm: string;
+        direction: string;
+    };
+    errors?: string[];
+}>;
+//# sourceMappingURL=fix-layout.d.ts.map

package/dist/tools/fix-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-layout.d.ts","sourceRoot":"","sources":["../../src/tools/fix-layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAwBvD,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAsGD"}

package/dist/tools/fix-layout.js

@@ -0,0 +1,100 @@
+import { runELKLayout, validateLayout } from '../lib/elk-runner.js';
+import { normalizeLayer, getTierColor } from '../lib/node-catalog.js';
+import { TIER_COLORS, COMM_COLORS } from '../lib/constants.js';
+const DEFAULT_NODE_WIDTH = 220;
+const DEFAULT_NODE_HEIGHT = 100;
+export async function fixLayout(input) {
+    const errors = [];
+    try {
+        const { nodes: inputNodes, edges: inputEdges, direction } = input;
+        if (inputNodes.length === 0) {
+            return {
+                success: false,
+                elkPositions: [],
+                metadata: {
+                    nodeCount: 0,
+                    edgeCount: 0,
+                    layoutAlgorithm: 'ELK layered',
+                    direction,
+                },
+                errors: ['No nodes provided'],
+            };
+        }
+        const architectureNodes = inputNodes.map((node, index) => {
+            const normalizedLayer = normalizeLayer(node.layer);
+            const tierColor = node.tierColor || getTierColor(normalizedLayer) || TIER_COLORS[normalizedLayer];
+            return {
+                id: node.id || `node-${index}`,
+                type: 'architectureNode',
+                label: node.label || `Node ${index}`,
+                layer: normalizedLayer,
+                tier: normalizedLayer,
+                tierColor,
+                width: Math.max(node.width || DEFAULT_NODE_WIDTH, 200),
+                height: Math.max(node.height || DEFAULT_NODE_HEIGHT, 100),
+                icon: 'box',
+                metadata: {},
+            };
+        });
+        const nodeIdSet = new Set(architectureNodes.map(n => n.id));
+        const architectureEdges = inputEdges.map((edge, index) => {
+            const commType = (edge.communicationType || 'sync');
+            const commStyle = COMM_COLORS[commType] || COMM_COLORS.sync;
+            if (!nodeIdSet.has(edge.source)) {
+                errors.push(`Edge ${edge.id || index}: invalid source node ${edge.source}`);
+            }
+            if (!nodeIdSet.has(edge.target)) {
+                errors.push(`Edge ${edge.id || index}: invalid target node ${edge.target}`);
+            }
+            return {
+                id: edge.id || `edge-${index}`,
+                source: edge.source,
+                target: edge.target,
+                sourceHandle: 'right',
+                targetHandle: 'left',
+                communicationType: (commType),
+                pathType: 'smooth',
+                label: '',
+                labelPosition: 'center',
+                animated: commType !== 'sync' && commType !== 'dep',
+                style: {
+                    stroke: commStyle.color,
+                    strokeDasharray: commStyle.dash,
+                    strokeWidth: 2,
+                },
+                markerEnd: 'arrowclosed',
+                markerStart: 'none',
+            };
+        });
+        const layoutResult = await runELKLayout(architectureNodes, architectureEdges, { direction });
+        const layoutValidation = validateLayout(layoutResult.nodes, layoutResult.edges);
+        if (!layoutValidation.valid) {
+            errors.push(...layoutValidation.errors);
+        }
+        return {
+            success: true,
+            elkPositions: layoutResult.elkPositions,
+            metadata: {
+                nodeCount: layoutResult.nodes.length,
+                edgeCount: layoutResult.edges.length,
+                layoutAlgorithm: 'ELK layered',
+                direction,
+            },
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            elkPositions: [],
+            metadata: {
+                nodeCount: 0,
+                edgeCount: 0,
+                layoutAlgorithm: 'ELK layered',
+                direction: input.direction,
+            },
+            errors: [error instanceof Error ? error.message : 'Unknown error'],
+        };
+    }
+}
+//# sourceMappingURL=fix-layout.js.map

package/dist/tools/fix-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-layout.js","sourceRoot":"","sources":["../../src/tools/fix-layout.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-diagram.d.ts

@@ -0,0 +1,31 @@
+import type { ReactFlowNode, ReactFlowEdge } from '../types/index.js';
+import type { GenerateDiagramInput } from '../lib/schema.js';
+export declare function generateDiagram(input: GenerateDiagramInput): Promise<{
+    success: boolean;
+    nodes: ReactFlowNode[];
+    edges: ReactFlowEdge[];
+    elkPositions: Array<{
+        id: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    metadata: {
+        nodeCount: number;
+        edgeCount: number;
+        layoutAlgorithm: string;
+        direction: string;
+        groupCount: number;
+    };
+    diagramUrl?: string;
+    sessionId?: string;
+    shareUrl?: string;
+    embeddedDiagram?: {
+        nodes: ReactFlowNode[];
+        edges: ReactFlowEdge[];
+    };
+    message?: string;
+    errors?: string[];
+}>;
+//# sourceMappingURL=generate-diagram.d.ts.map

package/dist/tools/generate-diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-diagram.d.ts","sourceRoot":"","sources":["../../src/tools/generate-diagram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsC,aAAa,EAAE,aAAa,EAAY,MAAM,mBAAmB,CAAC;AACpH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAmL7D,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAAC,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CA+RD"}

package/dist/tools/generate-diagram.js

@@ -0,0 +1,385 @@
+import { runELKLayout, validateLayout } from '../lib/elk-runner.js';
+import { parseUserPrompt } from '../lib/parse-prompt.js';
+import { fetchWithTimeout } from '../lib/http.js';
+import { TIER_COLORS, TIER_ORDER, TIER_RANK, COMM_COLORS, DEFAULT_NODE_WIDTH, DEFAULT_NODE_HEIGHT, DEFAULT_GROUP_WIDTH, DEFAULT_GROUP_HEIGHT, } from '../lib/constants.js';
+function assignTierFromLayer(layer) {
+    const normalized = layer.toLowerCase();
+    if (TIER_ORDER.includes(normalized))
+        return normalized;
+    return 'compute';
+}
+function validateNodes(nodes, techStack, customFeatures) {
+    const errors = [];
+    const ids = new Set();
+    for (const node of nodes) {
+        if (!node.id) {
+            errors.push(`Node missing id: ${node.label}`);
+        }
+        else if (ids.has(node.id)) {
+            errors.push(`Duplicate node id: ${node.id}`);
+        }
+        else {
+            ids.add(node.id);
+        }
+        if (!node.label)
+            errors.push(`Node missing label`);
+        const layer = node.tier || node.layer;
+        if (!layer)
+            errors.push(`Node ${node.label || node.id} missing tier/layer`);
+        // Tech stack fidelity: warn if subtitle looks generic
+        if (node.subtitle) {
+            const genericTerms = ['service', 'server', 'api', 'database', 'storage', 'cache', 'worker', 'backend'];
+            const subtitleLower = node.subtitle.toLowerCase();
+            const labelLower = (node.label || '').toLowerCase();
+            const isGeneric = genericTerms.some(t => subtitleLower === t || subtitleLower === `${labelLower} ${t}`);
+            if (isGeneric && techStack && techStack.length > 0) {
+                errors.push(`WARNING: Node "${node.label}" has a generic subtitle "${node.subtitle}". With user-specified tech stack, subtitles must include actual technology names.`);
+            }
+        }
+    }
+    // Validate parentId references
+    for (const node of nodes) {
+        if (node.parentId && !ids.has(node.parentId)) {
+            errors.push(`Node "${node.id}" has parentId "${node.parentId}" which does not exist`);
+        }
+        if (node.parentId && node.isGroup) {
+            errors.push(`Node "${node.id}" cannot be both a group and a child (parentId + isGroup)`);
+        }
+    }
+    // Tech stack fidelity check: every specified tech must appear in at least one node
+    if (techStack && techStack.length > 0) {
+        const allText = nodes.map(n => `${n.label} ${n.subtitle || ''}`).join(' ').toLowerCase();
+        for (const tech of techStack) {
+            if (!allText.includes(tech.toLowerCase())) {
+                errors.push(`TECH FIDELITY: User specified "${tech}" but it does not appear in any node label or subtitle. Add a node or update a subtitle to mention "${tech}".`);
+            }
+        }
+    }
+    // Custom features check
+    if (customFeatures && customFeatures.length > 0) {
+        const allText = nodes.map(n => `${n.label} ${n.subtitle || ''}`).join(' ').toLowerCase();
+        for (const feature of customFeatures) {
+            if (!allText.includes(feature.toLowerCase())) {
+                errors.push(`FEATURE MISSING: User requested "${feature}" but it does not appear in any node label or subtitle. Add a dedicated node or update an existing one.`);
+            }
+        }
+    }
+    return errors;
+}
+function validateEdgeTopology(nodes, edges) {
+    const topologyErrors = [];
+    const nodeMap = new Map(nodes.map(n => [n.id, n]));
+    // Count how many edges TARGET each node (inbound degree)
+    const inboundCount = new Map();
+    for (const n of nodes)
+        inboundCount.set(n.id, 0);
+    for (const e of edges) {
+        inboundCount.set(e.target, (inboundCount.get(e.target) || 0) + 1);
+    }
+    const totalEdges = edges.length;
+    for (const node of nodes) {
+        if (node.isGroup)
+            continue;
+        const tier = (node.tier || node.layer || 'compute').toLowerCase();
+        const inbound = inboundCount.get(node.id) || 0;
+        const label = node.label || node.id;
+        // ── RULE 1: Client nodes are SOURCES — max 1-2 inbound edges (responses only) ──
+        if (tier === 'client' && inbound > 2) {
+            topologyErrors.push(`🚨 STAR TOPOLOGY — Client node "${label}" has ${inbound} edges pointing TO it. ` +
+                `Client tier nodes (Web App, Mobile App) INITIATE requests — they are edge SOURCES, not targets. ` +
+                `FIX: Reverse these edges. Flow must be: Web Client → API Gateway → Services → Data. ` +
+                `Services must NEVER point back to the Web Client.`);
+        }
+        // ── RULE 2: No single non-gateway node should receive >45% of all edges ──
+        if (totalEdges >= 4 && inbound >= Math.ceil(totalEdges * 0.45) && tier !== 'edge') {
+            topologyErrors.push(`🚨 STAR TOPOLOGY — Node "${label}" (${tier}) is acting as a HUB with ${inbound}/${totalEdges} edges pointing TO it. ` +
+                `Architecture must use tiered flow, not hub-and-spoke. ` +
+                `FIX: Route connections through the appropriate gateway/service tier instead of directly to this node.`);
+        }
+    }
+    // ── RULE 3: No backward edges (higher tier → lower tier except response flows) ──
+    for (const edge of edges) {
+        const sourceNode = nodeMap.get(edge.source);
+        const targetNode = nodeMap.get(edge.target);
+        if (!sourceNode || !targetNode)
+            continue;
+        if (sourceNode.isGroup || targetNode.isGroup)
+            continue;
+        const sourceTier = (sourceNode.tier || sourceNode.layer || 'compute').toLowerCase();
+        const targetTier = (targetNode.tier || targetNode.layer || 'compute').toLowerCase();
+        const sourceRank = TIER_RANK[sourceTier] ?? 2;
+        const targetRank = TIER_RANK[targetTier] ?? 2;
+        // Compute/data/async tier nodes must NEVER connect to client tier
+        if (sourceRank >= 2 && targetRank === 0) {
+            topologyErrors.push(`🚨 BACKWARD EDGE — "${sourceNode.label}" (${sourceTier}) → "${targetNode.label}" (client). ` +
+                `Backend services must NEVER send edges to the client tier. ` +
+                `FIX: Remove this edge. If the client needs real-time updates, add a WebSocket Gateway or Notification Service as an intermediary.`);
+        }
+        // Edge tier nodes should generally not point back to client either
+        if (sourceRank >= 1 && targetRank === 0 && sourceTier !== 'external') {
+            topologyErrors.push(`⚠️  DIRECTION WARNING — "${sourceNode.label}" (${sourceTier}) → "${targetNode.label}" (client). ` +
+                `In request-response architecture, edges flow LEFT→RIGHT: client → gateway → services → data. ` +
+                `Do not draw reverse edges back to the client.`);
+        }
+    }
+    return topologyErrors;
+}
+export async function generateDiagram(input) {
+    const errors = [];
+    try {
+        const { direction } = input;
+        // Handle Mermaid input directly
+        if (input.mermaid) {
+            const API_BASE = process.env.API_BASE_URL || 'http://localhost:3000';
+            const label = input.label || 'AI Diagram';
+            const saveResponse = await fetchWithTimeout(`${API_BASE}/api/diagram/load`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    mermaid: input.mermaid,
+                    label,
+                    source: 'mcp',
+                }),
+            });
+            if (!saveResponse.ok) {
+                const errText = await saveResponse.text();
+                let errData;
+                try {
+                    errData = JSON.parse(errText);
+                }
+                catch { }
+                const errorMsg = errData?.error || errText || 'Failed to save diagram to API';
+                const warnings = errData?.warnings ? ` Warnings: ${errData.warnings.join(', ')}` : '';
+                return {
+                    success: false, nodes: [], edges: [], elkPositions: [],
+                    metadata: { nodeCount: 0, edgeCount: 0, layoutAlgorithm: 'Mermaid Pipeline', direction: input.direction || 'RIGHT', groupCount: 0 },
+                    errors: [`${errorMsg}${warnings}`],
+                };
+            }
+            const saveData = await saveResponse.json();
+            const urlPath = `/editor?session=${saveData.sessionId}`;
+            const diagramUrl = `${API_BASE}${urlPath}`;
+            const sessionId = saveData.sessionId;
+            const shareUrl = `${API_BASE}/share/${sessionId}`;
+            const nodeCount = saveData.nodes.filter(n => !n.data?.isGroup).length;
+            const groupCount = saveData.nodes.filter(n => n.data?.isGroup).length;
+            const techStack = input.techStack || [];
+            const customFeatures = input.customFeatures || [];
+            const techLine = techStack.length > 0
+                ? `\n\n🔧 **Tech Stack Applied**: ${techStack.join(', ')}`
+                : '';
+            const featuresLine = customFeatures.length > 0
+                ? `\n⚡ **Features Included**: ${customFeatures.join(', ')}`
+                : '';
+            const promptLine = input.userPrompt
+                ? `\n\n💬 **From prompt**: "${input.userPrompt.substring(0, 100)}${input.userPrompt.length > 100 ? '...' : ''}"` : '';
+            const message = `✅ Diagram ready! Open this URL to view and edit:\n\n${diagramUrl}\n\n🔗 Shareable link:\n${shareUrl}\n\n📊 ${nodeCount} nodes, ${groupCount} groups, ${saveData.edges.length} edges.${techLine}${featuresLine}${promptLine}\n\n**To export**: Use session ID "${sessionId}" with the export_diagram tool.`;
+            return {
+                success: true,
+                nodes: saveData.nodes,
+                edges: saveData.edges,
+                elkPositions: [],
+                metadata: {
+                    nodeCount: saveData.nodes.length,
+                    edgeCount: saveData.edges.length,
+                    layoutAlgorithm: 'Mermaid Pipeline',
+                    direction: input.direction || 'RIGHT',
+                    groupCount,
+                },
+                diagramUrl,
+                sessionId,
+                shareUrl,
+                embeddedDiagram: { nodes: saveData.nodes, edges: saveData.edges },
+                message,
+                errors: saveData.warnings && saveData.warnings.length > 0 ? saveData.warnings : undefined,
+            };
+        }
+        if (!input.nodes || input.nodes.length === 0) {
+            return {
+                success: false, nodes: [], edges: [], elkPositions: [],
+                metadata: { nodeCount: 0, edgeCount: 0, layoutAlgorithm: 'ELK layered', direction, groupCount: 0 },
+                errors: ['No nodes or mermaid string provided.'],
+            };
+        }
+        // Check if AI used groups — warn if not
+        const groupNodes = input.nodes.filter((n) => n.isGroup);
+        if (groupNodes.length === 0) {
+            errors.push('WARNING: No group nodes provided. Best practice: wrap related nodes in group containers (isGroup:true) for visual clarity.');
+        }
+        // Extract tech/feature context for fidelity checks.
+        // If the caller did not pass an explicit techStack/customFeatures, derive
+        // them from the userPrompt via the shared prompt parser (single source).
+        const parsedPrompt = input.userPrompt ? parseUserPrompt(input.userPrompt) : null;
+        const techStack = input.techStack && input.techStack.length > 0
+            ? [...input.techStack]
+            : parsedPrompt?.detectedTechStack || [];
+        const customFeatures = input.customFeatures && input.customFeatures.length > 0
+            ? [...input.customFeatures]
+            : parsedPrompt?.customFeatures || [];
+        const architectureNodes = input.nodes.map((node, index) => {
+            const layer = node.layer || node.tier || 'compute';
+            const tier = assignTierFromLayer(layer);
+            const isGroup = node.isGroup === true;
+            return {
+                id: node.id || `node-${index}`,
+                type: isGroup ? 'groupNode' : 'systemNode',
+                label: node.label,
+                subtitle: node.subtitle || '',
+                layer: tier,
+                tier: tier,
+                tierColor: node.tierColor || TIER_COLORS[tier],
+                accentColor: node.accentColor,
+                groupColor: node.groupColor,
+                status: node.status,
+                shape: node.shape,
+                // Groups get larger default dimensions; clamp regular nodes to minimum
+                width: isGroup
+                    ? Math.max(node.width || DEFAULT_GROUP_WIDTH, 300)
+                    : Math.max(node.width || DEFAULT_NODE_WIDTH, 160),
+                height: isGroup
+                    ? Math.max(node.height || DEFAULT_GROUP_HEIGHT, 200)
+                    : Math.max(node.height || DEFAULT_NODE_HEIGHT, 60),
+                icon: node.icon || (isGroup ? 'layers' : 'box'),
+                metadata: { serviceType: node.serviceType },
+                isGroup,
+                parentId: node.parentId,
+                serviceType: node.serviceType,
+            };
+        });
+        // Validate node integrity
+        const nodeIdSet = new Set(architectureNodes.map(n => n.id));
+        const inputEdgeErrors = [];
+        const inputEdgeIds = new Set();
+        for (const edge of (input.edges || [])) {
+            if (edge.id && inputEdgeIds.has(edge.id)) {
+                inputEdgeErrors.push(`Duplicate edge id: ${edge.id}`);
+            }
+            else if (edge.id) {
+                inputEdgeIds.add(edge.id);
+            }
+            if (!nodeIdSet.has(edge.source)) {
+                inputEdgeErrors.push(`Edge ${edge.id || 'unknown'}: invalid source "${edge.source}"`);
+            }
+            if (!nodeIdSet.has(edge.target)) {
+                inputEdgeErrors.push(`Edge ${edge.id || 'unknown'}: invalid target "${edge.target}"`);
+            }
+            if (edge.source === edge.target) {
+                inputEdgeErrors.push(`Edge ${edge.id || 'unknown'}: source and target are the same`);
+            }
+        }
+        errors.push(...validateNodes(architectureNodes, techStack, customFeatures), ...inputEdgeErrors);
+        // ── Run edge topology validation BEFORE layout ────────────────────────────
+        const topologyErrors = validateEdgeTopology(architectureNodes, (input.edges || []).map(e => ({ source: e.source, target: e.target, label: e.label, id: e.id })));
+        if (topologyErrors.length > 0) {
+            errors.push(...topologyErrors);
+            // Return early with topology errors — do NOT render a broken diagram
+            return {
+                success: false,
+                nodes: [],
+                edges: [],
+                elkPositions: [],
+                metadata: { nodeCount: 0, edgeCount: 0, layoutAlgorithm: 'ELK layered', direction, groupCount: 0 },
+                errors,
+                message: `❌ Diagram rejected due to topology errors. Fix the following issues and call generate_diagram again:\n\n` +
+                    topologyErrors.map((e, i) => `${i + 1}. ${e}`).join('\n\n') +
+                    `\n\n📐 CORRECT FLOW: client → API Gateway → Services → Async → Data → External\n` +
+                    `   Edges must flow LEFT→RIGHT through tiers. Never connect service/data nodes back to the client.`,
+            };
+        }
+        const architectureEdges = (input.edges || []).map((edge, index) => {
+            const commType = (edge.communicationType || 'sync');
+            const commStyle = COMM_COLORS[commType] || COMM_COLORS.sync;
+            // Use provided label; for async/stream/event, fall back to comm type description
+            const label = edge.label?.trim() || 'Connection';
+            return {
+                id: edge.id || `edge-${index}`,
+                source: edge.source,
+                target: edge.target,
+                communicationType: commType,
+                pathType: (edge.pathType ?? 'Smoothstep'),
+                label,
+                labelPosition: 'center',
+                animated: commStyle.animated,
+                style: {
+                    stroke: commStyle.color,
+                    strokeDasharray: commStyle.dash,
+                    strokeWidth: 2.5,
+                },
+                markerEnd: 'arrowclosed',
+                markerStart: 'none',
+            };
+        });
+        const layoutResult = await runELKLayout(architectureNodes, architectureEdges, { direction });
+        const layoutValidation = validateLayout(layoutResult.nodes, layoutResult.edges);
+        if (!layoutValidation.valid) {
+            errors.push(...layoutValidation.errors);
+        }
+        let diagramUrl;
+        let message;
+        let sessionId;
+        const API_BASE = process.env.API_BASE_URL || 'http://localhost:3000';
+        try {
+            const label = input.label || input.nodes[0]?.label || 'AI Diagram';
+            const saveResponse = await fetchWithTimeout(`${API_BASE}/api/diagram/load`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    nodes: layoutResult.nodes,
+                    edges: layoutResult.edges,
+                    label,
+                    source: 'mcp',
+                }),
+            });
+            if (saveResponse.ok) {
+                const saveData = await saveResponse.json();
+                const urlPath = saveData.url || `/editor?session=${saveData.sessionId}`;
+                diagramUrl = `${API_BASE}${urlPath}`;
+                sessionId = saveData.sessionId;
+                const shareUrl = `${API_BASE}/share/${sessionId}`;
+                const nodeCount = layoutResult.nodes.filter(n => !n.data?.isGroup).length;
+                const groupCount = layoutResult.nodes.filter(n => n.data?.isGroup).length;
+                // Build a context-aware success message
+                const techLine = techStack.length > 0
+                    ? `\n\n🔧 **Tech Stack Applied**: ${techStack.join(', ')}`
+                    : '';
+                const featuresLine = customFeatures.length > 0
+                    ? `\n⚡ **Features Included**: ${customFeatures.join(', ')}`
+                    : '';
+                const promptLine = input.userPrompt
+                    ? `\n\n💬 **From prompt**: "${input.userPrompt.substring(0, 100)}${input.userPrompt.length > 100 ? '...' : ''}"` : '';
+                message = `✅ Diagram ready! Open this URL to view and edit:\n\n${diagramUrl}\n\n🔗 Shareable link:\n${shareUrl}\n\n📊 ${nodeCount} nodes, ${groupCount} groups, ${layoutResult.edges.length} edges.${techLine}${featuresLine}${promptLine}\n\n**To export**: Use session ID "${sessionId}" with the export_diagram tool.`;
+            }
+        }
+        catch {
+            message = `Diagram generated with ${layoutResult.nodes.length} nodes and ${layoutResult.edges.length} edges, but couldn't save to generate a link. Make sure Next.js is running on ${API_BASE}.`;
+        }
+        const groupCount = architectureNodes.filter(n => n.isGroup).length;
+        return {
+            success: true,
+            nodes: layoutResult.nodes,
+            edges: layoutResult.edges,
+            elkPositions: layoutResult.elkPositions,
+            metadata: {
+                nodeCount: layoutResult.nodes.length,
+                edgeCount: layoutResult.edges.length,
+                layoutAlgorithm: 'ELK layered',
+                direction,
+                groupCount,
+            },
+            diagramUrl,
+            sessionId,
+            shareUrl: sessionId ? `${API_BASE}/share/${sessionId}` : undefined,
+            embeddedDiagram: { nodes: layoutResult.nodes, edges: layoutResult.edges },
+            message,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            success: false, nodes: [], edges: [], elkPositions: [],
+            metadata: { nodeCount: 0, edgeCount: 0, layoutAlgorithm: 'ELK layered', direction: input.direction, groupCount: 0 },
+            errors: [error instanceof Error ? error.message : 'Unknown error'],
+        };
+    }
+}
+//# sourceMappingURL=generate-diagram.js.map