@jobshimo/browser-link 0.7.9 → 0.7.12

package/dist/bridge/ipc-client.d.ts

@@ -0,0 +1,50 @@
+/** Raised when the proxy cannot complete the IPC handshake. */
+export declare class HandshakeError extends Error {
+    constructor(message: string);
+}
+export interface ConnectOptions {
+    host?: string;
+    port?: number;
+    /** How long to wait for a hello-ack after sending the hello. */
+    handshakeTimeoutMs?: number;
+}
+export interface ConnectionInfo {
+    sessionId: string;
+    version: string;
+}
+/** Minimal IPC client. Owns the TCP socket, handles framing, runs the
+ * handshake, dispatches mcp.response frames back to whoever sent the
+ * matching mcp.request. */
+export declare class IpcClient {
+    private socket;
+    private buffer;
+    private nextRequestId;
+    private pendingRequests;
+    private closeListeners;
+    private notificationListeners;
+    private closed;
+    /** Open the TCP connection, perform the handshake, and resolve with the
+     * session info from the primary's hello-ack. On any handshake failure,
+     * rejects with HandshakeError and tears down the socket. */
+    connect(token: string, opts?: ConnectOptions): Promise<ConnectionInfo>;
+    private handshakeReceiver;
+    /** Forward a JSON-RPC request as an mcp.request frame. Resolves with the
+     * primary's JSON-RPC response payload. Rejects if the socket closes. */
+    sendMcpRequest(jsonRpcPayload: unknown): Promise<unknown>;
+    /** Forward a JSON-RPC notification as an mcp.notification frame. Fire-
+     * and-forget — notifications have no response in JSON-RPC. */
+    sendMcpNotification(jsonRpcPayload: unknown): void;
+    /** Register a callback invoked when the IPC connection drops. The
+     * `reason` argument distinguishes a primary-closing broadcast from a
+     * plain remote close so callers can decide to re-elect vs exit. */
+    onClose(cb: (reason: 'remote' | 'local' | 'primary-closing') => void): void;
+    /** Register a callback for unsolicited notifications from the primary
+     * (e.g. tools/list_changed in the future). */
+    onNotification(cb: (payload: unknown) => void): void;
+    /** Close the IPC connection. */
+    disconnect(): Promise<void>;
+    private ingest;
+    private handleFrame;
+    private onSocketClose;
+    private notifyClose;
+}

package/dist/bridge/ipc-client.js

@@ -0,0 +1,247 @@
+import { connect } from 'node:net';
+import { IPC_HOST, IPC_PORT, IPC_PROTOCOL_VERSION, encodeFrame, parseFrame, } from './protocol.js';
+/**
+ * Bare IPC client used by the proxy. Owns the TCP socket, handles framing,
+ * runs the hello handshake, and dispatches mcp.response frames back to the
+ * caller that sent the matching mcp.request. The proxy wiring (stdin/stdout
+ * pipe + reelect loop) lives in proxy.ts.
+ */
+function log(msg) {
+    console.error(`[browser-link proxy] ${msg}`);
+}
+/** Raised when the proxy cannot complete the IPC handshake. */
+export class HandshakeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HandshakeError';
+    }
+}
+/** Minimal IPC client. Owns the TCP socket, handles framing, runs the
+ * handshake, dispatches mcp.response frames back to whoever sent the
+ * matching mcp.request. */
+export class IpcClient {
+    socket = null;
+    buffer = '';
+    nextRequestId = 1;
+    pendingRequests = new Map();
+    closeListeners = [];
+    notificationListeners = [];
+    closed = false;
+    /** Open the TCP connection, perform the handshake, and resolve with the
+     * session info from the primary's hello-ack. On any handshake failure,
+     * rejects with HandshakeError and tears down the socket. */
+    async connect(token, opts = {}) {
+        const host = opts.host ?? IPC_HOST;
+        const port = opts.port ?? IPC_PORT;
+        const handshakeTimeoutMs = opts.handshakeTimeoutMs ?? 4000;
+        const socket = await new Promise((resolve, reject) => {
+            const s = connect({ host, port });
+            s.once('connect', () => {
+                resolve(s);
+            });
+            s.once('error', (err) => {
+                reject(err);
+            });
+        });
+        this.socket = socket;
+        socket.on('data', (chunk) => {
+            this.ingest(chunk);
+        });
+        socket.on('close', () => {
+            this.onSocketClose('remote');
+        });
+        socket.on('error', (err) => {
+            log(`Socket error: ${err.message}`);
+        });
+        // Send hello, wait for ack or reject or timeout.
+        const ack = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new HandshakeError('Handshake timed out — primary did not reply.'));
+            }, handshakeTimeoutMs);
+            const onFirstFrame = (frame) => {
+                clearTimeout(timer);
+                if (frame.kind === 'hello-ack') {
+                    resolve({ sessionId: frame.sessionId, version: frame.version });
+                    return;
+                }
+                if (frame.kind === 'hello-reject') {
+                    reject(new HandshakeError(`Primary rejected: ${frame.reason}`));
+                    return;
+                }
+                reject(new HandshakeError(`Unexpected first frame: ${frame.kind}`));
+            };
+            this.handshakeReceiver = onFirstFrame;
+            try {
+                socket.write(encodeFrame({ kind: 'hello', version: IPC_PROTOCOL_VERSION, token }));
+            }
+            catch (err) {
+                clearTimeout(timer);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        }).catch((err) => {
+            void this.disconnect().catch(() => {
+                /* ignore */
+            });
+            throw err;
+        });
+        this.handshakeReceiver = null;
+        log(`Handshake ok — session=${ack.sessionId}`);
+        return ack;
+    }
+    handshakeReceiver = null;
+    /** Forward a JSON-RPC request as an mcp.request frame. Resolves with the
+     * primary's JSON-RPC response payload. Rejects if the socket closes. */
+    sendMcpRequest(jsonRpcPayload) {
+        const socket = this.socket;
+        if (!socket || this.closed) {
+            return Promise.reject(new Error('Proxy is not connected.'));
+        }
+        const requestId = this.nextRequestId++;
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(requestId, resolve);
+            const onCloseHandler = () => {
+                if (this.pendingRequests.delete(requestId)) {
+                    reject(new Error('Primary connection closed while a request was in flight.'));
+                }
+            };
+            this.onClose(onCloseHandler);
+            try {
+                socket.write(encodeFrame({ kind: 'mcp.request', requestId, payload: jsonRpcPayload }));
+            }
+            catch (err) {
+                this.pendingRequests.delete(requestId);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    /** Forward a JSON-RPC notification as an mcp.notification frame. Fire-
+     * and-forget — notifications have no response in JSON-RPC. */
+    sendMcpNotification(jsonRpcPayload) {
+        if (!this.socket || this.closed)
+            return;
+        try {
+            this.socket.write(encodeFrame({ kind: 'mcp.notification', payload: jsonRpcPayload }));
+        }
+        catch {
+            /* socket gone; close handler will fire */
+        }
+    }
+    /** Register a callback invoked when the IPC connection drops. The
+     * `reason` argument distinguishes a primary-closing broadcast from a
+     * plain remote close so callers can decide to re-elect vs exit. */
+    onClose(cb) {
+        this.closeListeners.push(cb);
+    }
+    /** Register a callback for unsolicited notifications from the primary
+     * (e.g. tools/list_changed in the future). */
+    onNotification(cb) {
+        this.notificationListeners.push(cb);
+    }
+    /** Close the IPC connection. */
+    disconnect() {
+        if (this.closed)
+            return Promise.resolve();
+        this.closed = true;
+        if (this.socket) {
+            const s = this.socket;
+            this.socket = null;
+            try {
+                s.end();
+            }
+            catch {
+                /* ignore */
+            }
+            s.destroy();
+            // Fire close listeners with reason=local (we initiated it).
+            this.notifyClose('local');
+        }
+        return Promise.resolve();
+    }
+    ingest(chunk) {
+        this.buffer += chunk.toString('utf8');
+        let nl;
+        while ((nl = this.buffer.indexOf('\n')) >= 0) {
+            const line = this.buffer.slice(0, nl);
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line.length === 0)
+                continue;
+            const frame = parseFrame(line);
+            if (!frame) {
+                log('Invalid frame from primary; dropping.');
+                continue;
+            }
+            this.handleFrame(frame);
+        }
+    }
+    handleFrame(frame) {
+        if (this.handshakeReceiver) {
+            this.handshakeReceiver(frame);
+            return;
+        }
+        switch (frame.kind) {
+            case 'mcp.response': {
+                const resolve = this.pendingRequests.get(frame.requestId);
+                if (resolve) {
+                    this.pendingRequests.delete(frame.requestId);
+                    resolve(frame.payload);
+                }
+                return;
+            }
+            case 'mcp.notification': {
+                for (const cb of this.notificationListeners)
+                    cb(frame.payload);
+                return;
+            }
+            case 'ping': {
+                try {
+                    this.socket?.write(encodeFrame({ kind: 'pong' }));
+                }
+                catch {
+                    /* socket gone */
+                }
+                return;
+            }
+            case 'pong': {
+                // Future: we can send our own pings if needed. Today the primary
+                // initiates the heartbeat; pong from us → primary.
+                return;
+            }
+            case 'primary-closing': {
+                log(`Primary signalled close (${frame.reason ?? 'no reason'}).`);
+                this.notifyClose('primary-closing');
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    onSocketClose(reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        log('Socket closed by primary.');
+        this.notifyClose(reason);
+    }
+    notifyClose(reason) {
+        // Reject every in-flight request first so callers don't hang.
+        for (const resolve of this.pendingRequests.values()) {
+            // We resolve with a JSON-RPC error envelope so the MCP client gets
+            // a tool error instead of a stuck promise.
+            resolve({
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: -32000, message: 'browser-link primary disconnected.' },
+            });
+        }
+        this.pendingRequests.clear();
+        for (const cb of this.closeListeners.splice(0)) {
+            try {
+                cb(reason);
+            }
+            catch (err) {
+                log(`Close listener threw: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=ipc-client.js.map

package/dist/bridge/ipc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-client.js","sourceRoot":"","sources":["../../src/bridge/ipc-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,WAAW,EACX,UAAU,GAEX,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AAEH,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,+DAA+D;AAC/D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAcD;;2BAE2B;AAC3B,MAAM,OAAO,SAAS;IACZ,MAAM,GAAkB,IAAI,CAAC;IAC7B,MAAM,GAAG,EAAE,CAAC;IACZ,aAAa,GAAG,CAAC,CAAC;IAClB,eAAe,GAAG,IAAI,GAAG,EAAsC,CAAC;IAChE,cAAc,GAAoE,EAAE,CAAC;IACrF,qBAAqB,GAAsC,EAAE,CAAC;IAC9D,MAAM,GAAG,KAAK,CAAC;IAEvB;;gEAE4D;IAC5D,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAuB,EAAE;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;QACnC,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACtB,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,GAAG,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,CAAC,IAAI,cAAc,CAAC,8CAA8C,CAAC,CAAC,CAAC;YAC7E,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACvB,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE;gBACpC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC/B,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,cAAc,CAAC,qBAAqB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC,IAAI,cAAc,CAAC,2BAA2B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC,CAAC;YACF,IAAI,CAAC,iBAAiB,GAAG,YAAY,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACxB,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChC,YAAY;YACd,CAAC,CAAC,CAAC;YACH,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,GAAG,CAAC,0BAA0B,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,iBAAiB,GAAoC,IAAI,CAAC;IAElE;4EACwE;IACxE,cAAc,CAAC,cAAuB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,cAAc,GAAG,GAAS,EAAE;gBAChC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;YACzF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACvC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;kEAC8D;IAC9D,mBAAmB,CAAC,cAAuB;QACzC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IAED;;uEAEmE;IACnE,OAAO,CAAC,EAA4D;QAClE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;kDAC8C;IAC9C,cAAc,CAAC,EAA8B;QAC3C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,gCAAgC;IAChC,UAAU;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC;gBACH,CAAC,CAAC,GAAG,EAAE,CAAC;YACV,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,CAAC,CAAC,OAAO,EAAE,CAAC;YACZ,4DAA4D;YAC5D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEO,MAAM,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAChC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,uCAAuC,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAY;QAC9B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC1D,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBAC7C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,qBAAqB;oBAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,CAAC;oBACH,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,iEAAiE;gBACjE,mDAAmD;gBACnD,OAAO;YACT,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,GAAG,CAAC,4BAA4B,KAAK,CAAC,MAAM,IAAI,WAAW,IAAI,CAAC,CAAC;gBACjE,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;YACD;gBACE,OAAO;QACX,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,MAAgB;QACpC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACjC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAEO,WAAW,CAAC,MAA8C;QAChE,8DAA8D;QAC9D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,mEAAmE;YACnE,2CAA2C;YAC3C,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,oCAAoC,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,EAAE,CAAC,MAAM,CAAC,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/bridge/{client.d.ts → proxy.d.ts}

@@ -1,54 +1,5 @@
 import { type Interface } from 'node:readline';
-/** Raised when the proxy cannot complete the IPC handshake. */
-export declare class HandshakeError extends Error {
-    constructor(message: string);
-}
-export interface ConnectOptions {
-    host?: string;
-    port?: number;
-    /** How long to wait for a hello-ack after sending the hello. */
-    handshakeTimeoutMs?: number;
-}
-export interface ConnectionInfo {
-    sessionId: string;
-    version: string;
-}
-/** Minimal IPC client. Owns the TCP socket, handles framing, runs the
- * handshake, dispatches mcp.response frames back to whoever sent the
- * matching mcp.request. */
-export declare class IpcClient {
-    private socket;
-    private buffer;
-    private nextRequestId;
-    private pendingRequests;
-    private closeListeners;
-    private notificationListeners;
-    private closed;
-    /** Open the TCP connection, perform the handshake, and resolve with the
-     * session info from the primary's hello-ack. On any handshake failure,
-     * rejects with HandshakeError and tears down the socket. */
-    connect(token: string, opts?: ConnectOptions): Promise<ConnectionInfo>;
-    private handshakeReceiver;
-    /** Forward a JSON-RPC request as an mcp.request frame. Resolves with the
-     * primary's JSON-RPC response payload. Rejects if the socket closes. */
-    sendMcpRequest(jsonRpcPayload: unknown): Promise<unknown>;
-    /** Forward a JSON-RPC notification as an mcp.notification frame. Fire-
-     * and-forget — notifications have no response in JSON-RPC. */
-    sendMcpNotification(jsonRpcPayload: unknown): void;
-    /** Register a callback invoked when the IPC connection drops. The
-     * `reason` argument distinguishes a primary-closing broadcast from a
-     * plain remote close so callers can decide to re-elect vs exit. */
-    onClose(cb: (reason: 'remote' | 'local' | 'primary-closing') => void): void;
-    /** Register a callback for unsolicited notifications from the primary
-     * (e.g. tools/list_changed in the future). */
-    onNotification(cb: (payload: unknown) => void): void;
-    /** Close the IPC connection. */
-    disconnect(): Promise<void>;
-    private ingest;
-    private handleFrame;
-    private onSocketClose;
-    private notifyClose;
-}
+import { IpcClient } from './ipc-client.js';
 export interface ProxyOptions {
     input?: NodeJS.ReadableStream;
     output?: NodeJS.WritableStream;

package/dist/bridge/proxy.js

@@ -0,0 +1,231 @@
+import { createInterface } from 'node:readline';
+import { IpcClient } from './ipc-client.js';
+import { readToken } from './token.js';
+/**
+ * Proxy wrapper around IpcClient. Pipes MCP frames between the parent's
+ * stdin/stdout and the IPC bridge to the primary browser-link process.
+ *
+ * runProxy() owns the line buffer on the input side, the JSON-RPC framing,
+ * the optional auto-reelect loop (survives IPC drops by reconnecting to a
+ * fresh primary), and the stop()/closed handle the caller waits on.
+ */
+function log(msg) {
+    console.error(`[browser-link proxy] ${msg}`);
+}
+/** Read the token from disk and connect to the running primary, then plug
+ * stdin → IPC mcp.request and IPC mcp.response → stdout.
+ *
+ * When `autoReelect: true` is passed, the proxy survives IPC drops by
+ * waiting for a fresh primary to appear at the same port. During the
+ * wait, incoming JSON-RPC requests get an immediate error response so
+ * the MCP client never hangs on a missing reply. */
+export async function runProxy(opts = {}) {
+    const input = opts.input ?? process.stdin;
+    const output = opts.output ?? process.stdout;
+    const autoReelect = opts.autoReelect === true;
+    const reelectTimeoutMs = opts.reelectTimeoutMs ?? 5000;
+    const reelectIntervalMs = opts.reelectIntervalMs ?? 200;
+    const initialToken = opts.token ?? readToken();
+    if (!initialToken) {
+        throw new Error('Multi-agent token not found. The primary browser-link instance is not running with multi-agent enabled.');
+    }
+    let client = new IpcClient();
+    await client.connect(initialToken, { host: opts.host, port: opts.port });
+    /* When the IPC drops AND autoReelect is on, we enter "reconnecting"
+     * mode. While reconnecting, the data pipe stays attached but requests
+     * are answered immediately with an error envelope so the MCP client
+     * does not stall on a missing reply.
+     *
+     * The flags live behind a getter pair on purpose: any read pattern
+     * TS can statically narrow (let-binding, object literal property)
+     * gets refined after the first `if (flag) return` and stays narrowed
+     * across the subsequent `await reconnectLoop(...)`, even though
+     * `stop()` can flip the value concurrently. TS does NOT narrow the
+     * return type of a function call, which is exactly the safety net
+     * we need for the post-await re-check. */
+    const flags = { stopped: false, reconnecting: false };
+    const isStopped = () => flags.stopped;
+    const isReconnecting = () => flags.reconnecting;
+    let closedResolve = () => {
+        /* replaced synchronously in the Promise executor below */
+    };
+    const closed = new Promise((resolve) => {
+        closedResolve = resolve;
+    });
+    const fail = (reason) => {
+        if (isStopped())
+            return;
+        flags.stopped = true;
+        input.off('data', onData);
+        if (opts.onClose) {
+            try {
+                opts.onClose(reason);
+            }
+            catch (err) {
+                log(`onClose handler threw: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        closedResolve();
+    };
+    // Set up the input pipe. We can't use readline.createInterface on a raw
+    // stream that has already been data-event-attached, but we can use a
+    // simple line buffer like the server side.
+    let lineBuffer = '';
+    const onData = (chunk) => {
+        const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+        lineBuffer += text;
+        let nl;
+        while ((nl = lineBuffer.indexOf('\n')) >= 0) {
+            const line = lineBuffer.slice(0, nl).replace(/\r$/, '');
+            lineBuffer = lineBuffer.slice(nl + 1);
+            if (line.length === 0)
+                continue;
+            handleLine(line);
+        }
+    };
+    const handleLine = (line) => {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            output.write(JSON.stringify({
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: -32700, message: 'Parse error in proxy input.' },
+            }) + '\n');
+            return;
+        }
+        if (typeof msg !== 'object')
+            return;
+        if (msg.id === undefined || msg.id === null) {
+            // Notification — fire and forget when connected; drop during reconnect.
+            if (!isReconnecting())
+                client.sendMcpNotification(msg);
+            return;
+        }
+        if (isReconnecting()) {
+            // Fail fast so the MCP client can decide to retry.
+            output.write(JSON.stringify({
+                jsonrpc: '2.0',
+                id: msg.id,
+                error: {
+                    code: -32001,
+                    message: 'browser-link bridge temporarily unavailable (primary just closed; reconnecting).',
+                },
+            }) + '\n');
+            return;
+        }
+        // Capture the id NOW; by the time the catch fires the closure scope
+        // still has `msg`, but TS narrowing of `msg` inside the catch is
+        // weaker than reading the field upfront.
+        const incomingId = msg.id;
+        client
+            .sendMcpRequest(msg)
+            .then((responsePayload) => {
+            output.write(JSON.stringify(responsePayload) + '\n');
+        })
+            .catch((err) => {
+            output.write(JSON.stringify({
+                jsonrpc: '2.0',
+                id: incomingId,
+                error: { code: -32000, message: err instanceof Error ? err.message : String(err) },
+            }) + '\n');
+        });
+    };
+    input.on('data', onData);
+    const wireCloseHandler = (c) => {
+        // The onClose contract is sync (returns void). The body needs awaits
+        // for the reconnect loop, so we kick off an async IIFE inside.
+        c.onClose((reason) => {
+            void (async () => {
+                if (isStopped())
+                    return;
+                if (!autoReelect) {
+                    fail(reason);
+                    return;
+                }
+                // Enter reconnect mode and try to find a new primary.
+                flags.reconnecting = true;
+                opts.onReelectStart?.();
+                log(`Primary closed (${reason}); reelect window opened for ${reelectTimeoutMs}ms.`);
+                const newClient = await reconnectLoop(opts.host, opts.port, reelectTimeoutMs, reelectIntervalMs);
+                // `stop()` may have run during the await above and flipped
+                // `flags.stopped`. The `isStopped()` call dodges TS narrowing
+                // from the check at the top of this IIFE so the runtime guard
+                // stays real.
+                if (isStopped()) {
+                    if (newClient)
+                        await newClient.disconnect();
+                    return;
+                }
+                if (!newClient) {
+                    log('Reelect window exhausted; closing proxy.');
+                    opts.onReelectExhausted?.();
+                    flags.reconnecting = false;
+                    fail(reason);
+                    return;
+                }
+                // Hot-swap clients. The old one is already torn down by its close
+                // handler chain; we just install the new one and wire it up.
+                log('Reconnected to new primary.');
+                opts.onReelectSuccess?.();
+                client = newClient;
+                flags.reconnecting = false;
+                wireCloseHandler(client);
+            })();
+        });
+    };
+    wireCloseHandler(client);
+    const stop = async () => {
+        flags.stopped = true;
+        input.off('data', onData);
+        await client.disconnect();
+        closedResolve();
+    };
+    return {
+        get client() {
+            return client;
+        },
+        stop,
+        closed,
+    };
+}
+/** Repeatedly try to connect to the IPC port until success or budget
+ * expires. Re-reads the token on every attempt because a new primary
+ * rotates it on startup. Returns the connected client, or null on
+ * timeout. */
+async function reconnectLoop(host, port, totalBudgetMs, intervalMs) {
+    const deadline = Date.now() + totalBudgetMs;
+    // Generous handshake budget — Windows under load can take >200ms for a
+    // local socket round-trip and a too-tight ceiling makes reconnects flap.
+    const handshakeTimeoutMs = Math.min(1500, Math.max(800, intervalMs * 4));
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, intervalMs));
+        const token = readToken();
+        if (!token)
+            continue;
+        const c = new IpcClient();
+        try {
+            await c.connect(token, { host, port, handshakeTimeoutMs });
+            return c;
+        }
+        catch {
+            try {
+                await c.disconnect();
+            }
+            catch {
+                /* ignore */
+            }
+            // Retry until deadline.
+        }
+    }
+    return null;
+}
+/** Convenience: open a readline-style line iterator over a stream. Currently
+ * unused (we use a hand-rolled line buffer for symmetry with the server)
+ * but exported for future tooling. */
+export function readlines(stream) {
+    return createInterface({ input: stream, crlfDelay: Infinity });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/bridge/proxy.js.map

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

package/dist/bridge/ws-bridge.d.ts

@@ -0,0 +1,26 @@
+import { WebSocket, WebSocketServer } from 'ws';
+import type { BridgeEventLog } from './events.js';
+export declare const WS_HOST = "127.0.0.1";
+export declare const WS_PORT = 17529;
+export interface TabSession {
+    tabId: string;
+    url: string;
+    title: string;
+    ws: WebSocket;
+}
+export interface PendingRequest {
+    resolve: (result: unknown) => void;
+    reject: (err: Error) => void;
+    timeout: NodeJS.Timeout;
+}
+export declare function isAddrInUse(err: unknown): boolean;
+/** Bring up the WebSocket bridge for the Chrome extension. Resolves only
+ * after the server is listening, so the caller can fail fast (and refuse
+ * to expose the MCP transport) when the port is taken or any other bind
+ * error happens. */
+export declare function startWsBridge(tabs: Map<string, TabSession>, pendingRequests: Map<string, PendingRequest>, events: BridgeEventLog): Promise<WebSocketServer>;
+/** Build the callback that sends a tool.request frame to a specific tab and
+ * resolves with the matching tool.response (or rejects on timeout). Kept here
+ * because it touches the same `tabs` / `pendingRequests` maps the bridge
+ * owns. */
+export declare function sendToolRequest(tabs: Map<string, TabSession>, pendingRequests: Map<string, PendingRequest>, tabId: string, id: string, tool: string, params: unknown, timeoutMs: number): Promise<unknown>;