@quenty/studio-bridge 0.7.1 → 0.9.0

package/dist/src/bridge/internal/bridge-host.test.js

@@ -0,0 +1,377 @@
+/**
+ * Unit tests for BridgeHost — validates plugin connection handling,
+ * handshake acceptance, session tracking, health endpoint integration,
+ * and disconnect events.
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { WebSocket } from 'ws';
+import http from 'http';
+import { BridgeHost } from './bridge-host.js';
+function connectPlugin(port) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://localhost:${port}/plugin`);
+        ws.on('open', () => resolve(ws));
+        ws.on('error', reject);
+    });
+}
+function httpGet(port, path) {
+    return new Promise((resolve, reject) => {
+        http
+            .get(`http://localhost:${port}${path}`, (res) => {
+            let body = '';
+            res.on('data', (chunk) => {
+                body += chunk;
+            });
+            res.on('end', () => {
+                resolve({ status: res.statusCode ?? 0, body });
+            });
+            res.on('error', reject);
+        })
+            .on('error', reject);
+    });
+}
+async function performRegisterHandshake(port, sessionId, options) {
+    const ws = await connectPlugin(port);
+    ws.send(JSON.stringify({
+        type: 'register',
+        sessionId,
+        payload: {
+            pluginVersion: options?.pluginVersion ?? '1.0.0',
+            instanceId: options?.instanceId ?? 'inst-1',
+            placeName: options?.placeName ?? 'TestPlace',
+            state: options?.state ?? 'Edit',
+            capabilities: options?.capabilities ?? ['execute', 'queryState'],
+        },
+    }));
+    // Allow the host to process the register message
+    await new Promise((r) => setTimeout(r, 10));
+    return { ws };
+}
+describe('BridgeHost', () => {
+    let host;
+    const openClients = [];
+    afterEach(async () => {
+        for (const ws of openClients) {
+            if (ws.readyState === WebSocket.OPEN ||
+                ws.readyState === WebSocket.CONNECTING) {
+                ws.close();
+            }
+        }
+        openClients.length = 0;
+        if (host) {
+            await host.stopAsync();
+            host = undefined;
+        }
+    });
+    describe('startAsync', () => {
+        it('starts on an ephemeral port and reports port', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            expect(port).toBeGreaterThan(0);
+            expect(host.port).toBe(port);
+            expect(host.isRunning).toBe(true);
+        });
+        it('throws when started twice', async () => {
+            host = new BridgeHost();
+            await host.startAsync({ port: 0 });
+            await expect(host.startAsync({ port: 0 })).rejects.toThrow('BridgeHost is already running');
+        });
+    });
+    describe('stopAsync', () => {
+        it('stops the host and resets state', async () => {
+            host = new BridgeHost();
+            await host.startAsync({ port: 0 });
+            await host.stopAsync();
+            expect(host.isRunning).toBe(false);
+            expect(host.pluginCount).toBe(0);
+        });
+        it('is idempotent', async () => {
+            host = new BridgeHost();
+            await host.startAsync({ port: 0 });
+            await host.stopAsync();
+            await host.stopAsync();
+        });
+    });
+    describe('register handshake', () => {
+        it('emits plugin-connected with session info on register', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const connectedPromise = new Promise((resolve) => {
+                host.on('plugin-connected', resolve);
+            });
+            const { ws } = await performRegisterHandshake(port, 'session-1', {
+                capabilities: ['execute', 'captureScreenshot'],
+                pluginVersion: '2.0.0',
+            });
+            openClients.push(ws);
+            const info = await connectedPromise;
+            expect(info.sessionId).toBe('session-1');
+            expect(info.capabilities).toEqual(['execute', 'captureScreenshot']);
+            expect(info.pluginVersion).toBe('2.0.0');
+        });
+        it('tracks the plugin in pluginCount', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            expect(host.pluginCount).toBe(0);
+            const { ws } = await performRegisterHandshake(port, 'session-1');
+            openClients.push(ws);
+            expect(host.pluginCount).toBe(1);
+        });
+    });
+    describe('plugin disconnect', () => {
+        it('emits plugin-disconnected when a plugin closes', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const { ws } = await performRegisterHandshake(port, 'session-dc');
+            openClients.push(ws);
+            // Wait for the plugin to be registered
+            await new Promise((r) => setTimeout(r, 50));
+            expect(host.pluginCount).toBe(1);
+            const disconnectedPromise = new Promise((resolve) => {
+                host.on('plugin-disconnected', resolve);
+            });
+            ws.close();
+            const sessionId = await disconnectedPromise;
+            expect(sessionId).toBe('session-dc');
+            expect(host.pluginCount).toBe(0);
+        });
+        it('tracks multiple plugins and removes only the disconnected one', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const { ws: ws1 } = await performRegisterHandshake(port, 'session-1');
+            openClients.push(ws1);
+            const { ws: ws2 } = await performRegisterHandshake(port, 'session-2');
+            openClients.push(ws2);
+            await new Promise((r) => setTimeout(r, 50));
+            expect(host.pluginCount).toBe(2);
+            const disconnectedPromise = new Promise((resolve) => {
+                host.on('plugin-disconnected', resolve);
+            });
+            ws1.close();
+            await disconnectedPromise;
+            expect(host.pluginCount).toBe(1);
+        });
+        it('handles duplicate sessionId by replacing old connection', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            // Connect first plugin
+            const { ws: ws1 } = await performRegisterHandshake(port, 'session-dup');
+            openClients.push(ws1);
+            await new Promise((r) => setTimeout(r, 50));
+            expect(host.pluginCount).toBe(1);
+            // Connect second plugin with the SAME sessionId
+            const { ws: ws2 } = await performRegisterHandshake(port, 'session-dup');
+            openClients.push(ws2);
+            await new Promise((r) => setTimeout(r, 50));
+            // Should still be 1 — second replaced first
+            expect(host.pluginCount).toBe(1);
+            // Old socket should have been closed by the host
+            await new Promise((r) => setTimeout(r, 100));
+            expect(ws1.readyState).toBe(WebSocket.CLOSED);
+            expect(ws2.readyState).toBe(WebSocket.OPEN);
+        });
+        it('old close handler does not remove new connection with same sessionId', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            // Connect two plugins with the same sessionId
+            const { ws: ws1 } = await performRegisterHandshake(port, 'session-race');
+            openClients.push(ws1);
+            await new Promise((r) => setTimeout(r, 50));
+            const { ws: ws2 } = await performRegisterHandshake(port, 'session-race');
+            openClients.push(ws2);
+            // Wait for close frames to propagate
+            await new Promise((r) => setTimeout(r, 200));
+            // ws2 should still be tracked despite ws1's close handler firing
+            expect(host.pluginCount).toBe(1);
+            expect(ws2.readyState).toBe(WebSocket.OPEN);
+        });
+    });
+    describe('health endpoint', () => {
+        it('responds with valid JSON on /health', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const result = await httpGet(port, '/health');
+            expect(result.status).toBe(200);
+            const json = JSON.parse(result.body);
+            expect(json.status).toBe('ok');
+            expect(json.port).toBe(port);
+            expect(json.sessions).toBe(0);
+            expect(typeof json.uptime).toBe('number');
+        });
+        it('reflects correct session count', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            // Connect a plugin
+            const { ws } = await performRegisterHandshake(port, 'session-h');
+            openClients.push(ws);
+            await new Promise((r) => setTimeout(r, 50));
+            const result = await httpGet(port, '/health');
+            const json = JSON.parse(result.body);
+            expect(json.sessions).toBe(1);
+        });
+        it('returns 404 for unknown HTTP paths', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const result = await httpGet(port, '/unknown');
+            expect(result.status).toBe(404);
+        });
+    });
+    describe('sendToPluginAsync request correlation', () => {
+        /**
+         * The persistent dispatcher routes plugin replies by `requestId` via a
+         * per-connection PendingRequestMap. This was previously a per-call
+         * `ws.on('message', ...)` listener that matched the first non-heartbeat
+         * reply, which could (a) leak listeners under load and (b) cross
+         * responses when ≥2 requests were in flight.
+         */
+        function readNextMessageAsync(ws) {
+            return new Promise((resolve, reject) => {
+                const onMessage = (raw) => {
+                    ws.off('message', onMessage);
+                    ws.off('error', onError);
+                    const data = typeof raw === 'string'
+                        ? raw
+                        : Buffer.isBuffer(raw)
+                            ? raw.toString('utf-8')
+                            : Buffer.concat(raw).toString('utf-8');
+                    try {
+                        resolve(JSON.parse(data));
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                };
+                const onError = (err) => {
+                    ws.off('message', onMessage);
+                    ws.off('error', onError);
+                    reject(err);
+                };
+                ws.on('message', onMessage);
+                ws.on('error', onError);
+            });
+        }
+        it('routes concurrent in-flight responses to the correct callers', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const sessionId = 'concurrent-test';
+            const { ws } = await performRegisterHandshake(port, sessionId);
+            openClients.push(ws);
+            // Fire two requests in parallel — they should resolve independently
+            // by requestId, even if the plugin replies in reverse order.
+            const firstRequestPromise = readNextMessageAsync(ws);
+            const reply1 = host.sendToPluginAsync(sessionId, {
+                type: 'execute',
+                sessionId,
+                requestId: 'req-1',
+                payload: { script: 'print(1)' },
+            }, 2_000);
+            const sent1 = await firstRequestPromise;
+            expect(sent1.requestId).toBe('req-1');
+            const secondRequestPromise = readNextMessageAsync(ws);
+            const reply2 = host.sendToPluginAsync(sessionId, {
+                type: 'execute',
+                sessionId,
+                requestId: 'req-2',
+                payload: { script: 'print(2)' },
+            }, 2_000);
+            const sent2 = await secondRequestPromise;
+            expect(sent2.requestId).toBe('req-2');
+            // Reply to req-2 first, then req-1.
+            ws.send(JSON.stringify({
+                type: 'scriptComplete',
+                sessionId,
+                requestId: 'req-2',
+                tag: 'second',
+                payload: { success: true },
+            }));
+            ws.send(JSON.stringify({
+                type: 'scriptComplete',
+                sessionId,
+                requestId: 'req-1',
+                tag: 'first',
+                payload: { success: true },
+            }));
+            const [r1, r2] = await Promise.all([reply1, reply2]);
+            expect(r1.requestId).toBe('req-1');
+            expect(r1.tag).toBe('first');
+            expect(r2.requestId).toBe('req-2');
+            expect(r2.tag).toBe('second');
+        });
+        it('does not satisfy a request with an unrelated error reply', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const sessionId = 'unrelated-error';
+            const { ws } = await performRegisterHandshake(port, sessionId);
+            openClients.push(ws);
+            const drained = readNextMessageAsync(ws);
+            const replyPromise = host.sendToPluginAsync(sessionId, {
+                type: 'execute',
+                sessionId,
+                requestId: 'req-real',
+                payload: { script: 'print()' },
+            }, 300);
+            await drained;
+            // Send an error reply with a *different* requestId. It must NOT
+            // satisfy req-real; req-real should still time out.
+            ws.send(JSON.stringify({
+                type: 'error',
+                sessionId,
+                requestId: 'some-other-request',
+                payload: { code: 'INTERNAL_ERROR', message: 'unrelated' },
+            }));
+            await expect(replyPromise).rejects.toThrow(/timed out/);
+        });
+        it('rejects pending requests when the plugin disconnects', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const sessionId = 'disconnect-test';
+            const { ws } = await performRegisterHandshake(port, sessionId);
+            openClients.push(ws);
+            const drained = readNextMessageAsync(ws);
+            const replyPromise = host.sendToPluginAsync(sessionId, {
+                type: 'execute',
+                sessionId,
+                requestId: 'req-x',
+                payload: { script: 'print()' },
+            }, 10_000);
+            await drained;
+            ws.close();
+            await expect(replyPromise).rejects.toThrow(/disconnect/i);
+        });
+        it('does not leak ws listeners across many requests', async () => {
+            host = new BridgeHost();
+            const port = await host.startAsync({ port: 0 });
+            const sessionId = 'no-leak';
+            const { ws: clientWs } = await performRegisterHandshake(port, sessionId);
+            openClients.push(clientWs);
+            // Reach into the host to grab the *server-side* WebSocket — that's the
+            // one the dispatcher attaches to.
+            const state = host._plugins.get(sessionId);
+            expect(state).toBeDefined();
+            const baselineListeners = state.ws.listenerCount('message');
+            // Fire 25 requests, replying immediately to each.
+            const requests = [];
+            for (let i = 0; i < 25; i++) {
+                const requestId = `bulk-${i}`;
+                const drained = readNextMessageAsync(clientWs);
+                requests.push(host.sendToPluginAsync(sessionId, {
+                    type: 'execute',
+                    sessionId,
+                    requestId,
+                    payload: { script: 'print()' },
+                }, 5_000));
+                await drained;
+                clientWs.send(JSON.stringify({
+                    type: 'scriptComplete',
+                    sessionId,
+                    requestId,
+                    payload: { success: true },
+                }));
+            }
+            await Promise.all(requests);
+            // Listener count is unchanged — the dispatcher is installed once.
+            expect(state.ws.listenerCount('message')).toBe(baselineListeners);
+        });
+    });
+});
+//# sourceMappingURL=bridge-host.test.js.map

package/dist/src/bridge/internal/bridge-host.test.js.map

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

package/dist/src/bridge/internal/environment-detection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Role detection utility for the bridge network. Determines whether the
+ * current process should act as a bridge host or bridge client by attempting
+ * to bind the port and probing the health endpoint.
+ *
+ * Algorithm:
+ * 1. If `remoteHost` specified -> client
+ * 2. Try to bind port -> host
+ * 3. EADDRINUSE -> check health endpoint
+ *    a. Health succeeds -> client (host is alive)
+ *    b. Health fails -> wait, retry bind (stale host)
+ */
+import { TransportServer } from './transport-server.js';
+export type DetectedRole = 'host' | 'client';
+export interface DetectRoleResult {
+    role: DetectedRole;
+    server?: TransportServer;
+    port: number;
+}
+/**
+ * Detect whether this process should act as a bridge host or client.
+ *
+ * - If `remoteHost` is specified, always returns 'client'.
+ * - Otherwise, tries to bind the port. Success means 'host'.
+ * - If EADDRINUSE, probes the health endpoint:
+ *   - If healthy, returns 'client'.
+ *   - If unhealthy (stale port), waits and retries the bind.
+ */
+export declare function detectRoleAsync(options: {
+    port: number;
+    remoteHost?: string;
+}): Promise<DetectRoleResult>;
+/**
+ * Detect whether running inside a devcontainer.
+ * Checks: REMOTE_CONTAINERS, CODESPACES, CONTAINER env vars, /.dockerenv file.
+ * Wide net -- false positive = 3s delay then fallback. False negative = user uses --remote.
+ */
+export declare function isDevcontainer(): boolean;
+/**
+ * Get default remote host for devcontainer environments.
+ * Returns "localhost:38741" inside devcontainer, null otherwise.
+ */
+export declare function getDefaultRemoteHost(): string | null;
+//# sourceMappingURL=environment-detection.d.ts.map

package/dist/src/bridge/internal/environment-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detection.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/environment-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoD5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAKpD"}

package/dist/src/bridge/internal/environment-detection.js

@@ -0,0 +1,91 @@
+/**
+ * Role detection utility for the bridge network. Determines whether the
+ * current process should act as a bridge host or bridge client by attempting
+ * to bind the port and probing the health endpoint.
+ *
+ * Algorithm:
+ * 1. If `remoteHost` specified -> client
+ * 2. Try to bind port -> host
+ * 3. EADDRINUSE -> check health endpoint
+ *    a. Health succeeds -> client (host is alive)
+ *    b. Health fails -> wait, retry bind (stale host)
+ */
+import { existsSync } from 'node:fs';
+import { TransportServer } from './transport-server.js';
+import { checkHealthAsync } from './health-endpoint.js';
+const STALE_RETRY_DELAY_MS = 1_000;
+const MAX_STALE_RETRIES = 3;
+const DEFAULT_BRIDGE_PORT = 38741;
+/**
+ * Detect whether this process should act as a bridge host or client.
+ *
+ * - If `remoteHost` is specified, always returns 'client'.
+ * - Otherwise, tries to bind the port. Success means 'host'.
+ * - If EADDRINUSE, probes the health endpoint:
+ *   - If healthy, returns 'client'.
+ *   - If unhealthy (stale port), waits and retries the bind.
+ */
+export async function detectRoleAsync(options) {
+    // If remoteHost is specified, always connect as client
+    if (options.remoteHost) {
+        return { role: 'client', port: options.port };
+    }
+    // Try to bind the port, with retries for stale ports
+    for (let attempt = 0; attempt <= MAX_STALE_RETRIES; attempt++) {
+        const server = new TransportServer();
+        try {
+            const boundPort = await server.startAsync({ port: options.port });
+            // We successfully bound -- we are the host.
+            // Stop the server for now; the caller (BridgeConnection) will
+            // use this server instance to set up BridgeHost.
+            // Actually, we return the server still listening so the caller
+            // can reuse it. But BridgeHost creates its own TransportServer.
+            // So we stop it and let the caller know to create a BridgeHost.
+            await server.stopAsync();
+            return { role: 'host', port: boundPort };
+        }
+        catch (err) {
+            const isAddressInUse = err instanceof Error &&
+                (err.message.includes('already in use') ||
+                    err.code === 'EADDRINUSE');
+            if (!isAddressInUse) {
+                throw err;
+            }
+            // Port is in use -- check if a healthy bridge host is there
+            const health = await checkHealthAsync(options.port);
+            if (health) {
+                // A live bridge host is running; become a client
+                return { role: 'client', port: options.port };
+            }
+            // Health check failed -- stale port. Wait and retry.
+            if (attempt < MAX_STALE_RETRIES) {
+                await new Promise((resolve) => setTimeout(resolve, STALE_RETRY_DELAY_MS));
+            }
+        }
+    }
+    // All retries exhausted
+    throw new Error(`Port ${options.port} is held by another process and no bridge host responded on /health. ` +
+        `The port may be in use by a non-bridge process.`);
+}
+/**
+ * Detect whether running inside a devcontainer.
+ * Checks: REMOTE_CONTAINERS, CODESPACES, CONTAINER env vars, /.dockerenv file.
+ * Wide net -- false positive = 3s delay then fallback. False negative = user uses --remote.
+ */
+export function isDevcontainer() {
+    return !!(process.env.REMOTE_CONTAINERS ||
+        process.env.CODESPACES ||
+        process.env.CONTAINER ||
+        existsSync('/.dockerenv'));
+}
+/**
+ * Get default remote host for devcontainer environments.
+ * Returns "localhost:38741" inside devcontainer, null otherwise.
+ */
+export function getDefaultRemoteHost() {
+    if (isDevcontainer()) {
+        return `localhost:${DEFAULT_BRIDGE_PORT}`;
+    }
+    return null;
+}
+//# sourceMappingURL=environment-detection.js.map

package/dist/src/bridge/internal/environment-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detection.js","sourceRoot":"","sources":["../../../../src/bridge/internal/environment-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAUxD,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAGrC;IACC,uDAAuD;IACvD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,qDAAqD;IACrD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,iBAAiB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,4CAA4C;YAC5C,8DAA8D;YAC9D,iDAAiD;YACjD,+DAA+D;YAC/D,gEAAgE;YAChE,gEAAgE;YAChE,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,cAAc,GAClB,GAAG,YAAY,KAAK;gBACpB,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBACpC,GAA6B,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;YAE1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,4DAA4D;YAC5D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEpD,IAAI,MAAM,EAAE,CAAC;gBACX,iDAAiD;gBACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAChD,CAAC;YAED,qDAAqD;YACrD,IAAI,OAAO,GAAG,iBAAiB,EAAE,CAAC;gBAChC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAC1C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,IAAI,uEAAuE;QACzF,iDAAiD,CACpD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,CACP,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,UAAU;QACtB,OAAO,CAAC,GAAG,CAAC,SAAS;QACrB,UAAU,CAAC,aAAa,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,OAAO,aAAa,mBAAmB,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/bridge/internal/environment-detection.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for environment-detection -- validates role detection logic
+ * including host election on free port, client detection when host exists,
+ * remoteHost override, and devcontainer detection.
+ */
+export {};
+//# sourceMappingURL=environment-detection.test.d.ts.map

package/dist/src/bridge/internal/environment-detection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detection.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/environment-detection.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}