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

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-options.js","sourceRoot":"","sources":["../../src/server/mcp-options.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;AAGlF,yCAAuC;AAEvC;;;;;;;;;;;GAWG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAAtB;QACH,WAAM,GAAyB,EAAE,CAAC;IACtC,CAAC;CAAA,CAAA;AAFY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,sBAAU,GAAE;GACA,gBAAgB,CAE5B;AAED;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/lib/server/mcp-progress-reporter.d.ts

@@ -0,0 +1,48 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Per-call shape of a `notifications/progress` emission. Mirrors the SDK's
+ * `ProgressNotificationParams` minus the `progressToken` field (the reporter pulls that from
+ * the active request context — the caller's job is just to describe the progress beat).
+ */
+export interface McpProgressBeat {
+    /** Monotonic progress count. Spec is loose; convention: increment from 0 toward `total` if known, or use seconds-elapsed otherwise. */
+    progress: number;
+    /** Total when known (e.g. number of nodes to process). Omit when bounded only by a timeout. */
+    total?: number;
+    /** Short user-facing description; surfaces in compatible clients' UI. */
+    message?: string;
+}
+/**
+ * Emits `notifications/progress` to the connected MCP client when the active request carries a
+ * `progressToken` in its `_meta`. Built on the same {@link mcpRequestContext} as
+ * {@link McpLogger}; handlers don't need to thread `extra` through their own signatures.
+ *
+ * Behaviour:
+ *  - Outside a request context (init, background): no-op.
+ *  - Inside a request context with no `progressToken` (client didn't opt in): no-op.
+ *    Universally supported per spec — clients that don't render progress simply omit the token.
+ *  - Failures to deliver are swallowed: a broken transport must not break the producing tool.
+ *
+ * Shared across MCP clients on the same GLSP session; per-client routing is handled by the
+ * active `mcpRequestContext` frame.
+ *
+ * @experimental
+ */
+export declare class McpProgressReporter {
+    emit(beat: McpProgressBeat): Promise<void>;
+}
+//# sourceMappingURL=mcp-progress-reporter.d.ts.map

package/lib/server/mcp-progress-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-progress-reporter.d.ts","sourceRoot":"","sources":["../../src/server/mcp-progress-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAKlF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,uIAAuI;IACvI,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBACa,mBAAmB;IACtB,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAenD"}

package/lib/server/mcp-progress-reporter.js

@@ -0,0 +1,66 @@
+"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.McpProgressReporter = void 0;
+const inversify_1 = require("inversify");
+const mcp_request_context_1 = require("./mcp-request-context");
+/**
+ * Emits `notifications/progress` to the connected MCP client when the active request carries a
+ * `progressToken` in its `_meta`. Built on the same {@link mcpRequestContext} as
+ * {@link McpLogger}; handlers don't need to thread `extra` through their own signatures.
+ *
+ * Behaviour:
+ *  - Outside a request context (init, background): no-op.
+ *  - Inside a request context with no `progressToken` (client didn't opt in): no-op.
+ *    Universally supported per spec — clients that don't render progress simply omit the token.
+ *  - Failures to deliver are swallowed: a broken transport must not break the producing tool.
+ *
+ * Shared across MCP clients on the same GLSP session; per-client routing is handled by the
+ * active `mcpRequestContext` frame.
+ *
+ * @experimental
+ */
+let McpProgressReporter = class McpProgressReporter {
+    async emit(beat) {
+        var _a;
+        const extra = mcp_request_context_1.mcpRequestContext.getStore();
+        const progressToken = (_a = extra === null || extra === void 0 ? void 0 : extra._meta) === null || _a === void 0 ? void 0 : _a.progressToken;
+        if (extra === undefined || progressToken === undefined) {
+            return;
+        }
+        try {
+            await extra.sendNotification({
+                method: 'notifications/progress',
+                params: { progressToken, ...beat }
+            });
+        }
+        catch {
+            // Fire-and-forget — never propagate transport errors into tool execution.
+        }
+    }
+};
+exports.McpProgressReporter = McpProgressReporter;
+exports.McpProgressReporter = McpProgressReporter = __decorate([
+    (0, inversify_1.injectable)()
+], McpProgressReporter);
+//# sourceMappingURL=mcp-progress-reporter.js.map

package/lib/server/mcp-progress-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-progress-reporter.js","sourceRoot":"","sources":["../../src/server/mcp-progress-reporter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;AAElF,yCAAuC;AACvC,+DAA0D;AAgB1D;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC5B,KAAK,CAAC,IAAI,CAAC,IAAqB;;QAC5B,MAAM,KAAK,GAAG,uCAAiB,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,aAAa,GAAG,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,0CAAE,aAAa,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACrD,OAAO;QACX,CAAC;QACD,IAAI,CAAC;YACD,MAAM,KAAK,CAAC,gBAAgB,CAAC;gBACzB,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE;aACrC,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACL,0EAA0E;QAC9E,CAAC;IACL,CAAC;CACJ,CAAA;AAhBY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,sBAAU,GAAE;GACA,mBAAmB,CAgB/B"}

package/lib/server/mcp-prompt-handler.d.ts

@@ -0,0 +1,120 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+import { Logger, MaybePromise, ModelState } from '@eclipse-glsp/server';
+import { interfaces } from 'inversify';
+import { ZodObject, ZodRawShape } from 'zod/v4';
+import { GLSPMcpServer } from './glsp-mcp-server';
+import { McpPromptResult } from './mcp-handler-shared';
+import { McpIdAliasService } from './mcp-id-alias-service';
+import { McpDiagramScopedInput } from './mcp-input-schemas';
+/**
+ * Multi-binding key for **server-scope** prompt handlers — singletons that don't target a
+ * specific GLSP client session. Diagram-scope prompts (one instance per open diagram) use the
+ * separate {@link McpDiagramPromptHandlerConstructor} multi-binding instead.
+ *
+ * Prompts are LLM-facing message templates the AI client may invoke. No prompts ship by default;
+ * the surface exists for adopters.
+ *
+ * @experimental
+ */
+export interface McpPromptHandler {
+    /** Prompt identifier exposed to the MCP client; matches the abstract base's field. */
+    readonly name: string;
+    registerPrompt(server: GLSPMcpServer): void;
+    /** Tool names this prompt's text references via `${OtherHandler.NAME}`; default: empty. */
+    referencedToolNames(): string[];
+}
+export declare const McpPromptHandler: unique symbol;
+/** Shared infrastructure for both server- and diagram-scope prompt handlers. */
+declare abstract class BaseMcpPromptHandler {
+    protected logger: Logger;
+    /**
+     * Prompt identifier exposed to the MCP client. Also used to reference this prompt from
+     * other handlers' prompt or description text — wire via `static readonly NAME = '…'` and
+     * `readonly name = ClassName.NAME` so those cross-references survive renames.
+     */
+    abstract readonly name: string;
+    /** LLM-facing explanation surfaced in the prompt catalog. Keep concise — clients pass this verbatim to the model. */
+    abstract readonly description: string;
+    /** Adopter writes `z.object({ ... })`; the base passes `.shape` to the SDK. */
+    abstract readonly argsSchema: ZodObject<ZodRawShape>;
+    /** Optional human-friendly display name for UIs that render a friendlier label than `name`. */
+    readonly title?: string;
+    /** SDK-facing registration config; consumed by both registration paths. */
+    toRegistrationConfig(): {
+        title?: string;
+        description: string;
+        argsSchema: ZodRawShape;
+    };
+    /**
+     * Optional list of tool names this prompt's text refers to via `${OtherHandler.NAME}`
+     * substitutions. Default: empty. Override in concrete subclasses to declare references so
+     * the launcher can warn at registration time when an adopter unbinds a referenced tool —
+     * the prompt would otherwise still register and silently produce text pointing at a tool
+     * that no longer exists. Pure declarative metadata; never invoked at request time.
+     */
+    referencedToolNames(): string[];
+    /**
+     * Catches `McpToolError` (→ surfaced as a `user`-role assistant message) and unexpected
+     * errors (→ logged + extracted message). Errors map to a single text-content message so
+     * the LLM sees the failure in the prompt response.
+     */
+    protected execute(producer: () => MaybePromise<McpPromptResult>): Promise<McpPromptResult>;
+    protected errorResult(message: string): McpPromptResult;
+}
+/**
+ * Server-scope prompt base — for prompts that don't target a specific GLSP client session
+ * (e.g., a prompt that summarizes the system's state). Bound under {@link McpPromptHandler};
+ * the launcher invokes `registerPrompt(server)` once per MCP session.
+ *
+ * @experimental
+ */
+export declare abstract class AbstractMcpPromptHandler<T = Record<string, unknown>> extends BaseMcpPromptHandler implements McpPromptHandler {
+    /** Throw {@link McpToolError} for expected errors; the base wraps. */
+    protected abstract createResult(args: T): MaybePromise<McpPromptResult>;
+    registerPrompt(server: GLSPMcpServer): void;
+}
+/**
+ * Diagram-scope prompt base — for prompts whose argument schema carries a `sessionId`
+ * (e.g., a `describe-diagram` prompt for one open diagram).
+ *
+ * The launcher's dispatcher resolves `args.sessionId` to the right GLSP session and invokes
+ * {@link handle} on this session's per-instance handler. From the handler's perspective the
+ * session is implicit — `this.clientId`, `this.modelState`, `this.aliasService` (and any
+ * adopter `@inject(...)` fields) all resolve to that GLSP session's container.
+ *
+ * @experimental
+ */
+export declare abstract class AbstractMcpDiagramPromptHandler<T extends McpDiagramScopedInput = McpDiagramScopedInput> extends BaseMcpPromptHandler {
+    protected clientId: string;
+    protected modelState: ModelState;
+    protected aliasService: McpIdAliasService;
+    /** Throw {@link McpToolError} for expected errors; the base wraps. */
+    protected abstract createResult(args: T): MaybePromise<McpPromptResult>;
+    /**
+     * Public dispatch entry point invoked by {@link McpServerLauncher}'s SDK callback.
+     */
+    handle(args: T): Promise<McpPromptResult>;
+}
+/**
+ * Multi-binding identifier for diagram-scope prompt handler constructors. See
+ * {@link McpDiagramToolHandlerConstructor} for the lifecycle pattern — same shape, applied to
+ * prompt handlers.
+ */
+export type McpDiagramPromptHandlerConstructor = interfaces.Newable<AbstractMcpDiagramPromptHandler<any>>;
+export declare const McpDiagramPromptHandlerConstructor: unique symbol;
+export {};
+//# sourceMappingURL=mcp-prompt-handler.d.ts.map

package/lib/server/mcp-prompt-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-prompt-handler.d.ts","sourceRoot":"","sources":["../../src/server/mcp-prompt-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAY,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAsB,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAqC,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C,2FAA2F;IAC3F,mBAAmB,IAAI,MAAM,EAAE,CAAC;CACnC;AACD,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D,gFAAgF;AAChF,uBACe,oBAAoB;IACf,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACrD,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,2EAA2E;IAC3E,oBAAoB,IAAI;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,WAAW,CAAA;KAAE;IAIxF;;;;;;OAMG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;OAIG;cACa,OAAO,CAAC,QAAQ,EAAE,MAAM,YAAY,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAahG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;CAG1D;AAED;;;;;;GAMG;AACH,8BACsB,wBAAwB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,oBAAqB,YAAW,gBAAgB;IAChI,sEAAsE;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,eAAe,CAAC;IAEvE,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;CAK9C;AAED;;;;;;;;;;GAUG;AACH,8BACsB,+BAA+B,CACjD,CAAC,SAAS,qBAAqB,GAAG,qBAAqB,CACzD,SAAQ,oBAAoB;IACR,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1B,SAAS,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAErE,sEAAsE;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,eAAe,CAAC;IAEvE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAG5C;AAED;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG,UAAU,CAAC,OAAO,CAAC,+BAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1G,eAAO,MAAM,kCAAkC,eAA+C,CAAC"}

package/lib/server/mcp-prompt-handler.js

@@ -0,0 +1,131 @@
+"use strict";
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+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.McpDiagramPromptHandlerConstructor = exports.AbstractMcpDiagramPromptHandler = exports.AbstractMcpPromptHandler = exports.McpPromptHandler = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const mcp_handler_shared_1 = require("./mcp-handler-shared");
+const mcp_id_alias_service_1 = require("./mcp-id-alias-service");
+const mcp_request_context_1 = require("./mcp-request-context");
+exports.McpPromptHandler = Symbol('McpPromptHandler');
+/** Shared infrastructure for both server- and diagram-scope prompt handlers. */
+let BaseMcpPromptHandler = class BaseMcpPromptHandler {
+    /** SDK-facing registration config; consumed by both registration paths. */
+    toRegistrationConfig() {
+        return { title: this.title, description: this.description, argsSchema: this.argsSchema.shape };
+    }
+    /**
+     * Optional list of tool names this prompt's text refers to via `${OtherHandler.NAME}`
+     * substitutions. Default: empty. Override in concrete subclasses to declare references so
+     * the launcher can warn at registration time when an adopter unbinds a referenced tool —
+     * the prompt would otherwise still register and silently produce text pointing at a tool
+     * that no longer exists. Pure declarative metadata; never invoked at request time.
+     */
+    referencedToolNames() {
+        return [];
+    }
+    /**
+     * Catches `McpToolError` (→ surfaced as a `user`-role assistant message) and unexpected
+     * errors (→ logged + extracted message). Errors map to a single text-content message so
+     * the LLM sees the failure in the prompt response.
+     */
+    async execute(producer) {
+        try {
+            return await producer();
+        }
+        catch (err) {
+            if (err instanceof mcp_handler_shared_1.McpToolError) {
+                return this.errorResult(err.message);
+            }
+            const message = (0, mcp_handler_shared_1.extractErrorMessage)(err);
+            this.logger.error(`Unexpected error in prompt '${this.name}': ${message}`, err);
+            return this.errorResult(message);
+        }
+    }
+    errorResult(message) {
+        return { messages: [{ role: 'user', content: { type: 'text', text: message } }] };
+    }
+};
+__decorate([
+    (0, inversify_1.inject)(server_1.Logger),
+    __metadata("design:type", server_1.Logger)
+], BaseMcpPromptHandler.prototype, "logger", void 0);
+BaseMcpPromptHandler = __decorate([
+    (0, inversify_1.injectable)()
+], BaseMcpPromptHandler);
+/**
+ * Server-scope prompt base — for prompts that don't target a specific GLSP client session
+ * (e.g., a prompt that summarizes the system's state). Bound under {@link McpPromptHandler};
+ * the launcher invokes `registerPrompt(server)` once per MCP session.
+ *
+ * @experimental
+ */
+let AbstractMcpPromptHandler = class AbstractMcpPromptHandler extends BaseMcpPromptHandler {
+    registerPrompt(server) {
+        server.registerPrompt(this.name, this.toRegistrationConfig(), async (args, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.execute(() => this.createResult(args))));
+    }
+};
+exports.AbstractMcpPromptHandler = AbstractMcpPromptHandler;
+exports.AbstractMcpPromptHandler = AbstractMcpPromptHandler = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractMcpPromptHandler);
+/**
+ * Diagram-scope prompt base — for prompts whose argument schema carries a `sessionId`
+ * (e.g., a `describe-diagram` prompt for one open diagram).
+ *
+ * The launcher's dispatcher resolves `args.sessionId` to the right GLSP session and invokes
+ * {@link handle} on this session's per-instance handler. From the handler's perspective the
+ * session is implicit — `this.clientId`, `this.modelState`, `this.aliasService` (and any
+ * adopter `@inject(...)` fields) all resolve to that GLSP session's container.
+ *
+ * @experimental
+ */
+let AbstractMcpDiagramPromptHandler = class AbstractMcpDiagramPromptHandler extends BaseMcpPromptHandler {
+    /**
+     * Public dispatch entry point invoked by {@link McpServerLauncher}'s SDK callback.
+     */
+    handle(args) {
+        return this.execute(() => this.createResult(args));
+    }
+};
+exports.AbstractMcpDiagramPromptHandler = AbstractMcpDiagramPromptHandler;
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientId),
+    __metadata("design:type", String)
+], AbstractMcpDiagramPromptHandler.prototype, "clientId", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ModelState),
+    __metadata("design:type", Object)
+], AbstractMcpDiagramPromptHandler.prototype, "modelState", void 0);
+__decorate([
+    (0, inversify_1.inject)(mcp_id_alias_service_1.McpIdAliasService),
+    __metadata("design:type", Object)
+], AbstractMcpDiagramPromptHandler.prototype, "aliasService", void 0);
+exports.AbstractMcpDiagramPromptHandler = AbstractMcpDiagramPromptHandler = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractMcpDiagramPromptHandler);
+exports.McpDiagramPromptHandlerConstructor = Symbol('McpDiagramPromptHandlerConstructor');
+//# sourceMappingURL=mcp-prompt-handler.js.map

package/lib/server/mcp-prompt-handler.js.map

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

package/lib/server/mcp-request-context.d.ts

@@ -0,0 +1,37 @@
+/********************************************************************************
+ * 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 { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import { AsyncLocalStorage } from 'node:async_hooks';
+export type McpRequestExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+/**
+ * Module-level `AsyncLocalStorage` carrying the SDK's per-request `extra` (notification sender,
+ * progress token, request id, session id) for the duration of a tool/resource/prompt callback.
+ *
+ * The handler bases (tool / resource / prompt) wrap each registered SDK callback in
+ * `mcpRequestContext.run(extra, () => …)`. Anything inside the handler — and any await chain
+ * branching off it — can read the active context via {@link mcpRequestContext.getStore}.
+ *
+ * This lets {@link McpLogger} forward logs to the MCP client without every handler having to
+ * thread `extra` through its own signature, and lets future progress-emission code (P1f / PNG
+ * export) reach the same channel from inside `requestUntil` chains.
+ *
+ * Concurrent requests on the same MCP session each get their own AsyncLocalStorage frame —
+ * no cross-talk. Code that runs OUTSIDE a request (init contributions, background timers)
+ * sees `undefined` from `getStore()`.
+ */
+export declare const mcpRequestContext: AsyncLocalStorage<McpRequestExtra>;
+//# sourceMappingURL=mcp-request-context.d.ts.map

package/lib/server/mcp-request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-request-context.d.ts","sourceRoot":"","sources":["../../src/server/mcp-request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,oCAA2C,CAAC"}

package/lib/server/mcp-request-context.js

@@ -0,0 +1,37 @@
+"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.mcpRequestContext = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Module-level `AsyncLocalStorage` carrying the SDK's per-request `extra` (notification sender,
+ * progress token, request id, session id) for the duration of a tool/resource/prompt callback.
+ *
+ * The handler bases (tool / resource / prompt) wrap each registered SDK callback in
+ * `mcpRequestContext.run(extra, () => …)`. Anything inside the handler — and any await chain
+ * branching off it — can read the active context via {@link mcpRequestContext.getStore}.
+ *
+ * This lets {@link McpLogger} forward logs to the MCP client without every handler having to
+ * thread `extra` through its own signature, and lets future progress-emission code (P1f / PNG
+ * export) reach the same channel from inside `requestUntil` chains.
+ *
+ * Concurrent requests on the same MCP session each get their own AsyncLocalStorage frame —
+ * no cross-talk. Code that runs OUTSIDE a request (init contributions, background timers)
+ * sees `undefined` from `getStore()`.
+ */
+exports.mcpRequestContext = new node_async_hooks_1.AsyncLocalStorage();
+//# sourceMappingURL=mcp-request-context.js.map

package/lib/server/mcp-request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-request-context.js","sourceRoot":"","sources":["../../src/server/mcp-request-context.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;AAIlF,uDAAqD;AAIrD;;;;;;;;;;;;;;;GAeG;AACU,QAAA,iBAAiB,GAAG,IAAI,oCAAiB,EAAmB,CAAC"}