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

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

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

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

@@ -0,0 +1,92 @@
+/********************************************************************************
+ * 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';
+/** Strict — any unknown field on the size object surfaces as a validation error. */
+export declare const NodeSizeSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+/** Single node-modification entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+export declare const ModifyNodeSpecSchema: z.ZodObject<{
+    elementId: z.ZodString;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    size: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const ModifyNodesInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    nodes: z.ZodArray<z.ZodObject<{
+        elementId: z.ZodString;
+        position: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strict>>;
+        size: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type ModifyNodesInput = z.infer<typeof ModifyNodesInputSchema>;
+export declare const ModifyNodesOutputSchema: z.ZodObject<{
+    modifiedNodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementTypeId: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    dispatchedCommands: z.ZodNumber;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare class ModifyNodesMcpToolHandler extends OperationMcpDiagramToolHandler<ModifyNodesInput> {
+    static readonly NAME = "modify-nodes";
+    readonly name = "modify-nodes";
+    readonly title = "Modify Diagram Nodes";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        nodes: z.ZodArray<z.ZodObject<{
+            elementId: z.ZodString;
+            position: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+            size: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        modifiedNodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            elementTypeId: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        dispatchedCommands: z.ZodNumber;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    protected createResult({ nodes }: ModifyNodesInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=modify-nodes-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modify-nodes-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/modify-nodes-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,oFAAoF;AACpF,eAAO,MAAM,cAAc;;;kBAGzB,CAAC;AAEH,sIAAsI;AACtI,eAAO,MAAM,oBAAoB;;;;;;;;;;;kBAK/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;;;;;;;;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,SAMsD;IAC1E,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;sBAA0B;IAC9C,SAAkB,YAAY;;;;;;;;sBAA2B;cAEzC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CA4DpF"}

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

@@ -0,0 +1,125 @@
+"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 ModifyNodesMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifyNodesMcpToolHandler = exports.ModifyNodesOutputSchema = exports.ModifyNodesInputSchema = exports.ModifyNodeSpecSchema = exports.NodeSizeSchema = 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");
+/** Strict — any unknown field on the size object surfaces as a validation error. */
+exports.NodeSizeSchema = z.strictObject({
+    width: z.number().positive().describe('Width of the element in diagram space (must be > 0).'),
+    height: z.number().positive().describe('Height of the element in diagram space (must be > 0).')
+});
+/** Single node-modification entry. Strict so an LLM-typoed field surfaces as a validation error instead of being silently dropped. */
+exports.ModifyNodeSpecSchema = z.strictObject({
+    elementId: server_2.elementId,
+    position: server_2.position.optional().describe('Position where the node should be moved to (absolute diagram coordinates)'),
+    size: exports.NodeSizeSchema.optional().describe('New size of the node'),
+    text: z.string().optional().describe("Label text to use instead (given that the element's type allows for labels).")
+});
+exports.ModifyNodesInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    nodes: z
+        .array(exports.ModifyNodeSpecSchema)
+        .min(1)
+        .describe('Array of node changes — each entry needs `elementId` plus the fields to update. Must include at least one change.')
+});
+exports.ModifyNodesOutputSchema = z.object({
+    modifiedNodes: z
+        .array(server_2.ElementIdentitySchema)
+        .describe('Identity of each node whose change request was dispatched (post-modification labels).'),
+    dispatchedCommands: z.number().int().describe('Number of underlying GLSP operations dispatched (a single change may yield several).'),
+    warnings: z
+        .array(z.string())
+        .describe('Soft notices for inputs whose change applied with caveats (e.g. `text` supplied for a node whose type has no editable label).')
+});
+let ModifyNodesMcpToolHandler = ModifyNodesMcpToolHandler_1 = class ModifyNodesMcpToolHandler extends server_2.OperationMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = ModifyNodesMcpToolHandler_1.NAME;
+        this.title = 'Modify Diagram Nodes';
+        this.description = 'Modify one or more existing nodes by changing their position, size, and/or label text. ' +
+            'When modifying position or size, absolutely consider the visual alignment with other nodes — ' +
+            'use `query-elements` (inspect mode) first to understand the layout. ' +
+            'Each change entry can include any combination of `position`, `size`, and `text`; omitted fields keep their current value. ' +
+            'This operation modifies the diagram state and requires user approval. ' +
+            'For edges (reconnect / routing-points), use `modify-edges` instead.';
+        this.inputSchema = exports.ModifyNodesInputSchema;
+        this.outputSchema = exports.ModifyNodesOutputSchema;
+    }
+    async createResult({ nodes }) {
+        const elements = this.lookupElements(nodes, change => change.elementId);
+        // Reject edge ids — they have no `position`/`size` semantics and would fail downstream
+        // with a misleading "model element not found" error from the operation handler. Aliases
+        // are sequential across all element kinds, so an LLM passing an arbitrary id may hit an edge.
+        const wrongType = elements.filter(([, element]) => element instanceof server_1.GEdge).map(([change]) => `'${change.elementId}'`);
+        if (wrongType.length) {
+            throw new server_2.McpToolError(`modify-nodes does not accept edges — got: ${wrongType.join(', ')}. Use modify-edges for edges.`);
+        }
+        // Reject any other non-shape kinds (labels, compartments, ports, custom kinds) — they
+        // reach the index too and would silently produce no-op or undefined-bounds operations.
+        const nonShape = elements.filter(([, element]) => !(element instanceof server_1.GShapeElement)).map(([change]) => `'${change.elementId}'`);
+        if (nonShape.length) {
+            throw new server_2.McpToolError(`modify-nodes only accepts shape elements — got: ${nonShape.join(', ')}. ` +
+                'Use `query-elements` (inspect mode) to find shape ids, or pick the parent shape.');
+        }
+        // Modifications are independent of each other — dispatch in parallel.
+        const promises = [];
+        const warnings = [];
+        elements.forEach(([change, element]) => {
+            var _a;
+            // Guaranteed non-null and shape-typed by the missing-elements / nonShape checks above.
+            const resolved = element;
+            const { size, position, text } = change;
+            const realId = this.aliasService.lookup(change.elementId);
+            if (size || position) {
+                const newSize = size !== null && size !== void 0 ? size : resolved.size;
+                const newPosition = position !== null && position !== void 0 ? position : resolved.position;
+                const operation = server_1.ChangeBoundsOperation.create([{ elementId: realId, newSize, newPosition }]);
+                promises.push(this.actionDispatcher.dispatch(operation));
+            }
+            if (text) {
+                const labelId = (_a = this.labelProvider.getLabel(resolved)) === null || _a === void 0 ? void 0 : _a.id;
+                if (labelId) {
+                    promises.push(this.actionDispatcher.dispatch(server_1.ApplyLabelEditOperation.create({ labelId, text })));
+                }
+                else {
+                    warnings.push(`Ignored \`text\` for '${change.elementId}' (type '${resolved.type}') — this element has no editable label.`);
+                }
+            }
+        });
+        await Promise.all(promises);
+        const modifiedNodes = nodes
+            .map(change => this.describeElement(change.elementId))
+            .filter((entry) => entry !== undefined);
+        return this.success(`Successfully modified ${nodes.length} node(s) (in ${promises.length} commands)` + (0, util_1.formatNoticeList)('warnings', warnings), { modifiedNodes, dispatchedCommands: promises.length, warnings });
+    }
+};
+exports.ModifyNodesMcpToolHandler = ModifyNodesMcpToolHandler;
+ModifyNodesMcpToolHandler.NAME = 'modify-nodes';
+exports.ModifyNodesMcpToolHandler = ModifyNodesMcpToolHandler = ModifyNodesMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], ModifyNodesMcpToolHandler);
+//# sourceMappingURL=modify-nodes-mcp-tool-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modify-nodes-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/modify-nodes-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;AAElF,iDAA4G;AAC5G,yCAAuC;AACvC,4BAA4B;AAC5B,yCAQsB;AACtB,qCAA8C;AAE9C,oFAAoF;AACvE,QAAA,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC7F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;CAClG,CAAC,CAAC;AAEH,sIAAsI;AACzH,QAAA,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,SAAS,EAAT,kBAAS;IACT,QAAQ,EAAE,iBAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IACnH,IAAI,EAAE,sBAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;CACvH,CAAC,CAAC;AAEU,QAAA,sBAAsB,GAAG,oCAA2B,CAAC,MAAM,CAAC;IACrE,KAAK,EAAE,CAAC;SACH,KAAK,CAAC,4BAAoB,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mHAAmH,CAAC;CACrI,CAAC,CAAC;AAGU,QAAA,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,aAAa,EAAE,CAAC;SACX,KAAK,CAAC,8BAAqB,CAAC;SAC5B,QAAQ,CAAC,uFAAuF,CAAC;IACtG,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;IACrI,QAAQ,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACL,+HAA+H,CAClI;CACR,CAAC,CAAC;AAGI,IAAM,yBAAyB,iCAA/B,MAAM,yBAA0B,SAAQ,uCAAgD;IAAxF;;QAEM,SAAI,GAAG,2BAAyB,CAAC,IAAI,CAAC;QAC7B,UAAK,GAAG,sBAAsB,CAAC;QACxC,gBAAW,GAChB,yFAAyF;YACzF,+FAA+F;YAC/F,sEAAsE;YACtE,4HAA4H;YAC5H,wEAAwE;YACxE,qEAAqE,CAAC;QACjE,gBAAW,GAAG,8BAAsB,CAAC;QAC5B,iBAAY,GAAG,+BAAuB,CAAC;IA8D7D,CAAC;IA5Da,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,EAAoB;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAExE,uFAAuF;QACvF,wFAAwF;QACxF,8FAA8F;QAC9F,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,YAAY,cAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QACxH,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,qBAAY,CAAC,6CAA6C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC7H,CAAC;QAED,sFAAsF;QACtF,uFAAuF;QACvF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,YAAY,sBAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QAClI,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,qBAAY,CAClB,mDAAmD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACtE,kFAAkF,CACzF,CAAC;QACN,CAAC;QAED,sEAAsE;QACtE,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;;YACnC,uFAAuF;YACvF,MAAM,QAAQ,GAAG,OAAwB,CAAC;YAC1C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE1D,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,QAAQ,CAAC,IAAI,CAAC;gBACtC,MAAM,WAAW,GAAG,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,QAAQ,CAAC,QAAQ,CAAC;gBAElD,MAAM,SAAS,GAAG,8BAAqB,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;gBAC9F,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,IAAI,EAAE,CAAC;gBACP,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,0CAAE,EAAE,CAAC;gBAC1D,IAAI,OAAO,EAAE,CAAC;oBACV,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,gCAAuB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACrG,CAAC;qBAAM,CAAC;oBACJ,QAAQ,CAAC,IAAI,CACT,yBAAyB,MAAM,CAAC,SAAS,YAAY,QAAQ,CAAC,IAAI,0CAA0C,CAC/G,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE5B,MAAM,aAAa,GAAG,KAAK;aACtB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;aACrD,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,OAAO,CACf,yBAAyB,KAAK,CAAC,MAAM,gBAAgB,QAAQ,CAAC,MAAM,YAAY,GAAG,IAAA,uBAAgB,EAAC,UAAU,EAAE,QAAQ,CAAC,EACzH,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CACnE,CAAC;IACN,CAAC;;AAzEQ,8DAAyB;AAClB,8BAAI,GAAG,cAAc,AAAjB,CAAkB;oCAD7B,yBAAyB;IADrC,IAAA,sBAAU,GAAE;GACA,yBAAyB,CA0ErC"}

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

@@ -0,0 +1,102 @@
+/********************************************************************************
+ * 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 { GModelElement } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { McpModelSerializer } from '../../resources/services/mcp-model-serializer';
+import { AbstractMcpDiagramToolHandler, McpToolResult } from '../../server';
+export declare const QueryElementsInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    elementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labelMatch: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type QueryElementsInput = z.infer<typeof QueryElementsInputSchema>;
+export declare const QueryElementMatchSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `.loose()` lets adopter element types attach extra fields (position, size, …) without widening the schema each time. */
+export declare const DiagramElementSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const QueryElementsOutputSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        list: "list";
+        inspect: "inspect";
+    }>;
+    matches: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    elements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        parentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    expandedFromContainers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** Two-mode element query — list/filter or inspect-by-id, discriminated by `elementIds` presence. */
+export declare class QueryElementsMcpToolHandler extends AbstractMcpDiagramToolHandler<QueryElementsInput> {
+    static readonly NAME = "query-elements";
+    readonly name = "query-elements";
+    readonly title = "Query Diagram Elements";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        elementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labelMatch: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        mode: z.ZodEnum<{
+            list: "list";
+            inspect: "inspect";
+        }>;
+        matches: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        elements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            parentId: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+        expandedFromContainers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    protected serializer: McpModelSerializer;
+    /** List-mode result cap when the call doesn't override `limit`. Override via subclass. */
+    protected readonly defaultLimit: number;
+    protected createResult(params: QueryElementsInput): Promise<McpToolResult>;
+    protected inspect(inputIds: string[]): McpToolResult;
+    /** Builds the LLM-facing summary for inspect mode. Override to customize per-adopter wording. */
+    protected summarizeInspect(elements: GModelElement[], expandedFromContainers: string[]): string;
+    protected list({ types, labelMatch, limit }: QueryElementsInput): McpToolResult;
+    protected renderMarkdown(matches: {
+        id: string;
+        type: string;
+        label?: string;
+    }[], truncated: boolean): string;
+}
+//# sourceMappingURL=query-elements-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-elements-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/query-elements-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAEH,6BAA6B,EAE7B,aAAa,EAEhB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,wBAAwB;;;;;;iBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAEH,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB;;;;iBAMrB,CAAC;AAEb,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAYpC,CAAC;AAEH,qGAAqG;AACrG,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,SAI8E;IAClG,QAAQ,CAAC,WAAW;;;;;;sBAA4B;IAChD,SAAkB,YAAY;;;;;;;;;;;;;;;;;sBAA6B;IAE/B,SAAS,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAErE,0FAA0F;IAC1F,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAO;cAE9B,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhF,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa;IA2BpD,iGAAiG;IACjG,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,MAAM;IAO/F,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,kBAAkB,GAAG,aAAa;IA8B/E,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM;CAKhH"}

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

@@ -0,0 +1,158 @@
+"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 QueryElementsMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryElementsMcpToolHandler = exports.QueryElementsOutputSchema = exports.DiagramElementSchema = exports.QueryElementMatchSchema = exports.QueryElementsInputSchema = void 0;
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const mcp_model_serializer_1 = require("../../resources/services/mcp-model-serializer");
+const server_1 = require("../../server");
+exports.QueryElementsInputSchema = server_1.McpDiagramScopedInputSchema.extend({
+    elementIds: server_1.elementIds
+        .optional()
+        .describe('Inspect-mode trigger. When set, returns rich per-element data and ignores the filter fields. Throws on unknown id.'),
+    types: z.array(z.string()).optional().describe('List-mode type filter. Empty/omitted = any. Ignored when `elementIds` is set.'),
+    labelMatch: z.string().optional().describe('List-mode case-insensitive substring on direct-child `GLabel.text`.'),
+    limit: z.number().int().min(1).max(1000).optional().describe('List-mode cap, 1–1000. Defaults to 100.')
+});
+exports.QueryElementMatchSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    label: z.string().optional()
+});
+/** `.loose()` lets adopter element types attach extra fields (position, size, …) without widening the schema each time. */
+exports.DiagramElementSchema = z
+    .object({
+    id: z.string(),
+    type: z.string(),
+    parentId: z.string().optional()
+})
+    .loose();
+exports.QueryElementsOutputSchema = z.object({
+    mode: z.enum(['list', 'inspect']).describe('Echoes which mode the call ran in.'),
+    matches: z.array(exports.QueryElementMatchSchema).optional().describe('Present in `list` mode: slim id/type/label entries.'),
+    elements: z.array(exports.DiagramElementSchema).optional().describe('Present in `inspect` mode: rich per-element detail.'),
+    truncated: z.boolean().optional().describe('Present in `list` mode: true when more elements matched than `limit`.'),
+    expandedFromContainers: z
+        .array(z.string())
+        .optional()
+        .describe('Present in `inspect` mode when one or more requested ids referred to containers — lists those container ids. ' +
+        'The `elements` array then includes the container plus its descendants.')
+});
+/** Two-mode element query — list/filter or inspect-by-id, discriminated by `elementIds` presence. */
+let QueryElementsMcpToolHandler = QueryElementsMcpToolHandler_1 = class QueryElementsMcpToolHandler extends server_1.AbstractMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = QueryElementsMcpToolHandler_1.NAME;
+        this.title = 'Query Diagram Elements';
+        this.description = 'Find or inspect elements in the session diagram. Pass `elementIds` to inspect specific ' +
+            'elements in detail (rich per-element data). Pass `types` and/or `labelMatch` to search by ' +
+            'filter (slim id/type/label summaries with truncation). Useful as a precursor to the ' +
+            'create/modify/delete tools, and a cheaper alternative to `diagram-model` on large diagrams.';
+        this.inputSchema = exports.QueryElementsInputSchema;
+        this.outputSchema = exports.QueryElementsOutputSchema;
+        /** List-mode result cap when the call doesn't override `limit`. Override via subclass. */
+        this.defaultLimit = 100;
+    }
+    async createResult(params) {
+        return params.elementIds && params.elementIds.length > 0 ? this.inspect(params.elementIds) : this.list(params);
+    }
+    inspect(inputIds) {
+        const { realIds, missingIds } = this.resolveIds(inputIds);
+        if (missingIds.length > 0) {
+            throw new server_1.McpElementsNotFoundError(missingIds);
+        }
+        const elements = realIds.map(id => this.modelState.index.get(id));
+        // Per-input serialize lets us identify which inputs caused expansion: the serializer
+        // walks descendants for containers, so a 1-input call may produce N output entries.
+        // The structural-children check the previous version used overstated this — a leaf node
+        // with a label child counts as having `children.length > 0` but doesn't produce extra
+        // entries because the serializer's adjuster drops labels.
+        const expandedFromContainers = elements
+            .filter(element => {
+            // `serializeStructuredArray` returns an open `Record<string, unknown>` per the
+            // `McpStructuredContent` contract; narrow before reading `.elements.length`.
+            const entries = this.serializer.serializeStructuredArray([element]).elements;
+            return Array.isArray(entries) && entries.length > 1;
+        })
+            .map(element => this.aliasService.alias(element.id));
+        // Serializer's `serializeStructuredArray` already returns `{ elements: [...] }`; spread to keep one source of truth.
+        return this.success(this.summarizeInspect(elements, expandedFromContainers), {
+            mode: 'inspect',
+            ...this.serializer.serializeStructuredArray(elements),
+            ...(expandedFromContainers.length > 0 ? { expandedFromContainers } : {})
+        });
+    }
+    /** Builds the LLM-facing summary for inspect mode. Override to customize per-adopter wording. */
+    summarizeInspect(elements, expandedFromContainers) {
+        const lines = elements.map(element => `- ${this.aliasService.alias(element.id)} (${element.type})`);
+        const expansionNote = expandedFromContainers.length > 0 ? `\nContainer(s) ${expandedFromContainers.join(', ')} expanded to include descendants.` : '';
+        return `Inspected ${elements.length} element(s); full data in structuredContent.\n${lines.join('\n')}${expansionNote}`;
+    }
+    list({ types, labelMatch, limit }) {
+        var _a;
+        const cap = limit !== null && limit !== void 0 ? limit : this.defaultLimit;
+        const typeFilter = types && types.length > 0 ? new Set(types) : undefined;
+        const needle = labelMatch === null || labelMatch === void 0 ? void 0 : labelMatch.toLowerCase();
+        const matches = [];
+        let truncated = false;
+        for (const id of this.modelState.index.allIds()) {
+            const element = this.modelState.index.get(id);
+            if (!element) {
+                continue;
+            }
+            if (typeFilter && !typeFilter.has(element.type)) {
+                continue;
+            }
+            const label = (_a = this.labelProvider.getLabel(element)) === null || _a === void 0 ? void 0 : _a.text;
+            if (needle !== undefined && !(label === null || label === void 0 ? void 0 : label.toLowerCase().includes(needle))) {
+                continue;
+            }
+            if (matches.length >= cap) {
+                truncated = true;
+                break;
+            }
+            matches.push({ id: this.aliasService.alias(element.id), type: element.type, ...(label !== undefined ? { label } : {}) });
+        }
+        const summary = matches.length === 0 ? 'No elements matched the query.' : this.renderMarkdown(matches, truncated);
+        return this.success(summary, { mode: 'list', matches, truncated });
+    }
+    renderMarkdown(matches, truncated) {
+        const rows = matches.map(match => `- ${match.id} (${match.type})${match.label ? ` — "${match.label}"` : ''}`).join('\n');
+        const tail = truncated ? '\n\n_(truncated — increase `limit` or refine filters to see more)_' : '';
+        return `Matched ${matches.length} element${matches.length === 1 ? '' : 's'}:\n${rows}${tail}`;
+    }
+};
+exports.QueryElementsMcpToolHandler = QueryElementsMcpToolHandler;
+QueryElementsMcpToolHandler.NAME = 'query-elements';
+__decorate([
+    (0, inversify_1.inject)(mcp_model_serializer_1.McpModelSerializer),
+    __metadata("design:type", Object)
+], QueryElementsMcpToolHandler.prototype, "serializer", void 0);
+exports.QueryElementsMcpToolHandler = QueryElementsMcpToolHandler = QueryElementsMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], QueryElementsMcpToolHandler);
+//# sourceMappingURL=query-elements-mcp-tool-handler.js.map

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

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

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

@@ -0,0 +1,45 @@
+/********************************************************************************
+ * 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 { CommandStack } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { McpToolResult, OperationMcpDiagramToolHandler } from '../../server';
+export declare const RedoInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    commandsToRedo: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type RedoInput = z.infer<typeof RedoInputSchema>;
+export declare const RedoOutputSchema: z.ZodObject<{
+    commandsRedone: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Redo a given number of the most recent undone actions on the command stack.
+ */
+export declare class RedoMcpToolHandler extends OperationMcpDiagramToolHandler<RedoInput> {
+    static readonly NAME = "redo";
+    readonly name = "redo";
+    readonly title = "Redo Diagram Commands";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        commandsToRedo: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        commandsRedone: z.ZodNumber;
+    }, z.core.$strip>;
+    protected commandStack: CommandStack;
+    protected createResult({ commandsToRedo }: RedoInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=redo-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redo-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/redo-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA6C,aAAa,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAExH,eAAO,MAAM,eAAe;;;iBAE1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH;;GAEG;AACH,qBACa,kBAAmB,SAAQ,8BAA8B,CAAC,SAAS,CAAC;IAC7E,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,QAAQ,CAAC,IAAI,UAA2B;IACxC,SAAkB,KAAK,2BAA2B;IAClD,QAAQ,CAAC,WAAW,SAI8C;IAClE,QAAQ,CAAC,WAAW;;;sBAAmB;IACvC,SAAkB,YAAY;;sBAAoB;IAE5B,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;cAE3C,YAAY,CAAC,EAAE,cAAc,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;CAatF"}