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

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

@@ -0,0 +1,212 @@
+/********************************************************************************
+ * 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 { ActionDispatcher, Logger, MaybePromise, ModelState, RequestAction, ResponseAction } from '@eclipse-glsp/server';
+import { CompleteResourceTemplateCallback, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Variables } from '@modelcontextprotocol/sdk/shared/uriTemplate.js';
+import { Annotations, ListResourcesResult, Role } from '@modelcontextprotocol/sdk/types.js';
+import { interfaces } from 'inversify';
+import { ZodObject, ZodRawShape } from 'zod/v4';
+import { GLSPMcpServer } from './glsp-mcp-server';
+import { McpResourceContent, McpResourceResult, McpToolResult } from './mcp-handler-shared';
+import { McpIdAliasService } from './mcp-id-alias-service';
+import { McpDiagramScopedInput } from './mcp-input-schemas';
+import { McpMimeType } from './mcp-mime-types';
+/**
+ * Multi-binding key for **server-scope** resource handlers — singletons that don't target a
+ * specific GLSP client session. For diagram-scope resources see
+ * {@link McpDiagramResourceHandlerConstructor}.
+ *
+ * @experimental
+ */
+export interface McpResourceHandler {
+    registerResource(server: GLSPMcpServer): void;
+    /** Optional tool fallback for clients that don't speak the resources protocol. */
+    registerToolAlternative?(server: GLSPMcpServer): void;
+}
+export declare const McpResourceHandler: unique symbol;
+/** Static URI (string) or templated URI (`{ template: string }`). The base branches on shape. */
+export type McpResourceUri = string | {
+    template: string;
+};
+/** Shared infrastructure for both server- and diagram-scope resource handlers. */
+declare abstract class BaseMcpResourceHandler {
+    protected logger: Logger;
+    /**
+     * Resource identifier exposed to the MCP client. Also used to reference this resource 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 resource catalog. Keep concise — clients pass this verbatim to the model. */
+    abstract readonly description: string;
+    /** MIME type of the resource body. Adopters typically use one of {@link McpMimeType}'s common values; any string the MCP SDK accepts is valid. */
+    abstract readonly mimeType: McpMimeType;
+    /** Static URI string for fixed resources, or `{ template: string }` for templated URIs (e.g. `glsp://diagrams/{sessionId}/model`). */
+    abstract readonly uri: McpResourceUri;
+    /** Optional human-friendly display name for UIs that render a friendlier label than `name`. */
+    readonly title?: string;
+    /**
+     * Intended audience(s) — `"user"` (display the rendered content), `"assistant"` (use as model
+     * context), or both. Clients use it to filter/route the resource.
+     */
+    readonly audience?: Role[];
+    /** Importance, 0.0–1.0. Clients use it to prioritize inclusion in context. */
+    readonly priority?: number;
+    /** ISO 8601 timestamp of last meaningful change. Omit when the server has no clean freshness signal. */
+    readonly lastModified?: string;
+    /**
+     * Assembles the {@link Annotations} object the SDK expects from the flat-field surface.
+     * Returns `undefined` when no field is set so `resources/list` entries don't carry an
+     * empty `annotations: {}`.
+     */
+    toAnnotations(): Annotations | undefined;
+    /**
+     * Set to a `z.object({...})` schema to also expose the resource as a tool fallback (for MCP
+     * clients that don't speak the resources protocol). Field shape mirrors `inputSchema` on
+     * tool handlers — declarative, no extra method.
+     */
+    readonly toolAlternativeInputSchema?: ZodObject<ZodRawShape>;
+    /**
+     * Optional dual-emit output schema applied **only** in tool-alternative mode (when
+     * {@link toolAlternativeInputSchema} is set). When declared, the handler should populate
+     * `structured` on the returned {@link McpResourceContent} so the framework can forward it
+     * to `CallToolResult.structuredContent`. Resource-protocol reads ignore this — the spec
+     * has no equivalent slot on `ReadResourceResult`.
+     */
+    readonly toolAlternativeOutputSchema?: ZodObject<ZodRawShape>;
+    /** Override for templated URIs — enumerate matching resources. */
+    list?(): MaybePromise<ListResourcesResult>;
+    /** Override for templated URIs — completers per template variable. */
+    complete?(): Record<string, CompleteResourceTemplateCallback>;
+    /** Resolve `this.uri` (which may be a fixed string or a template object) to a template string. */
+    protected uriTemplate(): string;
+    /**
+     * Replace `{key}` placeholders in the URI template with the supplied values, single-pass
+     * (no re-expansion of substituted text) and `encodeURIComponent`-escaped. Unmatched keys
+     * pass through verbatim so the caller can spot them.
+     */
+    protected expandUriTemplate(vars: Record<string, string>): string;
+    /** Catches `McpToolError` (→ surfaced as text content + isError) and unexpected errors. */
+    protected execute(producer: () => MaybePromise<McpResourceContent>): Promise<ResourceExecutionResult>;
+    /** Wraps the body returned by {@link createResult} with `uri` + `mimeType` for the SDK. */
+    toResourceResult(uri: string, result: ResourceExecutionResult): McpResourceResult;
+    /** Converts the body to a `CallToolResult` for tool-alternative mode. Image MIMEs render as `image` content. */
+    toToolResult(result: ResourceExecutionResult): McpToolResult;
+    /** Builds the SDK `ResourceTemplate` for templated URIs (server-scope path). */
+    protected buildResourceTemplate(template: string): ResourceTemplate;
+}
+export type ResourceExecutionResult = {
+    ok: true;
+    body: McpResourceContent;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Server-scope resource base — for resources that don't target a specific GLSP client session
+ * (e.g., a hypothetical adopter-supplied "global config" resource that returns the same data
+ * regardless of which diagram is open). The instance exists at boot, so `list`/`complete` can
+ * `@inject` server-scope deps directly. Bound under {@link McpResourceHandler}; the launcher
+ * invokes `registerResource(server)` once per MCP session.
+ *
+ * @experimental
+ */
+export declare abstract class AbstractMcpResourceHandler<T = Record<string, unknown>> extends BaseMcpResourceHandler implements McpResourceHandler {
+    /** Throw {@link McpToolError} for expected errors; the base wraps. */
+    protected abstract createResult(params: T): MaybePromise<McpResourceContent>;
+    registerResource(server: GLSPMcpServer): void;
+    /** No-op when no {@link toolAlternativeInputSchema} is declared; otherwise registers as a tool. */
+    registerToolAlternative(server: GLSPMcpServer): void;
+    protected doRegisterToolAlternative(server: GLSPMcpServer): void;
+}
+/**
+ * Diagram-scope resource base — for resources whose URI templates carry a `sessionId` (e.g.,
+ * `glsp://diagrams/{sessionId}/model`).
+ *
+ * Unlike the server-scope base, the diagram-scope handler does not register itself with the
+ * SDK. The launcher's dispatcher reads the per-diagram-type constructor list, registers a
+ * single resource entry per `name`, and routes incoming reads to the matching per-GLSP-session
+ * handler instance via {@link handleRead}. For `list`/`complete`, the launcher walks all open
+ * GLSP sessions and aggregates each instance's slice — see {@link glspSessionScopedComplete}
+ * for the cross-GLSP-session-pollution auto-guard.
+ *
+ * @experimental
+ */
+export declare abstract class AbstractMcpDiagramResourceHandler<T extends McpDiagramScopedInput = McpDiagramScopedInput> extends BaseMcpResourceHandler {
+    protected clientId: string;
+    protected modelState: ModelState;
+    protected aliasService: McpIdAliasService;
+    protected actionDispatcher: ActionDispatcher;
+    /** Throw {@link McpToolError} for expected errors; the base wraps. */
+    protected abstract createResult(params: T): MaybePromise<McpResourceContent>;
+    /**
+     * Convenience for resource handlers that fulfil a read by initiating a `RequestAction`
+     * round-trip to the client (today: `diagram-png` → `RequestExportAction`). Wraps
+     * {@link requestActionOrFail} with `this.actionDispatcher` and a default label of
+     * `this.name`. Pass an explicit label only to disambiguate between multiple round-trips.
+     */
+    protected requestAction<R extends ResponseAction>(request: RequestAction<R>, timeoutMs: number, label?: string): Promise<R>;
+    /** Override to opt out of registration when a runtime dependency is missing. Default: `true`. */
+    canRegister(): boolean;
+    /**
+     * Default `list()` for the per-session-single-resource case (diagram-model, diagram-png).
+     * Emits one entry resolved against the URI template, named with the handler's title and
+     * the GLSP session id, described with the handler's `description`. Multi-resource
+     * handlers (e.g. `element-types`, which lists once per diagram type) override.
+     */
+    list(): ListResourcesResult;
+    /**
+     * Default `complete()` for templated URIs that include `{sessionId}`. Returns a single
+     * completer that resolves to the current GLSP session's id. Handlers with other template
+     * variables (e.g. `{diagramType}` on `element-types`) override.
+     */
+    complete(): Record<string, CompleteResourceTemplateCallback>;
+    /** Default per-session entry built from the handler's metadata. Override to customize. */
+    protected toListingEntry(): ListResourcesResult['resources'][number];
+    /**
+     * Public dispatch entry point invoked by {@link McpServerLauncher}'s SDK callback for
+     * resource reads. The launcher passes the URI it received from the SDK plus the URI-template
+     * variable values normalized into a flat record.
+     */
+    handleRead(uri: string, params: T): Promise<McpResourceResult>;
+    /**
+     * Public dispatch entry point invoked by the launcher when the resource is exposed as a
+     * tool fallback (`McpServerOptions.resources === false`).
+     */
+    handleAsTool(params: T): Promise<McpToolResult>;
+    /**
+     * Wraps adopter-provided {@link complete} callbacks with the cross-GLSP-session-pollution
+     * auto-guard: when a templated URI carries `{sessionId}` and the LLM has bound a specific
+     * session id, completers for OTHER variables should not leak data from sessions whose ids
+     * don't match. The wrapper auto-returns `[]` from a GLSP session whose id doesn't match
+     * `ctx.arguments.sessionId`. Adopters write completers as if they only see their own GLSP
+     * session's data — the framework enforces the guard.
+     *
+     * Invoked by the launcher's aggregator, not by adopters directly.
+     */
+    glspSessionScopedComplete(): Record<string, CompleteResourceTemplateCallback>;
+}
+/** Normalizes SDK `Variables` (each value is `string | string[]`) to a flat `Record<string, string>`. */
+export declare function toParams(variables: Variables): Record<string, string>;
+/**
+ * Multi-binding identifier for diagram-scope resource handler constructors. See
+ * {@link McpDiagramToolHandlerConstructor} for the lifecycle pattern — same shape, applied to
+ * resource handlers.
+ */
+export type McpDiagramResourceHandlerConstructor = interfaces.Newable<AbstractMcpDiagramResourceHandler<any>>;
+export declare const McpDiagramResourceHandlerConstructor: unique symbol;
+export {};
+//# sourceMappingURL=mcp-resource-handler.d.ts.map

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

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

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

@@ -0,0 +1,298 @@
+"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.McpDiagramResourceHandlerConstructor = exports.AbstractMcpDiagramResourceHandler = exports.AbstractMcpResourceHandler = exports.McpResourceHandler = void 0;
+exports.toParams = toParams;
+const server_1 = require("@eclipse-glsp/server");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+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.McpResourceHandler = Symbol('McpResourceHandler');
+/** Shared infrastructure for both server- and diagram-scope resource handlers. */
+let BaseMcpResourceHandler = class BaseMcpResourceHandler {
+    /**
+     * Assembles the {@link Annotations} object the SDK expects from the flat-field surface.
+     * Returns `undefined` when no field is set so `resources/list` entries don't carry an
+     * empty `annotations: {}`.
+     */
+    toAnnotations() {
+        if (this.audience === undefined && this.priority === undefined && this.lastModified === undefined) {
+            return undefined;
+        }
+        return {
+            ...(this.audience !== undefined ? { audience: this.audience } : {}),
+            ...(this.priority !== undefined ? { priority: this.priority } : {}),
+            ...(this.lastModified !== undefined ? { lastModified: this.lastModified } : {})
+        };
+    }
+    /** Resolve `this.uri` (which may be a fixed string or a template object) to a template string. */
+    uriTemplate() {
+        return typeof this.uri === 'string' ? this.uri : this.uri.template;
+    }
+    /**
+     * Replace `{key}` placeholders in the URI template with the supplied values, single-pass
+     * (no re-expansion of substituted text) and `encodeURIComponent`-escaped. Unmatched keys
+     * pass through verbatim so the caller can spot them.
+     */
+    expandUriTemplate(vars) {
+        return this.uriTemplate().replace(/\{(\w+)\}/g, (placeholder, key) => {
+            const value = vars[key];
+            return value === undefined ? placeholder : encodeURIComponent(value);
+        });
+    }
+    /** Catches `McpToolError` (→ surfaced as text content + isError) and unexpected errors. */
+    async execute(producer) {
+        try {
+            return { ok: true, body: await producer() };
+        }
+        catch (err) {
+            if (err instanceof mcp_handler_shared_1.McpToolError) {
+                return { ok: false, message: err.message };
+            }
+            const message = (0, mcp_handler_shared_1.extractErrorMessage)(err);
+            this.logger.error(`Unexpected error in resource '${this.name}': ${message}`, err);
+            return { ok: false, message };
+        }
+    }
+    /** Wraps the body returned by {@link createResult} with `uri` + `mimeType` for the SDK. */
+    toResourceResult(uri, result) {
+        if (!result.ok) {
+            return { contents: [{ uri, mimeType: 'text/plain', text: result.message }], isError: true };
+        }
+        const content = 'text' in result.body
+            ? { uri, mimeType: this.mimeType, text: result.body.text }
+            : { uri, mimeType: this.mimeType, blob: result.body.blob };
+        return { contents: [content], isError: false };
+    }
+    /** Converts the body to a `CallToolResult` for tool-alternative mode. Image MIMEs render as `image` content. */
+    toToolResult(result) {
+        if (!result.ok) {
+            return { isError: true, content: [{ type: 'text', text: result.message }] };
+        }
+        const structuredContent = result.body.structured;
+        const baseContent = 'text' in result.body
+            ? { isError: false, content: [{ type: 'text', text: result.body.text }] }
+            : { isError: false, content: [{ type: 'image', data: result.body.blob, mimeType: this.mimeType }] };
+        return structuredContent ? { ...baseContent, structuredContent } : baseContent;
+    }
+    /** Builds the SDK `ResourceTemplate` for templated URIs (server-scope path). */
+    buildResourceTemplate(template) {
+        var _a;
+        return new mcp_js_1.ResourceTemplate(template, {
+            list: this.list ? async (extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.list()) : undefined,
+            complete: (_a = this.complete) === null || _a === void 0 ? void 0 : _a.call(this)
+        });
+    }
+};
+__decorate([
+    (0, inversify_1.inject)(server_1.Logger),
+    __metadata("design:type", server_1.Logger)
+], BaseMcpResourceHandler.prototype, "logger", void 0);
+BaseMcpResourceHandler = __decorate([
+    (0, inversify_1.injectable)()
+], BaseMcpResourceHandler);
+/**
+ * Server-scope resource base — for resources that don't target a specific GLSP client session
+ * (e.g., a hypothetical adopter-supplied "global config" resource that returns the same data
+ * regardless of which diagram is open). The instance exists at boot, so `list`/`complete` can
+ * `@inject` server-scope deps directly. Bound under {@link McpResourceHandler}; the launcher
+ * invokes `registerResource(server)` once per MCP session.
+ *
+ * @experimental
+ */
+let AbstractMcpResourceHandler = class AbstractMcpResourceHandler extends BaseMcpResourceHandler {
+    registerResource(server) {
+        const annotations = this.toAnnotations();
+        const config = {
+            title: this.title,
+            description: this.description,
+            mimeType: this.mimeType,
+            ...(annotations ? { annotations } : {})
+        };
+        if (typeof this.uri === 'string') {
+            const uri = this.uri;
+            server.registerResource(this.name, uri, config, async (_uri, extra) => mcp_request_context_1.mcpRequestContext.run(extra, async () => this.toResourceResult(uri, await this.execute(() => this.createResult({})))));
+        }
+        else {
+            server.registerResource(this.name, this.buildResourceTemplate(this.uri.template), config, async (uri, params, extra) => mcp_request_context_1.mcpRequestContext.run(extra, async () => this.toResourceResult(uri.toString(), await this.execute(() => this.createResult(toParams(params))))));
+        }
+    }
+    /** No-op when no {@link toolAlternativeInputSchema} is declared; otherwise registers as a tool. */
+    registerToolAlternative(server) {
+        if (!this.toolAlternativeInputSchema) {
+            return;
+        }
+        this.doRegisterToolAlternative(server);
+    }
+    doRegisterToolAlternative(server) {
+        const inputSchema = this.toolAlternativeInputSchema;
+        // `.strict()` matches the tool-handler policy — see `BaseMcpToolHandler.toRegistrationConfig`
+        // for the full rationale (LLM-typoed fields surface as JSON-RPC validation errors instead
+        // of being silently stripped).
+        server.registerTool(this.name, {
+            title: this.title,
+            description: this.description,
+            inputSchema: inputSchema.strict(),
+            outputSchema: this.toolAlternativeOutputSchema
+        }, async (params, extra) => mcp_request_context_1.mcpRequestContext.run(extra, async () => this.toToolResult(await this.execute(() => this.createResult(params)))));
+    }
+};
+exports.AbstractMcpResourceHandler = AbstractMcpResourceHandler;
+exports.AbstractMcpResourceHandler = AbstractMcpResourceHandler = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractMcpResourceHandler);
+/**
+ * Diagram-scope resource base — for resources whose URI templates carry a `sessionId` (e.g.,
+ * `glsp://diagrams/{sessionId}/model`).
+ *
+ * Unlike the server-scope base, the diagram-scope handler does not register itself with the
+ * SDK. The launcher's dispatcher reads the per-diagram-type constructor list, registers a
+ * single resource entry per `name`, and routes incoming reads to the matching per-GLSP-session
+ * handler instance via {@link handleRead}. For `list`/`complete`, the launcher walks all open
+ * GLSP sessions and aggregates each instance's slice — see {@link glspSessionScopedComplete}
+ * for the cross-GLSP-session-pollution auto-guard.
+ *
+ * @experimental
+ */
+let AbstractMcpDiagramResourceHandler = class AbstractMcpDiagramResourceHandler extends BaseMcpResourceHandler {
+    /**
+     * Convenience for resource handlers that fulfil a read by initiating a `RequestAction`
+     * round-trip to the client (today: `diagram-png` → `RequestExportAction`). Wraps
+     * {@link requestActionOrFail} with `this.actionDispatcher` and a default label of
+     * `this.name`. Pass an explicit label only to disambiguate between multiple round-trips.
+     */
+    requestAction(request, timeoutMs, label = this.name) {
+        return (0, mcp_handler_shared_1.requestActionOrFail)(this.actionDispatcher, request, timeoutMs, label);
+    }
+    /** Override to opt out of registration when a runtime dependency is missing. Default: `true`. */
+    canRegister() {
+        return true;
+    }
+    /**
+     * Default `list()` for the per-session-single-resource case (diagram-model, diagram-png).
+     * Emits one entry resolved against the URI template, named with the handler's title and
+     * the GLSP session id, described with the handler's `description`. Multi-resource
+     * handlers (e.g. `element-types`, which lists once per diagram type) override.
+     */
+    list() {
+        return { resources: [this.toListingEntry()] };
+    }
+    /**
+     * Default `complete()` for templated URIs that include `{sessionId}`. Returns a single
+     * completer that resolves to the current GLSP session's id. Handlers with other template
+     * variables (e.g. `{diagramType}` on `element-types`) override.
+     */
+    complete() {
+        if (this.uriTemplate().includes('{sessionId}')) {
+            return { sessionId: async () => [this.clientId] };
+        }
+        return {};
+    }
+    /** Default per-session entry built from the handler's metadata. Override to customize. */
+    toListingEntry() {
+        var _a;
+        const annotations = this.toAnnotations();
+        return {
+            uri: this.expandUriTemplate({ sessionId: this.clientId }),
+            name: `${(_a = this.title) !== null && _a !== void 0 ? _a : this.name}: ${this.clientId}`,
+            description: this.description,
+            mimeType: this.mimeType,
+            ...(annotations ? { annotations } : {})
+        };
+    }
+    /**
+     * Public dispatch entry point invoked by {@link McpServerLauncher}'s SDK callback for
+     * resource reads. The launcher passes the URI it received from the SDK plus the URI-template
+     * variable values normalized into a flat record.
+     */
+    async handleRead(uri, params) {
+        return this.toResourceResult(uri, await this.execute(() => this.createResult(params)));
+    }
+    /**
+     * Public dispatch entry point invoked by the launcher when the resource is exposed as a
+     * tool fallback (`McpServerOptions.resources === false`).
+     */
+    async handleAsTool(params) {
+        return this.toToolResult(await this.execute(() => this.createResult(params)));
+    }
+    /**
+     * Wraps adopter-provided {@link complete} callbacks with the cross-GLSP-session-pollution
+     * auto-guard: when a templated URI carries `{sessionId}` and the LLM has bound a specific
+     * session id, completers for OTHER variables should not leak data from sessions whose ids
+     * don't match. The wrapper auto-returns `[]` from a GLSP session whose id doesn't match
+     * `ctx.arguments.sessionId`. Adopters write completers as if they only see their own GLSP
+     * session's data — the framework enforces the guard.
+     *
+     * Invoked by the launcher's aggregator, not by adopters directly.
+     */
+    glspSessionScopedComplete() {
+        var _a, _b;
+        const raw = (_b = (_a = this.complete) === null || _a === void 0 ? void 0 : _a.call(this)) !== null && _b !== void 0 ? _b : {};
+        const myId = this.clientId;
+        const isGlspSessionScoped = typeof this.uri === 'object' && this.uri.template.includes('{sessionId}');
+        const wrapped = {};
+        for (const [variable, completer] of Object.entries(raw)) {
+            wrapped[variable] =
+                variable === 'sessionId' || !isGlspSessionScoped
+                    ? completer
+                    : async (value, ctx) => { var _a; return (((_a = ctx === null || ctx === void 0 ? void 0 : ctx.arguments) === null || _a === void 0 ? void 0 : _a.sessionId) === myId ? completer(value, ctx) : []); };
+        }
+        return wrapped;
+    }
+};
+exports.AbstractMcpDiagramResourceHandler = AbstractMcpDiagramResourceHandler;
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientId),
+    __metadata("design:type", String)
+], AbstractMcpDiagramResourceHandler.prototype, "clientId", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ModelState),
+    __metadata("design:type", Object)
+], AbstractMcpDiagramResourceHandler.prototype, "modelState", void 0);
+__decorate([
+    (0, inversify_1.inject)(mcp_id_alias_service_1.McpIdAliasService),
+    __metadata("design:type", Object)
+], AbstractMcpDiagramResourceHandler.prototype, "aliasService", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ActionDispatcher),
+    __metadata("design:type", Object)
+], AbstractMcpDiagramResourceHandler.prototype, "actionDispatcher", void 0);
+exports.AbstractMcpDiagramResourceHandler = AbstractMcpDiagramResourceHandler = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractMcpDiagramResourceHandler);
+/** Normalizes SDK `Variables` (each value is `string | string[]`) to a flat `Record<string, string>`. */
+function toParams(variables) {
+    var _a;
+    const out = {};
+    for (const [key, value] of Object.entries(variables)) {
+        out[key] = Array.isArray(value) ? (_a = value[0]) !== null && _a !== void 0 ? _a : '' : value;
+    }
+    return out;
+}
+exports.McpDiagramResourceHandlerConstructor = Symbol('McpDiagramResourceHandlerConstructor');
+//# sourceMappingURL=mcp-resource-handler.js.map

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

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