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

package/lib/server/mcp-input-schemas.js

@@ -0,0 +1,67 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementIdentitySchema = exports.McpDiagramScopedInputSchema = exports.position = exports.elementIds = exports.elementId = exports.sessionId = void 0;
+const z = require("zod/v4");
+/**
+ * Common Zod input-schema fragments shared across MCP tool / resource / prompt handlers.
+ * Adopters compose these via `z.object({ ... })` or `McpDiagramScopedInputSchema.extend(...)`
+ * — Zod's modifiers (`.describe`, `.optional`, `.min`, ...) return new schemas without mutating
+ * the exports, so the shared fragments can be safely adapted at the call site.
+ *
+ * @example
+ * ```ts
+ * import { McpDiagramScopedInputSchema, elementIds } from '@eclipse-glsp/server-mcp';
+ *
+ * // Use as-is — the tool's `description` field already conveys the action context:
+ * const inputSchema = McpDiagramScopedInputSchema.extend({ elementIds });
+ *
+ * // Override `describe` only when there's genuinely new info (defaults, conditional applicability):
+ * const inputSchema = McpDiagramScopedInputSchema.extend({
+ *     elementIds: elementIds.optional().describe('If not provided, validates entire model.')
+ * });
+ * ```
+ */
+/** GLSP client session id (open diagram). Resolved by the launcher dispatcher via `ClientSessionManager`. */
+exports.sessionId = z.string().describe('GLSP client session id (open diagram).');
+/** Single element id — alias or real; handlers translate via `resolveIds` on the diagram base. */
+exports.elementId = z.string();
+/** One or more element ids. Empty arrays are rejected. */
+exports.elementIds = z.array(z.string()).min(1);
+/** Cartesian position used by node-creation / -modification tools. */
+exports.position = z
+    .object({
+    x: z.number().describe('X coordinate in diagram space'),
+    y: z.number().describe('Y coordinate in diagram space')
+})
+    .strict();
+/**
+ * Base schema for diagram-scope tool / prompt / resource-tool-alternative input. Adopter
+ * schemas extend this via {@link z.ZodObject.extend} and add their tool-specific fields.
+ */
+exports.McpDiagramScopedInputSchema = z.object({ sessionId: exports.sessionId });
+/**
+ * Compact identity echoed by mutating tools (create / modify / delete) so the LLM has enough
+ * context to refer to the element by label or type in user-facing prose without a follow-up
+ * `query-elements`. The `id` is the alias.
+ */
+exports.ElementIdentitySchema = z.object({
+    id: z.string().describe('Aliased element id.'),
+    elementTypeId: z.string().describe('Element type id (e.g. `node:foo`, `edge`).'),
+    label: z.string().optional().describe('Primary label text, when the element has one.')
+});
+//# sourceMappingURL=mcp-input-schemas.js.map

package/lib/server/mcp-input-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-input-schemas.js","sourceRoot":"","sources":["../../src/server/mcp-input-schemas.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;AAElF,4BAA4B;AAE5B;;;;;;;;;;;;;;;;;;GAkBG;AAEH,6GAA6G;AAChG,QAAA,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAEvF,kGAAkG;AACrF,QAAA,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAEpC,0DAA0D;AAC7C,QAAA,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAErD,sEAAsE;AACzD,QAAA,QAAQ,GAAG,CAAC;KACpB,MAAM,CAAC;IACJ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACvD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC1D,CAAC;KACD,MAAM,EAAE,CAAC;AAEd;;;GAGG;AACU,QAAA,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAT,iBAAS,EAAE,CAAC,CAAC;AAEnE;;;;GAIG;AACU,QAAA,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAChF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACzF,CAAC,CAAC"}

package/lib/server/mcp-label-provider.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 { GLabel, GModelElement } from '@eclipse-glsp/server';
+export declare const McpLabelProvider: unique symbol;
+/**
+ * Locates the {@link GLabel} that primarily represents an element to a user. Centralises the
+ * label-lookup logic so both LLM-facing reads (label-text echoes in tool results,
+ * `query-elements` rendering) and writes (`ApplyLabelEditOperation` from `create-nodes` /
+ * `modify-nodes`) share one override point.
+ *
+ * Diagram-scope: bound per GLSP session via {@link DefaultMcpDiagramModule.bindLabelProvider}.
+ * Adopters with non-trivial label structures (nested headers, compartments) override the
+ * {@link DefaultMcpLabelProvider} once instead of per-handler.
+ *
+ * @experimental
+ */
+export interface McpLabelProvider {
+    /**
+     * The {@link GLabel} primarily representing this element to a user. Returns `undefined`
+     * when the element has no label.
+     */
+    getLabel(element: GModelElement): GLabel | undefined;
+}
+/**
+ * Default {@link McpLabelProvider}: returns the first direct {@link GLabel} child. Adopters
+ * whose elements wrap labels in intermediary container nodes (headers, compartments) subclass
+ * and override {@link getLabel}.
+ */
+export declare class DefaultMcpLabelProvider implements McpLabelProvider {
+    getLabel(element: GModelElement): GLabel | undefined;
+}
+//# sourceMappingURL=mcp-label-provider.d.ts.map

package/lib/server/mcp-label-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-label-provider.d.ts","sourceRoot":"","sources":["../../src/server/mcp-label-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG7D,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;;;GAIG;AACH,qBACa,uBAAwB,YAAW,gBAAgB;IAC5D,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;CAGvD"}

package/lib/server/mcp-label-provider.js

@@ -0,0 +1,42 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultMcpLabelProvider = exports.McpLabelProvider = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+exports.McpLabelProvider = Symbol('McpLabelProvider');
+/**
+ * Default {@link McpLabelProvider}: returns the first direct {@link GLabel} child. Adopters
+ * whose elements wrap labels in intermediary container nodes (headers, compartments) subclass
+ * and override {@link getLabel}.
+ */
+let DefaultMcpLabelProvider = class DefaultMcpLabelProvider {
+    getLabel(element) {
+        return element.children.find((child) => child instanceof server_1.GLabel);
+    }
+};
+exports.DefaultMcpLabelProvider = DefaultMcpLabelProvider;
+exports.DefaultMcpLabelProvider = DefaultMcpLabelProvider = __decorate([
+    (0, inversify_1.injectable)()
+], DefaultMcpLabelProvider);
+//# sourceMappingURL=mcp-label-provider.js.map

package/lib/server/mcp-label-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-label-provider.js","sourceRoot":"","sources":["../../src/server/mcp-label-provider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;AAElF,iDAA6D;AAC7D,yCAAuC;AAE1B,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAsB3D;;;;GAIG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAChC,QAAQ,CAAC,OAAsB;QAC3B,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,YAAY,eAAM,CAAC,CAAC;IACtF,CAAC;CACJ,CAAA;AAJY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,sBAAU,GAAE;GACA,uBAAuB,CAInC"}

package/lib/server/mcp-log-level-registry.d.ts

@@ -0,0 +1,54 @@
+/********************************************************************************
+ * 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 { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
+export declare const McpLogLevelRegistry: unique symbol;
+/**
+ * Per-MCP-session minimum-severity threshold for `notifications/message`. Updated by the
+ * server's `logging/setLevel` request handler (registered in {@link McpServerLauncher} on
+ * session-init); read by {@link McpLogger} to gate message delivery.
+ *
+ * Bound as a server-scope singleton: one registry shared across MCP sessions, keyed by
+ * session id. On session-close, the entry is cleared so a recycled session id does not
+ * inherit a stale threshold.
+ */
+export interface McpLogLevelRegistry {
+    /** Update the minimum severity for a session. Called by the SDK setLevel request handler. */
+    setLevel(sessionId: string, level: LoggingLevel): void;
+    /** Resolve the active threshold for a session, falling back to the default for unknown ids. */
+    getLevel(sessionId: string | undefined): LoggingLevel;
+    /** Drop the per-session entry on session-close. */
+    clear(sessionId: string): void;
+}
+/**
+ * Returns `true` iff a message of severity {@link level} should be delivered given the
+ * session's current {@link threshold}. A `setLevel('warning')` call drops `notice`, `info`,
+ * and `debug`; `setLevel('debug')` keeps everything (the default).
+ */
+export declare function passesLogThreshold(level: LoggingLevel, threshold: LoggingLevel): boolean;
+export declare class DefaultMcpLogLevelRegistry implements McpLogLevelRegistry {
+    /**
+     * Default threshold used when the client has not sent `logging/setLevel`. `'debug'` is the
+     * MCP-spec-permitted "send everything" mode (the spec lets the server decide if no
+     * setLevel was received). Set wide so adopters who never wire setLevel see the same
+     * verbose behavior the server had before this registry existed.
+     */
+    static readonly DEFAULT_LEVEL: LoggingLevel;
+    protected readonly levels: Map<string, LoggingLevel>;
+    setLevel(sessionId: string, level: LoggingLevel): void;
+    getLevel(sessionId: string | undefined): LoggingLevel;
+    clear(sessionId: string): void;
+}
+//# sourceMappingURL=mcp-log-level-registry.d.ts.map

package/lib/server/mcp-log-level-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-log-level-registry.d.ts","sourceRoot":"","sources":["../../src/server/mcp-log-level-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACvD,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,mDAAmD;IACnD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAiBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAExF;AAED,qBACa,0BAA2B,YAAW,mBAAmB;IAClE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAW;IAEtD,SAAS,CAAC,QAAQ,CAAC,MAAM,4BAAmC;IAE5D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAItD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY;IAOrD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/lib/server/mcp-log-level-registry.js

@@ -0,0 +1,80 @@
+"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 DefaultMcpLogLevelRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultMcpLogLevelRegistry = exports.McpLogLevelRegistry = void 0;
+exports.passesLogThreshold = passesLogThreshold;
+const inversify_1 = require("inversify");
+exports.McpLogLevelRegistry = Symbol('McpLogLevelRegistry');
+/**
+ * RFC 5424 severity numbering, mirroring the MCP `LoggingLevel` enum. Lower number = more
+ * severe; the threshold compares numerically.
+ */
+const SEVERITY = {
+    emergency: 0,
+    alert: 1,
+    critical: 2,
+    error: 3,
+    warning: 4,
+    notice: 5,
+    info: 6,
+    debug: 7
+};
+/**
+ * Returns `true` iff a message of severity {@link level} should be delivered given the
+ * session's current {@link threshold}. A `setLevel('warning')` call drops `notice`, `info`,
+ * and `debug`; `setLevel('debug')` keeps everything (the default).
+ */
+function passesLogThreshold(level, threshold) {
+    return SEVERITY[level] <= SEVERITY[threshold];
+}
+let DefaultMcpLogLevelRegistry = DefaultMcpLogLevelRegistry_1 = class DefaultMcpLogLevelRegistry {
+    constructor() {
+        this.levels = new Map();
+    }
+    setLevel(sessionId, level) {
+        this.levels.set(sessionId, level);
+    }
+    getLevel(sessionId) {
+        var _a;
+        if (sessionId === undefined) {
+            return DefaultMcpLogLevelRegistry_1.DEFAULT_LEVEL;
+        }
+        return (_a = this.levels.get(sessionId)) !== null && _a !== void 0 ? _a : DefaultMcpLogLevelRegistry_1.DEFAULT_LEVEL;
+    }
+    clear(sessionId) {
+        this.levels.delete(sessionId);
+    }
+};
+exports.DefaultMcpLogLevelRegistry = DefaultMcpLogLevelRegistry;
+/**
+ * Default threshold used when the client has not sent `logging/setLevel`. `'debug'` is the
+ * MCP-spec-permitted "send everything" mode (the spec lets the server decide if no
+ * setLevel was received). Set wide so adopters who never wire setLevel see the same
+ * verbose behavior the server had before this registry existed.
+ */
+DefaultMcpLogLevelRegistry.DEFAULT_LEVEL = 'debug';
+exports.DefaultMcpLogLevelRegistry = DefaultMcpLogLevelRegistry = DefaultMcpLogLevelRegistry_1 = __decorate([
+    (0, inversify_1.injectable)()
+], DefaultMcpLogLevelRegistry);
+//# sourceMappingURL=mcp-log-level-registry.js.map

package/lib/server/mcp-log-level-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-log-level-registry.js","sourceRoot":"","sources":["../../src/server/mcp-log-level-registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;AA6ClF,gDAEC;AA5CD,yCAAuC;AAE1B,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAoBjE;;;GAGG;AACH,MAAM,QAAQ,GAAiC;IAC3C,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACX,CAAC;AAEF;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAmB,EAAE,SAAuB;IAC3E,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAGM,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IAAhC;QASgB,WAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAgBhE,CAAC;IAdG,QAAQ,CAAC,SAAiB,EAAE,KAAmB;QAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ,CAAC,SAA6B;;QAClC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,4BAA0B,CAAC,aAAa,CAAC;QACpD,CAAC;QACD,OAAO,MAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,mCAAI,4BAA0B,CAAC,aAAa,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,SAAiB;QACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;;AAxBQ,gEAA0B;AACnC;;;;;GAKG;AACa,wCAAa,GAAiB,OAAO,AAAxB,CAAyB;qCAP7C,0BAA0B;IADtC,IAAA,sBAAU,GAAE;GACA,0BAA0B,CAyBtC"}

package/lib/server/mcp-logger.d.ts

@@ -0,0 +1,59 @@
+/********************************************************************************
+ * 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 { Logger } from '@eclipse-glsp/server';
+import type { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
+import { McpLogLevelRegistry } from './mcp-log-level-registry';
+/**
+ * Logger that writes to BOTH the GLSP-side server log and the connected MCP client.
+ *
+ * Mirrors the {@link Logger} shape so handlers can drop-in switch from `@inject(Logger)` to
+ * `@inject(McpLogger)`. The server-side route always fires; the MCP-side route fires only when
+ * a call is made from inside an MCP request callback (tracked via {@link mcpRequestContext}).
+ *
+ * We deliberately do NOT auto-forward arbitrary GLSP `Logger.info` calls to MCP clients —
+ * that would leak unrelated server-wide log lines into every connected LLM. Adopters opt in
+ * per-handler by injecting `McpLogger` instead of `Logger`.
+ *
+ * Level mapping (GLSP → MCP, RFC 5424 names per the MCP spec):
+ *  - `info`  → `info`
+ *  - `warn`  → `warning`
+ *  - `error` → `error`
+ *  - `debug` → `debug`
+ *
+ * Shared across MCP clients on the same GLSP session; per-client routing is handled by the
+ * active `mcpRequestContext` frame, and the per-MCP-session `logging/setLevel` threshold is
+ * stored in {@link McpLogLevelRegistry}.
+ *
+ * @experimental
+ */
+export declare class McpLogger {
+    protected glspLogger: Logger;
+    protected levelRegistry: McpLogLevelRegistry;
+    info(message: string, ...meta: unknown[]): void;
+    warn(message: string, ...meta: unknown[]): void;
+    error(message: string, ...meta: unknown[]): void;
+    debug(message: string, ...meta: unknown[]): void;
+    /**
+     * Send a `notifications/message` to the connected MCP client when invoked inside an active
+     * request context AND the message passes the session's `logging/setLevel` threshold.
+     * Outside a request context (init contributions, background timers) this is a no-op so the
+     * same logger can be used everywhere without orphan-notification leaks.
+     *
+     * Failures to deliver are swallowed — a broken transport must not break the producing tool.
+     */
+    protected notify(level: LoggingLevel, data: string): void;
+}
+//# sourceMappingURL=mcp-logger.d.ts.map

package/lib/server/mcp-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-logger.d.ts","sourceRoot":"","sources":["../../src/server/mcp-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,0BAA0B,CAAC;AAGnF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,SAAS;IACF,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAE1E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAW5D"}

package/lib/server/mcp-logger.js

@@ -0,0 +1,104 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpLogger = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const mcp_log_level_registry_1 = require("./mcp-log-level-registry");
+const mcp_request_context_1 = require("./mcp-request-context");
+/**
+ * Logger that writes to BOTH the GLSP-side server log and the connected MCP client.
+ *
+ * Mirrors the {@link Logger} shape so handlers can drop-in switch from `@inject(Logger)` to
+ * `@inject(McpLogger)`. The server-side route always fires; the MCP-side route fires only when
+ * a call is made from inside an MCP request callback (tracked via {@link mcpRequestContext}).
+ *
+ * We deliberately do NOT auto-forward arbitrary GLSP `Logger.info` calls to MCP clients —
+ * that would leak unrelated server-wide log lines into every connected LLM. Adopters opt in
+ * per-handler by injecting `McpLogger` instead of `Logger`.
+ *
+ * Level mapping (GLSP → MCP, RFC 5424 names per the MCP spec):
+ *  - `info`  → `info`
+ *  - `warn`  → `warning`
+ *  - `error` → `error`
+ *  - `debug` → `debug`
+ *
+ * Shared across MCP clients on the same GLSP session; per-client routing is handled by the
+ * active `mcpRequestContext` frame, and the per-MCP-session `logging/setLevel` threshold is
+ * stored in {@link McpLogLevelRegistry}.
+ *
+ * @experimental
+ */
+let McpLogger = class McpLogger {
+    info(message, ...meta) {
+        this.glspLogger.info(message, ...meta);
+        this.notify('info', message);
+    }
+    warn(message, ...meta) {
+        this.glspLogger.warn(message, ...meta);
+        this.notify('warning', message);
+    }
+    error(message, ...meta) {
+        this.glspLogger.error(message, ...meta);
+        this.notify('error', message);
+    }
+    debug(message, ...meta) {
+        this.glspLogger.debug(message, ...meta);
+        this.notify('debug', message);
+    }
+    /**
+     * Send a `notifications/message` to the connected MCP client when invoked inside an active
+     * request context AND the message passes the session's `logging/setLevel` threshold.
+     * Outside a request context (init contributions, background timers) this is a no-op so the
+     * same logger can be used everywhere without orphan-notification leaks.
+     *
+     * Failures to deliver are swallowed — a broken transport must not break the producing tool.
+     */
+    notify(level, data) {
+        const extra = mcp_request_context_1.mcpRequestContext.getStore();
+        if (!extra) {
+            return;
+        }
+        const threshold = this.levelRegistry.getLevel(extra.sessionId);
+        if (!(0, mcp_log_level_registry_1.passesLogThreshold)(level, threshold)) {
+            return;
+        }
+        extra.sendNotification({ method: 'notifications/message', params: { level, data } }).catch(() => undefined);
+    }
+};
+exports.McpLogger = McpLogger;
+__decorate([
+    (0, inversify_1.inject)(server_1.Logger),
+    __metadata("design:type", server_1.Logger)
+], McpLogger.prototype, "glspLogger", void 0);
+__decorate([
+    (0, inversify_1.inject)(mcp_log_level_registry_1.McpLogLevelRegistry),
+    __metadata("design:type", Object)
+], McpLogger.prototype, "levelRegistry", void 0);
+exports.McpLogger = McpLogger = __decorate([
+    (0, inversify_1.injectable)()
+], McpLogger);
+//# sourceMappingURL=mcp-logger.js.map

package/lib/server/mcp-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-logger.js","sourceRoot":"","sources":["../../src/server/mcp-logger.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;AAElF,iDAA8C;AAE9C,yCAA+C;AAC/C,qEAAmF;AACnF,+DAA0D;AAE1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEI,IAAM,SAAS,GAAf,MAAM,SAAS;IAKlB,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACO,MAAM,CAAC,KAAmB,EAAE,IAAY;QAC9C,MAAM,KAAK,GAAG,uCAAiB,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;QACX,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAA,2CAAkB,EAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YACxC,OAAO;QACX,CAAC;QACD,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChH,CAAC;CACJ,CAAA;AA5CY,8BAAS;AACQ;IAAzB,IAAA,kBAAM,EAAC,eAAM,CAAC;8BAAuB,eAAM;6CAAC;AAEN;IAAtC,IAAA,kBAAM,EAAC,4CAAmB,CAAC;;gDAA8C;oBAHjE,SAAS;IADrB,IAAA,sBAAU,GAAE;GACA,SAAS,CA4CrB"}

package/lib/server/mcp-mime-types.d.ts

@@ -0,0 +1,28 @@
+/********************************************************************************
+ * 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 { ProposalString } from '@eclipse-glsp/protocol';
+/**
+ * MIME type for an MCP resource. Annotating a `mimeType` field with this type prompts the IDE
+ * to suggest the listed common values; any other string the MCP SDK accepts is also valid (the
+ * `(string & {})` part of `ProposalString` keeps the field free-form).
+ *
+ * Unlike `MarkersReason` / `EditMode` (closed sets of framework-defined enum values), MIME
+ * types are open and IANA-defined — the listed literals are common, not exhaustive. There's
+ * no companion const object: at the call site, adopters write the string literal directly
+ * (`readonly mimeType: McpMimeType = 'image/png';`).
+ */
+export type McpMimeType = ProposalString<'text/plain' | 'text/markdown' | 'text/html' | 'application/json' | 'image/png' | 'image/jpeg' | 'image/svg+xml'>;
+//# sourceMappingURL=mcp-mime-types.d.ts.map

package/lib/server/mcp-mime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-mime-types.d.ts","sourceRoot":"","sources":["../../src/server/mcp-mime-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,CACpC,YAAY,GAAG,eAAe,GAAG,WAAW,GAAG,kBAAkB,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CACnH,CAAC"}

package/lib/server/mcp-mime-types.js

@@ -0,0 +1,18 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-mime-types.js.map

package/lib/server/mcp-mime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-mime-types.js","sourceRoot":"","sources":["../../src/server/mcp-mime-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF"}

package/lib/server/mcp-options.d.ts

@@ -0,0 +1,39 @@
+/********************************************************************************
+ * 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 { McpServerOptions as McpServerOptionsType } from '@eclipse-glsp/protocol';
+/**
+ * Holds the launcher-scoped MCP options. The launcher merges adopter-provided defaults
+ * (passed to the {@link AbstractMcpServerModule} constructor, bound as
+ * {@link McpServerDefaults}) with deployment-time overrides from the GLSP `initialize` request,
+ * then writes the merged result to `values`. Consumers `@inject(McpServerOptions)` and read
+ * `.values.<key>` directly.
+ *
+ * Bound as a singleton on the server container — the shared reference means server-scope
+ * singletons constructed before init still observe populated values once init runs.
+ *
+ * @experimental
+ */
+export declare class McpServerOptions {
+    values: McpServerOptionsType;
+}
+/**
+ * DI binding identifier for adopter-provided default options. Supplied via the
+ * {@link AbstractMcpServerModule} constructor and merged with init-time options by
+ * `McpServerLauncher.initializeServer` — init-time wins per field.
+ */
+export declare const McpServerDefaults: unique symbol;
+export type McpServerDefaults = McpServerOptionsType;
+//# sourceMappingURL=mcp-options.d.ts.map

package/lib/server/mcp-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-options.d.ts","sourceRoot":"","sources":["../../src/server/mcp-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGlF;;;;;;;;;;;GAWG;AACH,qBACa,gBAAgB;IACzB,MAAM,EAAE,oBAAoB,CAAM;CACrC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC"}

package/lib/server/mcp-options.js

@@ -0,0 +1,53 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerDefaults = exports.McpServerOptions = void 0;
+const inversify_1 = require("inversify");
+/**
+ * Holds the launcher-scoped MCP options. The launcher merges adopter-provided defaults
+ * (passed to the {@link AbstractMcpServerModule} constructor, bound as
+ * {@link McpServerDefaults}) with deployment-time overrides from the GLSP `initialize` request,
+ * then writes the merged result to `values`. Consumers `@inject(McpServerOptions)` and read
+ * `.values.<key>` directly.
+ *
+ * Bound as a singleton on the server container — the shared reference means server-scope
+ * singletons constructed before init still observe populated values once init runs.
+ *
+ * @experimental
+ */
+let McpServerOptions = class McpServerOptions {
+    constructor() {
+        this.values = {};
+    }
+};
+exports.McpServerOptions = McpServerOptions;
+exports.McpServerOptions = McpServerOptions = __decorate([
+    (0, inversify_1.injectable)()
+], McpServerOptions);
+/**
+ * DI binding identifier for adopter-provided default options. Supplied via the
+ * {@link AbstractMcpServerModule} constructor and merged with init-time options by
+ * `McpServerLauncher.initializeServer` — init-time wins per field.
+ */
+exports.McpServerDefaults = Symbol('McpServerDefaults');
+//# sourceMappingURL=mcp-options.js.map