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

package/README.md

@@ -27,7 +27,8 @@ Load the MCP container modules in your GLSP server's DI configuration:
 ```typescript
 import { GModelStorage, WebSocketServerLauncher, createAppModule } from '@eclipse-glsp/server/node';
 import { Container } from 'inversify';
-import { DefaultMcpDiagramModule, DefaultMcpServerModule } from '@eclipse-glsp/server-mcp';
+import { DefaultMcpDiagramModule } from '@eclipse-glsp/server-mcp';
+import { NodeMcpServerModule } from '@eclipse-glsp/server-mcp/node';
 
 const appContainer = new Container();
 appContainer.load(createAppModule(options));
@@ -38,16 +39,29 @@ const serverModule = new MyServerModule().configureDiagramModule(new MyDiagramMo
 
 const launcher = appContainer.resolve(WebSocketServerLauncher);
 // Launcher-level bindings — must not be part of `configureDiagramModule`.
-launcher.configure(serverModule, new DefaultMcpServerModule());
+launcher.configure(serverModule, new NodeMcpServerModule());
 ```
 
 The two modules are deliberately separate because they bind into different container scopes:
 
 -   `DefaultMcpDiagramModule` is mounted inside `configureDiagramModule`, so each `ClientSession.container` gets its own per-session services (`McpIdAliasService`, `McpModelSerializer`, the diagram-scope handler registries).
--   `DefaultMcpServerModule` is mounted at the launcher container, so the MCP HTTP server, the option holder, and the server-scope tool/resource handlers live as launcher singletons.
+-   `NodeMcpServerModule` is mounted at the launcher container, so the MCP HTTP server, the option holder, and the server-scope tool/resource handlers live as launcher singletons.
 
 The MCP server itself is started lazily on the first GLSP `InitializeAction` that carries an `mcpServer` configuration.
 
+### Browser / Web Worker target
+
+For browser, Bun, Deno, Cloudflare Workers, or any Fetch-shaped runtime, use the `browser` subpath. `McpWorkerBridge` wires `postMessage` traffic into the launcher for the common Service-Worker → Web-Worker setup:
+
+```typescript
+import { McpWorkerBridge } from '@eclipse-glsp/server-mcp/browser';
+
+const bridge = new McpWorkerBridge();
+launcher.configure(serverModule, bridge.createServerModule());
+```
+
+The page-side proxy — a Service Worker that intercepts `fetch('/mcp', …)` and forwards each `Request` to the bridge over a `MessageChannel` — is host-side scaffolding that adopters own. See `examples/workflow-server-mcp-demo/mcp-service-worker.js` for a working reference implementation that the workflow browser demo uses end-to-end.
+
 ## Further reading
 
 See [ARCHITECTURE.md](./ARCHITECTURE.md) for the architecture, security model, configuration surface, deployment guidance, and the extension cookbook. The workflow example (`examples/workflow-server`) is the canonical reference for adopter wiring; each shipped handler carries an LLM-facing `description` field that doubles as developer-facing documentation.

package/browser.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './lib/browser/index';

package/browser.js

@@ -0,0 +1,18 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+'use strict';
+
+module.exports = require('./lib/browser/index');

package/common.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './lib/common/index';

package/common.js

@@ -0,0 +1,18 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+'use strict';
+
+module.exports = require('./lib/common/index');

package/lib/browser/index.d.ts

@@ -0,0 +1,21 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './modules/browser-mcp-server-module';
+export * from './reexport';
+export * from './server/browser-mcp-request-context';
+export * from './server/mcp-worker-bridge';
+export * from './server/web-mcp-server-launcher';
+//# sourceMappingURL=index.d.ts.map

package/lib/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,cAAc,qCAAqC,CAAC;AACpD,cAAc,YAAY,CAAC;AAC3B,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC"}

package/lib/browser/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./modules/browser-mcp-server-module"), exports);
+__exportStar(require("./reexport"), exports);
+__exportStar(require("./server/browser-mcp-request-context"), exports);
+__exportStar(require("./server/mcp-worker-bridge"), exports);
+__exportStar(require("./server/web-mcp-server-launcher"), exports);
+//# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;;;;;;;;AAElF,sEAAoD;AACpD,6CAA2B;AAC3B,uEAAqD;AACrD,6DAA2C;AAC3C,mEAAiD"}

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

@@ -0,0 +1,42 @@
+/********************************************************************************
+ * 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 } from '@eclipse-glsp/server';
+import { AbstractMcpServerModule } from '../../common/modules/abstract-mcp-server-module';
+import { AbstractMcpServerLauncher } from '../../common/server/abstract-mcp-server-launcher';
+import { McpServerDefaults } from '../../common/server/mcp-options';
+import { McpRequestContext } from '../../common/server/mcp-request-context';
+/**
+ * Default {@link AbstractMcpServerModule} entry point for browser/web hosts (Bun, Deno, Cloudflare
+ * Worker, Service Worker, in-page Worker). Ships GLSP-default option values (see
+ * {@link BrowserMcpServerModule.DEFAULT_OPTIONS}) on top of the abstract module's hook defaults,
+ * and binds the web {@link WebMcpServerLauncher} + {@link BrowserMcpRequestContext}. Adopter-provided
+ * overrides via the constructor merge on top.
+ *
+ * Node-only deploy-side fields (`host`, `allowedHosts`, `allowedOrigins`, `acknowledgedNoAuth`)
+ * are intentionally omitted from defaults — adopters set these for their deployment, or run their
+ * own auth middleware around {@link AbstractMcpServerLauncher.getRequestHandler}.
+ *
+ * @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 BrowserMcpServerModule extends AbstractMcpServerModule {
+    static readonly DEFAULT_OPTIONS: McpServerDefaults;
+    constructor(overrides?: McpServerDefaults);
+    protected bindMcpServerLauncher(): BindingTarget<AbstractMcpServerLauncher>;
+    protected bindMcpRequestContext(): BindingTarget<McpRequestContext>;
+}
+//# sourceMappingURL=browser-mcp-server-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-mcp-server-module.d.ts","sourceRoot":"","sources":["../../../src/browser/modules/browser-mcp-server-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAuB,MAAM,iDAAiD,CAAC;AAC/G,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAI5E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,SAAQ,uBAAuB;IAC/D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAA8B;gBAEpE,SAAS,GAAE,iBAAsB;cAI1B,qBAAqB,IAAI,aAAa,CAAC,yBAAyB,CAAC;cAIjE,qBAAqB,IAAI,aAAa,CAAC,iBAAiB,CAAC;CAG/E"}

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

@@ -0,0 +1,50 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserMcpServerModule = void 0;
+const abstract_mcp_server_module_1 = require("../../common/modules/abstract-mcp-server-module");
+const browser_mcp_request_context_1 = require("../server/browser-mcp-request-context");
+const web_mcp_server_launcher_1 = require("../server/web-mcp-server-launcher");
+/**
+ * Default {@link AbstractMcpServerModule} entry point for browser/web hosts (Bun, Deno, Cloudflare
+ * Worker, Service Worker, in-page Worker). Ships GLSP-default option values (see
+ * {@link BrowserMcpServerModule.DEFAULT_OPTIONS}) on top of the abstract module's hook defaults,
+ * and binds the web {@link WebMcpServerLauncher} + {@link BrowserMcpRequestContext}. Adopter-provided
+ * overrides via the constructor merge on top.
+ *
+ * Node-only deploy-side fields (`host`, `allowedHosts`, `allowedOrigins`, `acknowledgedNoAuth`)
+ * are intentionally omitted from defaults — adopters set these for their deployment, or run their
+ * own auth middleware around {@link AbstractMcpServerLauncher.getRequestHandler}.
+ *
+ * @experimental The MCP integration is under active development. Option names, schema shapes,
+ * and handler contracts MAY change in minor releases until the feature graduates from
+ * experimental status.
+ */
+class BrowserMcpServerModule extends abstract_mcp_server_module_1.AbstractMcpServerModule {
+    constructor(overrides = {}) {
+        super({ ...BrowserMcpServerModule.DEFAULT_OPTIONS, ...overrides });
+    }
+    bindMcpServerLauncher() {
+        return web_mcp_server_launcher_1.WebMcpServerLauncher;
+    }
+    bindMcpRequestContext() {
+        return browser_mcp_request_context_1.BrowserMcpRequestContext;
+    }
+}
+exports.BrowserMcpServerModule = BrowserMcpServerModule;
+BrowserMcpServerModule.DEFAULT_OPTIONS = { ...abstract_mcp_server_module_1.DEFAULT_MCP_OPTIONS };
+//# sourceMappingURL=browser-mcp-server-module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-mcp-server-module.js","sourceRoot":"","sources":["../../../src/browser/modules/browser-mcp-server-module.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;AAGlF,gGAA+G;AAI/G,uFAAiF;AACjF,+EAAyE;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAa,sBAAuB,SAAQ,oDAAuB;IAG/D,YAAY,YAA+B,EAAE;QACzC,KAAK,CAAC,EAAE,GAAG,sBAAsB,CAAC,eAAe,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAEkB,qBAAqB;QACpC,OAAO,8CAAoB,CAAC;IAChC,CAAC;IAEkB,qBAAqB;QACpC,OAAO,sDAAwB,CAAC;IACpC,CAAC;;AAbL,wDAcC;AAbmB,sCAAe,GAAsB,EAAE,GAAG,gDAAmB,EAAE,CAAC"}

package/lib/browser/reexport.d.ts

@@ -0,0 +1,17 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from '../common';
+//# sourceMappingURL=reexport.d.ts.map

package/lib/browser/reexport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reexport.d.ts","sourceRoot":"","sources":["../../src/browser/reexport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAClF,cAAc,WAAW,CAAC"}

package/lib/browser/reexport.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+__exportStar(require("../common"), exports);
+//# sourceMappingURL=reexport.js.map

package/lib/browser/reexport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reexport.js","sourceRoot":"","sources":["../../src/browser/reexport.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;kFAckF;AAClF,4CAA0B"}

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

@@ -0,0 +1,27 @@
+/********************************************************************************
+ * 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 { McpRequestContext, McpRequestExtra } from '../../common/server/mcp-request-context';
+/**
+ * Browser-compatible {@link McpRequestContext} that holds one request context at a time.
+ * Hosts must serialise dispatches so they don't overwrite each other (e.g. via {@link McpWorkerBridge}).
+ */
+export declare class BrowserMcpRequestContext implements McpRequestContext {
+    protected current: McpRequestExtra | undefined;
+    protected concurrencyWarned: boolean;
+    run<R>(extra: McpRequestExtra, callback: () => R): R;
+    getStore(): McpRequestExtra | undefined;
+}
+//# sourceMappingURL=browser-mcp-request-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-mcp-request-context.d.ts","sourceRoot":"","sources":["../../../src/browser/server/browser-mcp-request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAGlF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE7F;;;GAGG;AACH,qBACa,wBAAyB,YAAW,iBAAiB;IAC9D,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,SAAS,CAAC,iBAAiB,UAAS;IAEpC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IA2BpD,QAAQ,IAAI,eAAe,GAAG,SAAS;CAG1C"}

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

@@ -0,0 +1,67 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserMcpRequestContext = void 0;
+const inversify_1 = require("inversify");
+/**
+ * Browser-compatible {@link McpRequestContext} that holds one request context at a time.
+ * Hosts must serialise dispatches so they don't overwrite each other (e.g. via {@link McpWorkerBridge}).
+ */
+let BrowserMcpRequestContext = class BrowserMcpRequestContext {
+    constructor() {
+        this.concurrencyWarned = false;
+    }
+    run(extra, callback) {
+        // Warn once if an adopter forgot to serialise dispatches — silent context corruption would be hard to debug.
+        if (this.current !== undefined && !this.concurrencyWarned) {
+            this.concurrencyWarned = true;
+            console.warn('BrowserMcpRequestContext: concurrent run() detected — request contexts will overwrite each other. ' +
+                'Serialise MCP dispatches (e.g. via McpWorkerBridge or an adopter-side queue around launcher.handleRequest).');
+        }
+        const prior = this.current;
+        this.current = extra;
+        let result;
+        try {
+            result = callback();
+        }
+        catch (error) {
+            this.current = prior;
+            throw error;
+        }
+        if (result instanceof Promise) {
+            return result.finally(() => {
+                this.current = prior;
+            });
+        }
+        this.current = prior;
+        return result;
+    }
+    getStore() {
+        return this.current;
+    }
+};
+exports.BrowserMcpRequestContext = BrowserMcpRequestContext;
+exports.BrowserMcpRequestContext = BrowserMcpRequestContext = __decorate([
+    (0, inversify_1.injectable)()
+], BrowserMcpRequestContext);
+//# sourceMappingURL=browser-mcp-request-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-mcp-request-context.js","sourceRoot":"","sources":["../../../src/browser/server/browser-mcp-request-context.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;;;;;;;AAElF,yCAAuC;AAGvC;;;GAGG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IAA9B;QAEO,sBAAiB,GAAG,KAAK,CAAC;IAgCxC,CAAC;IA9BG,GAAG,CAAI,KAAsB,EAAE,QAAiB;QAC5C,6GAA6G;QAC7G,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAC9B,OAAO,CAAC,IAAI,CACR,oGAAoG;gBAChG,6GAA6G,CACpH,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,MAAS,CAAC;QACd,IAAI,CAAC;YACD,MAAM,GAAG,QAAQ,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,MAAM,KAAK,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACzB,CAAC,CAAiB,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ,CAAA;AAlCY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,sBAAU,GAAE;GACA,wBAAwB,CAkCpC"}

package/lib/browser/server/mcp-worker-bridge.d.ts

@@ -0,0 +1,81 @@
+/********************************************************************************
+ * 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 { Disposable } from '@eclipse-glsp/server';
+import { AbstractMcpServerLauncher } from '../../common/server/abstract-mcp-server-launcher';
+import { McpServerDefaults } from '../../common/server/mcp-options';
+import { BrowserMcpServerModule } from '../modules/browser-mcp-server-module';
+export declare const MCP_REQUEST_MESSAGE_TYPE = "mcp-request";
+export declare const MCP_RESPONSE_MESSAGE_TYPE = "mcp-response";
+export declare const MCP_INIT_PORT_MESSAGE_TYPE = "mcp-init-port";
+export interface McpRequestMessage {
+    type: typeof MCP_REQUEST_MESSAGE_TYPE;
+    id: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+export interface McpResponseMessage {
+    type: typeof MCP_RESPONSE_MESSAGE_TYPE;
+    id: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    /** `ReadableStream` on Chromium (streams SSE); buffered `ArrayBuffer` on browsers without transferable streams. */
+    body: ReadableStream<Uint8Array> | ArrayBuffer | null;
+}
+/** Carries the SW↔Worker `MessagePort` transfer that wires MCP traffic over a dedicated channel. */
+export interface McpInitPortMessage {
+    type: typeof MCP_INIT_PORT_MESSAGE_TYPE;
+}
+export declare function isMcpRequestMessage(value: unknown): value is McpRequestMessage;
+export declare function isMcpInitPortMessage(value: unknown): value is McpInitPortMessage;
+/** Probes whether the current realm can transfer `ReadableStream` via `postMessage` (Chromium yes; Firefox / Safari no). */
+export declare function canTransferReadableStream(): boolean;
+/** Minimal Worker scope contract — defined locally so the package compiles without the `webworker` lib. */
+export interface McpBridgeScope {
+    addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: 'message', listener: (event: MessageEvent) => void): void;
+    postMessage(message: unknown, transfer?: Transferable[]): void;
+}
+/**
+ * Bridges `postMessage` traffic to an {@link AbstractMcpServerLauncher} for browser / Web Worker
+ * adopters that proxy MCP requests via Service-Worker → Web-Worker plumbing.
+ * See `ARCHITECTURE.md` (Portable handler) for the message protocol and queueing semantics.
+ */
+export declare class McpWorkerBridge implements Disposable {
+    protected readonly scope: McpBridgeScope;
+    protected resolveLauncher: (launcher: AbstractMcpServerLauncher) => void;
+    protected readonly launcherReady: Promise<AbstractMcpServerLauncher>;
+    protected readonly listener: (event: MessageEvent) => void;
+    /** Serialise dispatches — `BrowserMcpRequestContext` is a single-slot store, not concurrency-safe. */
+    protected dispatchChain: Promise<void>;
+    protected readonly streamTransferable: boolean;
+    protected bufferingWarned: boolean;
+    constructor(scope?: McpBridgeScope);
+    dispose(): void;
+    /** Returns a {@link BrowserMcpServerModule} that registers its launcher with this bridge on DI activation. */
+    createServerModule(overrides?: McpServerDefaults): BrowserMcpServerModule;
+    /** First call binds; subsequent calls are no-ops. */
+    bindLauncher(launcher: AbstractMcpServerLauncher): void;
+    protected onMessage(event: MessageEvent): void;
+    protected enqueueDispatch(request: McpRequestMessage, port: MessagePort | undefined): void;
+    protected dispatch(request: McpRequestMessage, port: MessagePort | undefined): Promise<void>;
+    /** Stream on Chromium; buffer to `ArrayBuffer` (still transferable) on browsers without transferable streams. */
+    protected encodeBody(response: Response): Promise<ReadableStream<Uint8Array> | ArrayBuffer | null>;
+    protected reply(port: MessagePort | undefined, message: McpResponseMessage): void;
+}
+//# sourceMappingURL=mcp-worker-bridge.d.ts.map

package/lib/browser/server/mcp-worker-bridge.d.ts.map

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