@evref-bl/plexus-gateway 0.1.0-alpha.0

package/dist/imageMcpRouter.js

@@ -0,0 +1,90 @@
+import http from "node:http";
+export class StreamableHttpImageMcpToolRouter {
+    host;
+    path;
+    timeoutMs;
+    constructor(options = {}) {
+        this.host = options.host ?? "127.0.0.1";
+        this.path = options.path ?? "/";
+        this.timeoutMs = options.timeoutMs ?? 60_000;
+    }
+    async callTool(route, toolName, argumentsValue) {
+        const response = await this.postJsonRpc(route.port, {
+            jsonrpc: "2.0",
+            id: `plexus-${route.targetId}-${route.imageId}-${Date.now()}`,
+            method: "tools/call",
+            params: {
+                name: toolName,
+                arguments: argumentsValue,
+            },
+        });
+        if ("error" in response) {
+            throw new Error(`MCP error ${jsonRpcErrorText(response.error)}`);
+        }
+        if (!("result" in response)) {
+            throw new Error("MCP response did not include a result");
+        }
+        return response.result;
+    }
+    async postJsonRpc(port, payload) {
+        const body = JSON.stringify(payload);
+        return new Promise((resolve, reject) => {
+            const request = http.request({
+                hostname: this.host,
+                port,
+                path: this.path,
+                method: "POST",
+                headers: {
+                    accept: "application/json, text/event-stream",
+                    "content-type": "application/json",
+                    "content-length": Buffer.byteLength(body),
+                    connection: "close",
+                },
+                timeout: this.timeoutMs,
+            }, (response) => {
+                const chunks = [];
+                response.on("data", (chunk) => {
+                    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                });
+                response.on("end", () => {
+                    if (response.statusCode === undefined ||
+                        response.statusCode < 200 ||
+                        response.statusCode >= 300) {
+                        reject(new Error(`HTTP ${response.statusCode ?? "unknown"} ${response.statusMessage ?? ""}`.trim()));
+                        return;
+                    }
+                    let data;
+                    try {
+                        data = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+                    }
+                    catch (error) {
+                        reject(new Error(`MCP response was not valid JSON: ${error instanceof Error ? error.message : String(error)}`));
+                        return;
+                    }
+                    if (!isRecord(data)) {
+                        reject(new Error("MCP response was not a JSON object"));
+                        return;
+                    }
+                    resolve(data);
+                });
+            });
+            request.on("timeout", () => {
+                request.destroy(new Error(`MCP request timed out after ${this.timeoutMs}ms`));
+            });
+            request.on("error", reject);
+            request.end(body);
+        });
+    }
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function jsonRpcErrorText(value) {
+    if (!isRecord(value)) {
+        return JSON.stringify(value);
+    }
+    const code = typeof value.code === "number" ? value.code : undefined;
+    const message = typeof value.message === "string" ? value.message : JSON.stringify(value);
+    return code === undefined ? message : `${code}: ${message}`;
+}
+//# sourceMappingURL=imageMcpRouter.js.map

package/dist/imageMcpRouter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export * from "./gateway.js";
+export * from "./imageMcpRouter.js";
+export * from "./pharoFacade.js";
+export * from "./routingTable.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export * from "./gateway.js";
+export * from "./imageMcpRouter.js";
+export * from "./pharoFacade.js";
+export * from "./routingTable.js";
+export * from "./server.js";
+import { startGatewayServerFromCli } from "./server.js";
+function comparablePath(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const realPath = fs.existsSync(resolvedPath)
+        ? fs.realpathSync.native(resolvedPath)
+        : resolvedPath;
+    return process.platform === "win32" ? realPath.toLowerCase() : realPath;
+}
+const entrypointPath = process.argv[1]
+    ? comparablePath(process.argv[1])
+    : undefined;
+const modulePath = comparablePath(fileURLToPath(import.meta.url));
+if (entrypointPath && modulePath === entrypointPath) {
+    startGatewayServerFromCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAC1C,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC;QACtC,CAAC,CAAC,YAAY,CAAC;IAEjB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC;AAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,SAAS,CAAC;AACd,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE,IAAI,cAAc,IAAI,UAAU,KAAK,cAAc,EAAE,CAAC;IACpD,yBAAyB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACnD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/pharoFacade.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare function buildPharoFacadeTool(tool: Tool): Tool;
+export declare function buildPharoFacadeTools(tools: readonly Tool[]): Tool[];
+export interface PharoFacadeArguments {
+    imageId: string;
+    argumentsValue: Record<string, unknown>;
+}
+export declare class PharoFacadeInputError extends Error {
+    constructor(message: string);
+}
+export declare function parsePharoFacadeArguments(input: unknown): PharoFacadeArguments;
+//# sourceMappingURL=pharoFacade.d.ts.map

package/dist/pharoFacade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pharoFacade.d.ts","sourceRoot":"","sources":["../src/pharoFacade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAoC/D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAiBrD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI,EAAE,CAEpE;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAe9E"}

package/dist/pharoFacade.js

@@ -0,0 +1,67 @@
+const imageIdSchema = {
+    type: "string",
+    minLength: 1,
+    description: "PLexus workspace-scoped image handle to route this Pharo tool call to.",
+};
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function schemaObject(value) {
+    return isObject(value) ? value : {};
+}
+function schemaProperties(value) {
+    if (!isObject(value)) {
+        return {};
+    }
+    return { ...value };
+}
+function schemaRequired(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === "string");
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+export function buildPharoFacadeTool(tool) {
+    const inputSchema = schemaObject(tool.inputSchema);
+    const properties = schemaProperties(inputSchema.properties);
+    const required = unique(["imageId", ...schemaRequired(inputSchema.required)]);
+    return {
+        ...tool,
+        inputSchema: {
+            ...inputSchema,
+            type: "object",
+            properties: {
+                ...properties,
+                imageId: imageIdSchema,
+            },
+            required,
+        },
+    };
+}
+export function buildPharoFacadeTools(tools) {
+    return tools.map((tool) => buildPharoFacadeTool(tool));
+}
+export class PharoFacadeInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PharoFacadeInputError";
+    }
+}
+export function parsePharoFacadeArguments(input) {
+    if (!isObject(input)) {
+        throw new PharoFacadeInputError("Pharo facade input must be an object");
+    }
+    const imageId = input.imageId;
+    if (typeof imageId !== "string" || imageId.length === 0) {
+        throw new PharoFacadeInputError("imageId is required");
+    }
+    const { imageId: _imageId, ...argumentsValue } = input;
+    return {
+        imageId,
+        argumentsValue,
+    };
+}
+//# sourceMappingURL=pharoFacade.js.map

package/dist/pharoFacade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pharoFacade.js","sourceRoot":"","sources":["../src/pharoFacade.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,wEAAwE;CAC7E,CAAC;AAEX,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAU;IAC7C,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,SAAS,EAAE,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE;YACX,GAAG,WAAW;YACd,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,UAAU;gBACb,OAAO,EAAE,aAAa;aACvB;YACD,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAOD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAAC,sCAAsC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC;IACvD,OAAO;QACL,OAAO;QACP,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/routingTable.d.ts

@@ -0,0 +1,84 @@
+export type GatewayProjectImageStatus = "starting" | "running" | "stopped" | "failed";
+export type GatewayPharoMcpContractStatus = "unknown" | "matching" | "mismatched";
+export interface GatewayPharoMcpContractReference {
+    id?: string;
+    hash?: string;
+}
+export interface GatewayProjectImagePharoMcpContractState extends GatewayPharoMcpContractReference {
+    status?: GatewayPharoMcpContractStatus;
+    expectedId?: string;
+    expectedHash?: string;
+}
+export interface GatewayProjectImageState {
+    id: string;
+    imageName: string;
+    assignedPort: number;
+    pid?: number;
+    status: GatewayProjectImageStatus;
+    pharoMcpContract?: GatewayProjectImagePharoMcpContractState;
+}
+export interface GatewayProjectState {
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    targetId: string;
+    pharoMcpContract?: GatewayPharoMcpContractReference;
+    images: GatewayProjectImageState[];
+    updatedAt: string;
+}
+export type GatewayImageHealth = "unknown" | "healthy" | "unhealthy";
+export type GatewayImageRoutabilityCode = "ready" | "image_unavailable" | "contract_unknown" | "contract_mismatch";
+export interface GatewayImageRoutability {
+    ok: boolean;
+    code: GatewayImageRoutabilityCode;
+    message: string;
+}
+export interface GatewayImageRouteMetadata {
+    serverName: "gateway";
+    requiredArgument: "imageId";
+    imageId: string;
+    routeReference: {
+        projectId: string;
+        workspaceId: string;
+        targetId: string;
+    };
+    imageIdSource: string;
+    recordHint: string;
+}
+export interface GatewayImageRoute {
+    id: string;
+    imageName: string;
+    port: number;
+    pid?: number;
+    status: GatewayProjectImageStatus;
+    health: GatewayImageHealth;
+    routable: GatewayImageRoutability;
+    routeMetadata: GatewayImageRouteMetadata;
+    pharoMcpContract?: GatewayProjectImagePharoMcpContractState;
+    updatedAt: string;
+}
+export interface GatewayProjectRoute {
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    targetId: string;
+    projectRoot: string;
+    statePath: string;
+    pharoMcpContract?: GatewayPharoMcpContractReference;
+    images: GatewayImageRoute[];
+    updatedAt: string;
+}
+export declare class PlexusRoutingTable {
+    private readonly targets;
+    upsertProject(projectRoot: string, statePath: string, state: GatewayProjectState): GatewayProjectRoute;
+    getTarget(targetId: string): GatewayProjectRoute | undefined;
+    removeTarget(targetId: string): GatewayProjectRoute | undefined;
+    removeProjectWorkspace(projectId: string, workspaceId: string): GatewayProjectRoute | undefined;
+    removeRoutesWithMissingStatePaths(statePathExists?: (statePath: string) => boolean): GatewayProjectRoute[];
+    getProjectWorkspace(projectId: string, workspaceId: string): GatewayProjectRoute | undefined;
+    listProjectTargets(projectId: string): GatewayProjectRoute[];
+    listTargets(): GatewayProjectRoute[];
+    findImageOutsideTarget(projectId: string, targetId: string, imageId: string): GatewayProjectRoute | undefined;
+    updateImageHealth(targetId: string, imageId: string, health: GatewayImageHealth): void;
+}
+//# sourceMappingURL=routingTable.d.ts.map

package/dist/routingTable.d.ts.map

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

package/dist/routingTable.js

@@ -0,0 +1,166 @@
+import fs from "node:fs";
+import path from "node:path";
+function contractLabel(contract) {
+    if (!contract) {
+        return "none";
+    }
+    return contract.hash ?? contract.id ?? "unknown";
+}
+function requiredProjectContractFields(contract) {
+    if (!contract) {
+        return [];
+    }
+    return ["id", "hash"].filter((key) => contract[key] !== undefined);
+}
+function contractRoutability(projectContract, imageContract, imageId) {
+    if (imageContract?.status === "mismatched") {
+        return {
+            ok: false,
+            code: "contract_mismatch",
+            message: `Image ${imageId} Pharo MCP contract is marked as mismatched`,
+        };
+    }
+    const requiredFields = requiredProjectContractFields(projectContract);
+    if (requiredFields.length === 0) {
+        return {
+            ok: true,
+            code: "ready",
+            message: "Image is routable",
+        };
+    }
+    if (!imageContract || imageContract.status === "unknown") {
+        return {
+            ok: false,
+            code: "contract_unknown",
+            message: `Image ${imageId} Pharo MCP contract is unknown; expected ${contractLabel(projectContract)}`,
+        };
+    }
+    for (const field of requiredFields) {
+        if (imageContract[field] === undefined) {
+            return {
+                ok: false,
+                code: "contract_unknown",
+                message: `Image ${imageId} Pharo MCP contract is missing ${String(field)}; expected ${contractLabel(projectContract)}`,
+            };
+        }
+        if (imageContract[field] !== projectContract?.[field]) {
+            return {
+                ok: false,
+                code: "contract_mismatch",
+                message: `Image ${imageId} Pharo MCP contract does not match project contract`,
+            };
+        }
+    }
+    return {
+        ok: true,
+        code: "ready",
+        message: "Image is routable",
+    };
+}
+function imageRoutability(projectContract, image) {
+    if (image.status !== "running") {
+        return {
+            ok: false,
+            code: "image_unavailable",
+            message: `Image ${image.id} is not running; current status is ${image.status}`,
+        };
+    }
+    return contractRoutability(projectContract, image.pharoMcpContract, image.id);
+}
+function imageRouteMetadata(state, imageId) {
+    return {
+        serverName: "gateway",
+        requiredArgument: "imageId",
+        imageId,
+        routeReference: {
+            projectId: state.projectId,
+            workspaceId: state.workspaceId,
+            targetId: state.targetId,
+        },
+        imageIdSource: "Read images[].imageId from PLexus scoped context, pharo-launcher image list, or gateway status",
+        recordHint: "Record the selected imageId with the scoped project/workspace/target before calling gateway tools",
+    };
+}
+export class PlexusRoutingTable {
+    targets = new Map();
+    upsertProject(projectRoot, statePath, state) {
+        const existing = this.targets.get(state.targetId);
+        const existingHealth = new Map(existing?.images.map((image) => [image.id, image.health]) ?? []);
+        const route = {
+            projectId: state.projectId,
+            projectName: state.projectName,
+            workspaceId: state.workspaceId,
+            targetId: state.targetId,
+            projectRoot: path.resolve(projectRoot),
+            statePath,
+            ...(state.pharoMcpContract
+                ? { pharoMcpContract: state.pharoMcpContract }
+                : {}),
+            updatedAt: state.updatedAt,
+            images: state.images.map((image) => ({
+                id: image.id,
+                imageName: image.imageName,
+                port: image.assignedPort,
+                ...(image.pid ? { pid: image.pid } : {}),
+                status: image.status,
+                health: existingHealth.get(image.id) ?? "unknown",
+                routable: imageRoutability(state.pharoMcpContract, image),
+                routeMetadata: imageRouteMetadata(state, image.id),
+                ...(image.pharoMcpContract
+                    ? { pharoMcpContract: image.pharoMcpContract }
+                    : {}),
+                updatedAt: state.updatedAt,
+            })),
+        };
+        this.targets.set(route.targetId, route);
+        return route;
+    }
+    getTarget(targetId) {
+        return this.targets.get(targetId);
+    }
+    removeTarget(targetId) {
+        const route = this.targets.get(targetId);
+        if (route) {
+            this.targets.delete(targetId);
+        }
+        return route;
+    }
+    removeProjectWorkspace(projectId, workspaceId) {
+        const route = this.getProjectWorkspace(projectId, workspaceId);
+        return route ? this.removeTarget(route.targetId) : undefined;
+    }
+    removeRoutesWithMissingStatePaths(statePathExists = fs.existsSync) {
+        const removed = [];
+        for (const route of this.listTargets()) {
+            if (!statePathExists(route.statePath)) {
+                const deleted = this.removeTarget(route.targetId);
+                if (deleted) {
+                    removed.push(deleted);
+                }
+            }
+        }
+        return removed;
+    }
+    getProjectWorkspace(projectId, workspaceId) {
+        return this.listProjectTargets(projectId).find((route) => route.workspaceId === workspaceId);
+    }
+    listProjectTargets(projectId) {
+        return this.listTargets().filter((route) => route.projectId === projectId);
+    }
+    listTargets() {
+        return [...this.targets.values()];
+    }
+    findImageOutsideTarget(projectId, targetId, imageId) {
+        return this.listProjectTargets(projectId).find((route) => route.targetId !== targetId &&
+            route.images.some((image) => image.id === imageId));
+    }
+    updateImageHealth(targetId, imageId, health) {
+        const project = this.targets.get(targetId);
+        const image = project?.images.find((candidate) => candidate.id === imageId);
+        if (image) {
+            image.health = health;
+            image.updatedAt = new Date().toISOString();
+        }
+    }
+}
+//# sourceMappingURL=routingTable.js.map

package/dist/routingTable.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,133 @@
+import http from "node:http";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type Tool } from "@modelcontextprotocol/sdk/types.js";
+import { PlexusGateway, type GatewayRouteReferenceInput } from "./gateway.js";
+export declare const gatewayTools: readonly [{
+    readonly name: "plexus_gateway_register_target";
+    readonly description: "Register or update one gateway target route from PLexus runtime state.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_unregister_target";
+    readonly description: "Remove a registered gateway target route without opening or closing project images.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_status";
+    readonly description: "Return gateway route status for registered targets/images.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_cleanup_stale_routes";
+    readonly description: "Remove registered gateway target routes whose runtime state files are gone.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}];
+export declare const rawRoutingTool: {
+    readonly name: "plexus_route_to_image";
+    readonly description: "Route a Pharo MCP tool call to the MCP server running inside a selected image.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+};
+declare const legacyGatewaySurface = "pharo";
+export type GatewaySurface = "combined" | "admin" | "gateway" | typeof legacyGatewaySurface;
+export interface GatewayServerOptions {
+    surface?: GatewaySurface;
+    exposeRawRoutingTool?: boolean;
+}
+export interface GatewayEnvironmentOptions {
+    surface: GatewaySurface;
+    exposeRawRoutingTool: boolean;
+    pharoTools: Tool[];
+    pharoScope: GatewayRouteReferenceInput;
+}
+export declare const legacyGatewayTools: readonly [{
+    readonly name: "plexus_gateway_register_target";
+    readonly description: "Register or update one gateway target route from PLexus runtime state.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_unregister_target";
+    readonly description: "Remove a registered gateway target route without opening or closing project images.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_status";
+    readonly description: "Return gateway route status for registered targets/images.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_gateway_cleanup_stale_routes";
+    readonly description: "Remove registered gateway target routes whose runtime state files are gone.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "plexus_route_to_image";
+    readonly description: "Route a Pharo MCP tool call to the MCP server running inside a selected image.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}];
+export interface GatewayHttpServerOptions {
+    host?: string;
+    port: number;
+    healthPath?: string;
+    mcpPath?: string;
+}
+export interface GatewayCliOptions {
+    transport: "stdio" | "http";
+    host: string;
+    port: number;
+}
+export declare function createGatewayServer(gateway?: PlexusGateway): Server;
+export declare function createGatewayServerWithOptions(gateway?: PlexusGateway, options?: GatewayServerOptions): Server;
+export declare function parseGatewayEnvironmentOptions(env?: NodeJS.ProcessEnv): GatewayEnvironmentOptions;
+export declare function createGatewayFromEnvironment(env?: NodeJS.ProcessEnv): {
+    gateway: PlexusGateway;
+    serverOptions: GatewayServerOptions;
+};
+export declare function startGatewayServer(): Promise<void>;
+export declare function startGatewayHttpServer(options: GatewayHttpServerOptions): Promise<http.Server>;
+export declare function parseGatewayServerCliOptions(args?: string[], env?: NodeJS.ProcessEnv): GatewayCliOptions;
+export declare function startGatewayServerFromCli(options?: GatewayCliOptions): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,EAIL,KAAK,IAAI,EACV,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AA4B9E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCf,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;CAgBjB,CAAC;AAEX,QAAA,MAAM,oBAAoB,UAAU,CAAC;AAErC,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,OAAO,GACP,SAAS,GACT,OAAO,oBAAoB,CAAC;AAEhC,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,0BAA0B,CAAC;CACxC;AA0DD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6C,CAAC;AAuB7E,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA+CD,wBAAgB,mBAAmB,CAAC,OAAO,gBAAsB,GAAG,MAAM,CAEzE;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,gBAAsB,EAC7B,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAmFR;AAeD,wBAAgB,8BAA8B,CAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,yBAAyB,CAiB3B;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,oBAAoB,CAAA;CAAE,CAYjE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AA2CD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAqFtB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,MAAM,EAA0B,EACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iBAAiB,CAgDnB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,oBAAiC,GACvC,OAAO,CAAC,IAAI,CAAC,CAUf"}