@eclipse-glsp/server-mcp 2.7.0-next.9

package/lib/tools/handlers/count-elements-mcp-tool-handler.d.ts

@@ -0,0 +1,46 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import * as z from 'zod/v4';
+import { AbstractMcpDiagramToolHandler, McpToolResult } from '../../server';
+export declare const CountElementsInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, z.core.$strip>;
+export type CountElementsInput = z.infer<typeof CountElementsInputSchema>;
+export declare const CountElementsOutputSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    countsByType: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Counts elements in the diagram, grouped by type. Cheap alternative to dumping the full
+ * `diagram-model` resource when the agent only needs to know "how big is this" or "do any
+ * elements of type X exist".
+ */
+export declare class CountElementsMcpToolHandler extends AbstractMcpDiagramToolHandler<CountElementsInput> {
+    static readonly NAME = "count-elements";
+    readonly name = "count-elements";
+    readonly title = "Count Diagram Elements";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        total: z.ZodNumber;
+        countsByType: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>;
+    protected createResult(_params: CountElementsInput): Promise<McpToolResult>;
+    protected renderMarkdown(total: number, countsByType: Record<string, number>): string;
+}
+//# sourceMappingURL=count-elements-mcp-tool-handler.d.ts.map

package/lib/tools/handlers/count-elements-mcp-tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-elements-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/count-elements-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA+B,6BAA6B,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEzG,eAAO,MAAM,wBAAwB;;iBAA8B,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AAEH;;;;GAIG;AACH,qBACa,2BAA4B,SAAQ,6BAA6B,CAAC,kBAAkB,CAAC;IAC9F,MAAM,CAAC,QAAQ,CAAC,IAAI,oBAAoB;IACxC,QAAQ,CAAC,IAAI,oBAAoC;IACjD,SAAkB,KAAK,4BAA4B;IACnD,QAAQ,CAAC,WAAW,SAIiC;IACrD,QAAQ,CAAC,WAAW;;sBAA4B;IAChD,SAAkB,YAAY;;;sBAA6B;cAE3C,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAcjF,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;CAKxF"}

package/lib/tools/handlers/count-elements-mcp-tool-handler.js

@@ -0,0 +1,76 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var CountElementsMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountElementsMcpToolHandler = exports.CountElementsOutputSchema = exports.CountElementsInputSchema = void 0;
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const server_1 = require("../../server");
+exports.CountElementsInputSchema = server_1.McpDiagramScopedInputSchema;
+exports.CountElementsOutputSchema = z.object({
+    total: z.number().int().describe('Total element count across the diagram (root included).'),
+    countsByType: z.record(z.string(), z.number().int()).describe('Element count grouped by `GModelElement.type`.')
+});
+/**
+ * Counts elements in the diagram, grouped by type. Cheap alternative to dumping the full
+ * `diagram-model` resource when the agent only needs to know "how big is this" or "do any
+ * elements of type X exist".
+ */
+let CountElementsMcpToolHandler = CountElementsMcpToolHandler_1 = class CountElementsMcpToolHandler extends server_1.AbstractMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = CountElementsMcpToolHandler_1.NAME;
+        this.title = 'Count Diagram Elements';
+        this.description = 'Count the elements in the session diagram, grouped by element type. ' +
+            'Cheap sizing primitive — useful before deciding whether to load the full model with `diagram-model` ' +
+            '(expensive on large diagrams) or whether a filtered `query-elements` call would suffice. ' +
+            'Returns total count plus a per-type breakdown.';
+        this.inputSchema = exports.CountElementsInputSchema;
+        this.outputSchema = exports.CountElementsOutputSchema;
+    }
+    async createResult(_params) {
+        var _a;
+        const countsByType = {};
+        let total = 0;
+        for (const id of this.modelState.index.allIds()) {
+            const element = this.modelState.index.get(id);
+            if (!element) {
+                continue;
+            }
+            countsByType[element.type] = ((_a = countsByType[element.type]) !== null && _a !== void 0 ? _a : 0) + 1;
+            total += 1;
+        }
+        return this.success(this.renderMarkdown(total, countsByType), { total, countsByType });
+    }
+    renderMarkdown(total, countsByType) {
+        const sorted = Object.entries(countsByType).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+        const rows = sorted.map(([type, count]) => `- ${type}: ${count}`).join('\n');
+        return `Total elements: ${total}\n\nBy type:\n${rows}`;
+    }
+};
+exports.CountElementsMcpToolHandler = CountElementsMcpToolHandler;
+CountElementsMcpToolHandler.NAME = 'count-elements';
+exports.CountElementsMcpToolHandler = CountElementsMcpToolHandler = CountElementsMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], CountElementsMcpToolHandler);
+//# sourceMappingURL=count-elements-mcp-tool-handler.js.map

package/lib/tools/handlers/count-elements-mcp-tool-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-elements-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/count-elements-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;AAElF,yCAAuC;AACvC,4BAA4B;AAC5B,yCAAyG;AAE5F,QAAA,wBAAwB,GAAG,oCAA2B,CAAC;AAGvD,QAAA,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAC3F,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAClH,CAAC,CAAC;AAEH;;;;GAIG;AAEI,IAAM,2BAA2B,mCAAjC,MAAM,2BAA4B,SAAQ,sCAAiD;IAA3F;;QAEM,SAAI,GAAG,6BAA2B,CAAC,IAAI,CAAC;QAC/B,UAAK,GAAG,wBAAwB,CAAC;QAC1C,gBAAW,GAChB,sEAAsE;YACtE,sGAAsG;YACtG,2FAA2F;YAC3F,gDAAgD,CAAC;QAC5C,gBAAW,GAAG,gCAAwB,CAAC;QAC9B,iBAAY,GAAG,iCAAyB,CAAC;IAqB/D,CAAC;IAnBa,KAAK,CAAC,YAAY,CAAC,OAA2B;;QACpD,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,SAAS;YACb,CAAC;YACD,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAA,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACnE,KAAK,IAAI,CAAC,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3F,CAAC;IAES,cAAc,CAAC,KAAa,EAAE,YAAoC;QACxE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpG,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,mBAAmB,KAAK,iBAAiB,IAAI,EAAE,CAAC;IAC3D,CAAC;;AA9BQ,kEAA2B;AACpB,gCAAI,GAAG,gBAAgB,AAAnB,CAAoB;sCAD/B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;GACA,2BAA2B,CA+BvC"}

package/lib/tools/handlers/create-edges-mcp-tool-handler.d.ts

@@ -0,0 +1,112 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import { DiagramConfiguration, EdgeCreationChecker } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { McpToolResult, OperationMcpDiagramToolHandler } from '../../server';
+/** Single edge-creation entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+export declare const CreateEdgeSpecSchema: z.ZodObject<{
+    elementTypeId: z.ZodString;
+    sourceElementId: z.ZodString;
+    targetElementId: z.ZodString;
+    routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>;
+export declare const CreateEdgesInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    edges: z.ZodArray<z.ZodObject<{
+        elementTypeId: z.ZodString;
+        sourceElementId: z.ZodString;
+        targetElementId: z.ZodString;
+        routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>>;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strict>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CreateEdgesInput = z.infer<typeof CreateEdgesInputSchema>;
+export declare const CreateEdgesValidationResultSchema: z.ZodObject<{
+    edgeType: z.ZodString;
+    sourceElementId: z.ZodString;
+    targetElementId: z.ZodString;
+    isValid: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateEdgesOutputSchema: z.ZodObject<{
+    createdEdges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementTypeId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    errors: z.ZodArray<z.ZodString>;
+    validationResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        edgeType: z.ZodString;
+        sourceElementId: z.ZodString;
+        targetElementId: z.ZodString;
+        isValid: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type EdgeInput = CreateEdgesInput['edges'][number];
+type ValidationResult = z.infer<typeof CreateEdgesValidationResultSchema>;
+export declare class CreateEdgesMcpToolHandler extends OperationMcpDiagramToolHandler<CreateEdgesInput> {
+    static readonly NAME = "create-edges";
+    readonly name = "create-edges";
+    readonly title = "Create Diagram Edges";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        edges: z.ZodArray<z.ZodObject<{
+            elementTypeId: z.ZodString;
+            sourceElementId: z.ZodString;
+            targetElementId: z.ZodString;
+            routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strict>>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        createdEdges: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            elementTypeId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        errors: z.ZodArray<z.ZodString>;
+        validationResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            edgeType: z.ZodString;
+            sourceElementId: z.ZodString;
+            targetElementId: z.ZodString;
+            isValid: z.ZodBoolean;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    protected diagramConfiguration: DiagramConfiguration;
+    protected edgeCreationChecker?: EdgeCreationChecker;
+    protected createResult({ edges, dryRun }: CreateEdgesInput): Promise<McpToolResult>;
+    protected runDryRun(edges: EdgeInput[]): McpToolResult;
+    protected runCreate(edges: EdgeInput[]): Promise<McpToolResult>;
+    /** Mirrors `RequestCheckEdgeAction`: existence check, then dynamic-hint → checker; static or unknown edgeType → valid. */
+    protected validateEdge(edge: EdgeInput): ValidationResult;
+}
+export {};
+//# sourceMappingURL=create-edges-mcp-tool-handler.d.ts.map

package/lib/tools/handlers/create-edges-mcp-tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-edges-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/create-edges-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAqD,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEpI,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAIH,aAAa,EACb,8BAA8B,EAEjC,MAAM,cAAc,CAAC;AAGtB,kIAAkI;AAClI,eAAO,MAAM,oBAAoB;;;;;;;;;kBAO/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAQjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,iCAAiC;;;;;;iBAM5C,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAOlC,CAAC;AAEH,KAAK,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE1E,qBACa,yBAA0B,SAAQ,8BAA8B,CAAC,gBAAgB,CAAC;IAC3F,MAAM,CAAC,QAAQ,CAAC,IAAI,kBAAkB;IACtC,QAAQ,CAAC,IAAI,kBAAkC;IAC/C,SAAkB,KAAK,0BAA0B;IACjD,QAAQ,CAAC,WAAW,SAKgD;IACpE,QAAQ,CAAC,WAAW;;;;;;;;;;;;;sBAA0B;IAC9C,SAAkB,YAAY;;;;;;;;;;;;;;sBAA2B;IAE3B,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAC1C,SAAS,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;cAE7E,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAOzF,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa;cAetC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA6DrE,0HAA0H;IAC1H,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB;CAiC5D"}

package/lib/tools/handlers/create-edges-mcp-tool-handler.js

@@ -0,0 +1,190 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var CreateEdgesMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateEdgesMcpToolHandler = exports.CreateEdgesOutputSchema = exports.CreateEdgesValidationResultSchema = exports.CreateEdgesInputSchema = exports.CreateEdgeSpecSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const server_2 = require("../../server");
+const util_1 = require("../../util");
+/** Single edge-creation entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+exports.CreateEdgeSpecSchema = z.strictObject({
+    elementTypeId: z.string().describe('Edge type ID (e.g., `edge`, `transition`). Use the `element-types` tool to discover valid IDs.'),
+    sourceElementId: z.string().describe('ID of the source element (must exist in the diagram)'),
+    targetElementId: z.string().describe('ID of the target element (must exist in the diagram)'),
+    routingPoints: z.array(server_2.position).optional().describe('Optional array of routing point coordinates that allow for a complex edge path.'),
+    // `args` stays open (`record(...)`) — adopter-specific extension surface for per-edge-type creation hints.
+    args: z.record(z.string(), z.any()).optional().describe('Additional type-specific arguments for edge creation (varies by edge type)')
+});
+exports.CreateEdgesInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    edges: z.array(exports.CreateEdgeSpecSchema).min(1).describe('Array of edges to create. Must include at least one edge.'),
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe('When true, validate each edge against the type-hint rules without creating anything; returns per-edge `validationResults`.')
+});
+exports.CreateEdgesValidationResultSchema = z.object({
+    edgeType: z.string(),
+    sourceElementId: z.string(),
+    targetElementId: z.string(),
+    isValid: z.boolean(),
+    reason: z.string().optional().describe('Brief reason explaining the verdict (always present when `isValid: false`).')
+});
+exports.CreateEdgesOutputSchema = z.object({
+    createdEdges: z.array(server_2.ElementIdentitySchema).describe('Identity of each edge successfully created. Empty in `dryRun` mode.'),
+    errors: z.array(z.string()).describe('Per-input failure messages; absent or empty when every input succeeded.'),
+    validationResults: z
+        .array(exports.CreateEdgesValidationResultSchema)
+        .optional()
+        .describe('Per-input validation results. Present only in `dryRun` mode.')
+});
+let CreateEdgesMcpToolHandler = CreateEdgesMcpToolHandler_1 = class CreateEdgesMcpToolHandler extends server_2.OperationMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = CreateEdgesMcpToolHandler_1.NAME;
+        this.title = 'Create Diagram Edges';
+        this.description = 'Create one or multiple new edges connecting two elements in the diagram. ' +
+            'Set `dryRun: true` to validate proposed edges (per the diagram-type type-hint rules) ' +
+            'without creating anything; the result then carries per-edge `validationResults`. ' +
+            'Without `dryRun`, this operation modifies the diagram state and requires user approval. ' +
+            'Use the `element-types` tool to discover valid edge type IDs.';
+        this.inputSchema = exports.CreateEdgesInputSchema;
+        this.outputSchema = exports.CreateEdgesOutputSchema;
+    }
+    async createResult({ edges, dryRun }) {
+        if (dryRun) {
+            return this.runDryRun(edges);
+        }
+        return this.runCreate(edges);
+    }
+    runDryRun(edges) {
+        const validationResults = edges.map(edge => this.validateEdge(edge));
+        const validCount = validationResults.filter(result => result.isValid).length;
+        const summary = `Dry run: validated ${edges.length} edge(s); ${validCount} would be accepted, ${edges.length - validCount} rejected.\n` +
+            validationResults
+                .map(result => `- ${result.edgeType} ${result.sourceElementId} → ${result.targetElementId}: ` +
+                `${result.isValid ? 'valid' : `invalid (${result.reason})`}`)
+                .join('\n');
+        return this.success(summary, { createdEdges: [], errors: [], validationResults });
+    }
+    async runCreate(edges) {
+        let beforeIds = this.modelState.index.allIds();
+        const errors = [];
+        const createdEdges = [];
+        let dispatchedOperations = 0;
+        // Sequential — each iteration must isolate its own creation in the post-dispatch diff.
+        for (const edge of edges) {
+            const { elementTypeId, routingPoints, args } = edge;
+            const sourceElementId = this.aliasService.lookup(edge.sourceElementId);
+            const targetElementId = this.aliasService.lookup(edge.targetElementId);
+            const source = this.modelState.index.find(sourceElementId);
+            if (!source) {
+                errors.push(`Source element not found: ${edge.sourceElementId}`);
+                continue;
+            }
+            const target = this.modelState.index.find(targetElementId);
+            if (!target) {
+                errors.push(`Target element not found: ${edge.targetElementId}`);
+                continue;
+            }
+            const operation = server_1.CreateEdgeOperation.create({ elementTypeId, sourceElementId, targetElementId, args });
+            await this.actionDispatcher.dispatch(operation);
+            dispatchedOperations++;
+            const afterIds = this.modelState.index.allIds();
+            const newIds = afterIds.filter(id => !beforeIds.includes(id));
+            const newElements = newIds.map(id => this.modelState.index.find(id)).filter(element => (element === null || element === void 0 ? void 0 : element.type) === elementTypeId);
+            const newElement = newElements[0];
+            if (newElements.length > 1) {
+                this.logger.warn('More than 1 new element created');
+            }
+            beforeIds = afterIds;
+            // Operations don't surface failure directly — infer from absence of a new id of the requested type.
+            if (!newElement) {
+                errors.push(`Edge creation likely failed because no new element ID was found for input: ${JSON.stringify(edge)}`);
+                continue;
+            }
+            if (routingPoints) {
+                const routingPointsOperation = server_1.ChangeRoutingPointsOperation.create([
+                    { elementId: newElement.id, newRoutingPoints: routingPoints }
+                ]);
+                await this.actionDispatcher.dispatch(routingPointsOperation);
+                dispatchedOperations++;
+            }
+            createdEdges.push(this.describeResolvedElement(newElement));
+        }
+        const successListStr = createdEdges.map(({ id, elementTypeId }) => `- ${elementTypeId} (#${id})`).join('\n');
+        // Per-input errors are surfaced in `errors`; the call itself still succeeds — rolling back partial creates would require operation-level transactions.
+        return this.success(`Successfully created ${createdEdges.length} edge(s) (in ${dispatchedOperations} commands):\n${successListStr}${(0, util_1.formatNoticeList)('errors', errors)}`, { createdEdges, errors });
+    }
+    /** Mirrors `RequestCheckEdgeAction`: existence check, then dynamic-hint → checker; static or unknown edgeType → valid. */
+    validateEdge(edge) {
+        const { elementTypeId } = edge;
+        const sourceRealId = this.aliasService.lookup(edge.sourceElementId);
+        const targetRealId = this.aliasService.lookup(edge.targetElementId);
+        const echo = {
+            edgeType: elementTypeId,
+            sourceElementId: edge.sourceElementId,
+            targetElementId: edge.targetElementId
+        };
+        const source = this.modelState.index.find(sourceRealId);
+        if (!source) {
+            return { ...echo, isValid: false, reason: `Source element not found: ${edge.sourceElementId}` };
+        }
+        const target = this.modelState.index.find(targetRealId);
+        if (!target) {
+            return { ...echo, isValid: false, reason: `Target element not found: ${edge.targetElementId}` };
+        }
+        const hasDynamicHint = this.diagramConfiguration.edgeTypeHints.some(hint => hint.elementTypeId === elementTypeId && hint.dynamic);
+        if (!hasDynamicHint) {
+            return { ...echo, isValid: true, reason: 'no dynamic edge-type hint — static hints apply' };
+        }
+        if (!this.edgeCreationChecker) {
+            return {
+                ...echo,
+                isValid: false,
+                reason: `EdgeCreationChecker is not bound although edge type '${elementTypeId}' declares a dynamic hint.`
+            };
+        }
+        const isValid = this.edgeCreationChecker.isValidTarget(elementTypeId, source, target);
+        return { ...echo, isValid, ...(isValid ? {} : { reason: 'rejected by EdgeCreationChecker' }) };
+    }
+};
+exports.CreateEdgesMcpToolHandler = CreateEdgesMcpToolHandler;
+CreateEdgesMcpToolHandler.NAME = 'create-edges';
+__decorate([
+    (0, inversify_1.inject)(server_1.DiagramConfiguration),
+    __metadata("design:type", Object)
+], CreateEdgesMcpToolHandler.prototype, "diagramConfiguration", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.EdgeCreationChecker),
+    (0, inversify_1.optional)(),
+    __metadata("design:type", Object)
+], CreateEdgesMcpToolHandler.prototype, "edgeCreationChecker", void 0);
+exports.CreateEdgesMcpToolHandler = CreateEdgesMcpToolHandler = CreateEdgesMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], CreateEdgesMcpToolHandler);
+//# sourceMappingURL=create-edges-mcp-tool-handler.js.map

package/lib/tools/handlers/create-edges-mcp-tool-handler.js.map

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

package/lib/tools/handlers/create-nodes-mcp-tool-handler.d.ts

@@ -0,0 +1,81 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import * as z from 'zod/v4';
+import { McpToolResult, OperationMcpDiagramToolHandler } from '../../server';
+/** Single node-creation entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+export declare const CreateNodeSpecSchema: z.ZodObject<{
+    elementTypeId: z.ZodString;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>;
+    text: z.ZodOptional<z.ZodString>;
+    containerId: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>;
+export declare const CreateNodesInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    nodes: z.ZodArray<z.ZodObject<{
+        elementTypeId: z.ZodString;
+        position: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>;
+        text: z.ZodOptional<z.ZodString>;
+        containerId: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type CreateNodesInput = z.infer<typeof CreateNodesInputSchema>;
+export declare const CreateNodesOutputSchema: z.ZodObject<{
+    createdNodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementTypeId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    errors: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare class CreateNodesMcpToolHandler extends OperationMcpDiagramToolHandler<CreateNodesInput> {
+    static readonly NAME = "create-nodes";
+    readonly name = "create-nodes";
+    readonly title = "Create Diagram Nodes";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        nodes: z.ZodArray<z.ZodObject<{
+            elementTypeId: z.ZodString;
+            position: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+            text: z.ZodOptional<z.ZodString>;
+            containerId: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        createdNodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            elementTypeId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        errors: z.ZodArray<z.ZodString>;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    protected createResult({ nodes }: CreateNodesInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=create-nodes-mcp-tool-handler.d.ts.map

package/lib/tools/handlers/create-nodes-mcp-tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-nodes-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/create-nodes-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAIlF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAIH,aAAa,EACb,8BAA8B,EAEjC,MAAM,cAAc,CAAC;AAGtB,kIAAkI;AAClI,eAAO,MAAM,oBAAoB;;;;;;;;;kBAS/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;iBAUlC,CAAC;AAEH,qBACa,yBAA0B,SAAQ,8BAA8B,CAAC,gBAAgB,CAAC;IAC3F,MAAM,CAAC,QAAQ,CAAC,IAAI,kBAAkB;IACtC,QAAQ,CAAC,IAAI,kBAAkC;IAC/C,SAAkB,KAAK,0BAA0B;IACjD,QAAQ,CAAC,WAAW,SAMwD;IAC5E,QAAQ,CAAC,WAAW;;;;;;;;;;;;sBAA0B;IAC9C,SAAkB,YAAY;;;;;;;;sBAA2B;cAEzC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CAyDpF"}