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

package/lib/tools/handlers/element-types-mcp-tool-handler.js

@@ -0,0 +1,155 @@
+"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 ElementTypesMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementTypesMcpToolHandler = exports.ElementTypesOutputSchema = exports.ElementTypeEntrySchema = exports.ElementTypesInputSchema = 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 element_types_provider_1 = require("../../resources/services/element-types-provider");
+exports.ElementTypesInputSchema = z.object({
+    sessionId: z.string().optional().describe('Open GLSP session id; diagram type is derived from it. Provide this OR `diagramType`.'),
+    diagramType: z.string().optional().describe('Diagram type to query. Provide this OR `sessionId`; useful when no session is open yet.')
+});
+/**
+ * `id` + `label` are required (the default registry-scrape provides both); `description` and
+ * `acceptsText` are optional adopter-richer fields. `.loose()` lets adopter providers attach
+ * arbitrary extra fields without us having to widen the schema each time.
+ */
+exports.ElementTypeEntrySchema = z
+    .object({
+    id: z.string().describe('Element type id used by `create-*` tools (e.g. `task:manual`).'),
+    label: z.string().describe('Human-readable display name for the element TYPE (e.g. `Manual Task`).'),
+    description: z.string().optional().describe('Adopter-supplied human-readable description.'),
+    acceptsText: z
+        .boolean()
+        .optional()
+        .describe('Whether `create-*` / `modify-*` tools should pass a `text` arg for elements of this type. Absent ⇒ unknown.')
+})
+    .loose();
+exports.ElementTypesOutputSchema = z.object({
+    diagramType: z.string(),
+    nodeTypes: z.array(exports.ElementTypeEntrySchema),
+    edgeTypes: z.array(exports.ElementTypeEntrySchema)
+});
+/**
+ * Server-scope so the LLM can discover types before opening a session. Lazy-harvests the
+ * per-diagram-type {@link ElementTypesProvider} via a temporary child container (same pattern
+ * as core's `DefaultGlobalActionProvider`) and caches the result for the server's lifetime —
+ * element-type sets are static at runtime, so we pay the harvest cost once per type.
+ *
+ * Adopters with statically-known type info bind their own {@link ElementTypesProvider} via
+ * `bindElementTypesProvider()`; the harvest picks it up without further overrides.
+ */
+let ElementTypesMcpToolHandler = ElementTypesMcpToolHandler_1 = class ElementTypesMcpToolHandler extends server_2.AbstractMcpToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = ElementTypesMcpToolHandler_1.NAME;
+        this.title = 'Creatable Element Types';
+        this.description = 'List all element types (nodes and edges) that can be created for a specific diagram type. ' +
+            'Use this to discover valid `elementTypeId` values for the create-nodes / create-edges tools. ' +
+            'Pass `sessionId` for the diagram you are working in (recommended), or `diagramType` directly ' +
+            'when no session of that type is open yet (e.g. when creating a brand-new diagram).';
+        this.inputSchema = exports.ElementTypesInputSchema;
+        this.outputSchema = exports.ElementTypesOutputSchema;
+        this.cache = new Map();
+    }
+    createResult({ sessionId, diagramType }) {
+        const resolved = diagramType !== null && diagramType !== void 0 ? diagramType : this.resolveDiagramType(sessionId);
+        const { nodeTypes, edgeTypes } = this.getElementTypes(resolved);
+        return this.success(this.summarizeElementTypes(resolved, nodeTypes, edgeTypes), {
+            diagramType: resolved,
+            nodeTypes,
+            edgeTypes
+        });
+    }
+    /** Builds the LLM-facing summary. Override to customize per-adopter wording. */
+    summarizeElementTypes(diagramType, nodeTypes, edgeTypes) {
+        return (`Diagram type '${diagramType}': ${nodeTypes.length} node type(s), ${edgeTypes.length} edge type(s); ` +
+            `full details in structuredContent.\n` +
+            `- Node types: ${nodeTypes.map(entry => entry.id).join(', ') || '(none)'}\n` +
+            `- Edge types: ${edgeTypes.map(entry => entry.id).join(', ') || '(none)'}`);
+    }
+    resolveDiagramType(sessionId) {
+        if (!sessionId) {
+            throw new server_2.McpToolError('Either `diagramType` or `sessionId` must be provided.');
+        }
+        const session = this.clientSessionManager.getSession(sessionId);
+        if (!session) {
+            throw new server_2.McpToolError(`Unknown sessionId: ${sessionId}`);
+        }
+        return session.diagramType;
+    }
+    getElementTypes(diagramType) {
+        let types = this.cache.get(diagramType);
+        if (!types) {
+            types = this.harvestElementTypes(diagramType);
+            this.cache.set(diagramType, types);
+        }
+        return types;
+    }
+    /** Runs session-open initializers on a throwaway container so registries (e.g. `OperationHandlerRegistry`) are populated for the provider to scrape. */
+    harvestElementTypes(diagramType) {
+        const modules = this.diagramModules.get(diagramType);
+        if (!modules) {
+            throw new server_2.McpToolError(`Unknown diagram type: ${diagramType}`);
+        }
+        const tempContainer = this.serverContainer.createChild();
+        try {
+            const placeholderSessionModule = (0, server_1.createClientSessionModule)({
+                clientId: 'mcp-element-types-temp',
+                glspClient: { process: () => { } },
+                clientActionKinds: []
+            });
+            tempContainer.load(...modules, placeholderSessionModule);
+            const initializers = tempContainer.getAll(server_1.ClientSessionInitializer);
+            initializers.forEach(initializer => initializer.initialize());
+            return tempContainer.get(element_types_provider_1.ElementTypesProvider).get();
+        }
+        finally {
+            tempContainer.unbindAll();
+        }
+    }
+};
+exports.ElementTypesMcpToolHandler = ElementTypesMcpToolHandler;
+ElementTypesMcpToolHandler.NAME = 'element-types';
+__decorate([
+    (0, inversify_1.inject)(server_1.DiagramModules),
+    __metadata("design:type", Map)
+], ElementTypesMcpToolHandler.prototype, "diagramModules", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.InjectionContainer),
+    __metadata("design:type", inversify_1.Container)
+], ElementTypesMcpToolHandler.prototype, "serverContainer", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], ElementTypesMcpToolHandler.prototype, "clientSessionManager", void 0);
+exports.ElementTypesMcpToolHandler = ElementTypesMcpToolHandler = ElementTypesMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], ElementTypesMcpToolHandler);
+//# sourceMappingURL=element-types-mcp-tool-handler.js.map

package/lib/tools/handlers/element-types-mcp-tool-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-types-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/element-types-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAM8B;AAC9B,yCAA2E;AAC3E,4BAA4B;AAC5B,yCAAmF;AACnF,4FAAqG;AAExF,QAAA,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;IAClI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;CACzI,CAAC,CAAC;AAGH;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,CAAC;KAClC,MAAM,CAAC;IACJ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IACzF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;IACpG,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC3F,WAAW,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,6GAA6G,CAAC;CAC/H,CAAC;KACD,KAAK,EAAE,CAAC;AAEA,QAAA,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC;CAC7C,CAAC,CAAC;AAEH;;;;;;;;GAQG;AAEI,IAAM,0BAA0B,kCAAhC,MAAM,0BAA2B,SAAQ,+BAAyC;IAAlF;;QAMM,SAAI,GAAG,4BAA0B,CAAC,IAAI,CAAC;QAC9B,UAAK,GAAG,yBAAyB,CAAC;QAC3C,gBAAW,GAChB,4FAA4F;YAC5F,+FAA+F;YAC/F,+FAA+F;YAC/F,oFAAoF,CAAC;QAChF,gBAAW,GAAG,+BAAuB,CAAC;QAC7B,iBAAY,GAAG,gCAAwB,CAAC;QAEvC,UAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAmE/D,CAAC;IAjEa,YAAY,CAAC,EAAE,SAAS,EAAE,WAAW,EAAqB;QAChE,MAAM,QAAQ,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YAC5E,WAAW,EAAE,QAAQ;YACrB,SAAS;YACT,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,gFAAgF;IACtE,qBAAqB,CAC3B,WAAmB,EACnB,SAAoC,EACpC,SAAoC;QAEpC,OAAO,CACH,iBAAiB,WAAW,MAAM,SAAS,CAAC,MAAM,kBAAkB,SAAS,CAAC,MAAM,iBAAiB;YACrG,sCAAsC;YACtC,iBAAiB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI;YAC5E,iBAAiB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC7E,CAAC;IACN,CAAC;IAES,kBAAkB,CAAC,SAA6B;QACtD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,qBAAY,CAAC,uDAAuD,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,qBAAY,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC;IAC/B,CAAC;IAES,eAAe,CAAC,WAAmB;QACzC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,wJAAwJ;IAC9I,mBAAmB,CAAC,WAAmB;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,qBAAY,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QACzD,IAAI,CAAC;YACD,MAAM,wBAAwB,GAAG,IAAA,kCAAyB,EAAC;gBACvD,QAAQ,EAAE,wBAAwB;gBAClC,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;gBACjC,iBAAiB,EAAE,EAAE;aACxB,CAAC,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,wBAAwB,CAAC,CAAC;YACzD,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAA2B,iCAAwB,CAAC,CAAC;YAC9F,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9D,OAAO,aAAa,CAAC,GAAG,CAAuB,6CAAoB,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/E,CAAC;gBAAS,CAAC;YACP,aAAa,CAAC,SAAS,EAAE,CAAC;QAC9B,CAAC;IACL,CAAC;;AAlFQ,gEAA0B;AAKnB,+BAAI,GAAG,eAAe,AAAlB,CAAmB;AAJL;IAAjC,IAAA,kBAAM,EAAC,uBAAc,CAAC;8BAA2B,GAAG;kEAA4B;AAC3C;IAArC,IAAA,kBAAM,EAAC,2BAAkB,CAAC;8BAA4B,qBAAS;mEAAC;AACzB;IAAvC,IAAA,kBAAM,EAAC,6BAAoB,CAAC;;wEAAsD;qCAH1E,0BAA0B;IADtC,IAAA,sBAAU,GAAE;GACA,0BAA0B,CAmFtC"}

package/lib/tools/handlers/get-selection-mcp-tool-handler.d.ts

@@ -0,0 +1,43 @@
+/********************************************************************************
+ * 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 { ActionDispatcher } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { AbstractMcpDiagramToolHandler, McpToolResult } from '../../server';
+export declare const GetSelectionInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, z.core.$strip>;
+export type GetSelectionInput = z.infer<typeof GetSelectionInputSchema>;
+export declare const GetSelectionOutputSchema: z.ZodObject<{
+    selectedElementIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Round-trips a sprotty {@link GetSelectionAction} via `ActionDispatcher.requestUntil` and awaits the matching `SelectionResult`. */
+export declare class GetSelectionMcpToolHandler extends AbstractMcpDiagramToolHandler<GetSelectionInput> {
+    /** Timeout (in ms) for awaiting the selection response from the client. Override via subclass + rebind. */
+    protected readonly timeoutMs: number;
+    static readonly NAME = "get-selection";
+    readonly name = "get-selection";
+    readonly title = "Get Selected Diagram Elements";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        selectedElementIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    protected actionDispatcher: ActionDispatcher;
+    protected createResult(_params: GetSelectionInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=get-selection-mcp-tool-handler.d.ts.map

package/lib/tools/handlers/get-selection-mcp-tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-selection-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/get-selection-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,gBAAgB,EAAsB,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA+B,6BAA6B,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAE9H,eAAO,MAAM,uBAAuB;;iBAA8B,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,sIAAsI;AACtI,qBACa,0BAA2B,SAAQ,6BAA6B,CAAC,iBAAiB,CAAC;IAC5F,2GAA2G;IAC3G,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAQ;IAE5C,MAAM,CAAC,QAAQ,CAAC,IAAI,mBAAmB;IACvC,QAAQ,CAAC,IAAI,mBAAmC;IAChD,SAAkB,KAAK,mCAAmC;IAC1D,QAAQ,CAAC,WAAW,SAIkC;IACtD,QAAQ,CAAC,WAAW;;sBAA2B;IAC/C,SAAkB,YAAY;;sBAA4B;IAEhC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;cAEvD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;CAMnF"}

package/lib/tools/handlers/get-selection-mcp-tool-handler.js

@@ -0,0 +1,68 @@
+"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 GetSelectionMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSelectionMcpToolHandler = exports.GetSelectionOutputSchema = exports.GetSelectionInputSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const server_2 = require("../../server");
+exports.GetSelectionInputSchema = server_2.McpDiagramScopedInputSchema;
+exports.GetSelectionOutputSchema = z.object({
+    selectedElementIds: z.array(z.string()).describe('Aliased ids of the elements currently selected on the client.')
+});
+/** Round-trips a sprotty {@link GetSelectionAction} via `ActionDispatcher.requestUntil` and awaits the matching `SelectionResult`. */
+let GetSelectionMcpToolHandler = GetSelectionMcpToolHandler_1 = class GetSelectionMcpToolHandler extends server_2.AbstractMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        /** Timeout (in ms) for awaiting the selection response from the client. Override via subclass + rebind. */
+        this.timeoutMs = 5000;
+        this.name = GetSelectionMcpToolHandler_1.NAME;
+        this.title = 'Get Selected Diagram Elements';
+        this.description = 'Get the element IDs of all elements currently selected in the user-facing diagram UI. ' +
+            'Use this only when the user explicitly references their selection ("the selected node", "what I have highlighted"); ' +
+            'do not call it speculatively. Pairs with `set-selection` for write-side selection control. ' +
+            'Returns an empty list when nothing is selected.';
+        this.inputSchema = exports.GetSelectionInputSchema;
+        this.outputSchema = exports.GetSelectionOutputSchema;
+    }
+    async createResult(_params) {
+        const response = await (0, server_2.requestActionOrFail)(this.actionDispatcher, server_1.GetSelectionAction.create(), this.timeoutMs, this.name);
+        const selectedElementIds = this.encodeIds(response.selectedElementsIDs);
+        const selectedIdsStr = selectedElementIds.map(id => `- ${id}`).join('\n');
+        return this.success(`Following element IDs are selected:\n${selectedIdsStr}`, { selectedElementIds });
+    }
+};
+exports.GetSelectionMcpToolHandler = GetSelectionMcpToolHandler;
+GetSelectionMcpToolHandler.NAME = 'get-selection';
+__decorate([
+    (0, inversify_1.inject)(server_1.ActionDispatcher),
+    __metadata("design:type", Object)
+], GetSelectionMcpToolHandler.prototype, "actionDispatcher", void 0);
+exports.GetSelectionMcpToolHandler = GetSelectionMcpToolHandler = GetSelectionMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], GetSelectionMcpToolHandler);
+//# sourceMappingURL=get-selection-mcp-tool-handler.js.map

package/lib/tools/handlers/get-selection-mcp-tool-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-selection-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/get-selection-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAA4E;AAC5E,yCAA+C;AAC/C,4BAA4B;AAC5B,yCAA8H;AAEjH,QAAA,uBAAuB,GAAG,oCAA2B,CAAC;AAGtD,QAAA,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACpH,CAAC,CAAC;AAEH,sIAAsI;AAE/H,IAAM,0BAA0B,kCAAhC,MAAM,0BAA2B,SAAQ,sCAAgD;IAAzF;;QACH,2GAA2G;QACxF,cAAS,GAAW,IAAI,CAAC;QAGnC,SAAI,GAAG,4BAA0B,CAAC,IAAI,CAAC;QAC9B,UAAK,GAAG,+BAA+B,CAAC;QACjD,gBAAW,GAChB,wFAAwF;YACxF,sHAAsH;YACtH,6FAA6F;YAC7F,iDAAiD,CAAC;QAC7C,gBAAW,GAAG,+BAAuB,CAAC;QAC7B,iBAAY,GAAG,gCAAwB,CAAC;IAU9D,CAAC;IANa,KAAK,CAAC,YAAY,CAAC,OAA0B;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAmB,EAAC,IAAI,CAAC,gBAAgB,EAAE,2BAAkB,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1H,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QACxE,MAAM,cAAc,GAAG,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,wCAAwC,cAAc,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC1G,CAAC;;AAtBQ,gEAA0B;AAInB,+BAAI,GAAG,eAAe,AAAlB,CAAmB;AAWH;IAAnC,IAAA,kBAAM,EAAC,yBAAgB,CAAC;;oEAA8C;qCAf9D,0BAA0B;IADtC,IAAA,sBAAU,GAAE;GACA,0BAA0B,CAuBtC"}

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

@@ -0,0 +1,43 @@
+/********************************************************************************
+ * 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 { LayoutEngine } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { McpToolResult, OperationMcpDiagramToolHandler } from '../../server';
+export declare const LayoutInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, z.core.$strip>;
+export type LayoutInput = z.infer<typeof LayoutInputSchema>;
+export declare const LayoutOutputSchema: z.ZodObject<{
+    applied: z.ZodBoolean;
+}, z.core.$strip>;
+/** Not registered by default: requires an adopter-supplied `LayoutEngine` to bind, which only some GLSP servers ship. */
+export declare class LayoutMcpToolHandler extends OperationMcpDiagramToolHandler<LayoutInput> {
+    static readonly NAME = "layout";
+    readonly name = "layout";
+    readonly title = "Auto-Layout Diagram";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        applied: z.ZodBoolean;
+    }, z.core.$strip>;
+    protected layoutEngine?: LayoutEngine;
+    /** Skip-bind when no `LayoutEngine` is bound — every dispatch would otherwise no-op. */
+    canRegister(): boolean;
+    protected createResult(_params: LayoutInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=layout-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/layout-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAErE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA+B,aAAa,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE1G,eAAO,MAAM,iBAAiB;;iBAA8B,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,yHAAyH;AACzH,qBACa,oBAAqB,SAAQ,8BAA8B,CAAC,WAAW,CAAC;IACjF,MAAM,CAAC,QAAQ,CAAC,IAAI,YAAY;IAChC,QAAQ,CAAC,IAAI,YAA6B;IAC1C,SAAkB,KAAK,yBAAyB;IAChD,QAAQ,CAAC,WAAW,SAM+D;IACnF,QAAQ,CAAC,WAAW;;sBAAqB;IACzC,SAAkB,YAAY;;sBAAsB;IAElB,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAExE,wFAAwF;IAC/E,WAAW,IAAI,OAAO;cAIf,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAI7E"}

package/lib/tools/handlers/layout-mcp-tool-handler.js

@@ -0,0 +1,71 @@
+"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 LayoutMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutMcpToolHandler = exports.LayoutOutputSchema = exports.LayoutInputSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const server_2 = require("../../server");
+exports.LayoutInputSchema = server_2.McpDiagramScopedInputSchema;
+exports.LayoutOutputSchema = z.object({
+    applied: z.boolean().describe('Always true on success — surfaced for parity with other operations.')
+});
+/** Not registered by default: requires an adopter-supplied `LayoutEngine` to bind, which only some GLSP servers ship. */
+let LayoutMcpToolHandler = LayoutMcpToolHandler_1 = class LayoutMcpToolHandler extends server_2.OperationMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = LayoutMcpToolHandler_1.NAME;
+        this.title = 'Auto-Layout Diagram';
+        this.description = "Trigger automatic layout computation for the given session's diagram, repositioning all nodes and " +
+            'rerouting all edges according to the configured layout engine. ' +
+            'Use this only when the user explicitly asks for "automatic layout" or similar — it overwrites every ' +
+            'manual position in the diagram and is generally a destructive change for hand-tuned layouts. ' +
+            'For targeted positional edits prefer `modify-nodes` / `modify-edges`. ' +
+            'Adopters who do not bind a `LayoutEngine` will not see this tool registered.';
+        this.inputSchema = exports.LayoutInputSchema;
+        this.outputSchema = exports.LayoutOutputSchema;
+    }
+    /** Skip-bind when no `LayoutEngine` is bound — every dispatch would otherwise no-op. */
+    canRegister() {
+        return this.layoutEngine !== undefined;
+    }
+    async createResult(_params) {
+        await this.actionDispatcher.dispatch(server_1.LayoutOperation.create());
+        return this.success('Automatic layout applied', { applied: true });
+    }
+};
+exports.LayoutMcpToolHandler = LayoutMcpToolHandler;
+LayoutMcpToolHandler.NAME = 'layout';
+__decorate([
+    (0, inversify_1.inject)(server_1.LayoutEngine),
+    (0, inversify_1.optional)(),
+    __metadata("design:type", Object)
+], LayoutMcpToolHandler.prototype, "layoutEngine", void 0);
+exports.LayoutMcpToolHandler = LayoutMcpToolHandler = LayoutMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], LayoutMcpToolHandler);
+//# sourceMappingURL=layout-mcp-tool-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/layout-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAAqE;AACrE,yCAAyD;AACzD,4BAA4B;AAC5B,yCAA0G;AAE7F,QAAA,iBAAiB,GAAG,oCAA2B,CAAC;AAGhD,QAAA,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CACvG,CAAC,CAAC;AAEH,yHAAyH;AAElH,IAAM,oBAAoB,4BAA1B,MAAM,oBAAqB,SAAQ,uCAA2C;IAA9E;;QAEM,SAAI,GAAG,sBAAoB,CAAC,IAAI,CAAC;QACxB,UAAK,GAAG,qBAAqB,CAAC;QACvC,gBAAW,GAChB,oGAAoG;YACpG,iEAAiE;YACjE,sGAAsG;YACtG,+FAA+F;YAC/F,wEAAwE;YACxE,8EAA8E,CAAC;QAC1E,gBAAW,GAAG,yBAAiB,CAAC;QACvB,iBAAY,GAAG,0BAAkB,CAAC;IAaxD,CAAC;IATG,wFAAwF;IAC/E,WAAW;QAChB,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;IAC3C,CAAC;IAES,KAAK,CAAC,YAAY,CAAC,OAAoB;QAC7C,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,wBAAe,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;;AAxBQ,oDAAoB;AACb,yBAAI,GAAG,QAAQ,AAAX,CAAY;AAaY;IAA3C,IAAA,kBAAM,EAAC,qBAAY,CAAC;IAAE,IAAA,oBAAQ,GAAE;;0DAAuC;+BAd/D,oBAAoB;IADhC,IAAA,sBAAU,GAAE;GACA,oBAAoB,CAyBhC"}

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

@@ -0,0 +1,78 @@
+/********************************************************************************
+ * 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 edge-modification entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+export declare const ModifyEdgeSpecSchema: z.ZodObject<{
+    elementId: z.ZodString;
+    sourceElementId: z.ZodOptional<z.ZodString>;
+    targetElementId: z.ZodOptional<z.ZodString>;
+    routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const ModifyEdgesInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    edges: z.ZodArray<z.ZodObject<{
+        elementId: z.ZodString;
+        sourceElementId: z.ZodOptional<z.ZodString>;
+        targetElementId: z.ZodOptional<z.ZodString>;
+        routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type ModifyEdgesInput = z.infer<typeof ModifyEdgesInputSchema>;
+export declare const ModifyEdgesOutputSchema: z.ZodObject<{
+    modifiedEdges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementTypeId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    dispatchedCommands: z.ZodNumber;
+    errors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare class ModifyEdgesMcpToolHandler extends OperationMcpDiagramToolHandler<ModifyEdgesInput> {
+    static readonly NAME = "modify-edges";
+    readonly name = "modify-edges";
+    readonly title = "Modify Diagram Edges";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        edges: z.ZodArray<z.ZodObject<{
+            elementId: z.ZodString;
+            sourceElementId: z.ZodOptional<z.ZodString>;
+            targetElementId: z.ZodOptional<z.ZodString>;
+            routingPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        modifiedEdges: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            elementTypeId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        dispatchedCommands: z.ZodNumber;
+        errors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    protected createResult({ edges }: ModifyEdgesInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=modify-edges-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modify-edges-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/modify-edges-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAIlF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAIH,aAAa,EACb,8BAA8B,EAGjC,MAAM,cAAc,CAAC;AAGtB,sIAAsI;AACtI,eAAO,MAAM,oBAAoB;;;;;;;;kBAW/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;iBAIlC,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,SAM8C;IAClE,QAAQ,CAAC,WAAW;;;;;;;;;;;sBAA0B;IAC9C,SAAkB,YAAY;;;;;;;;sBAA2B;cAEzC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CA0EpF"}

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

@@ -0,0 +1,136 @@
+"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 ModifyEdgesMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifyEdgesMcpToolHandler = exports.ModifyEdgesOutputSchema = exports.ModifyEdgesInputSchema = exports.ModifyEdgeSpecSchema = 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-modification entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+exports.ModifyEdgeSpecSchema = z.strictObject({
+    elementId: server_2.elementId,
+    sourceElementId: z.string().optional().describe('ID of the source element (must exist in the diagram)'),
+    targetElementId: z.string().optional().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. ' +
+        'Using an empty array removes all routing points.')
+});
+exports.ModifyEdgesInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    edges: z
+        .array(exports.ModifyEdgeSpecSchema)
+        .min(1)
+        .describe('Array of edge changes — each entry needs `elementId` plus the fields to update. Must include at least one change.')
+});
+exports.ModifyEdgesOutputSchema = z.object({
+    modifiedEdges: z.array(server_2.ElementIdentitySchema).describe('Identity of each edge whose change request was dispatched.'),
+    dispatchedCommands: z.number().int().describe('Number of underlying GLSP operations dispatched.'),
+    errors: z.array(z.string()).describe('Per-input failure messages; absent or empty when every input succeeded.')
+});
+let ModifyEdgesMcpToolHandler = ModifyEdgesMcpToolHandler_1 = class ModifyEdgesMcpToolHandler extends server_2.OperationMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = ModifyEdgesMcpToolHandler_1.NAME;
+        this.title = 'Modify Diagram Edges';
+        this.description = 'Modify one or more existing edges by reconnecting their source/target endpoints or rewriting their routing points. ' +
+            'Reconnection (provide both `sourceElementId` and `targetElementId`) and routing-point edits are mutually exclusive ' +
+            'per change entry — a reconnect recomputes the path from scratch and ignores `routingPoints`. ' +
+            'Pass an empty `routingPoints` array to remove all routing points (snap to a straight line). ' +
+            'This operation modifies the diagram state and requires user approval. ' +
+            'For nodes (position/size/text), use `modify-nodes` instead.';
+        this.inputSchema = exports.ModifyEdgesInputSchema;
+        this.outputSchema = exports.ModifyEdgesOutputSchema;
+    }
+    async createResult({ edges }) {
+        const elements = this.lookupElements(edges, change => change.elementId);
+        // Type-validate so non-edge ids surface a clear error instead of "model element not found"
+        // from the dispatched operation handler. Aliases are sequential across all element kinds,
+        // so an LLM passing an arbitrary id may hit a node here.
+        const wrongType = elements
+            .filter(([, element]) => !(element instanceof server_1.GEdge))
+            .map(([change, element]) => `'${change.elementId}' (type '${element.type}')`);
+        if (wrongType.length) {
+            throw new server_2.McpToolError(`modify-edges accepts edges only — got: ${wrongType.join(', ')}. Use modify-nodes for nodes.`);
+        }
+        // Dispatch in parallel via `allSettled` so one failed edge surfaces in `errors`
+        // instead of rejecting the whole call and losing the other outcomes.
+        const dispatched = [];
+        const errors = [];
+        const modifiedRealIds = new Set();
+        elements.forEach(([change]) => {
+            const { routingPoints } = change;
+            const realId = this.aliasService.lookup(change.elementId);
+            const sourceElementId = change.sourceElementId ? this.aliasService.lookup(change.sourceElementId) : undefined;
+            const targetElementId = change.targetElementId ? this.aliasService.lookup(change.targetElementId) : undefined;
+            if ((sourceElementId && !targetElementId) || (!sourceElementId && targetElementId)) {
+                errors.push(`Both source and target ID are required for input: ${JSON.stringify(change)}`);
+                return;
+            }
+            if (sourceElementId && targetElementId) {
+                const source = this.modelState.index.find(sourceElementId);
+                if (!source) {
+                    errors.push(`Source element not found: ${sourceElementId}`);
+                    return;
+                }
+                const target = this.modelState.index.find(targetElementId);
+                if (!target) {
+                    errors.push(`Target element not found: ${targetElementId}`);
+                    return;
+                }
+                const operation = server_1.ReconnectEdgeOperation.create({ edgeElementId: realId, sourceElementId, targetElementId });
+                dispatched.push({ promise: this.actionDispatcher.dispatch(operation), realId, inputId: change.elementId });
+                modifiedRealIds.add(realId);
+                // Routing-point changes are skipped during a reconnect — the edge's path is recomputed from scratch.
+                return;
+            }
+            if (routingPoints) {
+                const operation = server_1.ChangeRoutingPointsOperation.create([{ elementId: realId, newRoutingPoints: routingPoints }]);
+                dispatched.push({ promise: this.actionDispatcher.dispatch(operation), realId, inputId: change.elementId });
+                modifiedRealIds.add(realId);
+            }
+        });
+        const results = await Promise.allSettled(dispatched.map(entry => entry.promise));
+        results.forEach((result, i) => {
+            if (result.status === 'rejected') {
+                const { realId, inputId } = dispatched[i];
+                const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                errors.push(`Failed to modify edge '${inputId}': ${reason}`);
+                // The dispatch failed, so this id was *not* modified — drop it from the success list.
+                modifiedRealIds.delete(realId);
+            }
+        });
+        const modifiedEdges = [...modifiedRealIds]
+            .map(realId => this.describeElement(realId))
+            .filter((entry) => entry !== undefined);
+        return this.success(`Successfully modified ${edges.length - errors.length} edge(s) (in ${dispatched.length} commands)${(0, util_1.formatNoticeList)('errors', errors)}`, { modifiedEdges, dispatchedCommands: dispatched.length, errors });
+    }
+};
+exports.ModifyEdgesMcpToolHandler = ModifyEdgesMcpToolHandler;
+ModifyEdgesMcpToolHandler.NAME = 'modify-edges';
+exports.ModifyEdgesMcpToolHandler = ModifyEdgesMcpToolHandler = ModifyEdgesMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], ModifyEdgesMcpToolHandler);
+//# sourceMappingURL=modify-edges-mcp-tool-handler.js.map