cloakbrowser-mcp 1.0.2 → 1.2.0

package/dist/http/server.js

@@ -0,0 +1,315 @@
+import { randomUUID, timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { createBridgeServer } from '../server.js';
+import { createSessionStore } from './sessionStore.js';
+import { HttpStatus, JsonRpcErrorCode } from './status.js';
+const mcpSessionIdHeader = 'mcp-session-id';
+const jsonRpcContentType = 'application/json';
+const allowedMethods = 'GET, POST, DELETE';
+export async function startStreamableHttpBridge(options) {
+    const controller = new StreamableHttpBridgeController(options);
+    return controller.start();
+}
+export function isAuthorizedRequest(req, authToken) {
+    if (authToken === undefined)
+        return true;
+    const authorization = getSingleHeader(req, 'authorization');
+    if (!authorization)
+        return false;
+    const parts = authorization.trim().split(/\s+/);
+    if (parts.length !== 2)
+        return false;
+    const [scheme, token] = parts;
+    return scheme.toLowerCase() === 'bearer' && timingSafeStringEqual(token, authToken);
+}
+export function isEndpointRequest(req, endpoint, fallbackHost) {
+    const host = getSingleHeader(req, 'host') ?? formatHost(fallbackHost);
+    const url = new URL(req.url ?? '/', `http://${host}`);
+    return url.pathname === endpoint;
+}
+class StreamableHttpBridgeController {
+    #options;
+    #store;
+    #sessions = new Map();
+    #closing = new Map();
+    #httpServer;
+    #cleanupTimer;
+    #pendingSessionInitializations = 0;
+    constructor(options) {
+        this.#options = options;
+        this.#store = options.sessionStore ?? createSessionStore(options.sessionBackend);
+        this.#httpServer = createServer((req, res) => {
+            void this.#handleRequest(req, res);
+        });
+        this.#cleanupTimer = setInterval(() => {
+            void this.#closeExpiredSessions();
+        }, Math.min(options.sessionIdleTtlMs, 60_000));
+        this.#cleanupTimer.unref();
+    }
+    async start() {
+        await listenHttpServer(this.#httpServer, this.#options.port, this.#options.host);
+        const address = this.#httpServer.address();
+        if (typeof address === 'string' || address === null) {
+            throw new Error('HTTP server did not expose a TCP address');
+        }
+        return {
+            address,
+            url: `http://${formatHost(address.address)}:${address.port}${this.#options.endpoint}`,
+            close: async () => {
+                clearInterval(this.#cleanupTimer);
+                await Promise.allSettled([...this.#sessions.keys()].map((id) => this.#closeSession(id)));
+                await closeHttpServer(this.#httpServer);
+                await this.#store.clear();
+            },
+        };
+    }
+    async #handleRequest(req, res) {
+        try {
+            if (!isEndpointRequest(req, this.#options.endpoint, this.#options.host)) {
+                writeJsonRpcError(res, HttpStatus.NotFound, JsonRpcErrorCode.ServerError, 'Not found');
+                return;
+            }
+            if (!isAuthorizedRequest(req, this.#options.authToken)) {
+                writeJsonRpcError(res, HttpStatus.Unauthorized, JsonRpcErrorCode.ServerError, 'Unauthorized', {
+                    'WWW-Authenticate': 'Bearer',
+                });
+                return;
+            }
+            await this.#closeExpiredSessions();
+            const method = req.method ?? '';
+            if (method !== 'GET' && method !== 'POST' && method !== 'DELETE') {
+                writeJsonRpcError(res, HttpStatus.MethodNotAllowed, JsonRpcErrorCode.ServerError, 'Method not allowed.', {
+                    Allow: allowedMethods,
+                });
+                return;
+            }
+            if (method === 'POST') {
+                await this.#handlePostRequest(req, res);
+                return;
+            }
+            await this.#handleSessionRequest(req, res);
+        }
+        catch {
+            if (!res.headersSent) {
+                writeJsonRpcError(res, HttpStatus.InternalServerError, JsonRpcErrorCode.InternalError, 'Internal server error');
+            }
+            else {
+                res.end();
+            }
+        }
+    }
+    async #handlePostRequest(req, res) {
+        if (!hasJsonContentType(req)) {
+            writeJsonRpcError(res, HttpStatus.UnsupportedMediaType, JsonRpcErrorCode.ServerError, 'Unsupported Media Type: Content-Type must be application/json');
+            return;
+        }
+        let parsedBody;
+        try {
+            parsedBody = await readJsonBody(req, this.#options.bodyLimitBytes);
+        }
+        catch (error) {
+            if (error instanceof RequestBodyTooLargeError) {
+                writeJsonRpcError(res, HttpStatus.PayloadTooLarge, JsonRpcErrorCode.ServerError, 'Request body too large');
+            }
+            else {
+                writeJsonRpcError(res, HttpStatus.BadRequest, JsonRpcErrorCode.ParseError, 'Parse error: Invalid JSON');
+            }
+            return;
+        }
+        const sessionId = getSingleHeader(req, mcpSessionIdHeader);
+        if (sessionId) {
+            await this.#handleSessionRequest(req, res, parsedBody);
+            return;
+        }
+        if (!containsInitializeRequest(parsedBody)) {
+            writeJsonRpcError(res, HttpStatus.BadRequest, JsonRpcErrorCode.ServerError, 'Bad Request: No valid session ID provided');
+            return;
+        }
+        await this.#handleInitializeRequest(req, res, parsedBody);
+    }
+    async #handleInitializeRequest(req, res, parsedBody) {
+        const now = Date.now();
+        if (this.#sessions.size + this.#pendingSessionInitializations >= this.#options.sessionMax) {
+            writeJsonRpcError(res, HttpStatus.ServiceUnavailable, JsonRpcErrorCode.ServerError, 'HTTP session limit reached');
+            return;
+        }
+        this.#pendingSessionInitializations += 1;
+        const sessionId = randomUUID();
+        const record = {
+            id: sessionId,
+            createdAt: now,
+            lastSeenAt: now,
+            expiresAt: now + this.#options.sessionIdleTtlMs,
+            status: 'active',
+        };
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => sessionId,
+            onsessioninitialized: async (initializedSessionId) => {
+                if (initializedSessionId !== sessionId) {
+                    throw new Error(`Unexpected HTTP session ID "${initializedSessionId}"`);
+                }
+                await this.#store.create(record);
+            },
+            onsessionclosed: async (closedSessionId) => {
+                if (closedSessionId)
+                    await this.#store.markClosed(closedSessionId, Date.now());
+            },
+        });
+        try {
+            const bridge = await createBridgeServer({
+                serverInfo: this.#options.serverInfo,
+                runtimeOptions: { browserIsolated: true },
+            });
+            this.#sessions.set(sessionId, { id: sessionId, bridge, transport });
+            await bridge.start(transport);
+            await transport.handleRequest(req, res, parsedBody);
+        }
+        catch (error) {
+            await this.#closeSession(sessionId);
+            throw error;
+        }
+        finally {
+            this.#pendingSessionInitializations -= 1;
+        }
+    }
+    async #handleSessionRequest(req, res, parsedBody) {
+        const sessionId = getSingleHeader(req, mcpSessionIdHeader);
+        if (!sessionId) {
+            writeJsonRpcError(res, HttpStatus.BadRequest, JsonRpcErrorCode.ServerError, 'Bad Request: Mcp-Session-Id header is required');
+            return;
+        }
+        const session = await this.#getActiveSession(sessionId);
+        if (!session) {
+            writeJsonRpcError(res, HttpStatus.NotFound, JsonRpcErrorCode.SessionNotFound, 'Session not found');
+            return;
+        }
+        await this.#store.touch(sessionId, Date.now(), this.#options.sessionIdleTtlMs);
+        await session.transport.handleRequest(req, res, parsedBody);
+        if (req.method === 'DELETE') {
+            await this.#closeSession(sessionId);
+        }
+    }
+    async #getActiveSession(sessionId) {
+        const record = await this.#store.get(sessionId);
+        const session = this.#sessions.get(sessionId);
+        const now = Date.now();
+        if (!record || record.status !== 'active' || record.expiresAt <= now || !session) {
+            if (record?.status === 'active' && record.expiresAt <= now)
+                await this.#closeSession(sessionId);
+            return undefined;
+        }
+        return session;
+    }
+    async #closeExpiredSessions() {
+        const expired = await this.#store.listExpired(Date.now());
+        await Promise.allSettled(expired.map((record) => this.#closeSession(record.id)));
+    }
+    async #closeSession(sessionId) {
+        const pending = this.#closing.get(sessionId);
+        if (pending)
+            return pending;
+        const closing = this.#disposeSession(sessionId).finally(() => {
+            this.#closing.delete(sessionId);
+        });
+        this.#closing.set(sessionId, closing);
+        return closing;
+    }
+    async #disposeSession(sessionId) {
+        const session = this.#sessions.get(sessionId);
+        this.#sessions.delete(sessionId);
+        await this.#store.markClosed(sessionId, Date.now());
+        if (!session)
+            return;
+        await session.bridge.dispose();
+    }
+}
+function hasJsonContentType(req) {
+    const contentType = getSingleHeader(req, 'content-type');
+    return contentType?.toLowerCase().includes(jsonRpcContentType) ?? false;
+}
+async function readJsonBody(req, limitBytes) {
+    const contentLength = getSingleHeader(req, 'content-length');
+    if (contentLength !== undefined && Number.parseInt(contentLength, 10) > limitBytes) {
+        throw new RequestBodyTooLargeError();
+    }
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+        size += buffer.byteLength;
+        if (size > limitBytes)
+            throw new RequestBodyTooLargeError();
+        chunks.push(buffer);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+}
+function containsInitializeRequest(value) {
+    const messages = Array.isArray(value) ? value : [value];
+    return messages.some((message) => isInitializeRequest(message));
+}
+function getSingleHeader(req, name) {
+    const value = req.headers[name];
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+function writeJsonRpcError(res, status, code, message, headers = {}, data) {
+    const error = { code, message };
+    if (data !== undefined)
+        error.data = data;
+    res.writeHead(status, {
+        'Content-Type': jsonRpcContentType,
+        ...headers,
+    });
+    res.end(JSON.stringify({
+        jsonrpc: '2.0',
+        error,
+        id: null,
+    }));
+}
+function formatHost(host) {
+    if (host.startsWith('[') && host.endsWith(']'))
+        return host;
+    return host.includes(':') ? `[${host}]` : host;
+}
+function timingSafeStringEqual(actual, expected) {
+    const actualBuffer = Buffer.from(actual);
+    const expectedBuffer = Buffer.from(expected);
+    return actualBuffer.length === expectedBuffer.length && timingSafeEqual(actualBuffer, expectedBuffer);
+}
+async function closeHttpServer(server) {
+    if (!server.listening)
+        return;
+    await new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
+async function listenHttpServer(server, port, host) {
+    await new Promise((resolve, reject) => {
+        const cleanup = () => {
+            server.off('error', onError);
+            server.off('listening', onListening);
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onListening = () => {
+            cleanup();
+            resolve();
+        };
+        server.once('error', onError);
+        server.once('listening', onListening);
+        server.listen(port, host);
+    });
+}
+class RequestBodyTooLargeError extends Error {
+}
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/http/sessionStore.d.ts

@@ -0,0 +1,31 @@
+export type HttpSessionStatus = 'active' | 'closed';
+export interface HttpSessionRecord {
+    id: string;
+    createdAt: number;
+    lastSeenAt: number;
+    expiresAt: number;
+    status: HttpSessionStatus;
+}
+export interface SessionStore {
+    create(record: HttpSessionRecord): Promise<void>;
+    get(id: string): Promise<HttpSessionRecord | undefined>;
+    touch(id: string, now: number, idleTtlMs: number): Promise<HttpSessionRecord | undefined>;
+    markClosed(id: string, now: number): Promise<HttpSessionRecord | undefined>;
+    countActive(now: number): Promise<number>;
+    listExpired(now: number): Promise<HttpSessionRecord[]>;
+    list(): Promise<HttpSessionRecord[]>;
+    clear(): Promise<void>;
+}
+export declare class InMemorySessionStore implements SessionStore {
+    #private;
+    create(record: HttpSessionRecord): Promise<void>;
+    get(id: string): Promise<HttpSessionRecord | undefined>;
+    touch(id: string, now: number, idleTtlMs: number): Promise<HttpSessionRecord | undefined>;
+    markClosed(id: string, now: number): Promise<HttpSessionRecord | undefined>;
+    countActive(now: number): Promise<number>;
+    listExpired(now: number): Promise<HttpSessionRecord[]>;
+    list(): Promise<HttpSessionRecord[]>;
+    clear(): Promise<void>;
+}
+export declare function createSessionStore(backend: string): SessionStore;
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/http/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/http/sessionStore.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAC1F,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAC5E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACvD,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,oBAAqB,YAAW,YAAY;;IAGjD,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAKvD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAYzF,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAa3E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMtD,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAGhE"}

package/dist/http/sessionStore.js

@@ -0,0 +1,60 @@
+export class InMemorySessionStore {
+    #records = new Map();
+    async create(record) {
+        this.#records.set(record.id, { ...record });
+    }
+    async get(id) {
+        const record = this.#records.get(id);
+        return record ? { ...record } : undefined;
+    }
+    async touch(id, now, idleTtlMs) {
+        const record = this.#records.get(id);
+        if (!record || record.status !== 'active')
+            return undefined;
+        const updated = {
+            ...record,
+            lastSeenAt: now,
+            expiresAt: now + idleTtlMs,
+        };
+        this.#records.set(id, updated);
+        return { ...updated };
+    }
+    async markClosed(id, now) {
+        const record = this.#records.get(id);
+        if (!record)
+            return undefined;
+        const updated = {
+            ...record,
+            lastSeenAt: now,
+            expiresAt: now,
+            status: 'closed',
+        };
+        this.#records.set(id, updated);
+        return { ...updated };
+    }
+    async countActive(now) {
+        let count = 0;
+        for (const record of this.#records.values()) {
+            if (record.status === 'active' && record.expiresAt > now)
+                count += 1;
+        }
+        return count;
+    }
+    async listExpired(now) {
+        return [...this.#records.values()]
+            .filter((record) => record.status === 'active' && record.expiresAt <= now)
+            .map((record) => ({ ...record }));
+    }
+    async list() {
+        return [...this.#records.values()].map((record) => ({ ...record }));
+    }
+    async clear() {
+        this.#records.clear();
+    }
+}
+export function createSessionStore(backend) {
+    if (backend === 'memory')
+        return new InMemorySessionStore();
+    throw new Error(`Unsupported HTTP session backend "${backend}"`);
+}
+//# sourceMappingURL=sessionStore.js.map

package/dist/http/sessionStore.js.map

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

package/dist/http/status.d.ts

@@ -0,0 +1,18 @@
+export declare enum HttpStatus {
+    Ok = 200,
+    BadRequest = 400,
+    Unauthorized = 401,
+    NotFound = 404,
+    MethodNotAllowed = 405,
+    PayloadTooLarge = 413,
+    UnsupportedMediaType = 415,
+    InternalServerError = 500,
+    ServiceUnavailable = 503
+}
+export declare enum JsonRpcErrorCode {
+    ServerError = -32000,
+    SessionNotFound = -32001,
+    InternalError = -32603,
+    ParseError = -32700
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/http/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/http/status.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,UAAU,MAAM;IAChB,YAAY,MAAM;IAClB,QAAQ,MAAM;IACd,gBAAgB,MAAM;IACtB,eAAe,MAAM;IACrB,oBAAoB,MAAM;IAC1B,mBAAmB,MAAM;IACzB,kBAAkB,MAAM;CACzB;AAED,oBAAY,gBAAgB;IAC1B,WAAW,SAAS;IACpB,eAAe,SAAS;IACxB,aAAa,SAAS;IACtB,UAAU,SAAS;CACpB"}

package/dist/http/status.js

@@ -0,0 +1,20 @@
+export var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["Ok"] = 200] = "Ok";
+    HttpStatus[HttpStatus["BadRequest"] = 400] = "BadRequest";
+    HttpStatus[HttpStatus["Unauthorized"] = 401] = "Unauthorized";
+    HttpStatus[HttpStatus["NotFound"] = 404] = "NotFound";
+    HttpStatus[HttpStatus["MethodNotAllowed"] = 405] = "MethodNotAllowed";
+    HttpStatus[HttpStatus["PayloadTooLarge"] = 413] = "PayloadTooLarge";
+    HttpStatus[HttpStatus["UnsupportedMediaType"] = 415] = "UnsupportedMediaType";
+    HttpStatus[HttpStatus["InternalServerError"] = 500] = "InternalServerError";
+    HttpStatus[HttpStatus["ServiceUnavailable"] = 503] = "ServiceUnavailable";
+})(HttpStatus || (HttpStatus = {}));
+export var JsonRpcErrorCode;
+(function (JsonRpcErrorCode) {
+    JsonRpcErrorCode[JsonRpcErrorCode["ServerError"] = -32000] = "ServerError";
+    JsonRpcErrorCode[JsonRpcErrorCode["SessionNotFound"] = -32001] = "SessionNotFound";
+    JsonRpcErrorCode[JsonRpcErrorCode["InternalError"] = -32603] = "InternalError";
+    JsonRpcErrorCode[JsonRpcErrorCode["ParseError"] = -32700] = "ParseError";
+})(JsonRpcErrorCode || (JsonRpcErrorCode = {}));
+//# sourceMappingURL=status.js.map

package/dist/http/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/http/status.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAUX;AAVD,WAAY,UAAU;IACpB,yCAAQ,CAAA;IACR,yDAAgB,CAAA;IAChB,6DAAkB,CAAA;IAClB,qDAAc,CAAA;IACd,qEAAsB,CAAA;IACtB,mEAAqB,CAAA;IACrB,6EAA0B,CAAA;IAC1B,2EAAyB,CAAA;IACzB,yEAAwB,CAAA;AAC1B,CAAC,EAVW,UAAU,KAAV,UAAU,QAUrB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,0EAAoB,CAAA;IACpB,kFAAwB,CAAA;IACxB,8EAAsB,CAAA;IACtB,wEAAmB,CAAA;AACrB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B"}

package/dist/server.d.ts

@@ -2,9 +2,10 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { type Implementation } from '@modelcontextprotocol/sdk/types.js';
-import { type BridgeRuntime } from './bridge/config.js';
+import { type BridgeRuntime, type PrepareBridgeRuntimeOptions } from './bridge/config.js';
 export interface StartBridgeOptions {
     serverInfo?: Partial<Implementation>;
+    runtimeOptions?: Pick<PrepareBridgeRuntimeOptions, 'browserIsolated'>;
 }
 export interface BridgeServerOptions extends StartBridgeOptions {
     runtime?: BridgeRuntime;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAK9E,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAIzF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCjG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,2BAA2B,EACjC,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,cAAc,CAAC,EAAE,IAAI,CAAC,2BAA2B,EAAE,iBAAiB,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAIzF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCjG"}

package/dist/server.js

@@ -3,7 +3,7 @@ import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { prepareBridgeRuntime } from './bridge/config.js';
+import { prepareBridgeRuntime, } from './bridge/config.js';
 import { resolvePlaywrightMcpCliPath } from './bridge/paths.js';
 import { callLocalTool, createLocalTools, isLocalTool } from './bridge/tools.js';
 import { MCP_SERVER_INSTRUCTIONS, PROJECT_METADATA } from './project/metadata.js';
@@ -13,7 +13,7 @@ export async function startBridge(options = {}) {
     return bridge;
 }
 export async function createBridgeServer(options = {}) {
-    const runtime = options.runtime ?? (await prepareBridgeRuntime());
+    const runtime = options.runtime ?? (await prepareBridgeRuntime(options.runtimeOptions));
     const upstreamClient = options.upstreamClient ?? (await connectUpstream(runtime));
     const localTools = createLocalTools();
     const upstreamToolCache = new Map();

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EACL,qBAAqB,EAKrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAsB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAkBlF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAA8B,EAAE;IAChE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoC,CAAC;IACtE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC9D,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EAAE,uBAAuB;KACtC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5F,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM;YAAE,OAAO,QAAQ,CAAC;QAC5C,OAAO;YACL,GAAG,QAAQ;YACX,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAmB,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,OAAO;QACP,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,oBAAoB,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,cAAsB,EACtB,KAA4C,EAC5C,MAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CACnD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAyB,EACrC,CAAC,KAAc,EAAE,EAAE;QACjB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAsB;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,IAAI,EAAE,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;QACrE,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,kBAAkB;QACnD,OAAO,EAAE,gBAAgB,CAAC,OAAO;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAoC;IAC5D,OAAO;QACL,IAAI,EAAE,gBAAgB,CAAC,OAAO;QAC9B,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,OAAO,EAAE,gBAAgB,CAAC,OAAO;QACjC,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,UAAU,EAAE,gBAAgB,CAAC,UAAU;QACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EACL,qBAAqB,EAKrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,oBAAoB,GAGrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAmBlF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAA8B,EAAE;IAChE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,oBAAoB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoC,CAAC;IACtE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC9D,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EAAE,uBAAuB;KACtC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5F,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM;YAAE,OAAO,QAAQ,CAAC;QAC5C,OAAO;YACL,GAAG,QAAQ;YACX,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAmB,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,OAAO;QACP,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,oBAAoB,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,cAAsB,EACtB,KAA4C,EAC5C,MAAkC;IAElC,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CACnD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAyB,EACrC,CAAC,KAAc,EAAE,EAAE;QACjB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAsB;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,IAAI,EAAE,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;QACrE,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,kBAAkB;QACnD,OAAO,EAAE,gBAAgB,CAAC,OAAO;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAoC;IAC5D,OAAO;QACL,IAAI,EAAE,gBAAgB,CAAC,OAAO;QAC9B,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,OAAO,EAAE,gBAAgB,CAAC,OAAO;QACjC,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,UAAU,EAAE,gBAAgB,CAAC,UAAU;QACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloakbrowser-mcp",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Playwright MCP bridge that runs upstream browser tools with CloakBrowser.",
   "mcpName": "io.github.swimmwatch/cloakbrowser-mcp",
   "type": "module",
@@ -44,6 +44,7 @@
     "format:check": "prettier --check .",
     "docs:install": "python3 -m venv .venv-docs && .venv-docs/bin/pip install -r docs/requirements.txt",
     "docs:assets": "node scripts/generate-brand-assets.mjs",
+    "docs:cli": "tsx scripts/generate-cli-docs.ts",
     "docs:serve": ".venv-docs/bin/mkdocs serve",
     "docs:build": ".venv-docs/bin/mkdocs build --strict",
     "docs:seo:validate": "node scripts/validate-docs-seo.mjs",
@@ -61,12 +62,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.0",
     "@playwright/mcp": "^0.0.75",
-    "cloakbrowser": "^0.3.30"
+    "cloakbrowser": "^0.3.30",
+    "commander": "^14.0.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.13.0",
     "@types/node": "^20.14.0",
-    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/coverage-v8": "^3.2.4",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "eslint": "^9.13.0",
@@ -75,7 +77,10 @@
     "tsx": "^4.19.0",
     "typescript": "^5.5.4",
     "typescript-eslint": "^8.11.0",
-    "vitest": "^2.0.5"
+    "vitest": "^3.2.4"
+  },
+  "overrides": {
+    "vite": "6.4.2"
   },
   "keywords": [
     "mcp",