@lensmcp/cluster 1.17.3 → 1.17.4

package/executors/gateway/gateway.lib.d.ts

@@ -13,7 +13,7 @@
 export { hostMatches } from './manifest';
 export { startGateway } from './runtime/server';
 export { verifyDevJwt, stampIdentity } from './runtime/dev-auth';
-export { baseDomainOf, readLensScope } from './runtime/scope';
+export { baseDomainOf, deriveMcpHttpPort, readLensScope, type LensScope } from './runtime/scope';
 export { pickSock, discoverRoutes } from './runtime/discovery';
 export type { GatewayContext, ClusterProjectDecl, SockPool, Route, LensFrontend, ServiceCtl, GatewayRuntimeOptions, GatewayHandle, GatewayHooks, GatewayPhase, HookHandler, HookContext, } from './runtime/types';
 //# sourceMappingURL=gateway.lib.d.ts.map

package/executors/gateway/gateway.lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.lib.d.ts","sourceRoot":"","sources":["../../../../../libs/cluster/src/executors/gateway/gateway.lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"gateway.lib.d.ts","sourceRoot":"","sources":["../../../../../libs/cluster/src/executors/gateway/gateway.lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/executors/gateway/gateway.lib.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.discoverRoutes = exports.pickSock = exports.readLensScope = exports.baseDomainOf = exports.stampIdentity = exports.verifyDevJwt = exports.startGateway = exports.hostMatches = void 0;
+exports.discoverRoutes = exports.pickSock = exports.readLensScope = exports.deriveMcpHttpPort = exports.baseDomainOf = exports.stampIdentity = exports.verifyDevJwt = exports.startGateway = exports.hostMatches = void 0;
 /**
  * Public facade for the dev gateway runtime.
  *
@@ -22,6 +22,7 @@ Object.defineProperty(exports, "verifyDevJwt", { enumerable: true, get: function
 Object.defineProperty(exports, "stampIdentity", { enumerable: true, get: function () { return dev_auth_1.stampIdentity; } });
 var scope_1 = require("./runtime/scope");
 Object.defineProperty(exports, "baseDomainOf", { enumerable: true, get: function () { return scope_1.baseDomainOf; } });
+Object.defineProperty(exports, "deriveMcpHttpPort", { enumerable: true, get: function () { return scope_1.deriveMcpHttpPort; } });
 Object.defineProperty(exports, "readLensScope", { enumerable: true, get: function () { return scope_1.readLensScope; } });
 var discovery_1 = require("./runtime/discovery");
 Object.defineProperty(exports, "pickSock", { enumerable: true, get: function () { return discovery_1.pickSock; } });

package/executors/gateway/runtime/lens-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lens-children.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/lens-children.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAuB,MAAM,SAAS,CAAC;AAiB1F,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA0B7E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalE;AAyBD;;;;;;mDAMmD;AACnD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAMD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;iFAGiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,UAAU,CAAC;IAC9B;;gFAE4E;IAC5E,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;6GAEyG;IACzG,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF;;yGAEqG;IACrG,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACpE;gHAC4G;IAC5G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,qBAAqB,EAE9B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACzD,YAAY,CAmbd"}
+{"version":3,"file":"lens-children.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/lens-children.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAuB,MAAM,SAAS,CAAC;AAiB1F,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA0B7E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalE;AAyBD;;;;;;mDAMmD;AACnD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1F;AAMD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;iFAGiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQvE;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,UAAU,CAAC;IAC9B;;gFAE4E;IAC5E,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;6GAEyG;IACzG,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF;;yGAEqG;IACrG,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACpE;gHAC4G;IAC5G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,qBAAqB,EAE9B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACzD,YAAY,CA4bd"}

package/executors/gateway/runtime/lens-children.js

@@ -399,11 +399,20 @@ deps) {
                 console.warn("[gateway] MCP server bundle not found — skipping (lens apps will still publish to the bus; an external `lensmcp mcp` can read it). Install: `npm i -D lensmcp`.");
             }
             else {
-                console.log(`[gateway] starting lens MCP server (${mcpBundle})`);
+                // The workspace's OWN port, not a shared default. This used to be a
+                // hardcoded 3000 for EVERY workspace: with two gateways (or one daemon
+                // hosting two workspaces) whichever bound first served the other's
+                // sessions too — one project's agent reading another project's events.
+                // The port is also the contract the MCP shim resolves from
+                // `.lensmcp/config.json`, so it must not be stepped up on collision:
+                // a shim pointed at 4543 cannot find a server that quietly moved to 4544.
+                const scope = (0, scope_1.readLensScope)(rt.root);
+                const mcpPort = Number(process.env['LENSMCP_PORT'] ?? scope.mcpHttpPort);
+                console.log(`[gateway] starting lens MCP server on 127.0.0.1:${mcpPort} (${mcpBundle})`);
                 spawnManagedChild('lens-mcp', process.execPath, [mcpBundle], {
                     LENSMCP_EVENT_FILE: rt.eventFile,
                     LENSMCP_TRANSPORT: process.env['LENSMCP_TRANSPORT'] ?? 'http',
-                    LENSMCP_PORT: process.env['LENSMCP_PORT'] ?? '3000',
+                    LENSMCP_PORT: String(mcpPort),
                 });
             }
         }

package/executors/gateway/runtime/scope.d.ts

@@ -3,14 +3,26 @@
  *  'tetros.ai.local'] → 'tetros.ai.local'). Falls back to the first host, then
  *  to 'lens.local' if no host is declared. */
 export declare function baseDomainOf(hosts: string[]): string;
-/** Per-workspace lens scope (key + dashboard port + mount path). Prefers the
- *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
- *  / `lensmcp dashboard`); falls back to deriving from the workspace. */
-export declare function readLensScope(root: string): {
+export interface LensScope {
     key: string;
     dashboardPort: number;
+    /**
+     * The MCP server's HTTP port for THIS workspace.
+     *
+     * This is the ISOLATION BOUNDARY for the shared MCP server. One daemon hosts
+     * several workspaces; if their MCP children shared a port, a session in one
+     * workspace would read the other's observability data. It used to be the
+     * hardcoded `3000` for every workspace — see `lens-children.ts`.
+     */
+    mcpHttpPort: number;
     basePath: string;
-};
+}
+/** Per-workspace lens scope (key + ports + mount path). Prefers the
+ *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
+ *  / `lensmcp dashboard` / the MCP shim); falls back to deriving from the workspace. */
+export declare function readLensScope(root: string): LensScope;
+/** The workspace's MCP HTTP port, derived from its key. In lock-step with the CLI. */
+export declare function deriveMcpHttpPort(key: string): number;
 /**
  * Per-workspace extra SOURCE-SET excludes (`.lensmcp/config.json` →
  * `sourceSet.exclude: string[]`) — top-level dir names the staleness scanner

package/executors/gateway/runtime/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/scope.ts"],"names":[],"mappings":"AAOA;;;8CAG8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpD;AAED;;yEAEyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAmBpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAa9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../libs/cluster/src/executors/gateway/runtime/scope.ts"],"names":[],"mappings":"AAOA;;;8CAG8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpD;AAeD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;wFAEwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA2BrD;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAa9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/executors/gateway/runtime/scope.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.baseDomainOf = baseDomainOf;
 exports.readLensScope = readLensScope;
+exports.deriveMcpHttpPort = deriveMcpHttpPort;
 exports.readSourceSetExclude = readSourceSetExclude;
 exports.lensKeyFrom = lensKeyFrom;
 exports.lensSlug = lensSlug;
@@ -29,16 +30,30 @@ function baseDomainOf(hosts) {
     const parts = shortest.split('.');
     return parts.slice(-Math.min(parts.length, 3)).join('.');
 }
-/** Per-workspace lens scope (key + dashboard port + mount path). Prefers the
+/** Lens-infra port bases — must equal `BASE_PORTS` in the CLI's workspace-scope. */
+const BASE_PORTS = { dashboard: 4321, mcpHttp: 4500 };
+/** FNV-1a → 0..(range-1). Same derivation as the CLI's `hashToRange`. */
+function hashToRange(s, range) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return Math.abs(h | 0) % range;
+}
+/** Per-workspace lens scope (key + ports + mount path). Prefers the
  *  CLI-written `.lensmcp/config.json` (so the gateway agrees with `lensmcp gateway`
- *  / `lensmcp dashboard`); falls back to deriving from the workspace. */
+ *  / `lensmcp dashboard` / the MCP shim); falls back to deriving from the workspace. */
 function readLensScope(root) {
     try {
         const cfg = JSON.parse(fs.readFileSync(path.join(root, '.lensmcp', 'config.json'), 'utf8'));
         if (cfg && typeof cfg.key === 'string') {
             return {
                 key: cfg.key,
-                dashboardPort: cfg.ports?.dashboard ?? 4321,
+                dashboardPort: cfg.ports?.dashboard ?? BASE_PORTS.dashboard,
+                // Derive rather than fall back to a constant: a constant would put two
+                // config-less workspaces on ONE port, which is the cross-feed bug.
+                mcpHttpPort: cfg.ports?.mcpHttp ?? deriveMcpHttpPort(cfg.key),
                 basePath: cfg.dashboardBasePath ?? '/' + cfg.key,
             };
         }
@@ -47,7 +62,16 @@ function readLensScope(root) {
         /* no config yet — derive below */
     }
     const key = lensKeyFrom(root);
-    return { key, dashboardPort: 4321, basePath: '/' + key };
+    return {
+        key,
+        dashboardPort: BASE_PORTS.dashboard,
+        mcpHttpPort: deriveMcpHttpPort(key),
+        basePath: '/' + key,
+    };
+}
+/** The workspace's MCP HTTP port, derived from its key. In lock-step with the CLI. */
+function deriveMcpHttpPort(key) {
+    return BASE_PORTS.mcpHttp + hashToRange(key, 200);
 }
 /**
  * Per-workspace extra SOURCE-SET excludes (`.lensmcp/config.json` →

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/cluster",
-  "version": "1.17.3",
+  "version": "1.17.4",
   "description": "Run your Nx workspace as a local production cluster: pods on unix sockets with true HMR, one https gateway with per-project domains, scale-from-zero, autoscale, idle-kill, local-CA TLS — observed by the LensMCP lens.",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -65,8 +65,8 @@
     }
   },
   "dependencies": {
-    "@lensmcp/node-instrumentation": "1.17.3",
-    "@lensmcp/nx-plugin": "1.17.3",
+    "@lensmcp/node-instrumentation": "1.17.4",
+    "@lensmcp/nx-plugin": "1.17.4",
     "@typescript/native-preview": "^7.0.0-dev.20260707.2",
     "fork-ts-checker-webpack-plugin": "^9.0.0",
     "glob": "^11.0.0",