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

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-handler.js

@@ -0,0 +1,99 @@
+"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);
+};
+var SuggestImprovementsMcpPromptHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuggestImprovementsMcpPromptHandler = exports.SuggestImprovementsArgsSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const mcp_handler_shared_1 = require("../../server/mcp-handler-shared");
+const mcp_prompt_handler_1 = require("../../server/mcp-prompt-handler");
+const diagram_model_mcp_tool_handler_1 = require("../../tools/handlers/diagram-model-mcp-tool-handler");
+const query_elements_mcp_tool_handler_1 = require("../../tools/handlers/query-elements-mcp-tool-handler");
+const set_selection_mcp_tool_handler_1 = require("../../tools/handlers/set-selection-mcp-tool-handler");
+const validate_diagram_mcp_tool_handler_1 = require("../../tools/handlers/validate-diagram-mcp-tool-handler");
+exports.SuggestImprovementsArgsSchema = z.object({
+    sessionId: z
+        .string()
+        .optional()
+        .describe('GLSP client session id (open diagram). Defaults to the only open session; required when multiple are open.')
+});
+/**
+ * Prompt template that asks the agent to review the diagram and propose concrete improvements
+ * (validation issues, structural smells, missing labels, etc.). The agent orchestrates the
+ * tool calls; this prompt only frames the task.
+ *
+ * Server-scope on purpose — the prompt itself has no per-session state, so we avoid forcing
+ * the user to type a sessionId in the common single-diagram case.
+ */
+let SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler_1 = class SuggestImprovementsMcpPromptHandler extends mcp_prompt_handler_1.AbstractMcpPromptHandler {
+    constructor() {
+        super(...arguments);
+        this.name = SuggestImprovementsMcpPromptHandler_1.NAME;
+        this.title = 'Suggest Diagram Improvements';
+        this.description = 'Review an open diagram and propose concrete improvements grouped by severity ' +
+            '(must-fix vs. nice-to-have). The agent runs validation, checks connectivity, looks for unclear labels, ' +
+            'and flags structural inconsistencies, then names the specific element ids for each suggestion so the user ' +
+            'can act on them. Read-only by intent — the prompt instructs the agent not to modify the diagram, only propose. ' +
+            '`sessionId` is optional — defaults to the only open session.';
+        this.argsSchema = exports.SuggestImprovementsArgsSchema;
+    }
+    referencedToolNames() {
+        return [
+            validate_diagram_mcp_tool_handler_1.ValidateDiagramMcpToolHandler.NAME,
+            diagram_model_mcp_tool_handler_1.DiagramModelMcpToolHandler.NAME,
+            query_elements_mcp_tool_handler_1.QueryElementsMcpToolHandler.NAME,
+            set_selection_mcp_tool_handler_1.SetSelectionMcpToolHandler.NAME
+        ];
+    }
+    createResult(args) {
+        const sessionId = (0, mcp_handler_shared_1.resolveActiveSessionId)(this.clientSessionManager, args.sessionId);
+        const text = `Review the diagram for session \`${sessionId}\` and propose concrete improvements. Focus on:\n\n` +
+            `1. **Validation issues** — run \`${validate_diagram_mcp_tool_handler_1.ValidateDiagramMcpToolHandler.NAME}\` and surface any markers.\n` +
+            `2. **Connectivity** — load the model (\`${diagram_model_mcp_tool_handler_1.DiagramModelMcpToolHandler.NAME}\`) and flag unconnected ` +
+            `nodes or orphaned subgraphs.\n` +
+            `3. **Labelling** — use \`${query_elements_mcp_tool_handler_1.QueryElementsMcpToolHandler.NAME}\` to find nodes that lack a meaningful ` +
+            `label, and edges with missing or unclear text.\n` +
+            `4. **Structure** — call out elements whose type or placement looks inconsistent with ` +
+            `the rest of the diagram.\n\n` +
+            `Group findings by severity (must-fix vs. nice-to-have). ` +
+            `When naming elements, prefer their label or type with the alias in parens — e.g. ` +
+            `"the 'Brew' task (#7)" or "the decision node (#9)" — never the bare alias alone, since aliases mean nothing to the user. ` +
+            `Point at each suggestion via \`${set_selection_mcp_tool_handler_1.SetSelectionMcpToolHandler.NAME}\` so the user can navigate. ` +
+            `Do not modify the diagram — only propose.`;
+        return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+    }
+};
+exports.SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler;
+SuggestImprovementsMcpPromptHandler.NAME = 'suggest-improvements';
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientSessionManager),
+    __metadata("design:type", Object)
+], SuggestImprovementsMcpPromptHandler.prototype, "clientSessionManager", void 0);
+exports.SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler = SuggestImprovementsMcpPromptHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], SuggestImprovementsMcpPromptHandler);
+//# sourceMappingURL=suggest-improvements-mcp-prompt-handler.js.map

package/lib/prompts/handlers/suggest-improvements-mcp-prompt-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-improvements-mcp-prompt-handler.js","sourceRoot":"","sources":["../../../src/prompts/handlers/suggest-improvements-mcp-prompt-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAA4D;AAC5D,yCAA+C;AAC/C,4BAA4B;AAC5B,wEAA0F;AAC1F,wEAA2E;AAC3E,wGAAiG;AACjG,0GAAmG;AACnG,wGAAiG;AACjG,8GAAuG;AAE1F,QAAA,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4GAA4G,CAAC;CAC9H,CAAC,CAAC;AAGH;;;;;;;GAOG;AAEI,IAAM,mCAAmC,2CAAzC,MAAM,mCAAoC,SAAQ,6CAAiD;IAAnG;;QAEM,SAAI,GAAG,qCAAmC,CAAC,IAAI,CAAC;QACvC,UAAK,GAAG,8BAA8B,CAAC;QAChD,gBAAW,GAChB,+EAA+E;YAC/E,yGAAyG;YACzG,4GAA4G;YAC5G,iHAAiH;YACjH,8DAA8D,CAAC;QAC1D,eAAU,GAAG,qCAA6B,CAAC;IA+BxD,CAAC;IA3BY,mBAAmB;QACxB,OAAO;YACH,iEAA6B,CAAC,IAAI;YAClC,2DAA0B,CAAC,IAAI;YAC/B,6DAA2B,CAAC,IAAI;YAChC,2DAA0B,CAAC,IAAI;SAClC,CAAC;IACN,CAAC;IAES,YAAY,CAAC,IAA6B;QAChD,MAAM,SAAS,GAAG,IAAA,2CAAsB,EAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpF,MAAM,IAAI,GACN,oCAAoC,SAAS,qDAAqD;YAClG,oCAAoC,iEAA6B,CAAC,IAAI,+BAA+B;YACrG,2CAA2C,2DAA0B,CAAC,IAAI,2BAA2B;YACrG,gCAAgC;YAChC,4BAA4B,6DAA2B,CAAC,IAAI,0CAA0C;YACtG,kDAAkD;YAClD,uFAAuF;YACvF,8BAA8B;YAC9B,0DAA0D;YAC1D,mFAAmF;YACnF,2HAA2H;YAC3H,kCAAkC,2DAA0B,CAAC,IAAI,+BAA+B;YAChG,2CAA2C,CAAC;QAChD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC;;AAxCQ,kFAAmC;AAC5B,wCAAI,GAAG,sBAAsB,AAAzB,CAA0B;AAWN;IAAvC,IAAA,kBAAM,EAAC,6BAAoB,CAAC;;iFAAsD;8CAZ1E,mCAAmC;IAD/C,IAAA,sBAAU,GAAE;GACA,mCAAmC,CAyC/C"}

package/lib/resources/handlers/diagram-png-mcp-resource-handler.d.ts

@@ -0,0 +1,84 @@
+/********************************************************************************
+ * 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 { Role } from '@modelcontextprotocol/sdk/types.js';
+import * as z from 'zod/v4';
+import { McpResourceContent } from '../../server/mcp-handler-shared';
+import { McpMimeType } from '../../server/mcp-mime-types';
+import { McpProgressReporter } from '../../server/mcp-progress-reporter';
+import { AbstractMcpDiagramResourceHandler, McpResourceUri } from '../../server/mcp-resource-handler';
+export declare const DiagramPngInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    scale: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DiagramPngInput = z.infer<typeof DiagramPngInputSchema>;
+/** Rendering lives on the client — `RequestExportAction('png')` routes to the registered PNG exporter, which returns base64 via `ExportResultAction`. */
+export declare class DiagramPngMcpResourceHandler extends AbstractMcpDiagramResourceHandler<DiagramPngInput> {
+    /** Default timeout (in ms) used when the call doesn't override `timeoutMs`. Override via subclass + rebind. */
+    protected readonly defaultTimeoutMs: number;
+    /**
+     * Default `scale` multiplier when the caller doesn't pin `width`/`height`/`scale`. `1` means
+     * "render at the diagram's natural extent" — sharp because the client rasterises the SVG
+     * at the requested size. Adopters override (e.g. to `2` for a high-DPI deployment) via
+     * subclass + rebind.
+     */
+    protected readonly defaultScale: number;
+    static readonly NAME = "diagram-png";
+    readonly name = "diagram-png";
+    readonly title = "Diagram Model PNG";
+    readonly description: string;
+    readonly mimeType: McpMimeType;
+    readonly uri: McpResourceUri;
+    /** Both the user (visual artifact) and the assistant (visual reasoning) consume the rendered diagram. */
+    readonly audience: Role[];
+    /** Useful when relevant, but not always-relevant — clients may skip when text-only reasoning suffices. */
+    readonly priority = 0.6;
+    readonly toolAlternativeInputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        scale: z.ZodOptional<z.ZodNumber>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    protected progress: McpProgressReporter;
+    protected clientActionKinds: Set<string>;
+    /** Skip-bind when the GLSP client doesn't speak `RequestExportAction` — every read would otherwise time out. */
+    canRegister(): boolean;
+    protected createResult({ scale, width, height, timeoutMs }: DiagramPngInput): Promise<McpResourceContent>;
+    /**
+     * Resolve the final render size with this precedence:
+     * - `width` and `height` both given → use as-is.
+     * - only one of `width`/`height` given → derive the other from the diagram aspect ratio.
+     * - neither dimension given → natural × (`scale` ?? {@link defaultScale}).
+     */
+    protected resolveSize(scale: number | undefined, width: number | undefined, height: number | undefined): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Compute the diagram's natural extent as the bounding box of every {@link isGBoundsAware}
+     * element with both `position` and `size`. Throws when the model has no positioned elements
+     * — a 1×1 PNG of an empty diagram is technically renderable but useless, and surfacing it
+     * as a self-correctable error lets the LLM react (e.g. wait for layout, ask the user).
+     */
+    protected computeNaturalSize(): {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=diagram-png-mcp-resource-handler.d.ts.map

package/lib/resources/handlers/diagram-png-mcp-resource-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-png-mcp-resource-handler.d.ts","sourceRoot":"","sources":["../../../src/resources/handlers/diagram-png-mcp-resource-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAgB,MAAM,iCAAiC,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEtG,eAAO,MAAM,qBAAqB;;;;;;iBA+BhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,yJAAyJ;AACzJ,qBACa,4BAA6B,SAAQ,iCAAiC,CAAC,eAAe,CAAC;IAChG,+GAA+G;IAC/G,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAQ;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAK;IAE5C,MAAM,CAAC,QAAQ,CAAC,IAAI,iBAAiB;IACrC,QAAQ,CAAC,IAAI,iBAAqC;IAClD,SAAkB,KAAK,uBAAuB;IAC9C,QAAQ,CAAC,WAAW,SAO4F;IAChH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAe;IAC7C,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAmD;IAC/E,yGAAyG;IACzG,SAAkB,QAAQ,EAAE,IAAI,EAAE,CAAyB;IAC3D,0GAA0G;IAC1G,SAAkB,QAAQ,OAAO;IAIjC,SAAkB,0BAA0B;;;;;;sBAAyB;IAExC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAE1C,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpE,gHAAgH;IACvG,WAAW,IAAI,OAAO;cAIf,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe/G;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAkBpC;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAsBpE"}

package/lib/resources/handlers/diagram-png-mcp-resource-handler.js

@@ -0,0 +1,177 @@
+"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);
+};
+var DiagramPngMcpResourceHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagramPngMcpResourceHandler = exports.DiagramPngInputSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const mcp_handler_shared_1 = require("../../server/mcp-handler-shared");
+const mcp_input_schemas_1 = require("../../server/mcp-input-schemas");
+const mcp_progress_reporter_1 = require("../../server/mcp-progress-reporter");
+const mcp_resource_handler_1 = require("../../server/mcp-resource-handler");
+exports.DiagramPngInputSchema = mcp_input_schemas_1.McpDiagramScopedInputSchema.extend({
+    scale: z
+        .number()
+        .min(0.1)
+        .max(4)
+        .optional()
+        .describe("Multiplier applied to the diagram's natural extent (range 0.1..4). Use values >1 for " +
+        'sharper-than-default renders, <1 for thumbnails. Ignored when `width` or `height` is supplied.'),
+    width: z
+        .number()
+        .int()
+        .min(1)
+        .max(8192)
+        .optional()
+        .describe('Override the rendered width in pixels. When given alone, the height is derived from the diagram aspect ratio.'),
+    height: z
+        .number()
+        .int()
+        .min(1)
+        .max(8192)
+        .optional()
+        .describe('Override the rendered height in pixels. When given alone, the width is derived from the diagram aspect ratio.'),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(100)
+        .max(60000)
+        .optional()
+        .describe('Override the default render timeout in milliseconds (100–60000). Useful for very large diagrams.')
+});
+/** Rendering lives on the client — `RequestExportAction('png')` routes to the registered PNG exporter, which returns base64 via `ExportResultAction`. */
+let DiagramPngMcpResourceHandler = DiagramPngMcpResourceHandler_1 = class DiagramPngMcpResourceHandler extends mcp_resource_handler_1.AbstractMcpDiagramResourceHandler {
+    constructor() {
+        super(...arguments);
+        /** Default timeout (in ms) used when the call doesn't override `timeoutMs`. Override via subclass + rebind. */
+        this.defaultTimeoutMs = 5000;
+        /**
+         * Default `scale` multiplier when the caller doesn't pin `width`/`height`/`scale`. `1` means
+         * "render at the diagram's natural extent" — sharp because the client rasterises the SVG
+         * at the requested size. Adopters override (e.g. to `2` for a high-DPI deployment) via
+         * subclass + rebind.
+         */
+        this.defaultScale = 1;
+        this.name = DiagramPngMcpResourceHandler_1.NAME;
+        this.title = 'Diagram Model PNG';
+        this.description = 'Render the session diagram as a base64-encoded PNG screenshot of its current visible state. ' +
+            'Includes all nodes, edges, and their styling — useful when a visual answer would help the agent ' +
+            '(layout reasoning, confirming a recently-created element looks right, sharing the diagram with the user). ' +
+            "Defaults to a sharp render at the diagram's natural extent; pass `scale` to multiply, " +
+            'or `width`/`height` to pin specific dimensions. ' +
+            'Requires a connected frontend client to perform the render and is subject to a timeout if no response arrives. ' +
+            'For a structured-text view of the model use `diagram-model` instead; for vector output use `diagram-svg`.';
+        this.mimeType = 'image/png';
+        this.uri = { template: 'glsp://diagrams/{sessionId}/png' };
+        /** Both the user (visual artifact) and the assistant (visual reasoning) consume the rendered diagram. */
+        this.audience = ['user', 'assistant'];
+        /** Useful when relevant, but not always-relevant — clients may skip when text-only reasoning suffices. */
+        this.priority = 0.6;
+        // `lastModified` intentionally omitted: we have no cheap, accurate freshness signal for the
+        // rendered PNG (the model state doesn't track a "rendered at" timestamp), and a stale value
+        // would mislead clients.
+        this.toolAlternativeInputSchema = exports.DiagramPngInputSchema;
+    }
+    /** Skip-bind when the GLSP client doesn't speak `RequestExportAction` — every read would otherwise time out. */
+    canRegister() {
+        return this.clientActionKinds.has(server_1.RequestExportAction.KIND);
+    }
+    async createResult({ scale, width, height, timeoutMs }) {
+        const resolved = this.resolveSize(scale, width, height);
+        // Best-effort beat for clients that opted in via `_meta.progressToken`; no-ops otherwise.
+        await this.progress.emit({ progress: 0, message: 'Awaiting client-side PNG render…' });
+        const response = await this.requestAction(server_1.RequestExportAction.create('png', { formatOptions: { width: resolved.width, height: resolved.height } }), timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : this.defaultTimeoutMs);
+        // A misbehaving exporter strategy returning text-encoded data here would silently corrupt the blob; fail loudly instead.
+        if (response.encoding !== 'base64') {
+            throw new mcp_handler_shared_1.McpToolError(`PNG export returned unexpected encoding '${response.encoding}'; expected 'base64'.`);
+        }
+        return { blob: response.data };
+    }
+    /**
+     * Resolve the final render size with this precedence:
+     * - `width` and `height` both given → use as-is.
+     * - only one of `width`/`height` given → derive the other from the diagram aspect ratio.
+     * - neither dimension given → natural × (`scale` ?? {@link defaultScale}).
+     */
+    resolveSize(scale, width, height) {
+        if (width !== undefined && height !== undefined) {
+            return { width, height };
+        }
+        const natural = this.computeNaturalSize();
+        if (width !== undefined) {
+            return { width, height: Math.max(1, Math.round(width * (natural.height / natural.width))) };
+        }
+        if (height !== undefined) {
+            return { width: Math.max(1, Math.round(height * (natural.width / natural.height))), height };
+        }
+        const factor = scale !== null && scale !== void 0 ? scale : this.defaultScale;
+        return {
+            width: Math.max(1, Math.round(natural.width * factor)),
+            height: Math.max(1, Math.round(natural.height * factor))
+        };
+    }
+    /**
+     * Compute the diagram's natural extent as the bounding box of every {@link isGBoundsAware}
+     * element with both `position` and `size`. Throws when the model has no positioned elements
+     * — a 1×1 PNG of an empty diagram is technically renderable but useless, and surfacing it
+     * as a self-correctable error lets the LLM react (e.g. wait for layout, ask the user).
+     */
+    computeNaturalSize() {
+        let maxX = 0;
+        let maxY = 0;
+        for (const id of this.modelState.index.allIds()) {
+            const element = this.modelState.index.get(id);
+            if (!element || !(0, server_1.isGBoundsAware)(element)) {
+                continue;
+            }
+            const position = element.position;
+            const size = element.size;
+            if (position && size && size.width > 0 && size.height > 0) {
+                maxX = Math.max(maxX, position.x + size.width);
+                maxY = Math.max(maxY, position.y + size.height);
+            }
+        }
+        if (maxX <= 0 || maxY <= 0) {
+            throw new mcp_handler_shared_1.McpToolError('Diagram has no positioned elements yet — render once after layout completes, or pass `width` / `height` explicitly.');
+        }
+        return { width: Math.ceil(maxX), height: Math.ceil(maxY) };
+    }
+};
+exports.DiagramPngMcpResourceHandler = DiagramPngMcpResourceHandler;
+DiagramPngMcpResourceHandler.NAME = 'diagram-png';
+__decorate([
+    (0, inversify_1.inject)(mcp_progress_reporter_1.McpProgressReporter),
+    __metadata("design:type", mcp_progress_reporter_1.McpProgressReporter)
+], DiagramPngMcpResourceHandler.prototype, "progress", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientActionKinds),
+    __metadata("design:type", Set)
+], DiagramPngMcpResourceHandler.prototype, "clientActionKinds", void 0);
+exports.DiagramPngMcpResourceHandler = DiagramPngMcpResourceHandler = DiagramPngMcpResourceHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], DiagramPngMcpResourceHandler);
+//# sourceMappingURL=diagram-png-mcp-resource-handler.js.map

package/lib/resources/handlers/diagram-png-mcp-resource-handler.js.map

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

package/lib/resources/handlers/diagram-svg-mcp-resource-handler.d.ts

@@ -0,0 +1,55 @@
+/********************************************************************************
+ * 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 { Role } from '@modelcontextprotocol/sdk/types.js';
+import * as z from 'zod/v4';
+import { McpResourceContent } from '../../server/mcp-handler-shared';
+import { McpMimeType } from '../../server/mcp-mime-types';
+import { McpProgressReporter } from '../../server/mcp-progress-reporter';
+import { AbstractMcpDiagramResourceHandler, McpResourceUri } from '../../server/mcp-resource-handler';
+export declare const DiagramSvgInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DiagramSvgInput = z.infer<typeof DiagramSvgInputSchema>;
+/**
+ * Vector counterpart of {@link DiagramPngMcpResourceHandler}. Emits the diagram as raw SVG
+ * markup (text-encoded). No `width`/`height` knobs because SVG is vector — clients (and
+ * downstream rasterisers) scale it freely.
+ */
+export declare class DiagramSvgMcpResourceHandler extends AbstractMcpDiagramResourceHandler<DiagramSvgInput> {
+    /** Default timeout (in ms) used when the call doesn't override `timeoutMs`. Override via subclass + rebind. */
+    protected readonly defaultTimeoutMs: number;
+    static readonly NAME = "diagram-svg";
+    readonly name = "diagram-svg";
+    readonly title = "Diagram Model SVG";
+    readonly description: string;
+    readonly mimeType: McpMimeType;
+    readonly uri: McpResourceUri;
+    /** Both the user (visual artifact) and the assistant (visual reasoning) consume the rendered diagram. */
+    readonly audience: Role[];
+    /** Useful when relevant, but not always-relevant — clients may skip when text-only reasoning suffices. */
+    readonly priority = 0.6;
+    readonly toolAlternativeInputSchema: z.ZodObject<{
+        sessionId: z.ZodString;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    protected progress: McpProgressReporter;
+    protected clientActionKinds: Set<string>;
+    /** Skip-bind when the GLSP client doesn't speak `RequestExportAction`. */
+    canRegister(): boolean;
+    protected createResult({ timeoutMs }: DiagramSvgInput): Promise<McpResourceContent>;
+}
+//# sourceMappingURL=diagram-svg-mcp-resource-handler.d.ts.map

package/lib/resources/handlers/diagram-svg-mcp-resource-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-svg-mcp-resource-handler.d.ts","sourceRoot":"","sources":["../../../src/resources/handlers/diagram-svg-mcp-resource-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAgB,MAAM,iCAAiC,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEtG,eAAO,MAAM,qBAAqB;;;iBAQhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,qBACa,4BAA6B,SAAQ,iCAAiC,CAAC,eAAe,CAAC;IAChG,+GAA+G;IAC/G,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAQ;IAEnD,MAAM,CAAC,QAAQ,CAAC,IAAI,iBAAiB;IACrC,QAAQ,CAAC,IAAI,iBAAqC;IAClD,SAAkB,KAAK,uBAAuB;IAC9C,QAAQ,CAAC,WAAW,SAMiE;IACrF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAmB;IACjD,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAmD;IAC/E,yGAAyG;IACzG,SAAkB,QAAQ,EAAE,IAAI,EAAE,CAAyB;IAC3D,0GAA0G;IAC1G,SAAkB,QAAQ,OAAO;IACjC,SAAkB,0BAA0B;;;sBAAyB;IAExC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAE1C,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpE,0EAA0E;IACjE,WAAW,IAAI,OAAO;cAIf,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAU5F"}

package/lib/resources/handlers/diagram-svg-mcp-resource-handler.js

@@ -0,0 +1,99 @@
+"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);
+};
+var DiagramSvgMcpResourceHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagramSvgMcpResourceHandler = exports.DiagramSvgInputSchema = void 0;
+const server_1 = require("@eclipse-glsp/server");
+const inversify_1 = require("inversify");
+const z = require("zod/v4");
+const mcp_handler_shared_1 = require("../../server/mcp-handler-shared");
+const mcp_input_schemas_1 = require("../../server/mcp-input-schemas");
+const mcp_progress_reporter_1 = require("../../server/mcp-progress-reporter");
+const mcp_resource_handler_1 = require("../../server/mcp-resource-handler");
+exports.DiagramSvgInputSchema = mcp_input_schemas_1.McpDiagramScopedInputSchema.extend({
+    timeoutMs: z
+        .number()
+        .int()
+        .min(100)
+        .max(60000)
+        .optional()
+        .describe('Override the default render timeout in milliseconds (100–60000). Useful for very large diagrams.')
+});
+/**
+ * Vector counterpart of {@link DiagramPngMcpResourceHandler}. Emits the diagram as raw SVG
+ * markup (text-encoded). No `width`/`height` knobs because SVG is vector — clients (and
+ * downstream rasterisers) scale it freely.
+ */
+let DiagramSvgMcpResourceHandler = DiagramSvgMcpResourceHandler_1 = class DiagramSvgMcpResourceHandler extends mcp_resource_handler_1.AbstractMcpDiagramResourceHandler {
+    constructor() {
+        super(...arguments);
+        /** Default timeout (in ms) used when the call doesn't override `timeoutMs`. Override via subclass + rebind. */
+        this.defaultTimeoutMs = 5000;
+        this.name = DiagramSvgMcpResourceHandler_1.NAME;
+        this.title = 'Diagram Model SVG';
+        this.description = 'Render the session diagram as SVG markup of its current visible state. ' +
+            'Vector format — scales without quality loss, ideal for embedding in documentation, ' +
+            'further programmatic processing, or post-export rasterisation at arbitrary resolutions. ' +
+            'Requires a connected frontend client to perform the render and is subject to a timeout if no response arrives. ' +
+            'Use `diagram-png` instead when you need a ready-to-display raster image; ' +
+            '`diagram-model` is the structured-text alternative for content-only reasoning.';
+        this.mimeType = 'image/svg+xml';
+        this.uri = { template: 'glsp://diagrams/{sessionId}/svg' };
+        /** Both the user (visual artifact) and the assistant (visual reasoning) consume the rendered diagram. */
+        this.audience = ['user', 'assistant'];
+        /** Useful when relevant, but not always-relevant — clients may skip when text-only reasoning suffices. */
+        this.priority = 0.6;
+        this.toolAlternativeInputSchema = exports.DiagramSvgInputSchema;
+    }
+    /** Skip-bind when the GLSP client doesn't speak `RequestExportAction`. */
+    canRegister() {
+        return this.clientActionKinds.has(server_1.RequestExportAction.KIND);
+    }
+    async createResult({ timeoutMs }) {
+        // Best-effort beat for clients that opted in via `_meta.progressToken`; no-ops otherwise.
+        await this.progress.emit({ progress: 0, message: 'Awaiting client-side SVG render…' });
+        const response = await this.requestAction(server_1.RequestExportAction.create('svg'), timeoutMs !== null && timeoutMs !== void 0 ? timeoutMs : this.defaultTimeoutMs);
+        // SVG is text-encoded — base64 encoding here would mean an exporter mis-classified its payload.
+        if (response.encoding !== 'text') {
+            throw new mcp_handler_shared_1.McpToolError(`SVG export returned unexpected encoding '${response.encoding}'; expected 'text'.`);
+        }
+        return { text: response.data };
+    }
+};
+exports.DiagramSvgMcpResourceHandler = DiagramSvgMcpResourceHandler;
+DiagramSvgMcpResourceHandler.NAME = 'diagram-svg';
+__decorate([
+    (0, inversify_1.inject)(mcp_progress_reporter_1.McpProgressReporter),
+    __metadata("design:type", mcp_progress_reporter_1.McpProgressReporter)
+], DiagramSvgMcpResourceHandler.prototype, "progress", void 0);
+__decorate([
+    (0, inversify_1.inject)(server_1.ClientActionKinds),
+    __metadata("design:type", Set)
+], DiagramSvgMcpResourceHandler.prototype, "clientActionKinds", void 0);
+exports.DiagramSvgMcpResourceHandler = DiagramSvgMcpResourceHandler = DiagramSvgMcpResourceHandler_1 = __decorate([
+    (0, inversify_1.injectable)()
+], DiagramSvgMcpResourceHandler);
+//# sourceMappingURL=diagram-svg-mcp-resource-handler.js.map

package/lib/resources/handlers/diagram-svg-mcp-resource-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-svg-mcp-resource-handler.js","sourceRoot":"","sources":["../../../src/resources/handlers/diagram-svg-mcp-resource-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;AAElF,iDAA8E;AAE9E,yCAA+C;AAC/C,4BAA4B;AAC5B,wEAAmF;AACnF,sEAA6E;AAE7E,8EAAyE;AACzE,4EAAsG;AAEzF,QAAA,qBAAqB,GAAG,+CAA2B,CAAC,MAAM,CAAC;IACpE,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,kGAAkG,CAAC;CACpH,CAAC,CAAC;AAGH;;;;GAIG;AAEI,IAAM,4BAA4B,oCAAlC,MAAM,4BAA6B,SAAQ,wDAAkD;IAA7F;;QACH,+GAA+G;QAC5F,qBAAgB,GAAW,IAAI,CAAC;QAG1C,SAAI,GAAG,8BAA4B,CAAC,IAAI,CAAC;QAChC,UAAK,GAAG,mBAAmB,CAAC;QACrC,gBAAW,GAChB,yEAAyE;YACzE,qFAAqF;YACrF,0FAA0F;YAC1F,iHAAiH;YACjH,2EAA2E;YAC3E,gFAAgF,CAAC;QAC5E,aAAQ,GAAgB,eAAe,CAAC;QACxC,QAAG,GAAmB,EAAE,QAAQ,EAAE,iCAAiC,EAAE,CAAC;QAC/E,yGAAyG;QACvF,aAAQ,GAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3D,0GAA0G;QACxF,aAAQ,GAAG,GAAG,CAAC;QACf,+BAA0B,GAAG,6BAAqB,CAAC;IAqBzE,CAAC;IAfG,0EAA0E;IACjE,WAAW;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,4BAAmB,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAES,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAmB;QACvD,0FAA0F;QAC1F,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;QACvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,4BAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACjH,gGAAgG;QAChG,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,iCAAY,CAAC,4CAA4C,QAAQ,CAAC,QAAQ,qBAAqB,CAAC,CAAC;QAC/G,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;;AAxCQ,oEAA4B;AAIrB,iCAAI,GAAG,aAAa,AAAhB,CAAiB;AAkBE;IAAtC,IAAA,kBAAM,EAAC,2CAAmB,CAAC;8BAAqB,2CAAmB;8DAAC;AAEhC;IAApC,IAAA,kBAAM,EAAC,0BAAiB,CAAC;8BAA8B,GAAG;uEAAS;uCAxB3D,4BAA4B;IADxC,IAAA,sBAAU,GAAE;GACA,4BAA4B,CAyCxC"}

package/lib/resources/services/element-types-provider.d.ts

@@ -0,0 +1,65 @@
+/********************************************************************************
+ * 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 { CreateOperationHandler, Logger, OperationHandlerRegistry } from '@eclipse-glsp/server';
+/**
+ * A discoverable creatable element type emitted by the `element-types` tool handler. Adopters
+ * may add further passthrough fields beyond these — the tool handler's structured output schema
+ * is `loose()`.
+ *
+ * @experimental
+ */
+export interface ElementTypeEntry {
+    id: string;
+    /** Human-readable display name for the element TYPE (e.g. `Manual Task`). */
+    label: string;
+    /** Adopter-supplied human-readable description; absent on the default scrape impl. */
+    description?: string;
+    /** Whether create-* / modify-* tools should pass a `text` arg for this type. Absent ⇒ unknown. */
+    acceptsText?: boolean;
+}
+/** Node + edge types creatable in a given diagram type. */
+export interface ElementTypes {
+    nodeTypes: ElementTypeEntry[];
+    edgeTypes: ElementTypeEntry[];
+}
+/**
+ * Per-diagram-type provider of creatable element types. Bound on the diagram (per-GLSP-session)
+ * container so each diagram type can supply its own list. Adopters with explicit type info
+ * typically rebind to a constant-value provider; the default scrapes
+ * {@link OperationHandlerRegistry} for backwards compatibility with adopters that haven't
+ * declared their types yet.
+ *
+ * @experimental
+ */
+export interface ElementTypesProvider {
+    get(): ElementTypes;
+}
+export declare const ElementTypesProvider: unique symbol;
+/**
+ * Default {@link ElementTypesProvider} that scrapes the per-session {@link OperationHandlerRegistry}
+ * for {@link CreateNodeOperationHandler} / {@link CreateEdgeOperationHandler} instances and reads
+ * their `elementTypeIds`.
+ */
+export declare class DefaultElementTypesProvider implements ElementTypesProvider {
+    protected operationHandlerRegistry: OperationHandlerRegistry;
+    protected logger: Logger;
+    /** Already-warned operation types, deduped so the warn fires once per type. */
+    protected readonly warnedTypes: Set<string>;
+    get(): ElementTypes;
+    /** Once-per-type warn when a `CreateOperationHandler` carries an unrecognized `operationType`. */
+    protected warnUnrecognizedOperationType(handler: CreateOperationHandler): void;
+}
+//# sourceMappingURL=element-types-provider.d.ts.map

package/lib/resources/services/element-types-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-types-provider.d.ts","sourceRoot":"","sources":["../../../src/resources/services/element-types-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,EAGH,sBAAsB,EACtB,MAAM,EACN,wBAAwB,EAC3B,MAAM,sBAAsB,CAAC;AAG9B;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,SAAS,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACjC,GAAG,IAAI,YAAY,CAAC;CACvB;AACD,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE;;;;GAIG;AACH,qBACa,2BAA4B,YAAW,oBAAoB;IAClC,SAAS,CAAC,wBAAwB,EAAE,wBAAwB,CAAC;IAE/E,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzC,+EAA+E;IAC/E,SAAS,CAAC,QAAQ,CAAC,WAAW,cAAqB;IAEnD,GAAG,IAAI,YAAY;IAenB,kGAAkG;IAClG,SAAS,CAAC,6BAA6B,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;CAWjF"}