@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/bridge/internal/transport-server.test.js

@@ -0,0 +1,171 @@
+/**
+ * Unit tests for TransportServer — validates port binding, path-based
+ * WebSocket routing, HTTP health endpoint delegation, and cleanup.
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { WebSocket } from 'ws';
+import http from 'http';
+import { TransportServer } from './transport-server.js';
+function connectWs(port, path) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://localhost:${port}${path}`);
+        ws.on('open', () => resolve(ws));
+        ws.on('error', reject);
+    });
+}
+function connectWsExpectReject(port, path) {
+    return new Promise((resolve) => {
+        const ws = new WebSocket(`ws://localhost:${port}${path}`);
+        ws.on('error', () => resolve('error'));
+        ws.on('unexpected-response', () => {
+            ws.close();
+            resolve('rejected');
+        });
+    });
+}
+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);
+    });
+}
+describe('TransportServer', () => {
+    let server;
+    const openClients = [];
+    afterEach(async () => {
+        for (const ws of openClients) {
+            if (ws.readyState === WebSocket.OPEN ||
+                ws.readyState === WebSocket.CONNECTING) {
+                ws.close();
+            }
+        }
+        openClients.length = 0;
+        if (server) {
+            await server.stopAsync();
+            server = undefined;
+        }
+    });
+    describe('startAsync', () => {
+        it('binds to an ephemeral port and returns the actual port', async () => {
+            server = new TransportServer();
+            const port = await server.startAsync({ port: 0 });
+            expect(port).toBeGreaterThan(0);
+            expect(server.port).toBe(port);
+            expect(server.isListening).toBe(true);
+        });
+        it('throws when trying to start while already listening', async () => {
+            server = new TransportServer();
+            await server.startAsync({ port: 0 });
+            await expect(server.startAsync({ port: 0 })).rejects.toThrow('TransportServer is already listening');
+        });
+        it('reports EADDRINUSE when port is taken', async () => {
+            server = new TransportServer();
+            const port = await server.startAsync({ port: 0 });
+            const server2 = new TransportServer();
+            await expect(server2.startAsync({ port })).rejects.toThrow(`Port ${port} is already in use`);
+        });
+    });
+    describe('onConnection', () => {
+        it('routes WebSocket connections to registered path handlers', async () => {
+            server = new TransportServer();
+            const connections = [];
+            server.onConnection('/plugin', () => {
+                connections.push('plugin');
+            });
+            server.onConnection('/client', () => {
+                connections.push('client');
+            });
+            const port = await server.startAsync({ port: 0 });
+            const ws1 = await connectWs(port, '/plugin');
+            openClients.push(ws1);
+            // Allow event loop to process
+            await new Promise((r) => setTimeout(r, 50));
+            expect(connections).toContain('plugin');
+            const ws2 = await connectWs(port, '/client');
+            openClients.push(ws2);
+            await new Promise((r) => setTimeout(r, 50));
+            expect(connections).toContain('client');
+        });
+        it('rejects WebSocket connections on unregistered paths with 404', async () => {
+            server = new TransportServer();
+            server.onConnection('/plugin', () => { });
+            const port = await server.startAsync({ port: 0 });
+            const result = await connectWsExpectReject(port, '/unknown');
+            expect(['error', 'rejected']).toContain(result);
+        });
+        it('passes the WebSocket and request to the handler', async () => {
+            server = new TransportServer();
+            let receivedWs;
+            let receivedUrl;
+            server.onConnection('/plugin', (ws, req) => {
+                receivedWs = ws;
+                receivedUrl = req.url;
+            });
+            const port = await server.startAsync({ port: 0 });
+            const ws = await connectWs(port, '/plugin');
+            openClients.push(ws);
+            await new Promise((r) => setTimeout(r, 50));
+            expect(receivedWs).toBeDefined();
+            expect(receivedUrl).toBe('/plugin');
+        });
+    });
+    describe('onHttpRequest', () => {
+        it('routes HTTP GET requests to registered path handlers', async () => {
+            server = new TransportServer();
+            server.onHttpRequest('/health', (_req, res) => {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ status: 'ok' }));
+            });
+            const port = await server.startAsync({ port: 0 });
+            const result = await httpGet(port, '/health');
+            expect(result.status).toBe(200);
+            expect(JSON.parse(result.body)).toEqual({ status: 'ok' });
+        });
+        it('returns 404 for unregistered HTTP paths', async () => {
+            server = new TransportServer();
+            const port = await server.startAsync({ port: 0 });
+            const result = await httpGet(port, '/nonexistent');
+            expect(result.status).toBe(404);
+        });
+    });
+    describe('stopAsync', () => {
+        it('closes the server and resets state', async () => {
+            server = new TransportServer();
+            await server.startAsync({ port: 0 });
+            expect(server.isListening).toBe(true);
+            await server.stopAsync();
+            expect(server.isListening).toBe(false);
+            expect(server.port).toBe(0);
+        });
+        it('is idempotent', async () => {
+            server = new TransportServer();
+            await server.startAsync({ port: 0 });
+            await server.stopAsync();
+            // Second call should not throw
+            await server.stopAsync();
+        });
+        it('terminates connected WebSocket clients', async () => {
+            server = new TransportServer();
+            server.onConnection('/plugin', () => { });
+            const port = await server.startAsync({ port: 0 });
+            const ws = await connectWs(port, '/plugin');
+            const closedPromise = new Promise((resolve) => {
+                ws.on('close', () => resolve());
+            });
+            await server.stopAsync();
+            await closedPromise;
+            // If we get here, the client was terminated
+        });
+    });
+});
+//# sourceMappingURL=transport-server.test.js.map

package/dist/src/bridge/internal/transport-server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-server.test.js","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-server.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,kBAAkB,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,kBAAkB,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,EAAE,CAAC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAChC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,IAAY;IAEZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI;aACD,GAAG,CAAC,oBAAoB,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;YAC9C,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;gBACxC,IAAI,IAAI,KAAK,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC;aACD,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,MAAmC,CAAC;IACxC,MAAM,WAAW,GAAgB,EAAE,CAAC;IAEpC,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IACE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAChC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,EACtC,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAEvB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAErC,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC1D,sCAAsC,CACvC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;YACtC,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,QAAQ,IAAI,oBAAoB,CACjC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAE/B,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE;gBAClC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE;gBAClC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7C,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,8BAA8B;YAC9B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAExC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7C,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;YAC5E,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC7D,MAAM,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAE/B,IAAI,UAAiC,CAAC;YACtC,IAAI,WAA+B,CAAC;YAEpC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;gBACzC,UAAU,GAAG,EAAE,CAAC;gBAChB,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAClD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC5C,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAErB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAE5C,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBAC5C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAE9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAErC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEtC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YAEzB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC7B,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAErC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACzB,+BAA+B;YAC/B,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAElD,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAE5C,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,aAAa,CAAC;YACpB,4CAA4C;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/bridge/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Public types for the bridge network layer. Defines session metadata,
+ * instance grouping, action result types, and typed error classes.
+ *
+ * This module has no imports from internal/ -- it is a pure type definition
+ * file that forms the public API surface of the bridge network.
+ */
+import type { StudioState, Capability, DataModelInstance, OutputLevel } from '../server/web-socket-protocol.js';
+export type { StudioState, Capability, DataModelInstance, OutputLevel };
+export type SessionContext = 'edit' | 'client' | 'server';
+export type SessionOrigin = 'user' | 'managed';
+export interface SessionInfo {
+    sessionId: string;
+    placeName: string;
+    placeFile?: string;
+    state: StudioState;
+    pluginVersion: string;
+    capabilities: Capability[];
+    connectedAt: Date;
+    origin: SessionOrigin;
+    context: SessionContext;
+    instanceId: string;
+    placeId: number;
+    gameId: number;
+}
+export interface InstanceInfo {
+    instanceId: string;
+    placeName: string;
+    placeId: number;
+    gameId: number;
+    contexts: SessionContext[];
+    origin: SessionOrigin;
+}
+export interface ExecResult {
+    success: boolean;
+    output: Array<{
+        level: OutputLevel;
+        body: string;
+    }>;
+    error?: string;
+}
+export interface StateResult {
+    state: StudioState;
+    placeId: number;
+    placeName: string;
+    gameId: number;
+}
+export interface ScreenshotResult {
+    data: string;
+    format: 'png' | 'rgba';
+    width: number;
+    height: number;
+}
+export interface LogEntry {
+    level: OutputLevel;
+    body: string;
+    timestamp: number;
+}
+export interface LogsResult {
+    entries: LogEntry[];
+    total: number;
+    bufferCapacity: number;
+}
+export interface DataModelResult {
+    instance: DataModelInstance;
+}
+export interface LogOptions {
+    count?: number;
+    direction?: 'head' | 'tail';
+    levels?: OutputLevel[];
+    includeInternal?: boolean;
+}
+export interface QueryDataModelOptions {
+    path: string;
+    depth?: number;
+    properties?: string[];
+    includeAttributes?: boolean;
+    find?: {
+        name: string;
+        recursive?: boolean;
+    };
+    listServices?: boolean;
+}
+export interface LogFollowOptions {
+    levels?: OutputLevel[];
+}
+export declare class SessionNotFoundError extends Error {
+    readonly sessionId?: string | undefined;
+    constructor(message: string, sessionId?: string | undefined);
+}
+export declare class ActionTimeoutError extends Error {
+    readonly action: string;
+    readonly timeoutMs: number;
+    readonly sessionId: string;
+    constructor(action: string, timeoutMs: number, sessionId: string);
+}
+export declare class SessionDisconnectedError extends Error {
+    readonly sessionId: string;
+    constructor(sessionId: string);
+}
+export declare class CapabilityNotSupportedError extends Error {
+    readonly capability: string;
+    readonly sessionId: string;
+    constructor(capability: string, sessionId: string);
+}
+export declare class ContextNotFoundError extends Error {
+    readonly context: SessionContext;
+    readonly instanceId: string;
+    readonly availableContexts: SessionContext[];
+    constructor(context: SessionContext, instanceId: string, availableContexts: SessionContext[]);
+}
+export declare class HostUnreachableError extends Error {
+    readonly host: string;
+    readonly port: number;
+    constructor(host: string, port: number);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/bridge/types.d.ts.map

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

package/dist/src/bridge/types.js

@@ -0,0 +1,68 @@
+/**
+ * Public types for the bridge network layer. Defines session metadata,
+ * instance grouping, action result types, and typed error classes.
+ *
+ * This module has no imports from internal/ -- it is a pure type definition
+ * file that forms the public API surface of the bridge network.
+ */
+export class SessionNotFoundError extends Error {
+    sessionId;
+    constructor(message, sessionId) {
+        super(message);
+        this.sessionId = sessionId;
+        this.name = 'SessionNotFoundError';
+    }
+}
+export class ActionTimeoutError extends Error {
+    action;
+    timeoutMs;
+    sessionId;
+    constructor(action, timeoutMs, sessionId) {
+        super(`Action '${action}' timed out after ${timeoutMs}ms on session '${sessionId}'`);
+        this.action = action;
+        this.timeoutMs = timeoutMs;
+        this.sessionId = sessionId;
+        this.name = 'ActionTimeoutError';
+    }
+}
+export class SessionDisconnectedError extends Error {
+    sessionId;
+    constructor(sessionId) {
+        super(`Session '${sessionId}' disconnected`);
+        this.sessionId = sessionId;
+        this.name = 'SessionDisconnectedError';
+    }
+}
+export class CapabilityNotSupportedError extends Error {
+    capability;
+    sessionId;
+    constructor(capability, sessionId) {
+        super(`Plugin does not support capability '${capability}' on session '${sessionId}'`);
+        this.capability = capability;
+        this.sessionId = sessionId;
+        this.name = 'CapabilityNotSupportedError';
+    }
+}
+export class ContextNotFoundError extends Error {
+    context;
+    instanceId;
+    availableContexts;
+    constructor(context, instanceId, availableContexts) {
+        super(`Context '${context}' not connected on instance '${instanceId}'. Available: ${availableContexts.join(', ')}`);
+        this.context = context;
+        this.instanceId = instanceId;
+        this.availableContexts = availableContexts;
+        this.name = 'ContextNotFoundError';
+    }
+}
+export class HostUnreachableError extends Error {
+    host;
+    port;
+    constructor(host, port) {
+        super(`Bridge host unreachable at ${host}:${port}`);
+        this.host = host;
+        this.port = port;
+        this.name = 'HostUnreachableError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+FH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACA;IAA7C,YAAY,OAAe,EAAkB,SAAkB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,cAAS,GAAT,SAAS,CAAS;QAE7D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IACA;IACA;IAHlB,YACkB,MAAc,EACd,SAAiB,EACjB,SAAiB;QAEjC,KAAK,CACH,WAAW,MAAM,qBAAqB,SAAS,kBAAkB,SAAS,GAAG,CAC9E,CAAC;QANc,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAQ;QAKjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACrB;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CAAC,YAAY,SAAS,gBAAgB,CAAC,CAAC;QADnB,cAAS,GAAT,SAAS,CAAQ;QAE3C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAElC;IACA;IAFlB,YACkB,UAAkB,EAClB,SAAiB;QAEjC,KAAK,CACH,uCAAuC,UAAU,iBAAiB,SAAS,GAAG,CAC/E,CAAC;QALc,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAQ;QAKjC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IACA;IACA;IAHlB,YACkB,OAAuB,EACvB,UAAkB,EAClB,iBAAmC;QAEnD,KAAK,CACH,YAAY,OAAO,gCAAgC,UAAU,iBAAiB,iBAAiB,CAAC,IAAI,CAClG,IAAI,CACL,EAAE,CACJ,CAAC;QARc,YAAO,GAAP,OAAO,CAAgB;QACvB,eAAU,GAAV,UAAU,CAAQ;QAClB,sBAAiB,GAAjB,iBAAiB,CAAkB;QAOnD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACjB;IAA8B;IAA1D,YAA4B,IAAY,EAAkB,IAAY;QACpE,KAAK,CAAC,8BAA8B,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAD1B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAQ;QAEpE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/src/cli/adapters/cli-command-adapter-handler.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handler-level tests for the CLI command adapter — format flags,
+ * output file writing, and watch mode.
+ */
+export {};
+//# sourceMappingURL=cli-command-adapter-handler.test.d.ts.map

package/dist/src/cli/adapters/cli-command-adapter-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-adapter-handler.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/adapters/cli-command-adapter-handler.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/cli/adapters/cli-command-adapter-handler.test.js

@@ -0,0 +1,260 @@
+/**
+ * Handler-level tests for the CLI command adapter — format flags,
+ * output file writing, and watch mode.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { buildYargsCommand } from './cli-command-adapter.js';
+import { defineCommand } from '../../commands/framework/define-command.js';
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        writeFileSync: vi.fn(),
+    };
+});
+import * as fs from 'fs';
+function createMockSession() {
+    return { sessionId: 'mock-session' };
+}
+function createMockConnection() {
+    const session = createMockSession();
+    return {
+        connection: {
+            resolveSessionAsync: vi.fn().mockResolvedValue(session),
+            disconnectAsync: vi.fn().mockResolvedValue(undefined),
+            listSessions: vi.fn().mockReturnValue([]),
+        },
+        session,
+    };
+}
+function createMockLifecycle() {
+    const mock = createMockConnection();
+    return {
+        mock,
+        connectAsync: vi.fn().mockResolvedValue(mock.connection),
+    };
+}
+/** Capture console.log output during handler execution. */
+async function captureOutput(fn) {
+    const logs = [];
+    const origLog = console.log;
+    console.log = (...args) => {
+        logs.push(args.map(String).join(' '));
+    };
+    try {
+        await fn();
+    }
+    finally {
+        console.log = origLog;
+    }
+    return logs;
+}
+function readCommand(overrides = {}) {
+    return defineCommand({
+        group: 'test',
+        name: 'read',
+        description: 'Test read command',
+        category: 'execution',
+        safety: 'read',
+        scope: overrides.scope ?? 'session',
+        args: {},
+        handler: overrides.handler ??
+            (async () => ({
+                items: ['a', 'b'],
+                summary: 'Found 2 items',
+            })),
+        cli: overrides.cli,
+    });
+}
+let exitSpy;
+beforeEach(() => {
+    exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => {
+        throw new Error('process.exit called');
+    });
+    vi.mocked(fs.writeFileSync).mockReset();
+});
+afterEach(() => {
+    exitSpy.mockRestore();
+});
+describe('handler — format flags', () => {
+    it('outputs JSON when --format json is specified', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand();
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const output = await captureOutput(async () => {
+            await module.handler({ format: 'json' });
+        });
+        expect(output.length).toBe(1);
+        const parsed = JSON.parse(output[0]);
+        expect(parsed.items).toEqual(['a', 'b']);
+        expect(parsed.summary).toBe('Found 2 items');
+    });
+    it('outputs summary text when --format text and no cli.formatResult', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand();
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const output = await captureOutput(async () => {
+            await module.handler({ format: 'text' });
+        });
+        expect(output[0]).toBe('Found 2 items');
+    });
+    it('uses cli.format when --format text', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand({
+            cli: {
+                format: (result) => `Custom: ${result.items.join(', ')}`,
+            },
+        });
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const output = await captureOutput(async () => {
+            await module.handler({ format: 'text' });
+        });
+        expect(output[0]).toBe('Custom: a, b');
+    });
+    it('falls back to JSON when --format text and no formatter or summary', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand({
+            handler: async () => ({ data: [1, 2, 3] }),
+        });
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const output = await captureOutput(async () => {
+            await module.handler({ format: 'text' });
+        });
+        expect(JSON.parse(output[0])).toEqual({ data: [1, 2, 3] });
+    });
+    it('defaults to JSON when no format specified and no formatter (non-TTY)', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand();
+        const module = buildYargsCommand(cmd, { lifecycle });
+        // No --format specified, non-TTY resolves to 'text' mode which falls
+        // back to summary
+        const output = await captureOutput(async () => {
+            await module.handler({});
+        });
+        // Should output the summary (in non-TTY mode resolves to 'text')
+        expect(output.length).toBe(1);
+        expect(output[0]).toBe('Found 2 items');
+    });
+});
+describe('handler — output file writing', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('writes JSON to file when --output and --format json', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand();
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        await captureOutput(async () => {
+            await module.handler({
+                format: 'json',
+                output: '/tmp/test.json',
+            });
+        });
+        expect(fs.writeFileSync).toHaveBeenCalledOnce();
+        const call = vi.mocked(fs.writeFileSync).mock.calls[0];
+        expect(call[0]).toBe('/tmp/test.json');
+        const written = call[1];
+        expect(JSON.parse(written)).toEqual({
+            items: ['a', 'b'],
+            summary: 'Found 2 items',
+        });
+        expect(stderrSpy).toHaveBeenCalledWith('Wrote output to /tmp/test.json\n');
+        stderrSpy.mockRestore();
+    });
+    it('writes binary when --output and binaryField is set', async () => {
+        const lifecycle = createMockLifecycle();
+        const base64Data = Buffer.from('PNG-DATA').toString('base64');
+        const cmd = readCommand({
+            handler: async () => ({
+                data: base64Data,
+                summary: 'Screenshot taken',
+            }),
+            cli: {
+                binaryField: 'data',
+                format: (result) => result.summary,
+            },
+        });
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        await captureOutput(async () => {
+            await module.handler({
+                output: '/tmp/test.png',
+                format: 'text',
+            });
+        });
+        expect(fs.writeFileSync).toHaveBeenCalledOnce();
+        const call = vi.mocked(fs.writeFileSync).mock.calls[0];
+        expect(call[0]).toBe('/tmp/test.png');
+        // Should be a Buffer (binary write)
+        expect(Buffer.isBuffer(call[1])).toBe(true);
+        expect(call[1].toString()).toBe('PNG-DATA');
+        expect(stderrSpy).toHaveBeenCalledWith('Wrote binary output to /tmp/test.png\n');
+        stderrSpy.mockRestore();
+    });
+    it('writes JSON (not binary) when --output --format json even with binaryField', async () => {
+        const lifecycle = createMockLifecycle();
+        const base64Data = Buffer.from('PNG-DATA').toString('base64');
+        const cmd = readCommand({
+            handler: async () => ({
+                data: base64Data,
+                summary: 'Screenshot taken',
+            }),
+            cli: {
+                binaryField: 'data',
+                json: (result) => JSON.stringify({ summary: result.summary }),
+            },
+        });
+        const module = buildYargsCommand(cmd, { lifecycle });
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        await captureOutput(async () => {
+            await module.handler({
+                output: '/tmp/test.json',
+                format: 'json',
+            });
+        });
+        expect(fs.writeFileSync).toHaveBeenCalledOnce();
+        const call = vi.mocked(fs.writeFileSync).mock.calls[0];
+        const written = call[1];
+        // Should be the JSON formatter output, not binary
+        expect(JSON.parse(written)).toEqual({ summary: 'Screenshot taken' });
+        vi.restoreAllMocks();
+    });
+});
+describe('handler — standalone scope', () => {
+    it('does not connect for standalone commands', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = defineCommand({
+            group: null,
+            name: 'standalone',
+            description: 'Standalone test',
+            category: 'infrastructure',
+            safety: 'none',
+            scope: 'standalone',
+            args: {},
+            handler: async () => ({ ok: true, summary: 'done' }),
+        });
+        const module = buildYargsCommand(cmd, { lifecycle });
+        const output = await captureOutput(async () => {
+            await module.handler({ format: 'text' });
+        });
+        expect(lifecycle.connectAsync).not.toHaveBeenCalled();
+        expect(output[0]).toBe('done');
+    });
+});
+describe('handler — connection lifecycle', () => {
+    it('disconnects after handler completes', async () => {
+        const lifecycle = createMockLifecycle();
+        const cmd = readCommand();
+        const module = buildYargsCommand(cmd, { lifecycle });
+        await captureOutput(async () => {
+            await module.handler({ format: 'json' });
+        });
+        expect(lifecycle.mock.connection.disconnectAsync).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=cli-command-adapter-handler.test.js.map