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

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

@@ -0,0 +1,73 @@
+"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 RedoMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedoMcpToolHandler = exports.RedoOutputSchema = exports.RedoInputSchema = 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.RedoInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    commandsToRedo: z.number().min(1).default(1).describe('Number of commands to redo. Defaults to 1 (most recent undone command).')
+});
+exports.RedoOutputSchema = z.object({
+    commandsRedone: z.number().int().describe('Number of previously-undone commands re-applied.')
+});
+/**
+ * Redo a given number of the most recent undone actions on the command stack.
+ */
+let RedoMcpToolHandler = RedoMcpToolHandler_1 = class RedoMcpToolHandler extends server_2.OperationMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = RedoMcpToolHandler_1.NAME;
+        this.title = 'Redo Diagram Commands';
+        this.description = 'Re-apply commands that were previously undone. Defaults to redoing one command — the most recent undo — when ' +
+            '`commandsToRedo` is omitted. Use the same count you passed to `undo` to revert a complete undo cycle. ' +
+            "Throws when there's nothing on the redo stack (e.g. nothing has been undone, or the redo stack was cleared by a " +
+            'subsequent edit). Only do this on an explicit user request.';
+        this.inputSchema = exports.RedoInputSchema;
+        this.outputSchema = exports.RedoOutputSchema;
+    }
+    async createResult({ commandsToRedo }) {
+        if (!this.commandStack.canRedo()) {
+            throw new server_2.McpToolError('Nothing to redo (redo stack is empty; perform an undo first or accept that the redo history was cleared by a subsequent edit).');
+        }
+        for (let i = 0; i < commandsToRedo; i++) {
+            await this.actionDispatcher.dispatch(server_1.RedoAction.create());
+        }
+        return this.success('Redo successful', { commandsRedone: commandsToRedo });
+    }
+};
+exports.RedoMcpToolHandler = RedoMcpToolHandler;
+RedoMcpToolHandler.NAME = 'redo';
+__decorate([
+    (0, inversify_1.inject)(server_1.CommandStack),
+    __metadata("design:type", Object)
+], RedoMcpToolHandler.prototype, "commandStack", void 0);
+exports.RedoMcpToolHandler = RedoMcpToolHandler = RedoMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], RedoMcpToolHandler);
+//# sourceMappingURL=redo-mcp-tool-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redo-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/redo-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAAgE;AAChE,yCAA+C;AAC/C,4BAA4B;AAC5B,yCAAwH;AAE3G,QAAA,eAAe,GAAG,oCAA2B,CAAC,MAAM,CAAC;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yEAAyE,CAAC;CACnI,CAAC,CAAC;AAGU,QAAA,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CAChG,CAAC,CAAC;AAEH;;GAEG;AAEI,IAAM,kBAAkB,0BAAxB,MAAM,kBAAmB,SAAQ,uCAAyC;IAA1E;;QAEM,SAAI,GAAG,oBAAkB,CAAC,IAAI,CAAC;QACtB,UAAK,GAAG,uBAAuB,CAAC;QACzC,gBAAW,GAChB,+GAA+G;YAC/G,wGAAwG;YACxG,kHAAkH;YAClH,6DAA6D,CAAC;QACzD,gBAAW,GAAG,uBAAe,CAAC;QACrB,iBAAY,GAAG,wBAAgB,CAAC;IAiBtD,CAAC;IAba,KAAK,CAAC,YAAY,CAAC,EAAE,cAAc,EAAa;QACtD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,qBAAY,CAClB,gIAAgI,CACnI,CAAC;QACN,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,mBAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;IAC/E,CAAC;;AA1BQ,gDAAkB;AACX,uBAAI,GAAG,MAAM,AAAT,CAAU;AAWE;IAA/B,IAAA,kBAAM,EAAC,qBAAY,CAAC;;wDAAsC;6BAZlD,kBAAkB;IAD9B,IAAA,sBAAU,GAAE;GACA,kBAAkB,CA2B9B"}

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

@@ -0,0 +1,55 @@
+/********************************************************************************
+ * 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, CommandStack } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { AbstractMcpDiagramToolHandler, McpLogger, McpToolResult } from '../../server';
+export declare const SaveModelInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    fileUri: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SaveModelInput = z.infer<typeof SaveModelInputSchema>;
+export declare const SaveModelOutputSchema: z.ZodObject<{
+    saved: z.ZodBoolean;
+    fileUri: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Doesn't extend `OperationMcpDiagramToolHandler` — saving a read-only model is a legitimate adopter scenario (e.g. "save as" to a writable location). */
+export declare class SaveModelMcpToolHandler extends AbstractMcpDiagramToolHandler<SaveModelInput> {
+    static readonly NAME = "save-model";
+    readonly name = "save-model";
+    readonly title = "Save Diagram Model";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        fileUri: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        saved: z.ZodBoolean;
+        fileUri: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    /**
+     * Saving writes to disk — that's a mutation of the environment even though the in-memory
+     * model state isn't a target of an `Operation` dispatch. Drop the readOnly claim from the
+     * read-base default. Not destructive per the spec definition (no irreversible deletion).
+     */
+    readonly readOnlyHint = false;
+    readonly destructiveHint: boolean;
+    readonly idempotentHint: boolean;
+    protected actionDispatcher: ActionDispatcher;
+    protected commandStack: CommandStack;
+    protected mcpLogger: McpLogger;
+    protected createResult({ fileUri }: SaveModelInput): Promise<McpToolResult>;
+}
+//# sourceMappingURL=save-model-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-model-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/save-model-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAEvF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA+B,6BAA6B,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEpH,eAAO,MAAM,oBAAoB;;;iBAE/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;iBAMhC,CAAC;AAEH,2JAA2J;AAC3J,qBACa,uBAAwB,SAAQ,6BAA6B,CAAC,cAAc,CAAC;IACtF,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB;IACpC,QAAQ,CAAC,IAAI,gBAAgC;IAC7C,SAAkB,KAAK,wBAAwB;IAC/C,QAAQ,CAAC,WAAW,SAIoD;IACxE,QAAQ,CAAC,WAAW;;;sBAAwB;IAC5C,SAAkB,YAAY;;;sBAAyB;IACvD;;;;OAIG;IACH,SAAkB,YAAY,SAAS;IACvC,SAAkB,eAAe,EAAE,OAAO,CAAS;IACnD,SAAkB,cAAc,EAAE,OAAO,CAAS;IAExB,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACjD,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACxC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;cAElC,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAUpF"}

package/lib/tools/handlers/save-model-mcp-tool-handler.js

@@ -0,0 +1,91 @@
+"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 SaveModelMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaveModelMcpToolHandler = exports.SaveModelOutputSchema = exports.SaveModelInputSchema = 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.SaveModelInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    fileUri: z.string().optional().describe('Optional destination file URI. If not provided, saves to the original source model location.')
+});
+exports.SaveModelOutputSchema = z.object({
+    saved: z.boolean().describe('True when a save operation was dispatched; false when the model was clean and nothing was written.'),
+    fileUri: z
+        .string()
+        .optional()
+        .describe('Destination file URI when explicitly provided; absent when saving to the original source location.')
+});
+/** Doesn't extend `OperationMcpDiagramToolHandler` — saving a read-only model is a legitimate adopter scenario (e.g. "save as" to a writable location). */
+let SaveModelMcpToolHandler = SaveModelMcpToolHandler_1 = class SaveModelMcpToolHandler extends server_2.AbstractMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = SaveModelMcpToolHandler_1.NAME;
+        this.title = 'Save Diagram Model';
+        this.description = 'Save the current diagram model to persistent storage. ' +
+            'This operation persists all changes back to the source model. ' +
+            'Only do this on an explicit user request and not as part of other tasks. ' +
+            'Optionally specify a new fileUri to save to a different location.';
+        this.inputSchema = exports.SaveModelInputSchema;
+        this.outputSchema = exports.SaveModelOutputSchema;
+        /**
+         * Saving writes to disk — that's a mutation of the environment even though the in-memory
+         * model state isn't a target of an `Operation` dispatch. Drop the readOnly claim from the
+         * read-base default. Not destructive per the spec definition (no irreversible deletion).
+         */
+        this.readOnlyHint = false;
+        this.destructiveHint = false;
+        this.idempotentHint = false;
+    }
+    async createResult({ fileUri }) {
+        if (!this.commandStack.isDirty) {
+            this.mcpLogger.info('save-model: nothing to save');
+            return this.success('No changes to save', { saved: false, fileUri });
+        }
+        await this.actionDispatcher.dispatch(server_1.SaveModelAction.create({ fileUri }));
+        this.mcpLogger.info(`save-model: model saved${fileUri ? ` to ${fileUri}` : ''}`);
+        return this.success('Model saved successfully', { saved: true, fileUri });
+    }
+};
+exports.SaveModelMcpToolHandler = SaveModelMcpToolHandler;
+SaveModelMcpToolHandler.NAME = 'save-model';
+__decorate([
+    (0, inversify_1.inject)(server_1.ActionDispatcher),
+    __metadata("design:type", Object)
+], SaveModelMcpToolHandler.prototype, "actionDispatcher", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.CommandStack),
+    __metadata("design:type", Object)
+], SaveModelMcpToolHandler.prototype, "commandStack", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_2.McpLogger),
+    __metadata("design:type", server_2.McpLogger)
+], SaveModelMcpToolHandler.prototype, "mcpLogger", void 0);
+exports.SaveModelMcpToolHandler = SaveModelMcpToolHandler = SaveModelMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], SaveModelMcpToolHandler);
+//# sourceMappingURL=save-model-mcp-tool-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-model-mcp-tool-handler.js","sourceRoot":"","sources":["../../../src/tools/handlers/save-model-mcp-tool-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAAuF;AACvF,yCAA+C;AAC/C,4BAA4B;AAC5B,yCAAoH;AAEvG,QAAA,oBAAoB,GAAG,oCAA2B,CAAC,MAAM,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8FAA8F,CAAC;CAC1I,CAAC,CAAC;AAGU,QAAA,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oGAAoG,CAAC;IACjI,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oGAAoG,CAAC;CACtH,CAAC,CAAC;AAEH,2JAA2J;AAEpJ,IAAM,uBAAuB,+BAA7B,MAAM,uBAAwB,SAAQ,sCAA6C;IAAnF;;QAEM,SAAI,GAAG,yBAAuB,CAAC,IAAI,CAAC;QAC3B,UAAK,GAAG,oBAAoB,CAAC;QACtC,gBAAW,GAChB,wDAAwD;YACxD,gEAAgE;YAChE,2EAA2E;YAC3E,mEAAmE,CAAC;QAC/D,gBAAW,GAAG,4BAAoB,CAAC;QAC1B,iBAAY,GAAG,6BAAqB,CAAC;QACvD;;;;WAIG;QACe,iBAAY,GAAG,KAAK,CAAC;QACrB,oBAAe,GAAY,KAAK,CAAC;QACjC,mBAAc,GAAY,KAAK,CAAC;IAgBtD,CAAC;IAVa,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,EAAkB;QACpD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,wBAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;;AAjCQ,0DAAuB;AAChB,4BAAI,GAAG,YAAY,AAAf,CAAgB;AAmBA;IAAnC,IAAA,kBAAM,EAAC,yBAAgB,CAAC;;iEAA8C;AACvC;IAA/B,IAAA,kBAAM,EAAC,qBAAY,CAAC;;6DAAsC;AAC9B;IAA5B,IAAA,kBAAM,EAAC,kBAAS,CAAC;8BAAsB,kBAAS;0DAAC;kCAtBzC,uBAAuB;IADnC,IAAA,sBAAU,GAAE;GACA,uBAAuB,CAkCnC"}

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

@@ -0,0 +1,65 @@
+/********************************************************************************
+ * 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 { ClientSessionManager } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { AbstractMcpToolHandler, McpToolResult } from '../../server';
+export declare const SessionInfoInputSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionInfoInput = z.infer<typeof SessionInfoInputSchema>;
+export declare const SessionInfoRowSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    diagramType: z.ZodString;
+    sourceUri: z.ZodString;
+    readOnly: z.ZodBoolean;
+    dirty: z.ZodBoolean;
+}, z.core.$strip>;
+export type SessionInfoRow = z.infer<typeof SessionInfoRowSchema>;
+export declare const SessionInfoOutputSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        diagramType: z.ZodString;
+        sourceUri: z.ZodString;
+        readOnly: z.ZodBoolean;
+        dirty: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare class SessionInfoMcpToolHandler extends AbstractMcpToolHandler<SessionInfoInput> {
+    protected clientSessionManager: ClientSessionManager;
+    static readonly NAME = "session-info";
+    readonly name = "session-info";
+    readonly title = "GLSP Session Info";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        sessions: z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            diagramType: z.ZodString;
+            sourceUri: z.ZodString;
+            readOnly: z.ZodBoolean;
+            dirty: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    protected createResult({ sessionId }: SessionInfoInput): McpToolResult;
+    /** Extracts a {@link SessionInfoRow} from a {@link ClientSession}. Override to surface adopter-specific fields. */
+    protected buildSessionRow(session: ReturnType<ClientSessionManager['getSessions']>[number]): SessionInfoRow;
+    /** Builds the LLM-facing summary. Override to customize per-adopter wording. */
+    protected summarizeSessions(rows: SessionInfoRow[]): string;
+    protected singleSession(sessionId: string): ReturnType<ClientSessionManager['getSessions']>;
+}
+//# sourceMappingURL=session-info-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-info-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/session-info-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,oBAAoB,EAA4B,MAAM,sBAAsB,CAAC;AAEtF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAgB,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnF,eAAO,MAAM,sBAAsB;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,uBAAuB;;;;;;;;iBAElC,CAAC;AAEH,qBACa,yBAA0B,SAAQ,sBAAsB,CAAC,gBAAgB,CAAC;IACrD,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAEnF,MAAM,CAAC,QAAQ,CAAC,IAAI,kBAAkB;IACtC,QAAQ,CAAC,IAAI,kBAAkC;IAC/C,SAAkB,KAAK,uBAAuB;IAC9C,QAAQ,CAAC,WAAW,SAGmF;IACvG,QAAQ,CAAC,WAAW;;sBAA0B;IAC9C,SAAkB,YAAY;;;;;;;;sBAA2B;IAEzD,SAAS,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,gBAAgB,GAAG,aAAa;IAMtE,mHAAmH;IACnH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,cAAc;IAa3G,gFAAgF;IAChF,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM;IAY3D,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;CAO9F"}

package/lib/tools/handlers/session-info-mcp-tool-handler.js

@@ -0,0 +1,108 @@
+"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 SessionInfoMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionInfoMcpToolHandler = exports.SessionInfoOutputSchema = exports.SessionInfoRowSchema = exports.SessionInfoInputSchema = 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.SessionInfoInputSchema = z.object({
+    sessionId: z
+        .string()
+        .optional()
+        .describe('Optional filter — returns only the matching session, or throws if unknown. Omit to list all sessions.')
+});
+exports.SessionInfoRowSchema = z.object({
+    sessionId: z.string(),
+    diagramType: z.string(),
+    sourceUri: z.string(),
+    readOnly: z.boolean(),
+    dirty: z.boolean().describe('True when the diagram has unsaved changes — call `save-model` to persist.')
+});
+exports.SessionInfoOutputSchema = z.object({
+    sessions: z.array(exports.SessionInfoRowSchema)
+});
+let SessionInfoMcpToolHandler = SessionInfoMcpToolHandler_1 = class SessionInfoMcpToolHandler extends server_2.AbstractMcpToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = SessionInfoMcpToolHandler_1.NAME;
+        this.title = 'GLSP Session Info';
+        this.description = 'Report info on the active GLSP client sessions: session id, diagram type, source uri, and read-only status. ' +
+            "Pass `sessionId` to retrieve a single session's entry; omit it to list every active session. " +
+            'Useful as a discovery tool — most other diagram-scoped tools take the `sessionId` returned here.';
+        this.inputSchema = exports.SessionInfoInputSchema;
+        this.outputSchema = exports.SessionInfoOutputSchema;
+    }
+    createResult({ sessionId }) {
+        const sessions = sessionId !== undefined ? this.singleSession(sessionId) : this.clientSessionManager.getSessions();
+        const rows = sessions.map(session => this.buildSessionRow(session));
+        return this.success(this.summarizeSessions(rows), { sessions: rows });
+    }
+    /** Extracts a {@link SessionInfoRow} from a {@link ClientSession}. Override to surface adopter-specific fields. */
+    buildSessionRow(session) {
+        var _a;
+        const modelState = session.container.get(server_1.ModelState);
+        const commandStack = session.container.get(server_1.CommandStack);
+        return {
+            sessionId: session.id,
+            diagramType: session.diagramType,
+            // `ModelState.sourceUri` may be undefined for not-yet-persisted diagrams; render as empty string to keep the schema-required string shape.
+            sourceUri: (_a = modelState.sourceUri) !== null && _a !== void 0 ? _a : '',
+            readOnly: modelState.isReadonly,
+            dirty: commandStack.isDirty
+        };
+    }
+    /** Builds the LLM-facing summary. Override to customize per-adopter wording. */
+    summarizeSessions(rows) {
+        if (rows.length === 0) {
+            return 'No active sessions.';
+        }
+        const lines = rows.map(row => {
+            const flags = [row.readOnly ? 'read-only' : undefined, row.dirty ? 'dirty' : undefined].filter(Boolean);
+            const suffix = flags.length > 0 ? `, ${flags.join(', ')}` : '';
+            return `- ${row.sessionId} (${row.diagramType}${suffix})`;
+        });
+        return `${rows.length} session(s); full details in structuredContent.\n${lines.join('\n')}`;
+    }
+    singleSession(sessionId) {
+        const session = this.clientSessionManager.getSession(sessionId);
+        if (!session) {
+            throw new server_2.McpToolError(`Unknown sessionId: ${sessionId}`);
+        }
+        return [session];
+    }
+};
+exports.SessionInfoMcpToolHandler = SessionInfoMcpToolHandler;
+SessionInfoMcpToolHandler.NAME = 'session-info';
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], SessionInfoMcpToolHandler.prototype, "clientSessionManager", void 0);
+exports.SessionInfoMcpToolHandler = SessionInfoMcpToolHandler = SessionInfoMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], SessionInfoMcpToolHandler);
+//# sourceMappingURL=session-info-mcp-tool-handler.js.map

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

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

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

@@ -0,0 +1,60 @@
+/********************************************************************************
+ * 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 SetSelectionInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    selectedElementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    deselectedElementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    clear: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SetSelectionInput = z.infer<typeof SetSelectionInputSchema>;
+export declare const SetSelectionOutputSchema: z.ZodObject<{
+    selectedElementIds: z.ZodArray<z.ZodString>;
+    deselectedElementIds: z.ZodArray<z.ZodString>;
+    cleared: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Pushes a selection change to the client. Counterpart to `get-selection` — useful for the
+ * agent to direct a human reviewer's attention to elements it just modified ("here's what I
+ * touched"), or to chain follow-up tools that rely on the visible selection.
+ *
+ * Read-write hint is honest: the viewport selection state is part of the client environment
+ * even though the underlying GModel is unaffected.
+ */
+export declare class SetSelectionMcpToolHandler extends AbstractMcpDiagramToolHandler<SetSelectionInput> {
+    static readonly NAME = "set-selection";
+    readonly name = "set-selection";
+    readonly title = "Set Diagram Selection";
+    readonly description: string;
+    readonly inputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        selectedElementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        deselectedElementIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        clear: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        selectedElementIds: z.ZodArray<z.ZodString>;
+        deselectedElementIds: z.ZodArray<z.ZodString>;
+        cleared: z.ZodBoolean;
+    }, z.core.$strip>;
+    readonly readOnlyHint = false;
+    protected actionDispatcher: ActionDispatcher;
+    protected createResult({ selectedElementIds, deselectedElementIds, clear }: SetSelectionInput): Promise<McpToolResult>;
+    protected summarize(selected: string[], deselected: string[], cleared: boolean): string;
+}
+//# sourceMappingURL=set-selection-mcp-tool-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set-selection-mcp-tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/set-selection-mcp-tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,gBAAgB,EAAiC,MAAM,sBAAsB,CAAC;AAEvF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAA+B,aAAa,EAAc,MAAM,cAAc,CAAC;AAErH,eAAO,MAAM,uBAAuB;;;;;iBASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH;;;;;;;GAOG;AACH,qBACa,0BAA2B,SAAQ,6BAA6B,CAAC,iBAAiB,CAAC;IAC5F,MAAM,CAAC,QAAQ,CAAC,IAAI,mBAAmB;IACvC,QAAQ,CAAC,IAAI,mBAAmC;IAChD,SAAkB,KAAK,2BAA2B;IAClD,QAAQ,CAAC,WAAW,SAGgC;IACpD,QAAQ,CAAC,WAAW;;;;;sBAA2B;IAC/C,SAAkB,YAAY;;;;sBAA4B;IAC1D,SAAkB,YAAY,SAAS;IAEb,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;cAEvD,YAAY,CAAC,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB5H,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;CAO1F"}

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

@@ -0,0 +1,103 @@
+"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 SetSelectionMcpToolHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetSelectionMcpToolHandler = exports.SetSelectionOutputSchema = exports.SetSelectionInputSchema = 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.SetSelectionInputSchema = server_2.McpDiagramScopedInputSchema.extend({
+    selectedElementIds: server_2.elementIds
+        .optional()
+        .describe('Element IDs to select. Pass an empty array (or omit + set `clear: true`) to clear the selection.'),
+    deselectedElementIds: server_2.elementIds.optional().describe('Element IDs to remove from the selection. Used to subtract without replacing.'),
+    clear: z
+        .boolean()
+        .optional()
+        .describe('When true, clear the existing selection before applying `selectedElementIds`. Defaults to false (additive).')
+});
+exports.SetSelectionOutputSchema = z.object({
+    selectedElementIds: z.array(z.string()).describe('Aliased ids requested for selection.'),
+    deselectedElementIds: z.array(z.string()).describe('Aliased ids requested for deselection.'),
+    cleared: z.boolean().describe('Whether the existing selection was cleared before applying.')
+});
+/**
+ * Pushes a selection change to the client. Counterpart to `get-selection` — useful for the
+ * agent to direct a human reviewer's attention to elements it just modified ("here's what I
+ * touched"), or to chain follow-up tools that rely on the visible selection.
+ *
+ * Read-write hint is honest: the viewport selection state is part of the client environment
+ * even though the underlying GModel is unaffected.
+ */
+let SetSelectionMcpToolHandler = SetSelectionMcpToolHandler_1 = class SetSelectionMcpToolHandler extends server_2.AbstractMcpDiagramToolHandler {
+    constructor() {
+        super(...arguments);
+        this.name = SetSelectionMcpToolHandler_1.NAME;
+        this.title = 'Set Diagram Selection';
+        this.description = 'Set the selection of elements on the client UI. Useful to direct a reviewer to a ' +
+            'set of elements (e.g. those just created or modified). Pass `clear: true` to replace ' +
+            'the existing selection rather than add to it.';
+        this.inputSchema = exports.SetSelectionInputSchema;
+        this.outputSchema = exports.SetSelectionOutputSchema;
+        this.readOnlyHint = false;
+    }
+    async createResult({ selectedElementIds, deselectedElementIds, clear }) {
+        const resolvedSelected = this.resolveExistingIds(selectedElementIds);
+        const resolvedDeselected = this.resolveExistingIds(deselectedElementIds);
+        if (clear) {
+            await this.actionDispatcher.dispatch(server_1.SelectAllAction.create(false));
+        }
+        if (resolvedSelected.length > 0 || resolvedDeselected.length > 0) {
+            await this.actionDispatcher.dispatch(server_1.SelectAction.create({ selectedElementsIDs: resolvedSelected, deselectedElementsIDs: resolvedDeselected }));
+        }
+        return this.success(this.summarize(resolvedSelected, resolvedDeselected, clear !== null && clear !== void 0 ? clear : false), {
+            selectedElementIds: this.encodeIds(resolvedSelected),
+            deselectedElementIds: this.encodeIds(resolvedDeselected),
+            cleared: clear !== null && clear !== void 0 ? clear : false
+        });
+    }
+    summarize(selected, deselected, cleared) {
+        const parts = [];
+        if (cleared)
+            parts.push('Cleared previous selection.');
+        if (selected.length > 0)
+            parts.push(`Selected ${selected.length} element${selected.length === 1 ? '' : 's'}.`);
+        if (deselected.length > 0)
+            parts.push(`Deselected ${deselected.length} element${deselected.length === 1 ? '' : 's'}.`);
+        return parts.length > 0 ? parts.join(' ') : 'Selection unchanged.';
+    }
+};
+exports.SetSelectionMcpToolHandler = SetSelectionMcpToolHandler;
+SetSelectionMcpToolHandler.NAME = 'set-selection';
+__decorate([
+    (0, inversify_1.inject)(server_1.ActionDispatcher),
+    __metadata("design:type", Object)
+], SetSelectionMcpToolHandler.prototype, "actionDispatcher", void 0);
+exports.SetSelectionMcpToolHandler = SetSelectionMcpToolHandler = SetSelectionMcpToolHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], SetSelectionMcpToolHandler);
+//# sourceMappingURL=set-selection-mcp-tool-handler.js.map

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

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