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

package/README.md

@@ -0,0 +1,57 @@
+# @eclipse-glsp/server-mcp
+
+> **Status: Experimental.** The MCP integration is under active development. Option names, schema shapes, and handler contracts MAY change in minor releases until the feature graduates from experimental status. Pin the package version in adopter projects; track release notes for breaking changes.
+
+An extension of the [GLSP Node Server](https://github.com/eclipse-glsp/glsp-server-node) that exposes a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server alongside the existing GLSP server. This allows AI agents and LLM-based tools to interact with graphical diagram models using the standardized MCP interface.
+
+## What it provides
+
+-   **Tools** — Read/query and read/write operations to inspect, create, modify, delete, validate, and navigate diagram elements (and the active sessions themselves).
+-   **Resources** — URI-addressable read-only data; in the default ship-set this is `diagram-png` only (the rendered diagram screenshot, useful as embeddable image content). Other read endpoints ship as plain tools because in-the-wild MCP clients support tools more reliably than resources — see [Resource vs. Tool Mode](./ARCHITECTURE.md#resource-vs-tool-mode).
+-   **Prompts** — User-invokable templates (slash-command-style) that frame multi-step agent tasks against the diagram.
+
+The MCP server is initialized as part of the GLSP server startup sequence and creates a new MCP session for each connecting MCP client. Each session runs a preconfigured AI agent persona (the _GLSP Modeling Agent_) that guides AI clients toward correct and safe usage of the modeling tools. It should be noted that the server startup sequence does not mean simply starting a server process, but rather that some kind of GLSP client starts the initialization.
+
+## Installation
+
+```bash
+yarn add @eclipse-glsp/server-mcp
+# or
+npm install @eclipse-glsp/server-mcp
+```
+
+## Integrating into a GLSP Server
+
+Load the MCP container modules in your GLSP server's DI configuration:
+
+```typescript
+import { GModelStorage, WebSocketServerLauncher, createAppModule } from '@eclipse-glsp/server/node';
+import { Container } from 'inversify';
+import { DefaultMcpDiagramModule, DefaultMcpServerModule } from '@eclipse-glsp/server-mcp';
+
+const appContainer = new Container();
+appContainer.load(createAppModule(options));
+
+// Per-session bindings — must be part of `configureDiagramModule`.
+const mcpDiagramModule = new DefaultMcpDiagramModule();
+const serverModule = new MyServerModule().configureDiagramModule(new MyDiagramModule(() => GModelStorage), mcpDiagramModule);
+
+const launcher = appContainer.resolve(WebSocketServerLauncher);
+// Launcher-level bindings — must not be part of `configureDiagramModule`.
+launcher.configure(serverModule, new DefaultMcpServerModule());
+```
+
+The two modules are deliberately separate because they bind into different container scopes:
+
+-   `DefaultMcpDiagramModule` is mounted inside `configureDiagramModule`, so each `ClientSession.container` gets its own per-session services (`McpIdAliasService`, `McpModelSerializer`, the diagram-scope handler registries).
+-   `DefaultMcpServerModule` is mounted at the launcher container, so the MCP HTTP server, the option holder, and the server-scope tool/resource handlers live as launcher singletons.
+
+The MCP server itself is started lazily on the first GLSP `InitializeAction` that carries an `mcpServer` configuration.
+
+## Further reading
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for the architecture, security model, configuration surface, deployment guidance, and the extension cookbook. The workflow example (`examples/workflow-server`) is the canonical reference for adopter wiring; each shipped handler carries an LLM-facing `description` field that doubles as developer-facing documentation.
+
+## License
+
+EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * Copyright (c) 2025-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
+ ********************************************************************************/
+export * from './prompts';
+export * from './resources';
+export * from './server';
+export * from './tools';
+export * from './util';
+export * from './server/mcp-diagram-module';
+export * from './server/mcp-server-module';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAClF,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AAGvB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/lib/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/********************************************************************************
+ * Copyright (c) 2025-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
+ ********************************************************************************/
+__exportStar(require("./prompts"), exports);
+__exportStar(require("./resources"), exports);
+__exportStar(require("./server"), exports);
+__exportStar(require("./tools"), exports);
+__exportStar(require("./util"), exports);
+// Module classes — exported here (not from `./server`) to avoid circular imports through
+// the handler barrels which the modules consume.
+__exportStar(require("./server/mcp-diagram-module"), exports);
+__exportStar(require("./server/mcp-server-module"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;kFAckF;AAClF,4CAA0B;AAC1B,8CAA4B;AAC5B,2CAAyB;AACzB,0CAAwB;AACxB,yCAAuB;AACvB,yFAAyF;AACzF,iDAAiD;AACjD,8DAA4C;AAC5C,6DAA2C"}

package/lib/prompts/handlers/describe-diagram-mcp-prompt-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 { ClientSessionManager } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { AbstractMcpPromptHandler, McpPromptResult } from '../../server';
+export declare const DescribeDiagramArgsSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DescribeDiagramArgs = z.infer<typeof DescribeDiagramArgsSchema>;
+/**
+ * Prompt template that instructs the agent to produce a structured description of a diagram.
+ * Pre-baked starting point invokable from the MCP-client UI; the agent then orchestrates the
+ * necessary tool calls on its own.
+ *
+ * Server-scope on purpose — the prompt itself has no per-session state, so we avoid forcing
+ * the user to type a sessionId in the common single-diagram case.
+ */
+export declare class DescribeDiagramMcpPromptHandler extends AbstractMcpPromptHandler<DescribeDiagramArgs> {
+    static readonly NAME = "describe-diagram";
+    readonly name = "describe-diagram";
+    readonly title = "Describe Diagram";
+    readonly description: string;
+    readonly argsSchema: z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    protected clientSessionManager: ClientSessionManager;
+    referencedToolNames(): string[];
+    protected createResult(args: DescribeDiagramArgs): McpPromptResult;
+}
+//# sourceMappingURL=describe-diagram-mcp-prompt-handler.d.ts.map

package/lib/prompts/handlers/describe-diagram-mcp-prompt-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-diagram-mcp-prompt-handler.d.ts","sourceRoot":"","sources":["../../../src/prompts/handlers/describe-diagram-mcp-prompt-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAA0B,MAAM,cAAc,CAAC;AAUjG,eAAO,MAAM,yBAAyB;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;GAOG;AACH,qBACa,+BAAgC,SAAQ,wBAAwB,CAAC,mBAAmB,CAAC;IAC9F,MAAM,CAAC,QAAQ,CAAC,IAAI,sBAAsB;IAC1C,QAAQ,CAAC,IAAI,sBAAwC;IACrD,SAAkB,KAAK,sBAAsB;IAC7C,QAAQ,CAAC,WAAW,SAK+C;IACnE,QAAQ,CAAC,UAAU;;sBAA6B;IAElB,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAE1E,mBAAmB,IAAI,MAAM,EAAE;IAWxC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe;CAiBrE"}

package/lib/prompts/handlers/describe-diagram-mcp-prompt-handler.js

@@ -0,0 +1,96 @@
+"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 DescribeDiagramMcpPromptHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DescribeDiagramMcpPromptHandler = exports.DescribeDiagramArgsSchema = 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 tools_1 = require("../../tools");
+exports.DescribeDiagramArgsSchema = z.object({
+    sessionId: z
+        .string()
+        .optional()
+        .describe('GLSP client session id (open diagram). Defaults to the only open session; required when multiple are open.')
+});
+/**
+ * Prompt template that instructs the agent to produce a structured description of a diagram.
+ * Pre-baked starting point invokable from the MCP-client UI; the agent then orchestrates the
+ * necessary tool calls on its own.
+ *
+ * Server-scope on purpose — the prompt itself has no per-session state, so we avoid forcing
+ * the user to type a sessionId in the common single-diagram case.
+ */
+let DescribeDiagramMcpPromptHandler = DescribeDiagramMcpPromptHandler_1 = class DescribeDiagramMcpPromptHandler extends server_2.AbstractMcpPromptHandler {
+    constructor() {
+        super(...arguments);
+        this.name = DescribeDiagramMcpPromptHandler_1.NAME;
+        this.title = 'Describe Diagram';
+        this.description = 'Produce a structured, skim-friendly description of an open diagram. ' +
+            'The agent picks the right tools to gather data (overview, element-type breakdown, structure, notable elements) ' +
+            'and writes the description in its own words. ' +
+            'Use this as a starting point when the user asks "what does this diagram show?" or wants a documentation-style summary. ' +
+            '`sessionId` is optional — defaults to the only open session.';
+        this.argsSchema = exports.DescribeDiagramArgsSchema;
+    }
+    referencedToolNames() {
+        return [
+            tools_1.CountElementsMcpToolHandler.NAME,
+            tools_1.ElementTypesMcpToolHandler.NAME,
+            tools_1.DiagramModelMcpToolHandler.NAME,
+            tools_1.QueryElementsMcpToolHandler.NAME,
+            tools_1.SetSelectionMcpToolHandler.NAME,
+            tools_1.SetViewMcpToolHandler.NAME
+        ];
+    }
+    createResult(args) {
+        const sessionId = (0, server_2.resolveActiveSessionId)(this.clientSessionManager, args.sessionId);
+        const text = `Describe the diagram for session \`${sessionId}\`. Include:\n\n` +
+            `1. **Overview** — diagram type and total element count (use \`${tools_1.CountElementsMcpToolHandler.NAME}\`).\n` +
+            `2. **Element-type breakdown** — what kinds of elements are present and how many of each ` +
+            `(use \`${tools_1.ElementTypesMcpToolHandler.NAME}\` and \`${tools_1.CountElementsMcpToolHandler.NAME}\`).\n` +
+            `3. **Structure** — load the model with \`${tools_1.DiagramModelMcpToolHandler.NAME}\` and summarize the ` +
+            `hierarchy and major connections.\n` +
+            `4. **Notable elements** — call out anything that stands out (unconnected nodes, deeply ` +
+            `nested groups, missing labels). Use \`${tools_1.QueryElementsMcpToolHandler.NAME}\` to locate specific cases.\n\n` +
+            `Keep the description concise and skim-friendly. ` +
+            `When mentioning an element, prefer its label or type, with the alias appended in parens — e.g. ` +
+            `"the 'Brew' task (#7)" or "the decision node (#9)" — never the bare alias alone, since aliases mean nothing to the user. ` +
+            `Use \`${tools_1.SetSelectionMcpToolHandler.NAME}\` or \`${tools_1.SetViewMcpToolHandler.NAME} → 'center-on-elements'\` to draw the user's attention.`;
+        return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+    }
+};
+exports.DescribeDiagramMcpPromptHandler = DescribeDiagramMcpPromptHandler;
+DescribeDiagramMcpPromptHandler.NAME = 'describe-diagram';
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], DescribeDiagramMcpPromptHandler.prototype, "clientSessionManager", void 0);
+exports.DescribeDiagramMcpPromptHandler = DescribeDiagramMcpPromptHandler = DescribeDiagramMcpPromptHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], DescribeDiagramMcpPromptHandler);
+//# sourceMappingURL=describe-diagram-mcp-prompt-handler.js.map

package/lib/prompts/handlers/describe-diagram-mcp-prompt-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-diagram-mcp-prompt-handler.js","sourceRoot":"","sources":["../../../src/prompts/handlers/describe-diagram-mcp-prompt-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAA4D;AAC5D,yCAA+C;AAC/C,4BAA4B;AAC5B,yCAAiG;AACjG,uCAOqB;AAER,QAAA,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4GAA4G,CAAC;CAC9H,CAAC,CAAC;AAGH;;;;;;;GAOG;AAEI,IAAM,+BAA+B,uCAArC,MAAM,+BAAgC,SAAQ,iCAA6C;IAA3F;;QAEM,SAAI,GAAG,iCAA+B,CAAC,IAAI,CAAC;QACnC,UAAK,GAAG,kBAAkB,CAAC;QACpC,gBAAW,GAChB,sEAAsE;YACtE,iHAAiH;YACjH,+CAA+C;YAC/C,yHAAyH;YACzH,8DAA8D,CAAC;QAC1D,eAAU,GAAG,iCAAyB,CAAC;IAgCpD,CAAC;IA5BY,mBAAmB;QACxB,OAAO;YACH,mCAA2B,CAAC,IAAI;YAChC,kCAA0B,CAAC,IAAI;YAC/B,kCAA0B,CAAC,IAAI;YAC/B,mCAA2B,CAAC,IAAI;YAChC,kCAA0B,CAAC,IAAI;YAC/B,6BAAqB,CAAC,IAAI;SAC7B,CAAC;IACN,CAAC;IAES,YAAY,CAAC,IAAyB;QAC5C,MAAM,SAAS,GAAG,IAAA,+BAAsB,EAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpF,MAAM,IAAI,GACN,sCAAsC,SAAS,kBAAkB;YACjE,iEAAiE,mCAA2B,CAAC,IAAI,QAAQ;YACzG,0FAA0F;YAC1F,UAAU,kCAA0B,CAAC,IAAI,YAAY,mCAA2B,CAAC,IAAI,QAAQ;YAC7F,4CAA4C,kCAA0B,CAAC,IAAI,uBAAuB;YAClG,oCAAoC;YACpC,yFAAyF;YACzF,yCAAyC,mCAA2B,CAAC,IAAI,kCAAkC;YAC3G,kDAAkD;YAClD,iGAAiG;YACjG,2HAA2H;YAC3H,SAAS,kCAA0B,CAAC,IAAI,WAAW,6BAAqB,CAAC,IAAI,yDAAyD,CAAC;QAC3I,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC;;AAzCQ,0EAA+B;AACxB,oCAAI,GAAG,kBAAkB,AAArB,CAAsB;AAWF;IAAvC,IAAA,kBAAM,EAAC,6BAAoB,CAAC;;6EAAsD;0CAZ1E,+BAA+B;IAD3C,IAAA,sBAAU,GAAE;GACA,+BAA+B,CA0C3C"}

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-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 { ClientSessionManager } from '@eclipse-glsp/server';
+import * as z from 'zod/v4';
+import { AbstractMcpPromptHandler, McpPromptResult } from '../../server';
+export declare const SuggestImprovementsArgsSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SuggestImprovementsArgs = z.infer<typeof SuggestImprovementsArgsSchema>;
+/**
+ * Prompt template that asks the agent to review the diagram and propose concrete improvements
+ * (validation issues, structural smells, missing labels, etc.). The agent orchestrates the
+ * tool calls; this prompt only frames the task.
+ *
+ * Server-scope on purpose — the prompt itself has no per-session state, so we avoid forcing
+ * the user to type a sessionId in the common single-diagram case.
+ */
+export declare class SuggestImprovementsMcpPromptHandler extends AbstractMcpPromptHandler<SuggestImprovementsArgs> {
+    static readonly NAME = "suggest-improvements";
+    readonly name = "suggest-improvements";
+    readonly title = "Suggest Diagram Improvements";
+    readonly description: string;
+    readonly argsSchema: z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    protected clientSessionManager: ClientSessionManager;
+    referencedToolNames(): string[];
+    protected createResult(args: SuggestImprovementsArgs): McpPromptResult;
+}
+//# sourceMappingURL=suggest-improvements-mcp-prompt-handler.d.ts.map

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-improvements-mcp-prompt-handler.d.ts","sourceRoot":"","sources":["../../../src/prompts/handlers/suggest-improvements-mcp-prompt-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAA0B,MAAM,cAAc,CAAC;AAQjG,eAAO,MAAM,6BAA6B;;iBAKxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;;;GAOG;AACH,qBACa,mCAAoC,SAAQ,wBAAwB,CAAC,uBAAuB,CAAC;IACtG,MAAM,CAAC,QAAQ,CAAC,IAAI,0BAA0B;IAC9C,QAAQ,CAAC,IAAI,0BAA4C;IACzD,SAAkB,KAAK,kCAAkC;IACzD,QAAQ,CAAC,WAAW,SAK+C;IACnE,QAAQ,CAAC,UAAU;;sBAAiC;IAEtB,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAE1E,mBAAmB,IAAI,MAAM,EAAE;IASxC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,uBAAuB,GAAG,eAAe;CAkBzE"}

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-handler.js

@@ -0,0 +1,95 @@
+"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 SuggestImprovementsMcpPromptHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuggestImprovementsMcpPromptHandler = exports.SuggestImprovementsArgsSchema = 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 tools_1 = require("../../tools");
+exports.SuggestImprovementsArgsSchema = z.object({
+    sessionId: z
+        .string()
+        .optional()
+        .describe('GLSP client session id (open diagram). Defaults to the only open session; required when multiple are open.')
+});
+/**
+ * Prompt template that asks the agent to review the diagram and propose concrete improvements
+ * (validation issues, structural smells, missing labels, etc.). The agent orchestrates the
+ * tool calls; this prompt only frames the task.
+ *
+ * Server-scope on purpose — the prompt itself has no per-session state, so we avoid forcing
+ * the user to type a sessionId in the common single-diagram case.
+ */
+let SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler_1 = class SuggestImprovementsMcpPromptHandler extends server_2.AbstractMcpPromptHandler {
+    constructor() {
+        super(...arguments);
+        this.name = SuggestImprovementsMcpPromptHandler_1.NAME;
+        this.title = 'Suggest Diagram Improvements';
+        this.description = 'Review an open diagram and propose concrete improvements grouped by severity ' +
+            '(must-fix vs. nice-to-have). The agent runs validation, checks connectivity, looks for unclear labels, ' +
+            'and flags structural inconsistencies, then names the specific element ids for each suggestion so the user ' +
+            'can act on them. Read-only by intent — the prompt instructs the agent not to modify the diagram, only propose. ' +
+            '`sessionId` is optional — defaults to the only open session.';
+        this.argsSchema = exports.SuggestImprovementsArgsSchema;
+    }
+    referencedToolNames() {
+        return [
+            tools_1.ValidateDiagramMcpToolHandler.NAME,
+            tools_1.DiagramModelMcpToolHandler.NAME,
+            tools_1.QueryElementsMcpToolHandler.NAME,
+            tools_1.SetSelectionMcpToolHandler.NAME
+        ];
+    }
+    createResult(args) {
+        const sessionId = (0, server_2.resolveActiveSessionId)(this.clientSessionManager, args.sessionId);
+        const text = `Review the diagram for session \`${sessionId}\` and propose concrete improvements. Focus on:\n\n` +
+            `1. **Validation issues** — run \`${tools_1.ValidateDiagramMcpToolHandler.NAME}\` and surface any markers.\n` +
+            `2. **Connectivity** — load the model (\`${tools_1.DiagramModelMcpToolHandler.NAME}\`) and flag unconnected ` +
+            `nodes or orphaned subgraphs.\n` +
+            `3. **Labelling** — use \`${tools_1.QueryElementsMcpToolHandler.NAME}\` to find nodes that lack a meaningful ` +
+            `label, and edges with missing or unclear text.\n` +
+            `4. **Structure** — call out elements whose type or placement looks inconsistent with ` +
+            `the rest of the diagram.\n\n` +
+            `Group findings by severity (must-fix vs. nice-to-have). ` +
+            `When naming elements, prefer their label or type with the alias in parens — e.g. ` +
+            `"the 'Brew' task (#7)" or "the decision node (#9)" — never the bare alias alone, since aliases mean nothing to the user. ` +
+            `Point at each suggestion via \`${tools_1.SetSelectionMcpToolHandler.NAME}\` so the user can navigate. ` +
+            `Do not modify the diagram — only propose.`;
+        return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+    }
+};
+exports.SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler;
+SuggestImprovementsMcpPromptHandler.NAME = 'suggest-improvements';
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], SuggestImprovementsMcpPromptHandler.prototype, "clientSessionManager", void 0);
+exports.SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], SuggestImprovementsMcpPromptHandler);
+//# sourceMappingURL=suggest-improvements-mcp-prompt-handler.js.map

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-improvements-mcp-prompt-handler.js","sourceRoot":"","sources":["../../../src/prompts/handlers/suggest-improvements-mcp-prompt-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAA4D;AAC5D,yCAA+C;AAC/C,4BAA4B;AAC5B,yCAAiG;AACjG,uCAKqB;AAER,QAAA,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4GAA4G,CAAC;CAC9H,CAAC,CAAC;AAGH;;;;;;;GAOG;AAEI,IAAM,mCAAmC,2CAAzC,MAAM,mCAAoC,SAAQ,iCAAiD;IAAnG;;QAEM,SAAI,GAAG,qCAAmC,CAAC,IAAI,CAAC;QACvC,UAAK,GAAG,8BAA8B,CAAC;QAChD,gBAAW,GAChB,+EAA+E;YAC/E,yGAAyG;YACzG,4GAA4G;YAC5G,iHAAiH;YACjH,8DAA8D,CAAC;QAC1D,eAAU,GAAG,qCAA6B,CAAC;IA+BxD,CAAC;IA3BY,mBAAmB;QACxB,OAAO;YACH,qCAA6B,CAAC,IAAI;YAClC,kCAA0B,CAAC,IAAI;YAC/B,mCAA2B,CAAC,IAAI;YAChC,kCAA0B,CAAC,IAAI;SAClC,CAAC;IACN,CAAC;IAES,YAAY,CAAC,IAA6B;QAChD,MAAM,SAAS,GAAG,IAAA,+BAAsB,EAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpF,MAAM,IAAI,GACN,oCAAoC,SAAS,qDAAqD;YAClG,oCAAoC,qCAA6B,CAAC,IAAI,+BAA+B;YACrG,2CAA2C,kCAA0B,CAAC,IAAI,2BAA2B;YACrG,gCAAgC;YAChC,4BAA4B,mCAA2B,CAAC,IAAI,0CAA0C;YACtG,kDAAkD;YAClD,uFAAuF;YACvF,8BAA8B;YAC9B,0DAA0D;YAC1D,mFAAmF;YACnF,2HAA2H;YAC3H,kCAAkC,kCAA0B,CAAC,IAAI,+BAA+B;YAChG,2CAA2C,CAAC;QAChD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC;;AAxCQ,kFAAmC;AAC5B,wCAAI,GAAG,sBAAsB,AAAzB,CAA0B;AAWN;IAAvC,IAAA,kBAAM,EAAC,6BAAoB,CAAC;;iFAAsD;8CAZ1E,mCAAmC;IAD/C,IAAA,sBAAU,GAAE;GACA,mCAAmC,CAyC/C"}

package/lib/prompts/index.d.ts

@@ -0,0 +1,18 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './handlers/describe-diagram-mcp-prompt-handler';
+export * from './handlers/suggest-improvements-mcp-prompt-handler';
+//# sourceMappingURL=index.d.ts.map

package/lib/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC"}

package/lib/prompts/index.js

@@ -0,0 +1,34 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./handlers/describe-diagram-mcp-prompt-handler"), exports);
+__exportStar(require("./handlers/suggest-improvements-mcp-prompt-handler"), exports);
+//# sourceMappingURL=index.js.map

package/lib/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;;;;AAElF,iFAA+D;AAC/D,qFAAmE"}

package/lib/resources/handlers/diagram-png-mcp-resource-handler.d.ts

@@ -0,0 +1,81 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import { Role } from '@modelcontextprotocol/sdk/types.js';
+import * as z from 'zod/v4';
+import { AbstractMcpDiagramResourceHandler, McpMimeType, McpProgressReporter, McpResourceContent, McpResourceUri } from '../../server';
+export declare const DiagramPngInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    scale: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DiagramPngInput = z.infer<typeof DiagramPngInputSchema>;
+/** Rendering lives on the client — `RequestExportAction('png')` routes to the registered PNG exporter, which returns base64 via `ExportResultAction`. */
+export declare class DiagramPngMcpResourceHandler extends AbstractMcpDiagramResourceHandler<DiagramPngInput> {
+    /** Default timeout (in ms) used when the call doesn't override `timeoutMs`. Override via subclass + rebind. */
+    protected readonly defaultTimeoutMs: number;
+    /**
+     * Default `scale` multiplier when the caller doesn't pin `width`/`height`/`scale`. `1` means
+     * "render at the diagram's natural extent" — sharp because the client rasterises the SVG
+     * at the requested size. Adopters override (e.g. to `2` for a high-DPI deployment) via
+     * subclass + rebind.
+     */
+    protected readonly defaultScale: number;
+    static readonly NAME = "diagram-png";
+    readonly name = "diagram-png";
+    readonly title = "Diagram Model PNG";
+    readonly description: string;
+    readonly mimeType: McpMimeType;
+    readonly uri: McpResourceUri;
+    /** Both the user (visual artifact) and the assistant (visual reasoning) consume the rendered diagram. */
+    readonly audience: Role[];
+    /** Useful when relevant, but not always-relevant — clients may skip when text-only reasoning suffices. */
+    readonly priority = 0.6;
+    readonly toolAlternativeInputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        scale: z.ZodOptional<z.ZodNumber>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    protected progress: McpProgressReporter;
+    protected clientActionKinds: Set<string>;
+    /** Skip-bind when the GLSP client doesn't speak `RequestExportAction` — every read would otherwise time out. */
+    canRegister(): boolean;
+    protected createResult({ scale, width, height, timeoutMs }: DiagramPngInput): Promise<McpResourceContent>;
+    /**
+     * Resolve the final render size with this precedence:
+     * - `width` and `height` both given → use as-is.
+     * - only one of `width`/`height` given → derive the other from the diagram aspect ratio.
+     * - neither dimension given → natural × (`scale` ?? {@link defaultScale}).
+     */
+    protected resolveSize(scale: number | undefined, width: number | undefined, height: number | undefined): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Compute the diagram's natural extent as the bounding box of every {@link isGBoundsAware}
+     * element with both `position` and `size`. Throws when the model has no positioned elements
+     * — a 1×1 PNG of an empty diagram is technically renderable but useless, and surfacing it
+     * as a self-correctable error lets the LLM react (e.g. wait for layout, ask the user).
+     */
+    protected computeNaturalSize(): {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=diagram-png-mcp-resource-handler.d.ts.map

package/lib/resources/handlers/diagram-png-mcp-resource-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-png-mcp-resource-handler.d.ts","sourceRoot":"","sources":["../../../src/resources/handlers/diagram-png-mcp-resource-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EACH,iCAAiC,EAEjC,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EAEjB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,qBAAqB;;;;;;iBA+BhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,yJAAyJ;AACzJ,qBACa,4BAA6B,SAAQ,iCAAiC,CAAC,eAAe,CAAC;IAChG,+GAA+G;IAC/G,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAQ;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAK;IAE5C,MAAM,CAAC,QAAQ,CAAC,IAAI,iBAAiB;IACrC,QAAQ,CAAC,IAAI,iBAAqC;IAClD,SAAkB,KAAK,uBAAuB;IAC9C,QAAQ,CAAC,WAAW,SAO4F;IAChH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAe;IAC7C,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAmD;IAC/E,yGAAyG;IACzG,SAAkB,QAAQ,EAAE,IAAI,EAAE,CAAyB;IAC3D,0GAA0G;IAC1G,SAAkB,QAAQ,OAAO;IAIjC,SAAkB,0BAA0B;;;;;;sBAAyB;IAExC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAE1C,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpE,gHAAgH;IACvG,WAAW,IAAI,OAAO;cAIf,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe/G;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAkBpC;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAsBpE"}