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

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

@@ -0,0 +1,143 @@
+/********************************************************************************
+ * 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 { BindingContext } from '@eclipse-glsp/protocol/lib/di';
+import { AbstractMultiBinding, BindingTarget, GLSPModule } from '@eclipse-glsp/server';
+import { interfaces } from 'inversify';
+import { GLSPMcpServerFactory } from './glsp-mcp-server';
+import { McpDiagramHandlerDispatcher } from './mcp-diagram-handler-dispatcher';
+import { McpLogLevelRegistry } from './mcp-log-level-registry';
+import { McpHttpTransport } from './mcp-http-transport';
+import { McpLogger } from './mcp-logger';
+import { McpServerDefaults, McpServerOptions } from './mcp-options';
+import { McpProgressReporter } from './mcp-progress-reporter';
+import { McpPromptHandler } from './mcp-prompt-handler';
+import { McpResourceHandler } from './mcp-resource-handler';
+import { McpServerLauncher } from './mcp-server-launcher';
+import { McpToolHandler } from './mcp-tool-handler';
+/**
+ * Multi-binding helper for MCP handler classes. Singleton-scoped sibling of core's
+ * `MultiBinding<T>` — same `binding.add(...)` / `binding.rebind(old, new)` adopter shape, but
+ * core's plain `MultiBinding` binds in transient scope, while MCP handlers cache deferred
+ * resolvers (selection/PNG round-trips) and need singleton scope to keep their state.
+ */
+export declare class McpHandlerMultiBinding<T> extends AbstractMultiBinding<interfaces.Newable<T>> {
+    applyBindings(context: BindingContext): void;
+}
+/**
+ * Server-scope DI module for the MCP server. Adopters subclass {@link DefaultMcpServerModule}
+ * and override the `bind*` hooks to swap single-instance services or the `configure*` hooks to
+ * add/replace handlers in the multi-bindings. Mirrors the `DiagramModule` pattern from core
+ * (`bindGModelSerializer()`, `configureActionHandlers(binding)`, etc.).
+ *
+ * Adopter-provided default option values flow through the constructor — pass a
+ * `Partial<McpServerOptions>` to override individual fields. The launcher then merges these
+ * defaults with init-time options from the GLSP `initialize` request (init-time wins per field).
+ *
+ * @example
+ * ```ts
+ * // Drop-in: GLSP defaults.
+ * launcher.configure(serverModule, new DefaultMcpServerModule());
+ *
+ * // Drop-in with a product-specific override.
+ * launcher.configure(serverModule, new DefaultMcpServerModule({ dataMode: 'resources' }));
+ *
+ * // Subclass when handler customization is needed.
+ * class WorkflowMcpServerModule extends DefaultMcpServerModule {
+ *     constructor() { super({ agentPersona: WORKFLOW_PERSONA }); }
+ *     protected override configureToolHandlers(binding) {
+ *         super.configureToolHandlers(binding);
+ *         binding.add(WorkflowSpecificTool);
+ *     }
+ * }
+ * ```
+ */
+export declare abstract class AbstractMcpServerModule extends GLSPModule {
+    protected readonly defaultOptions: McpServerDefaults;
+    protected bind: interfaces.Bind;
+    protected rebind: interfaces.Rebind;
+    constructor(defaultOptions?: McpServerDefaults);
+    protected configure(bind: interfaces.Bind, _unbind: interfaces.Unbind, isBound: interfaces.IsBound, rebind: interfaces.Rebind): void;
+    /**
+     * {@link McpServerLauncher} binding. Bound as a singleton AND aliased to
+     * `GLSPServerInitializer` + `GLSPServerListener` (the launcher implements both).
+     * Override to swap in a custom launcher impl.
+     */
+    protected bindMcpServerLauncher(): BindingTarget<McpServerLauncher>;
+    /** {@link McpHttpTransport} binding. Override to swap to a different transport implementation. */
+    protected bindMcpHttpTransport(): BindingTarget<McpHttpTransport>;
+    /**
+     * {@link McpDiagramHandlerDispatcher} binding. Owns diagram-scope handler discovery,
+     * SDK registration, and per-call dispatch routing. Override (or `rebind` to a subclass)
+     * to customize registration without subclassing the launcher itself.
+     */
+    protected bindMcpDiagramHandlerDispatcher(): BindingTarget<McpDiagramHandlerDispatcher>;
+    /** {@link McpServerOptions} holder binding. Mutated at init by the launcher. */
+    protected bindMcpServerOptions(): BindingTarget<McpServerOptions>;
+    /**
+     * {@link McpServerDefaults} binding — adopter-supplied default option values flow through
+     * the constructor and land here as a constant. The launcher merges these defaults with
+     * init-time options at server init (init-time wins per field).
+     */
+    protected bindMcpServerDefaults(): BindingTarget<McpServerDefaults>;
+    /**
+     * {@link McpLogger} binding. Bound on the server container; per-session containers inherit
+     * it, so handlers at any scope can inject it; routes through the active MCP request via
+     * {@link mcpRequestContext}.
+     */
+    protected bindMcpLogger(): BindingTarget<McpLogger>;
+    /** {@link McpProgressReporter} binding. Same scope/lifecycle story as {@link bindMcpLogger}. */
+    protected bindMcpProgressReporter(): BindingTarget<McpProgressReporter>;
+    /**
+     * {@link McpLogLevelRegistry} binding — holds per-MCP-session `logging/setLevel` thresholds
+     * read by {@link McpLogger} when filtering `notifications/message`.
+     */
+    protected bindMcpLogLevelRegistry(): BindingTarget<McpLogLevelRegistry>;
+    /**
+     * {@link GLSPMcpServerFactory} binding — produces a fresh {@link DefaultGLSPMcpServer} per
+     * MCP-session-init call. Override to wrap the SDK `McpServer` differently (e.g. add custom
+     * middleware, swap the Proxy strategy).
+     */
+    protected bindGLSPMcpServerFactory(): BindingTarget<GLSPMcpServerFactory>;
+    /**
+     * Override to add or replace tool handlers. Adopters typically `super.configureToolHandlers(binding)`
+     * to keep the defaults, then `binding.add(MyTool)` for additions or
+     * `binding.rebind(StandardTool, MyTool)` for overrides.
+     */
+    protected configureToolHandlers(binding: McpHandlerMultiBinding<McpToolHandler>): void;
+    /** See {@link configureToolHandlers}. No server-scope resources ship by default. */
+    protected configureResourceHandlers(_binding: McpHandlerMultiBinding<McpResourceHandler>): void;
+    /**
+     * See {@link configureToolHandlers}. Server-scope by default because the shipped prompts
+     * (`describe-diagram`, `suggest-improvements`) are diagram-type-agnostic and resolve their
+     * target session at invocation time — diagram-scope adopters add prompts via
+     * {@link DefaultMcpDiagramModule.configurePromptHandlers}.
+     */
+    protected configurePromptHandlers(binding: McpHandlerMultiBinding<McpPromptHandler>): void;
+}
+/**
+ * Default {@link AbstractMcpServerModule} entry point. Ships GLSP-default option values (see
+ * {@link DEFAULT_OPTIONS}) on top of the abstract module's hook defaults. Adopter-provided
+ * overrides via the constructor merge on top.
+ *
+ * @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.
+ */
+export declare class DefaultMcpServerModule extends AbstractMcpServerModule {
+    static readonly DEFAULT_OPTIONS: McpServerDefaults;
+    constructor(overrides?: McpServerDefaults);
+}
+//# sourceMappingURL=mcp-server-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-module.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server-module.ts"],"names":[],"mappings":"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"}

package/lib/server/mcp-server-module.js

@@ -0,0 +1,249 @@
+"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.DefaultMcpServerModule = exports.AbstractMcpServerModule = exports.McpHandlerMultiBinding = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const prompts_1 = require("../prompts");
+const tools_1 = require("../tools");
+const glsp_mcp_server_1 = require("./glsp-mcp-server");
+const mcp_diagram_handler_dispatcher_1 = require("./mcp-diagram-handler-dispatcher");
+const mcp_log_level_registry_1 = require("./mcp-log-level-registry");
+const lru_event_store_1 = require("./lru-event-store");
+const mcp_http_transport_1 = require("./mcp-http-transport");
+const mcp_logger_1 = require("./mcp-logger");
+const mcp_options_1 = require("./mcp-options");
+const mcp_progress_reporter_1 = require("./mcp-progress-reporter");
+const mcp_prompt_handler_1 = require("./mcp-prompt-handler");
+const mcp_resource_handler_1 = require("./mcp-resource-handler");
+const mcp_server_launcher_1 = require("./mcp-server-launcher");
+const mcp_tool_handler_1 = require("./mcp-tool-handler");
+/**
+ * GLSP-generic default agent persona — adopters typically pass a product-specific persona to
+ * the {@link DefaultMcpServerModule} constructor (e.g. workflow-server might say "You are the
+ * Workflow Modeling Agent...").
+ *
+ * **Spec note.** This is wired to the MCP `instructions` field, which the spec describes as
+ * "concise instructions". This persona is intentionally verbose (~700 chars of behavior rules)
+ * — within the spec's "free-form server-supplied instructions" allowance and adopter-overridable
+ * via `mcpDefaults.agentPersona`. Don't trim on autopilot if a "concise" interpretation drifts
+ * back: the verbose form materially improves LLM tool-use compliance for graphical modelling.
+ */
+const DEFAULT_AGENT_PERSONA = `
+You are the GLSP Modeling Agent. Your primary goal is to assist in the creation and modification of graphical models using the
+GLSP MCP server. You have to adhere to the following principles:
+- MCP-Interaction: Any modeling related activity has to occur using the MCP server.
+- Real Data: The diagram model is the ground truth regarding the existing graphical model. Always query it before modifying the diagram.
+- Real Creation: Consult the available element types before creating elements.
+- Visual Proof: An image of the graphical model can be created, if you deem it useful for calculating or verifying layout decisions.
+- Precision: All IDs and types must be exact.
+- Visualization: When creating nodes, suggest sensible default positions and avoid visual overlapping.
+- Careful: Under no circumstances save the model without explicit instruction. If you deem it sensible, you may ask the user for permission.
+  The same goes for Undo/Redo operations.
+- Layouting: If available, make use of automatic layouting when not given explicit custom layouting requirements.
+- Human-friendly references: When mentioning an element in user-visible prose, prefer its label, then its element type
+  (the bare ids returned by the tools are internal aliases that mean nothing to the user). Append the alias in parentheses
+  so the user can correlate it with follow-up tools. Use the \`set-selection\` tool — or the \`set-view\` tool with
+  \`action: "center-on-elements"\` — to point the user at the elements you reference.
+`;
+/**
+ * Multi-binding helper for MCP handler classes. Singleton-scoped sibling of core's
+ * `MultiBinding<T>` — same `binding.add(...)` / `binding.rebind(old, new)` adopter shape, but
+ * core's plain `MultiBinding` binds in transient scope, while MCP handlers cache deferred
+ * resolvers (selection/PNG round-trips) and need singleton scope to keep their state.
+ */
+class McpHandlerMultiBinding extends server_1.AbstractMultiBinding {
+    applyBindings(context) {
+        this.bindings.forEach(handlerClass => {
+            if (!context.isBound(handlerClass)) {
+                context.bind(handlerClass).toSelf().inSingletonScope();
+            }
+            context.bind(this.identifier).toService(handlerClass);
+        });
+    }
+}
+exports.McpHandlerMultiBinding = McpHandlerMultiBinding;
+/**
+ * Server-scope DI module for the MCP server. Adopters subclass {@link DefaultMcpServerModule}
+ * and override the `bind*` hooks to swap single-instance services or the `configure*` hooks to
+ * add/replace handlers in the multi-bindings. Mirrors the `DiagramModule` pattern from core
+ * (`bindGModelSerializer()`, `configureActionHandlers(binding)`, etc.).
+ *
+ * Adopter-provided default option values flow through the constructor — pass a
+ * `Partial<McpServerOptions>` to override individual fields. The launcher then merges these
+ * defaults with init-time options from the GLSP `initialize` request (init-time wins per field).
+ *
+ * @example
+ * ```ts
+ * // Drop-in: GLSP defaults.
+ * launcher.configure(serverModule, new DefaultMcpServerModule());
+ *
+ * // Drop-in with a product-specific override.
+ * launcher.configure(serverModule, new DefaultMcpServerModule({ dataMode: 'resources' }));
+ *
+ * // Subclass when handler customization is needed.
+ * class WorkflowMcpServerModule extends DefaultMcpServerModule {
+ *     constructor() { super({ agentPersona: WORKFLOW_PERSONA }); }
+ *     protected override configureToolHandlers(binding) {
+ *         super.configureToolHandlers(binding);
+ *         binding.add(WorkflowSpecificTool);
+ *     }
+ * }
+ * ```
+ */
+class AbstractMcpServerModule extends server_1.GLSPModule {
+    constructor(defaultOptions = {}) {
+        super();
+        this.defaultOptions = defaultOptions;
+    }
+    configure(bind, _unbind, isBound, rebind) {
+        this.bind = bind;
+        this.rebind = rebind;
+        const context = { bind, isBound };
+        (0, server_1.applyBindingTarget)(context, mcp_server_launcher_1.McpServerLauncher, this.bindMcpServerLauncher()).inSingletonScope();
+        // The launcher is bound under two additional service identifiers so core's existing
+        // multi-bindings pick it up alongside the rest of the server's contributions/listeners.
+        bind(server_1.GLSPServerInitializer).toService(mcp_server_launcher_1.McpServerLauncher);
+        bind(server_1.GLSPServerListener).toService(mcp_server_launcher_1.McpServerLauncher);
+        (0, server_1.applyBindingTarget)(context, mcp_http_transport_1.McpHttpTransport, this.bindMcpHttpTransport()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, mcp_diagram_handler_dispatcher_1.McpDiagramHandlerDispatcher, this.bindMcpDiagramHandlerDispatcher()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, mcp_options_1.McpServerOptions, this.bindMcpServerOptions()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, mcp_options_1.McpServerDefaults, this.bindMcpServerDefaults());
+        (0, server_1.applyBindingTarget)(context, mcp_logger_1.McpLogger, this.bindMcpLogger()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, mcp_log_level_registry_1.McpLogLevelRegistry, this.bindMcpLogLevelRegistry()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, mcp_progress_reporter_1.McpProgressReporter, this.bindMcpProgressReporter()).inSingletonScope();
+        (0, server_1.applyBindingTarget)(context, glsp_mcp_server_1.GLSPMcpServerFactory, this.bindGLSPMcpServerFactory());
+        this.configureMultiBinding(new McpHandlerMultiBinding(mcp_tool_handler_1.McpToolHandler), binding => this.configureToolHandlers(binding));
+        this.configureMultiBinding(new McpHandlerMultiBinding(mcp_resource_handler_1.McpResourceHandler), binding => this.configureResourceHandlers(binding));
+        this.configureMultiBinding(new McpHandlerMultiBinding(mcp_prompt_handler_1.McpPromptHandler), binding => this.configurePromptHandlers(binding));
+    }
+    /**
+     * {@link McpServerLauncher} binding. Bound as a singleton AND aliased to
+     * `GLSPServerInitializer` + `GLSPServerListener` (the launcher implements both).
+     * Override to swap in a custom launcher impl.
+     */
+    bindMcpServerLauncher() {
+        return mcp_server_launcher_1.McpServerLauncher;
+    }
+    /** {@link McpHttpTransport} binding. Override to swap to a different transport implementation. */
+    bindMcpHttpTransport() {
+        return mcp_http_transport_1.McpHttpTransport;
+    }
+    /**
+     * {@link McpDiagramHandlerDispatcher} binding. Owns diagram-scope handler discovery,
+     * SDK registration, and per-call dispatch routing. Override (or `rebind` to a subclass)
+     * to customize registration without subclassing the launcher itself.
+     */
+    bindMcpDiagramHandlerDispatcher() {
+        return mcp_diagram_handler_dispatcher_1.DefaultMcpDiagramHandlerDispatcher;
+    }
+    /** {@link McpServerOptions} holder binding. Mutated at init by the launcher. */
+    bindMcpServerOptions() {
+        return mcp_options_1.McpServerOptions;
+    }
+    /**
+     * {@link McpServerDefaults} binding — adopter-supplied default option values flow through
+     * the constructor and land here as a constant. The launcher merges these defaults with
+     * init-time options at server init (init-time wins per field).
+     */
+    bindMcpServerDefaults() {
+        return { constantValue: this.defaultOptions };
+    }
+    /**
+     * {@link McpLogger} binding. Bound on the server container; per-session containers inherit
+     * it, so handlers at any scope can inject it; routes through the active MCP request via
+     * {@link mcpRequestContext}.
+     */
+    bindMcpLogger() {
+        return mcp_logger_1.McpLogger;
+    }
+    /** {@link McpProgressReporter} binding. Same scope/lifecycle story as {@link bindMcpLogger}. */
+    bindMcpProgressReporter() {
+        return mcp_progress_reporter_1.McpProgressReporter;
+    }
+    /**
+     * {@link McpLogLevelRegistry} binding — holds per-MCP-session `logging/setLevel` thresholds
+     * read by {@link McpLogger} when filtering `notifications/message`.
+     */
+    bindMcpLogLevelRegistry() {
+        return mcp_log_level_registry_1.DefaultMcpLogLevelRegistry;
+    }
+    /**
+     * {@link GLSPMcpServerFactory} binding — produces a fresh {@link DefaultGLSPMcpServer} per
+     * MCP-session-init call. Override to wrap the SDK `McpServer` differently (e.g. add custom
+     * middleware, swap the Proxy strategy).
+     */
+    bindGLSPMcpServerFactory() {
+        return {
+            dynamicValue: ctx => {
+                const logger = ctx.container.get(server_1.Logger);
+                return (mcpServer, options) => new glsp_mcp_server_1.DefaultGLSPMcpServer(mcpServer, options, logger);
+            }
+        };
+    }
+    /**
+     * Override to add or replace tool handlers. Adopters typically `super.configureToolHandlers(binding)`
+     * to keep the defaults, then `binding.add(MyTool)` for additions or
+     * `binding.rebind(StandardTool, MyTool)` for overrides.
+     */
+    configureToolHandlers(binding) {
+        binding.add(tools_1.SessionInfoMcpToolHandler);
+        binding.add(tools_1.ElementTypesMcpToolHandler);
+    }
+    /** See {@link configureToolHandlers}. No server-scope resources ship by default. */
+    configureResourceHandlers(_binding) {
+        // empty by default
+    }
+    /**
+     * See {@link configureToolHandlers}. Server-scope by default because the shipped prompts
+     * (`describe-diagram`, `suggest-improvements`) are diagram-type-agnostic and resolve their
+     * target session at invocation time — diagram-scope adopters add prompts via
+     * {@link DefaultMcpDiagramModule.configurePromptHandlers}.
+     */
+    configurePromptHandlers(binding) {
+        binding.add(prompts_1.DescribeDiagramMcpPromptHandler);
+        binding.add(prompts_1.SuggestImprovementsMcpPromptHandler);
+    }
+}
+exports.AbstractMcpServerModule = AbstractMcpServerModule;
+/**
+ * Default {@link AbstractMcpServerModule} entry point. Ships GLSP-default option values (see
+ * {@link DEFAULT_OPTIONS}) on top of the abstract module's hook defaults. Adopter-provided
+ * overrides via the constructor merge on top.
+ *
+ * @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.
+ */
+class DefaultMcpServerModule extends AbstractMcpServerModule {
+    constructor(overrides = {}) {
+        super({ ...DefaultMcpServerModule.DEFAULT_OPTIONS, ...overrides });
+    }
+}
+exports.DefaultMcpServerModule = DefaultMcpServerModule;
+DefaultMcpServerModule.DEFAULT_OPTIONS = {
+    host: '127.0.0.1',
+    allowedHosts: ['127.0.0.1', 'localhost'],
+    // `allowedOrigins` deliberately undefined: accept absent Origin (typical for desktop-IDE
+    // MCP clients) and rely on Host validation to gate DNS-rebinding. Adopters whose
+    // deployment is browser-fronted set this explicitly to their frontend's origin.
+    dataMode: 'tools',
+    agentPersona: DEFAULT_AGENT_PERSONA,
+    // 10K events per session is generous for typical workloads (a few MB) and large enough
+    // that disconnects within seconds recover via `Last-Event-ID` resumability.
+    eventStoreLimit: lru_event_store_1.LruEventStore.DEFAULT_LIMIT
+};
+//# sourceMappingURL=mcp-server-module.js.map

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

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

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

@@ -0,0 +1,44 @@
+/********************************************************************************
+ * 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 type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+/**
+ * **Note on terminology** — the word "session" is overloaded in this codebase. Two
+ * independent concepts exist and must not be conflated:
+ *
+ * 1. **MCP session** (this file): one MCP client connection to the MCP HTTP endpoint, tracked by
+ *    {@link McpHttpTransport.sessions} keyed by the SDK-issued `mcp-session-id` HTTP header.
+ *    Created in `onsessioninitialized`, supports resumability across reconnects via
+ *    `Last-Event-ID`. Each {@link McpSession} corresponds to one underlying SDK `McpServer`
+ *    instance — multiple LLM clients can connect simultaneously, each with its own MCP session
+ *    and its own SDK server.
+ *
+ * 2. **GLSP client session** (core): one open diagram, tracked by core's `ClientSessionManager`
+ *    and represented by `ClientSession`. Tools/resources/prompts that target a specific diagram
+ *    receive the GLSP session id via `params.sessionId` in their input schema.
+ *
+ * The two are independent in lifetime and cardinality: a single MCP session sees ALL open GLSP
+ * sessions; a single GLSP session is visible to every connected MCP session. Names in this
+ * package distinguish them: anything with the `Mcp` prefix in {@link mcp-session.ts} or
+ * `mcp-http-transport.ts` is MCP-side; anything talking about diagrams (`AbstractMcpDiagram*`,
+ * `requireGlspSession`, `GlspSession`) is GLSP-side.
+ */
+export type McpSessionId = string;
+export type WithSessionId<T> = T & {
+    get sessionId(): McpSessionId;
+};
+/** SDK {@link Transport} widened with the session-id accessor every concrete MCP transport carries post-handshake. */
+export type McpSession = WithSessionId<Transport>;
+//# sourceMappingURL=mcp-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session.d.ts","sourceRoot":"","sources":["../../src/server/mcp-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,SAAS,IAAI,YAAY,CAAA;CAAE,CAAC;AAErE,sHAAsH;AACtH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC"}

package/lib/server/mcp-session.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-session.js.map

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

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