@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/commands/process/list/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/list/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAezB;AAiBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGlE;AAED,eAAO,MAAM,WAAW,wFAYtB,CAAC"}

package/dist/src/commands/process/list/list.js

@@ -0,0 +1,56 @@
+/**
+ * `process list` — list connected Studio sessions.
+ */
+import { defineCommand } from '../../framework/define-command.js';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { formatTable, } from '@quenty/cli-output-helpers/reporting';
+import { colorizeState } from '../format-state.js';
+/**
+ * List all connected Studio sessions with a summary message.
+ */
+export async function listSessionsHandlerAsync(connection) {
+    const sessions = connection.listSessions();
+    if (sessions.length === 0) {
+        return {
+            sessions: [],
+            summary: 'No active sessions. Is Studio running with the studio-bridge plugin?',
+        };
+    }
+    return {
+        sessions,
+        summary: `${sessions.length} session(s) connected.`,
+    };
+}
+const sessionColumns = [
+    {
+        header: 'Session',
+        value: (s) => s.sessionId.slice(0, 8),
+        format: (v) => OutputHelper.formatHint(v),
+    },
+    { header: 'Context', value: (s) => s.context },
+    { header: 'Place', value: (s) => s.placeName },
+    {
+        header: 'State',
+        value: (s) => s.state,
+        format: (v) => colorizeState(v),
+    },
+];
+export function formatSessionsTable(result) {
+    if (result.sessions.length === 0)
+        return result.summary;
+    return formatTable(result.sessions, sessionColumns);
+}
+export const listCommand = defineCommand({
+    group: 'process',
+    name: 'list',
+    description: 'List connected Studio sessions',
+    category: 'infrastructure',
+    safety: 'read',
+    scope: 'connection',
+    args: {},
+    cli: {
+        format: formatSessionsTable,
+    },
+    handler: async (connection) => listSessionsHandlerAsync(connection),
+});
+//# sourceMappingURL=list.js.map

package/dist/src/commands/process/list/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/process/list/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,WAAW,GAEZ,MAAM,sCAAsC,CAAC;AAI9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOnD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAA4B;IAE5B,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;IAE3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,OAAO,EACL,sEAAsE;SACzE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,wBAAwB;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,cAAc,GAA+B;IACjD;QACE,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;KAC1C;IACD,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;IAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE;IAC9C;QACE,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;QACrB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAgB,CAAC;KAC/C;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACxD,OAAO,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,EAAE;IACR,GAAG,EAAE;QACH,MAAM,EAAE,mBAAmB;KAC5B;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,wBAAwB,CAAC,UAAU,CAAC;CACpE,CAAC,CAAC"}

package/dist/src/commands/process/list/list.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the list (sessions) command handler.
+ */
+export {};
+//# sourceMappingURL=list.test.d.ts.map

package/dist/src/commands/process/list/list.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/list/list.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/process/list/list.test.js

@@ -0,0 +1,71 @@
+/**
+ * Unit tests for the list (sessions) command handler.
+ */
+import { describe, it, expect } from 'vitest';
+import { listSessionsHandlerAsync } from './list.js';
+function createSessionInfo(overrides = {}) {
+    return {
+        sessionId: 'session-1',
+        placeName: 'TestPlace',
+        state: 'Edit',
+        pluginVersion: '1.0.0',
+        capabilities: ['execute', 'queryState'],
+        connectedAt: new Date(),
+        origin: 'user',
+        context: 'edit',
+        instanceId: 'inst-1',
+        placeId: 123,
+        gameId: 456,
+        ...overrides,
+    };
+}
+function createMockConnection(sessions) {
+    return {
+        listSessions: () => sessions,
+        getSession: (id) => sessions.find((s) => s.sessionId === id),
+    };
+}
+describe('listSessionsHandlerAsync', () => {
+    it('returns empty sessions with helpful message', async () => {
+        const conn = createMockConnection([]);
+        const result = await listSessionsHandlerAsync(conn);
+        expect(result.sessions).toEqual([]);
+        expect(result.summary).toContain('No active sessions');
+        expect(result.summary).toContain('studio-bridge plugin');
+    });
+    it('returns sessions with count summary', async () => {
+        const sessions = [
+            createSessionInfo({ sessionId: 's1' }),
+            createSessionInfo({ sessionId: 's2' }),
+        ];
+        const conn = createMockConnection(sessions);
+        const result = await listSessionsHandlerAsync(conn);
+        expect(result.sessions).toHaveLength(2);
+        expect(result.summary).toBe('2 session(s) connected.');
+    });
+    it('returns single session with correct summary', async () => {
+        const sessions = [createSessionInfo({ sessionId: 'only-one' })];
+        const conn = createMockConnection(sessions);
+        const result = await listSessionsHandlerAsync(conn);
+        expect(result.sessions).toHaveLength(1);
+        expect(result.summary).toBe('1 session(s) connected.');
+    });
+    it('sessions data includes expected fields', async () => {
+        const session = createSessionInfo({
+            sessionId: 'test-id',
+            placeName: 'MyPlace',
+            context: 'server',
+            state: 'Play',
+            origin: 'managed',
+        });
+        const conn = createMockConnection([session]);
+        const result = await listSessionsHandlerAsync(conn);
+        const s = result.sessions[0];
+        expect(s.sessionId).toBe('test-id');
+        expect(s.placeName).toBe('MyPlace');
+        expect(s.context).toBe('server');
+        expect(s.state).toBe('Play');
+        expect(s.origin).toBe('managed');
+    });
+});
+//# sourceMappingURL=list.test.js.map

package/dist/src/commands/process/list/list.test.js.map

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

package/dist/src/commands/process/run/run.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `process run` -- explicit ephemeral mode: launch Studio, execute code,
+ * then tear down. Wraps the StudioBridgeServer lifecycle with full
+ * reporter output.
+ *
+ * This is standalone (no existing connection needed) and is CLI-only.
+ * MCP does NOT expose this command.
+ */
+export interface ProcessRunOptions {
+    scriptContent: string;
+    packageName: string;
+    placePath?: string;
+    timeoutMs: number;
+    verbose: boolean;
+    showLogs: boolean;
+    filePath?: string;
+}
+export interface ProcessRunResult {
+    success: boolean;
+    summary: string;
+}
+interface ProcessRunArgs {
+    code?: string;
+    file?: string;
+    place?: string;
+    timeout?: number;
+}
+export declare function processRunHandlerAsync(options: ProcessRunOptions): Promise<ProcessRunResult>;
+export declare const processRunCommand: import("../../framework/define-command.js").CommandDefinition<ProcessRunArgs, ProcessRunResult>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/src/commands/process/run/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/run/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAED,eAAO,MAAM,iBAAiB,iGA2C5B,CAAC"}

package/dist/src/commands/process/run/run.js

@@ -0,0 +1,63 @@
+/**
+ * `process run` -- explicit ephemeral mode: launch Studio, execute code,
+ * then tear down. Wraps the StudioBridgeServer lifecycle with full
+ * reporter output.
+ *
+ * This is standalone (no existing connection needed) and is CLI-only.
+ * MCP does NOT expose this command.
+ */
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+import { resolveScriptContentAsync } from '../../../cli/resolve-script-content.js';
+export async function processRunHandlerAsync(options) {
+    // Lazy import to avoid pulling in StudioBridgeServer at module load
+    const { executeScriptAsync } = await import('../../../cli/script-executor.js');
+    // executeScriptAsync calls process.exit internally, so this return
+    // is only reachable in test scenarios where it's mocked.
+    await executeScriptAsync(options);
+    return {
+        success: true,
+        summary: 'Script execution completed.',
+    };
+}
+export const processRunCommand = defineCommand({
+    group: 'process',
+    name: 'run',
+    description: 'Launch Studio, execute a script, and shut down (ephemeral mode)',
+    category: 'execution',
+    safety: 'none',
+    scope: 'standalone',
+    args: {
+        code: arg.positional({
+            description: 'Inline Luau code to execute',
+            required: false,
+        }),
+        file: arg.option({
+            description: 'Path to a Luau script file to execute',
+            alias: 'f',
+        }),
+        place: arg.option({
+            description: 'Path to a .rbxl place file',
+            alias: 'p',
+        }),
+        timeout: arg.option({
+            description: 'Execution timeout in milliseconds',
+            type: 'number',
+        }),
+    },
+    handler: async (args) => {
+        const { scriptContent, filePath } = await resolveScriptContentAsync(args);
+        return processRunHandlerAsync({
+            scriptContent,
+            packageName: 'studio-bridge',
+            placePath: args.place,
+            timeoutMs: args.timeout ?? 120_000,
+            verbose: OutputHelper.isVerbose(),
+            showLogs: true,
+            filePath,
+        });
+    },
+    // No MCP config -- process run is CLI-only
+});
+//# sourceMappingURL=run.js.map

package/dist/src/commands/process/run/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../../src/commands/process/run/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAwBnF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA0B;IAE1B,oEAAoE;IACpE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CACzC,iCAAiC,CAClC,CAAC;IAEF,mEAAmE;IACnE,yDAAyD;IACzD,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,6BAA6B;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAG5C;IACA,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,KAAK;IACX,WAAW,EACT,iEAAiE;IACnE,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE;QACJ,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;YACnB,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,uCAAuC;YACpD,KAAK,EAAE,GAAG;SACX,CAAC;QACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,4BAA4B;YACzC,KAAK,EAAE,GAAG;SACX,CAAC;QACF,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,mCAAmC;YAChD,IAAI,EAAE,QAAQ;SACf,CAAC;KACH;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAE1E,OAAO,sBAAsB,CAAC;YAC5B,aAAa;YACb,WAAW,EAAE,eAAe;YAC5B,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,SAAS,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;YAClC,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE;YACjC,QAAQ,EAAE,IAAI;YACd,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,2CAA2C;CAC5C,CAAC,CAAC"}

package/dist/src/commands/rgba-to-png.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal PNG encoder that converts raw RGBA pixel data into a valid PNG file.
+ *
+ * Uses only Node.js built-ins (zlib, Buffer). Produces unfiltered scanlines
+ * (filter byte 0 per row) compressed with deflate — not optimal file size,
+ * but correct and dependency-free.
+ */
+/**
+ * Convert raw RGBA pixel data to a PNG file buffer.
+ *
+ * @param rgba - Raw RGBA bytes (4 bytes per pixel, row-major, top-to-bottom)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns A Buffer containing a valid PNG file
+ */
+export declare function rgbaToPng(rgba: Buffer, width: number, height: number): Buffer;
+//# sourceMappingURL=rgba-to-png.d.ts.map

package/dist/src/commands/rgba-to-png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba-to-png.d.ts","sourceRoot":"","sources":["../../../src/commands/rgba-to-png.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsC7E"}

package/dist/src/commands/rgba-to-png.js

@@ -0,0 +1,85 @@
+/**
+ * Minimal PNG encoder that converts raw RGBA pixel data into a valid PNG file.
+ *
+ * Uses only Node.js built-ins (zlib, Buffer). Produces unfiltered scanlines
+ * (filter byte 0 per row) compressed with deflate — not optimal file size,
+ * but correct and dependency-free.
+ */
+import { deflateSync } from 'zlib';
+// PNG uses network byte order (big-endian)
+function writeU32BE(buf, offset, value) {
+    buf[offset] = (value >>> 24) & 0xff;
+    buf[offset + 1] = (value >>> 16) & 0xff;
+    buf[offset + 2] = (value >>> 8) & 0xff;
+    buf[offset + 3] = value & 0xff;
+}
+// CRC-32 lookup table (ISO 3309 / ITU-T V.42 polynomial)
+const CRC_TABLE = new Uint32Array(256);
+for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+    }
+    CRC_TABLE[n] = c >>> 0;
+}
+function crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = CRC_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Build a PNG chunk: length(4) + type(4) + data + crc32(4). */
+function makeChunk(type, data) {
+    const typeBytes = Buffer.from(type, 'ascii');
+    const chunk = Buffer.alloc(4 + 4 + data.length + 4);
+    writeU32BE(chunk, 0, data.length);
+    typeBytes.copy(chunk, 4);
+    data.copy(chunk, 8);
+    // CRC covers type + data
+    const crcInput = Buffer.alloc(4 + data.length);
+    typeBytes.copy(crcInput, 0);
+    data.copy(crcInput, 4);
+    writeU32BE(chunk, 8 + data.length, crc32(crcInput));
+    return chunk;
+}
+/**
+ * Convert raw RGBA pixel data to a PNG file buffer.
+ *
+ * @param rgba - Raw RGBA bytes (4 bytes per pixel, row-major, top-to-bottom)
+ * @param width - Image width in pixels
+ * @param height - Image height in pixels
+ * @returns A Buffer containing a valid PNG file
+ */
+export function rgbaToPng(rgba, width, height) {
+    const expectedBytes = width * height * 4;
+    if (rgba.length !== expectedBytes) {
+        throw new Error(`RGBA data length mismatch: expected ${expectedBytes} bytes (${width}x${height}x4), got ${rgba.length}`);
+    }
+    // PNG signature
+    const signature = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+    // IHDR: width(4) + height(4) + bitDepth(1) + colorType(1) + compression(1) + filter(1) + interlace(1)
+    const ihdrData = Buffer.alloc(13);
+    writeU32BE(ihdrData, 0, width);
+    writeU32BE(ihdrData, 4, height);
+    ihdrData[8] = 8; // 8 bits per channel
+    ihdrData[9] = 6; // RGBA color type
+    ihdrData[10] = 0; // deflate compression
+    ihdrData[11] = 0; // adaptive filtering
+    ihdrData[12] = 0; // no interlace
+    const ihdr = makeChunk('IHDR', ihdrData);
+    // Build raw scanlines: each row gets a filter byte (0 = None) prefix
+    const rowBytes = width * 4;
+    const rawData = Buffer.alloc(height * (1 + rowBytes));
+    for (let y = 0; y < height; y++) {
+        const outOffset = y * (1 + rowBytes);
+        rawData[outOffset] = 0; // filter: None
+        rgba.copy(rawData, outOffset + 1, y * rowBytes, (y + 1) * rowBytes);
+    }
+    const compressed = deflateSync(rawData);
+    const idat = makeChunk('IDAT', compressed);
+    // IEND: empty chunk
+    const iend = makeChunk('IEND', Buffer.alloc(0));
+    return Buffer.concat([signature, ihdr, idat, iend]);
+}
+//# sourceMappingURL=rgba-to-png.js.map

package/dist/src/commands/rgba-to-png.js.map

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

package/dist/src/commands/serve/serve.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `serve` — start a dedicated bridge host process that stays alive,
+ * accepting plugin and client connections.
+ */
+export interface ServeOptions {
+    port?: number;
+    json?: boolean;
+    timeout?: number;
+}
+export interface ServeResult {
+    port: number;
+    event: string;
+}
+/** Blocks until shutdown signal or timeout. */
+export declare function serveHandlerAsync(options?: ServeOptions): Promise<ServeResult>;
+export declare const serveCommand: import("../framework/define-command.js").CommandDefinition<ServeOptions, ServeResult>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/src/commands/serve/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../src/commands/serve/serve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+CAA+C;AAC/C,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAmHtB;AAED,eAAO,MAAM,YAAY,uFAmBvB,CAAC"}

package/dist/src/commands/serve/serve.js

@@ -0,0 +1,128 @@
+/**
+ * `serve` — start a dedicated bridge host process that stays alive,
+ * accepting plugin and client connections.
+ */
+import { defineCommand } from '../framework/define-command.js';
+import { arg } from '../framework/arg-builder.js';
+import { BridgeConnection } from '../../bridge/index.js';
+/** Blocks until shutdown signal or timeout. */
+export async function serveHandlerAsync(options = {}) {
+    const port = options.port ?? 38741;
+    let connection;
+    try {
+        connection = await BridgeConnection.connectAsync({
+            port,
+            keepAlive: true,
+        });
+    }
+    catch (err) {
+        if (err instanceof Error &&
+            'code' in err &&
+            err.code === 'EADDRINUSE') {
+            throw new Error(`Port ${port} is already in use. A bridge host is already running. ` +
+                `Connect as a client with any studio-bridge command, or use --port to start on a different port.`);
+        }
+        throw err;
+    }
+    // Log startup
+    if (options.json) {
+        console.log(JSON.stringify({
+            event: 'started',
+            port: connection.port,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    else {
+        console.log(`Bridge host listening on port ${connection.port}`);
+    }
+    // Set up event listeners for session changes
+    connection.on('session-connected', (session) => {
+        if (options.json) {
+            console.log(JSON.stringify({
+                event: 'pluginConnected',
+                sessionId: session.info.sessionId,
+                context: session.info.context,
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            console.log(`Plugin connected: ${session.info.sessionId} (${session.info.context})`);
+        }
+    });
+    connection.on('session-disconnected', (sessionId) => {
+        if (options.json) {
+            console.log(JSON.stringify({
+                event: 'pluginDisconnected',
+                sessionId,
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            console.log(`Plugin disconnected: ${sessionId}`);
+        }
+    });
+    // Set up signal handlers
+    const shutdownAsync = async () => {
+        if (options.json) {
+            console.log(JSON.stringify({
+                event: 'shuttingDown',
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            console.log('Shutting down...');
+        }
+        await connection.disconnectAsync();
+        if (options.json) {
+            console.log(JSON.stringify({
+                event: 'stopped',
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            console.log('Bridge host stopped.');
+        }
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => void shutdownAsync());
+    process.on('SIGINT', () => void shutdownAsync());
+    process.on('SIGHUP', () => {
+        /* ignore -- survive terminal close */
+    });
+    // Block until shutdown
+    if (options.timeout) {
+        // With timeout: auto-shutdown after idle period
+        await new Promise((resolve) => {
+            setTimeout(resolve, options.timeout);
+        });
+        await connection.disconnectAsync();
+    }
+    else {
+        // No timeout: block forever
+        await new Promise(() => {
+            // Never resolves -- process runs until signal
+        });
+    }
+    return { port: connection.port, event: 'stopped' };
+}
+export const serveCommand = defineCommand({
+    group: null,
+    name: 'serve',
+    description: 'Start the bridge server',
+    category: 'infrastructure',
+    safety: 'none',
+    scope: 'standalone',
+    args: {
+        port: arg.option({
+            description: 'Port to listen on (default: 38741)',
+            type: 'number',
+        }),
+        json: arg.flag({ description: 'Output events as JSON lines' }),
+        timeout: arg.option({
+            description: 'Auto-shutdown after N milliseconds',
+            type: 'number',
+        }),
+    },
+    handler: async (args) => serveHandlerAsync(args),
+});
+//# sourceMappingURL=serve.js.map

package/dist/src/commands/serve/serve.js.map

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

package/dist/src/commands/serve/serve.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the serve command handler.
+ */
+export {};
+//# sourceMappingURL=serve.test.d.ts.map

package/dist/src/commands/serve/serve.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/serve/serve.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/serve/serve.test.js

@@ -0,0 +1,100 @@
+/**
+ * Unit tests for the serve command handler.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { EventEmitter } from 'events';
+// Mock BridgeConnection before importing serve handler
+vi.mock('../../bridge/index.js', () => {
+    return {
+        BridgeConnection: {
+            connectAsync: vi.fn(),
+        },
+    };
+});
+import { BridgeConnection } from '../../bridge/index.js';
+import { serveHandlerAsync } from './serve.js';
+function createMockConnection(port) {
+    const emitter = new EventEmitter();
+    return Object.assign(emitter, {
+        disconnectAsync: vi.fn().mockResolvedValue(undefined),
+        port,
+    });
+}
+describe('serveHandlerAsync', () => {
+    let mockConnection;
+    const connectAsyncMock = BridgeConnection.connectAsync;
+    beforeEach(() => {
+        mockConnection = createMockConnection(38741);
+        connectAsyncMock.mockResolvedValue(mockConnection);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('calls connectAsync with keepAlive true and correct port', async () => {
+        const promise = serveHandlerAsync({ port: 38741, timeout: 10 });
+        await promise;
+        expect(connectAsyncMock).toHaveBeenCalledWith({
+            port: 38741,
+            keepAlive: true,
+        });
+    });
+    it('uses default port 38741 when none specified', async () => {
+        const promise = serveHandlerAsync({ timeout: 10 });
+        await promise;
+        expect(connectAsyncMock).toHaveBeenCalledWith({
+            port: 38741,
+            keepAlive: true,
+        });
+    });
+    it('passes custom port through', async () => {
+        mockConnection = createMockConnection(9999);
+        connectAsyncMock.mockResolvedValue(mockConnection);
+        const promise = serveHandlerAsync({ port: 9999, timeout: 10 });
+        await promise;
+        expect(connectAsyncMock).toHaveBeenCalledWith({
+            port: 9999,
+            keepAlive: true,
+        });
+    });
+    it('throws clear error on EADDRINUSE', async () => {
+        const err = new Error('listen EADDRINUSE: address already in use');
+        err.code = 'EADDRINUSE';
+        connectAsyncMock.mockRejectedValue(err);
+        await expect(serveHandlerAsync({ port: 38741 })).rejects.toThrow('Port 38741 is already in use');
+    });
+    it('re-throws non-EADDRINUSE errors', async () => {
+        connectAsyncMock.mockRejectedValue(new Error('some other error'));
+        await expect(serveHandlerAsync({ port: 38741 })).rejects.toThrow('some other error');
+    });
+    it('disconnects after timeout expires', async () => {
+        const result = await serveHandlerAsync({ timeout: 10 });
+        expect(mockConnection.disconnectAsync).toHaveBeenCalled();
+        expect(result).toEqual({ port: 38741, event: 'stopped' });
+    });
+    it('logs JSON startup when json option is set', async () => {
+        const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await serveHandlerAsync({ json: true, timeout: 10 });
+        const startedCall = consoleSpy.mock.calls.find((call) => {
+            try {
+                const parsed = JSON.parse(call[0]);
+                return parsed.event === 'started';
+            }
+            catch {
+                return false;
+            }
+        });
+        expect(startedCall).toBeDefined();
+        const parsed = JSON.parse(startedCall[0]);
+        expect(parsed.event).toBe('started');
+        expect(parsed.port).toBe(38741);
+        consoleSpy.mockRestore();
+    });
+    it('logs human-readable startup when json option is not set', async () => {
+        const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await serveHandlerAsync({ timeout: 10 });
+        const startedCall = consoleSpy.mock.calls.find((call) => call[0].includes('Bridge host listening'));
+        expect(startedCall).toBeDefined();
+        consoleSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=serve.test.js.map