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

package/lib/server/mcp-diagram-handler-dispatcher.js

@@ -0,0 +1,382 @@
+"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.DefaultMcpDiagramHandlerDispatcher = exports.McpDiagramHandlerDispatcher = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const inversify_1 = require("inversify");
+const mcp_diagram_prompt_handler_registry_1 = require("./mcp-diagram-prompt-handler-registry");
+const mcp_diagram_resource_handler_registry_1 = require("./mcp-diagram-resource-handler-registry");
+const mcp_diagram_tool_handler_registry_1 = require("./mcp-diagram-tool-handler-registry");
+const mcp_handler_shared_1 = require("./mcp-handler-shared");
+const mcp_prompt_handler_1 = require("./mcp-prompt-handler");
+const mcp_request_context_1 = require("./mcp-request-context");
+const mcp_resource_handler_1 = require("./mcp-resource-handler");
+const mcp_tool_handler_1 = require("./mcp-tool-handler");
+exports.McpDiagramHandlerDispatcher = Symbol('McpDiagramHandlerDispatcher');
+let DefaultMcpDiagramHandlerDispatcher = class DefaultMcpDiagramHandlerDispatcher {
+    constructor() {
+        this.diagramCatalogs = [];
+    }
+    /**
+     * Build the per-diagram-type catalog by inspecting each diagram type's module set. We don't
+     * have a real GLSP session yet — and we don't want one, because we only need the bound
+     * constructor *lists*, not instances. So we spin up a throwaway child container per diagram
+     * type, load its modules plus a placeholder session module, and read out the multi-binding
+     * constants. No handler is instantiated; the temporary container is unbound immediately
+     * after.
+     *
+     * The placeholder session module is bound with the synthetic {@link TEMPORARY_CLIENT_ID} so
+     * any session-scoped `@inject(ClientId)` in module-load wiring resolves cleanly. Diagram
+     * modules must therefore treat `ClientId` as opaque at `configure()` time — the value they
+     * see at harvest is a placeholder, not the GLSP session that will later receive a call.
+     *
+     * Idempotent until {@link reset}.
+     */
+    harvest() {
+        if (this.diagramCatalogs.length > 0) {
+            return;
+        }
+        const catalogs = [];
+        const placeholderSessionModule = (0, server_1.createClientSessionModule)({
+            clientId: server_1.TEMPORARY_CLIENT_ID,
+            glspClient: { process: () => { } },
+            clientActionKinds: []
+        });
+        for (const [diagramType, modules] of this.diagramModules) {
+            const tempContainer = this.serverContainer.createChild();
+            tempContainer.load(...modules, placeholderSessionModule);
+            const tools = getConstructorList(tempContainer, mcp_tool_handler_1.McpDiagramToolHandlerConstructor);
+            const resources = getConstructorList(tempContainer, mcp_resource_handler_1.McpDiagramResourceHandlerConstructor);
+            const prompts = getConstructorList(tempContainer, mcp_prompt_handler_1.McpDiagramPromptHandlerConstructor);
+            tempContainer.unbindAll();
+            catalogs.push({ diagramType, toolConstructors: tools, resourceConstructors: resources, promptConstructors: prompts });
+        }
+        this.diagramCatalogs = catalogs;
+    }
+    /** True when at least one diagram type has at least one tool handler bound. */
+    hasDiagramTools() {
+        return this.diagramCatalogs.some(catalog => catalog.toolConstructors.length > 0);
+    }
+    /** True when at least one diagram type has at least one resource handler bound. */
+    hasDiagramResources() {
+        return this.diagramCatalogs.some(catalog => catalog.resourceConstructors.length > 0);
+    }
+    /** True when at least one diagram type has at least one prompt handler bound. */
+    hasDiagramPrompts() {
+        return this.diagramCatalogs.some(catalog => catalog.promptConstructors.length > 0);
+    }
+    /**
+     * Registers all diagram-scope tools/resources/prompts on the supplied per-MCP-session
+     * {@link GLSPMcpServer}. Resource registration shape depends on `dataMode`: `resources`
+     * registers them as URI-addressable resources; `tools` (default) registers each
+     * `toolAlternativeInputSchema`-bearing resource as a tool.
+     */
+    registerAll(glspMcpServer, resourcesAsResources) {
+        this.registerDiagramScopeTools(glspMcpServer);
+        this.registerDiagramScopeResources(glspMcpServer, resourcesAsResources);
+        this.registerDiagramScopePrompts(glspMcpServer);
+    }
+    registerDiagramScopeTools(glspMcpServer) {
+        var _a, _b;
+        const seen = new Map();
+        for (const catalog of this.diagramCatalogs) {
+            for (const Constructor of catalog.toolConstructors) {
+                const probe = new Constructor();
+                const fingerprint = {
+                    description: probe.description,
+                    inputKeys: Object.keys((_b = (_a = probe.inputSchema) === null || _a === void 0 ? void 0 : _a.shape) !== null && _b !== void 0 ? _b : {})
+                        .sort()
+                        .join(','),
+                    diagramType: catalog.diagramType
+                };
+                const existing = seen.get(probe.name);
+                if (existing) {
+                    if (existing.description !== fingerprint.description || existing.inputKeys !== fingerprint.inputKeys) {
+                        this.logger.warn(`Diagram-scope tool '${probe.name}' is registered by multiple diagram types with diverging schemas: ` +
+                            `first registered by '${existing.diagramType}', shadowed registration from '${catalog.diagramType}' ` +
+                            'is silently dropped. Either align schemas (description + inputSchema.shape keys must match) or ' +
+                            'pick distinct tool names.');
+                    }
+                    continue;
+                }
+                seen.set(probe.name, fingerprint);
+                glspMcpServer.registerTool(probe.name, probe.toRegistrationConfig(), (params, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.dispatchDiagramTool(probe.name, params)));
+            }
+        }
+    }
+    registerDiagramScopeResources(glspMcpServer, resourcesAsResources) {
+        const seenNames = new Set();
+        for (const catalog of this.diagramCatalogs) {
+            for (const Constructor of catalog.resourceConstructors) {
+                const probe = new Constructor();
+                if (seenNames.has(probe.name)) {
+                    continue;
+                }
+                seenNames.add(probe.name);
+                if (resourcesAsResources) {
+                    this.registerOneDiagramResource(glspMcpServer, probe);
+                }
+                else if (probe.toolAlternativeInputSchema) {
+                    this.registerOneDiagramResourceAsTool(glspMcpServer, probe);
+                }
+            }
+        }
+    }
+    registerOneDiagramResource(glspMcpServer, probe) {
+        const name = probe.name;
+        const annotations = probe.toAnnotations();
+        const config = {
+            title: probe.title,
+            description: probe.description,
+            mimeType: probe.mimeType,
+            ...(annotations ? { annotations } : {})
+        };
+        if (typeof probe.uri === 'string') {
+            const uri = probe.uri;
+            glspMcpServer.registerResource(name, uri, config, (_uri, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.dispatchStaticDiagramRead(name, uri)));
+        }
+        else {
+            const template = this.buildAggregatingResourceTemplate(probe.uri.template, name);
+            glspMcpServer.registerResource(name, template, config, (uri, params, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.dispatchTemplatedDiagramRead(name, uri, params)));
+        }
+    }
+    registerOneDiagramResourceAsTool(glspMcpServer, probe) {
+        const name = probe.name;
+        const inputSchema = probe.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).
+        glspMcpServer.registerTool(name, {
+            title: probe.title,
+            description: probe.description,
+            inputSchema: inputSchema.strict(),
+            outputSchema: probe.toolAlternativeOutputSchema
+        }, (params, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.dispatchDiagramResourceAsTool(name, params)));
+    }
+    registerDiagramScopePrompts(glspMcpServer) {
+        const seenNames = new Set();
+        for (const catalog of this.diagramCatalogs) {
+            for (const Constructor of catalog.promptConstructors) {
+                const probe = new Constructor();
+                if (seenNames.has(probe.name)) {
+                    continue;
+                }
+                seenNames.add(probe.name);
+                // Prompt errors propagate as JSON-RPC errors per spec — no `runWithToolErrorEnvelope` wrap.
+                glspMcpServer.registerPrompt(probe.name, probe.toRegistrationConfig(), (args, extra) => mcp_request_context_1.mcpRequestContext.run(extra, () => this.dispatchDiagramPrompt(probe.name, args)));
+            }
+        }
+    }
+    /**
+     * Builds an SDK `ResourceTemplate` whose `list`/`complete` walk all open GLSP sessions and
+     * aggregate the per-session handler results. The cross-GLSP-session-pollution guard for
+     * `complete` (auto-empty for non-matching sessions) is applied at the handler base level
+     * via {@link AbstractMcpDiagramResourceHandler.glspSessionScopedComplete}.
+     */
+    buildAggregatingResourceTemplate(uriTemplate, name) {
+        return new mcp_js_1.ResourceTemplate(uriTemplate, {
+            list: extra => mcp_request_context_1.mcpRequestContext.run(extra, () => this.aggregateList(name)),
+            complete: this.buildAggregatedCompleters(name)
+        });
+    }
+    async aggregateList(name) {
+        var _a;
+        const aggregated = [];
+        const seenUris = new Set();
+        for (const sessionId of this.clientSessionManager.getSessions().map(session => session.id)) {
+            const handler = this.findDiagramResourceHandler(name, sessionId);
+            const partial = await ((_a = handler === null || handler === void 0 ? void 0 : handler.list) === null || _a === void 0 ? void 0 : _a.call(handler));
+            if (!partial) {
+                continue;
+            }
+            for (const entry of partial.resources) {
+                if (!seenUris.has(entry.uri)) {
+                    seenUris.add(entry.uri);
+                    aggregated.push(entry);
+                }
+            }
+        }
+        return { resources: aggregated };
+    }
+    buildAggregatedCompleters(name) {
+        const variableNames = this.collectCompleterVariableNames(name);
+        const completers = {};
+        for (const variable of variableNames) {
+            completers[variable] = async (value, ctx) => {
+                const aggregated = new Set();
+                for (const sessionId of this.clientSessionManager.getSessions().map(session => session.id)) {
+                    const handler = this.findDiagramResourceHandler(name, sessionId);
+                    if (!handler) {
+                        continue;
+                    }
+                    const sessionScoped = handler.glspSessionScopedComplete();
+                    const completer = sessionScoped[variable];
+                    if (!completer) {
+                        continue;
+                    }
+                    const partial = await completer(value, ctx);
+                    partial.forEach(item => aggregated.add(item));
+                }
+                return [...aggregated];
+            };
+        }
+        return completers;
+    }
+    /** Probe each diagram type's resource constructor for `complete()` keys to wire SDK-side. */
+    collectCompleterVariableNames(name) {
+        var _a, _b;
+        const variables = new Set();
+        for (const catalog of this.diagramCatalogs) {
+            for (const Constructor of catalog.resourceConstructors) {
+                const probe = new Constructor();
+                if (probe.name !== name) {
+                    continue;
+                }
+                Object.keys((_b = (_a = probe.complete) === null || _a === void 0 ? void 0 : _a.call(probe)) !== null && _b !== void 0 ? _b : {}).forEach(key => variables.add(key));
+            }
+        }
+        return variables;
+    }
+    // ── Dispatch entry points ──────────────────────────────────────────────────
+    /** SDK-validated `params` against the registered Zod schema before this callback fires. */
+    dispatchDiagramTool(name, params) {
+        return (0, mcp_handler_shared_1.runWithToolErrorEnvelope)(async () => {
+            const handler = this.requireDiagramToolHandler(name, params);
+            return handler.handle(params);
+        });
+    }
+    /**
+     * Dispatch a read against a diagram-scope resource registered with a *static* (non-templated)
+     * URI. The URI carries no session id, so we pick the first open GLSP session as the source —
+     * adopters that need session-aware routing should register a templated URI instead.
+     */
+    dispatchStaticDiagramRead(name, uri) {
+        var _a;
+        const sessionId = (_a = this.clientSessionManager.getSessions()[0]) === null || _a === void 0 ? void 0 : _a.id;
+        if (!sessionId) {
+            throw new mcp_handler_shared_1.McpToolError(`No open GLSP session can serve resource '${name}'.`);
+        }
+        const handler = this.requireDiagramResourceHandler(name, sessionId);
+        return handler.handleRead(uri, { sessionId });
+    }
+    dispatchTemplatedDiagramRead(name, uri, params) {
+        const flat = (0, mcp_resource_handler_1.toParams)(params);
+        const handler = this.requireDiagramResourceHandler(name, flat.sessionId);
+        return handler.handleRead(uri.toString(), flat);
+    }
+    dispatchDiagramResourceAsTool(name, params) {
+        return (0, mcp_handler_shared_1.runWithToolErrorEnvelope)(async () => {
+            const handler = this.requireDiagramResourceHandler(name, this.extractSessionId(params));
+            return handler.handleAsTool(params);
+        });
+    }
+    dispatchDiagramPrompt(name, args) {
+        const handler = this.requireDiagramPromptHandler(name, args);
+        return handler.handle(args);
+    }
+    // ── Handler resolution ─────────────────────────────────────────────────────
+    /** Reads `sessionId` from a JSON-shaped tool/resource/prompt input without committing to the full schema. */
+    extractSessionId(params) {
+        return params.sessionId;
+    }
+    /** Resolves the per-GLSP-session tool handler for `params.sessionId`, throwing on miss. */
+    requireDiagramToolHandler(name, params) {
+        const session = this.requireGlspSession(this.extractSessionId(params));
+        const registry = session.container.get(mcp_diagram_tool_handler_registry_1.McpDiagramToolHandlerRegistry);
+        const handler = registry.get(name);
+        if (!handler) {
+            throw new mcp_handler_shared_1.McpToolError(`No tool handler '${name}' registered for diagram type '${session.diagramType}'.`);
+        }
+        return handler;
+    }
+    /** Resolves the per-GLSP-session resource handler for `sessionId`, throwing on miss. */
+    requireDiagramResourceHandler(name, sessionId) {
+        const session = this.requireGlspSession(sessionId);
+        const registry = session.container.get(mcp_diagram_resource_handler_registry_1.McpDiagramResourceHandlerRegistry);
+        const handler = registry.get(name);
+        if (!handler) {
+            throw new mcp_handler_shared_1.McpToolError(`No resource handler '${name}' registered for diagram type '${session.diagramType}'.`);
+        }
+        return handler;
+    }
+    /** Looks up the per-GLSP-session resource handler — returns `undefined` for an unknown id. */
+    findDiagramResourceHandler(name, sessionId) {
+        const session = this.clientSessionManager.getSession(sessionId);
+        if (!session) {
+            return undefined;
+        }
+        return session.container.get(mcp_diagram_resource_handler_registry_1.McpDiagramResourceHandlerRegistry).get(name);
+    }
+    requireDiagramPromptHandler(name, args) {
+        const session = this.requireGlspSession(this.extractSessionId(args));
+        const registry = session.container.get(mcp_diagram_prompt_handler_registry_1.McpDiagramPromptHandlerRegistry);
+        const handler = registry.get(name);
+        if (!handler) {
+            throw new mcp_handler_shared_1.McpToolError(`No prompt handler '${name}' registered for diagram type '${session.diagramType}'.`);
+        }
+        return handler;
+    }
+    requireGlspSession(sessionId) {
+        if (!sessionId) {
+            throw new mcp_handler_shared_1.McpMissingParamError('sessionId');
+        }
+        const session = this.clientSessionManager.getSession(sessionId);
+        if (!session) {
+            throw new mcp_handler_shared_1.McpSessionNotFoundError(sessionId);
+        }
+        return session;
+    }
+    /** Disposes the catalog so a subsequent {@link harvest} call re-reads the diagram modules. */
+    reset() {
+        this.diagramCatalogs = [];
+    }
+};
+exports.DefaultMcpDiagramHandlerDispatcher = DefaultMcpDiagramHandlerDispatcher;
+__decorate([
+    (0, inversify_1.inject)(server_1.InjectionContainer),
+    __metadata("design:type", inversify_1.Container)
+], DefaultMcpDiagramHandlerDispatcher.prototype, "serverContainer", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.DiagramModules),
+    __metadata("design:type", Map)
+], DefaultMcpDiagramHandlerDispatcher.prototype, "diagramModules", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], DefaultMcpDiagramHandlerDispatcher.prototype, "clientSessionManager", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.Logger),
+    __metadata("design:type", server_1.Logger)
+], DefaultMcpDiagramHandlerDispatcher.prototype, "logger", void 0);
+exports.DefaultMcpDiagramHandlerDispatcher = DefaultMcpDiagramHandlerDispatcher = __decorate([
+    (0, inversify_1.injectable)()
+], DefaultMcpDiagramHandlerDispatcher);
+/** Read an optional constructor-list multi-binding. Returns `[]` when no module bound the symbol. */
+function getConstructorList(container, identifier) {
+    return container.isBound(identifier) ? container.get(identifier) : [];
+}
+//# sourceMappingURL=mcp-diagram-handler-dispatcher.js.map

package/lib/server/mcp-diagram-handler-dispatcher.js.map

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

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

@@ -0,0 +1,123 @@
+/********************************************************************************
+ * 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 { BindingTarget, GLSPModule, InstanceMultiBinding } from '@eclipse-glsp/server';
+import { interfaces } from 'inversify';
+import { ElementTypesProvider } from '../resources/services/element-types-provider';
+import { McpModelSerializer } from '../resources/services/mcp-model-serializer';
+import { McpIdAliasService } from './mcp-id-alias-service';
+import { McpLabelProvider } from './mcp-label-provider';
+import { McpDiagramPromptHandlerConstructor } from './mcp-prompt-handler';
+import { McpDiagramResourceHandlerConstructor } from './mcp-resource-handler';
+import { McpDiagramToolHandlerConstructor } from './mcp-tool-handler';
+/**
+ * Per-GLSP-client-session DI module for the MCP server. Loaded inside `configureDiagramModule`
+ * so each `ClientSession.container` gets its own instance of session-scoped services.
+ *
+ * Binds the {@link McpIdAliasService}, the {@link McpModelSerializer}, the
+ * {@link ElementTypesProvider}, and the diagram-scope handler-constructor multi-bindings
+ * (`McpDiagram*HandlerConstructor`). Adopters subclass and override the `bind*` hooks to swap
+ * single-instance services and the `configure*` hooks to extend the multi-binding handler sets.
+ *
+ * @example
+ * ```ts
+ * class WorkflowMcpDiagramModule extends DefaultMcpDiagramModule {
+ *     // Single-instance binding: return the class.
+ *     protected override bindModelSerializer(): BindingTarget<McpModelSerializer> {
+ *         return WorkflowMcpModelSerializer;
+ *     }
+ *     // Multi-binding: extend or rebind the default set.
+ *     protected override configureToolHandlers(binding) {
+ *         super.configureToolHandlers(binding);
+ *         binding.add(WorkflowExtraTool);
+ *         binding.rebind(CreateNodesMcpToolHandler, WorkflowCreateNodesMcpToolHandler);
+ *     }
+ * }
+ * new WorkflowServerModule().configureDiagramModule(
+ *     new WorkflowDiagramModule(...),
+ *     elkLayoutModule,
+ *     new WorkflowMcpDiagramModule()
+ * );
+ * ```
+ */
+export declare abstract class AbstractMcpDiagramModule extends GLSPModule {
+    protected bind: interfaces.Bind;
+    protected rebind: interfaces.Rebind;
+    protected configure(bind: interfaces.Bind, _unbind: interfaces.Unbind, isBound: interfaces.IsBound, rebind: interfaces.Rebind): void;
+    /**
+     * Bind the per-GLSP-session handler registries, factories, and {@link ClientSessionInitializer}s
+     * that populate the registries at session-open. Adopters typically don't override.
+     *
+     * Each kind (tool / resource / prompt) follows the same shape:
+     *  - `Registry` — singleton-per-session, holds instantiated handlers keyed by `name`.
+     *  - `Factory` — `dynamicValue` that calls `ctx.container.resolve(constructor)`, so the
+     *    handler's `@inject(...)` fields resolve against the live `ClientSession.container`.
+     *  - `RegistryInitializer` — at session-open, reads the constructor multi-binding (added by
+     *    adopter `configure*Handlers` overrides) and instantiates each via the factory.
+     *    Picked up by Inversify alongside core's own `ClientSessionInitializer`s
+     *    (`OperationHandlerRegistryInitializer` etc.).
+     */
+    protected configureHandlerRegistries(): void;
+    /**
+     * {@link McpIdAliasService} binding. Override to swap in a custom alias strategy. Bind the
+     * shipped `NullMcpIdAliasService` (passthrough) to expose raw GLSP ids on the wire — useful
+     * for diagnostic readability or when token cost isn't a concern.
+     */
+    protected bindIdAliasService(): BindingTarget<McpIdAliasService>;
+    /**
+     * {@link McpLabelProvider} binding. Override to teach MCP about adopter-specific label
+     * locations (e.g., labels nested in header components or compartments). One override here
+     * covers every read-side echo and every write-side label-edit operation.
+     */
+    protected bindLabelProvider(): BindingTarget<McpLabelProvider>;
+    /**
+     * {@link McpModelSerializer} binding. Override to swap in a diagram-type-specific serializer
+     * (e.g. one that emits JSON, or knows the adopter's element schema). Per-session scope means
+     * each diagram type provides its own serializer without a server-level rebind.
+     */
+    protected bindModelSerializer(): BindingTarget<McpModelSerializer>;
+    /**
+     * {@link ElementTypesProvider} binding. Override to ship a constant-value list of creatable
+     * element types for the adopter's diagram type instead of the default impl that scrapes
+     * {@link OperationHandlerRegistry} (noisy for non-trivial diagrams).
+     */
+    protected bindElementTypesProvider(): BindingTarget<ElementTypesProvider>;
+    /**
+     * Override to add or replace diagram-scope 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: InstanceMultiBinding<McpDiagramToolHandlerConstructor>): void;
+    /** See {@link configureToolHandlers}. */
+    protected configureResourceHandlers(binding: InstanceMultiBinding<McpDiagramResourceHandlerConstructor>): void;
+    /**
+     * See {@link configureToolHandlers}. No diagram-scope prompts ship by default — the shipped
+     * `describe-diagram` and `suggest-improvements` prompts are diagram-type-agnostic and bound
+     * server-scope. Adopters add their own diagram-type-specific prompts here.
+     */
+    protected configurePromptHandlers(_binding: InstanceMultiBinding<McpDiagramPromptHandlerConstructor>): void;
+}
+/**
+ * Default {@link AbstractMcpDiagramModule} entry point. Adopters who don't need overrides
+ * use it directly: `new DefaultMcpDiagramModule()`. Adopters with customizations subclass
+ * `AbstractMcpDiagramModule` (or this class) and override the `bind*` / `configure*` hooks.
+ *
+ * @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 DefaultMcpDiagramModule extends AbstractMcpDiagramModule {
+}
+//# sourceMappingURL=mcp-diagram-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-diagram-module.d.ts","sourceRoot":"","sources":["../../src/server/mcp-diagram-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAsB,aAAa,EAA4B,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACrI,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAA+B,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACjH,OAAO,EAA8B,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAkC5G,OAAO,EAA4B,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAA2B,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAmC,kCAAkC,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EAAqC,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAA6B,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,8BAAsB,wBAAyB,SAAQ,UAAU;IAC7D,SAAS,CAAC,IAAI,EAAG,UAAU,CAAC,IAAI,CAAC;IACjC,SAAS,CAAC,MAAM,EAAG,UAAU,CAAC,MAAM,CAAC;cAElB,SAAS,CACxB,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,OAAO,EAAE,UAAU,CAAC,MAAM,EAC1B,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,GAC1B,IAAI;IAsBP;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,0BAA0B,IAAI,IAAI;IA0B5C;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAIhE;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,IAAI,aAAa,CAAC,gBAAgB,CAAC;IAI9D;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,IAAI,aAAa,CAAC,kBAAkB,CAAC;IAIlE;;;;OAIG;IACH,SAAS,CAAC,wBAAwB,IAAI,aAAa,CAAC,oBAAoB,CAAC;IAIzE;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,CAAC,gCAAgC,CAAC,GAAG,IAAI;IAoBtG,yCAAyC;IACzC,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,CAAC,oCAAoC,CAAC,GAAG,IAAI;IAK9G;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,kCAAkC,CAAC,GAAG,IAAI;CAG9G;AAED;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,SAAQ,wBAAwB;CAAG"}