@quenty/studio-bridge 0.21.0 → 0.22.0

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

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

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

@@ -1,17 +1,27 @@
 /**
- * `process launch` — launch Roblox Studio, optionally with a place file.
+ * `process launch` — launch Roblox Studio, optionally with a place file, a
+ * cloud place, or a target from the nearest `deploy.nevermore.json`.
  */
 export interface LaunchOptions {
     placePath?: string;
     placeId?: number;
     universeId?: number;
+    /** A `deploy.nevermore.json` target, e.g. `test` or `integration.places.hub`. */
+    deployTarget?: string;
+    /** Where to start looking for `deploy.nevermore.json`. Default: the current directory. */
+    cwd?: string;
 }
 export interface LaunchResult {
     launched: boolean;
+    /** The `deploy.nevermore.json` target that was opened, if any. */
+    deployTarget?: string;
+    placeId?: number;
+    universeId?: number;
     summary: string;
 }
 export declare function launchHandlerAsync(options?: LaunchOptions): Promise<LaunchResult>;
 interface LaunchArgs {
+    deployTarget?: string;
     place?: string;
     placeId?: number;
     universeId?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/launch/launch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,yFA0BxB,CAAC"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/launch/launch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAkDvB;AAED,UAAU,UAAU;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,yFAiCxB,CAAC"}

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

@@ -1,27 +1,56 @@
 /**
- * `process launch` — launch Roblox Studio, optionally with a place file.
+ * `process launch` — launch Roblox Studio, optionally with a place file, a
+ * cloud place, or a target from the nearest `deploy.nevermore.json`.
  */
+import * as path from 'path';
 import { defineCommand } from '../../framework/define-command.js';
 import { arg } from '../../framework/arg-builder.js';
 import { launchStudioAsync } from '../../../process/studio-process-manager.js';
+import { DEPLOY_CONFIG_FILE_NAME, resolveDeployPlaceAsync, } from '../../../deploy/deploy-places.js';
 export async function launchHandlerAsync(options = {}) {
-    await launchStudioAsync(options);
-    const target = options.placeId != null
-        ? `place ${options.placeId}${options.universeId != null ? ` (universe ${options.universeId})` : ''}`
-        : options.placePath;
+    const hasExplicitPlace = options.placePath !== undefined || options.placeId !== undefined;
+    if (hasExplicitPlace && options.deployTarget !== undefined) {
+        throw new Error(`Pass a deploy target or --place / --place-id, not both (got '${options.deployTarget}')`);
+    }
+    const deployPlace = hasExplicitPlace
+        ? undefined
+        : await resolveDeployPlaceAsync(options.cwd ?? process.cwd(), options.deployTarget);
+    if (deployPlace) {
+        const { placeId, universeId } = deployPlace.place;
+        await launchStudioAsync({ placeId, universeId });
+        const configDir = path.relative(options.cwd ?? process.cwd(), path.dirname(deployPlace.configPath));
+        return {
+            launched: true,
+            deployTarget: deployPlace.selector,
+            placeId,
+            universeId,
+            summary: `Studio launched with '${deployPlace.selector}' (place ${placeId}, universe ${universeId}) from ${path.join(configDir, DEPLOY_CONFIG_FILE_NAME)}`,
+        };
+    }
+    const { placePath, placeId, universeId } = options;
+    await launchStudioAsync({ placePath, placeId, universeId });
+    const opened = placeId != null
+        ? `place ${placeId}${universeId != null ? ` (universe ${universeId})` : ''}`
+        : placePath;
     return {
         launched: true,
-        summary: `Studio launched${target ? ` with ${target}` : ''}`,
+        placeId,
+        universeId,
+        summary: `Studio launched${opened ? ` with ${opened}` : ''}`,
     };
 }
 export const launchCommand = defineCommand({
     group: 'process',
     name: 'launch',
-    description: 'Launch Roblox Studio',
+    description: "Launch Roblox Studio, by default with the place of the nearest deploy.nevermore.json's default target",
     category: 'infrastructure',
     safety: 'none',
     scope: 'standalone',
     args: {
+        deployTarget: arg.positional({
+            description: 'deploy.nevermore.json target to open, e.g. test or integration.places.hub (default: its default target)',
+            required: false,
+        }),
         place: arg.option({ description: 'Path to a .rbxl place file' }),
         placeId: arg.option({
             description: 'Cloud place id to open in Studio (edit mode, via the EditPlace deep-link)',
@@ -33,6 +62,7 @@ export const launchCommand = defineCommand({
         }),
     },
     handler: async (args) => launchHandlerAsync({
+        deployTarget: args.deployTarget,
         placePath: args.place,
         placeId: args.placeId,
         universeId: args.universeId,

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

@@ -1 +1 @@
-{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../../../src/commands/process/launch/launch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAa/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAyB,EAAE;IAE3B,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,MAAM,GACV,OAAO,CAAC,OAAO,IAAI,IAAI;QACrB,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,GACtB,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EACrE,EAAE;QACJ,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACxB,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,kBAAkB,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC7D,CAAC;AACJ,CAAC;AAQD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA2B;IACnE,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,sBAAsB;IACnC,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;QAChE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC;YAClB,WAAW,EACT,2EAA2E;YAC7E,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;YACrB,WAAW,EACT,+DAA+D;YACjE,IAAI,EAAE,QAAQ;SACf,CAAC;KACH;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,kBAAkB,CAAC;QACjB,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../../../src/commands/process/launch/launch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAqB1C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAyB,EAAE;IAE3B,MAAM,gBAAgB,GACpB,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;IACnE,IAAI,gBAAgB,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,gEAAgE,OAAO,CAAC,YAAY,IAAI,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB;QAClC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,uBAAuB,CAC3B,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAC5B,OAAO,CAAC,YAAY,CACrB,CAAC;IACN,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC;QAClD,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAC7B,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAC5B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CACrC,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,WAAW,CAAC,QAAQ;YAClC,OAAO;YACP,UAAU;YACV,OAAO,EAAE,yBACP,WAAW,CAAC,QACd,YAAY,OAAO,cAAc,UAAU,UAAU,IAAI,CAAC,IAAI,CAC5D,SAAS,EACT,uBAAuB,CACxB,EAAE;SACJ,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5D,MAAM,MAAM,GACV,OAAO,IAAI,IAAI;QACb,CAAC,CAAC,SAAS,OAAO,GACd,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,UAAU,GAAG,CAAC,CAAC,CAAC,EACrD,EAAE;QACJ,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO;QACP,UAAU;QACV,OAAO,EAAE,kBAAkB,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC7D,CAAC;AACJ,CAAC;AASD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA2B;IACnE,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,uGAAuG;IACzG,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE;QACJ,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC;YAC3B,WAAW,EACT,yGAAyG;YAC3G,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;QAChE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC;YAClB,WAAW,EACT,2EAA2E;YAC7E,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;YACrB,WAAW,EACT,+DAA+D;YACjE,IAAI,EAAE,QAAQ;SACf,CAAC;KACH;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,kBAAkB,CAAC;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;CACL,CAAC,CAAC"}

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

@@ -1,7 +1,10 @@
 /**
  * Unit tests for the launch command handler.
  */
-import { describe, it, expect, vi } from 'vitest';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { afterEach, beforeEach, describe, it, expect, vi } from 'vitest';
 // Mock the process manager before importing the handler
 vi.mock('../../../process/studio-process-manager.js', () => ({
     launchStudioAsync: vi.fn().mockResolvedValue({
@@ -11,27 +14,45 @@ vi.mock('../../../process/studio-process-manager.js', () => ({
 }));
 import { launchHandlerAsync } from './launch.js';
 import { launchStudioAsync } from '../../../process/studio-process-manager.js';
+let tempDir;
+beforeEach(async () => {
+    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'launch-test-'));
+    vi.mocked(launchStudioAsync).mockClear();
+});
+afterEach(async () => {
+    await fs.rm(tempDir, { recursive: true, force: true });
+});
+async function writeDeployConfigAsync(dir, config) {
+    await fs.writeFile(path.join(dir, 'deploy.nevermore.json'), JSON.stringify(config));
+}
+const place = (placeId, name) => ({
+    name,
+    universeId: 900,
+    placeId,
+    project: 'default.project.json',
+});
 describe('launchHandlerAsync', () => {
-    it('calls launchStudioAsync and returns result', async () => {
-        const result = await launchHandlerAsync();
-        expect(launchStudioAsync).toHaveBeenCalled();
+    it('launches a bare Studio outside any deploy.nevermore.json', async () => {
+        const result = await launchHandlerAsync({ cwd: tempDir });
+        expect(launchStudioAsync).toHaveBeenCalledWith({});
         expect(result.launched).toBe(true);
         expect(result.summary).toBe('Studio launched');
     });
     it('passes place path to launchStudioAsync', async () => {
         const result = await launchHandlerAsync({
             placePath: '/tmp/game.rbxl',
+            cwd: tempDir,
         });
         expect(launchStudioAsync).toHaveBeenCalledWith({
             placePath: '/tmp/game.rbxl',
         });
-        expect(result.launched).toBe(true);
         expect(result.summary).toBe('Studio launched with /tmp/game.rbxl');
     });
     it('passes cloud place + universe ids to launchStudioAsync', async () => {
         const result = await launchHandlerAsync({
             placeId: 84760113521251,
             universeId: 9893751595,
+            cwd: tempDir,
         });
         expect(launchStudioAsync).toHaveBeenCalledWith({
             placeId: 84760113521251,
@@ -40,27 +61,85 @@ describe('launchHandlerAsync', () => {
         expect(result.summary).toBe('Studio launched with place 84760113521251 (universe 9893751595)');
     });
     it('summarizes a cloud place id without a universe id', async () => {
-        const result = await launchHandlerAsync({ placeId: 123 });
+        const result = await launchHandlerAsync({ placeId: 123, cwd: tempDir });
         expect(result.summary).toBe('Studio launched with place 123');
     });
-    it('passes an empty options object when nothing is specified', async () => {
-        await launchHandlerAsync({});
-        expect(launchStudioAsync).toHaveBeenCalledWith({});
+    it('propagates errors from launchStudioAsync', async () => {
+        vi.mocked(launchStudioAsync).mockRejectedValueOnce(new Error('Studio not found'));
+        await expect(launchHandlerAsync({ cwd: tempDir })).rejects.toThrow('Studio not found');
     });
-    it('returns correct summary without place path', async () => {
-        const result = await launchHandlerAsync({});
+});
+describe('launchHandlerAsync with deploy.nevermore.json', () => {
+    it("opens the default target's place from a parent directory's config", async () => {
+        await writeDeployConfigAsync(tempDir, { targets: { test: place(111) } });
+        const nested = path.join(tempDir, 'src', 'Server');
+        await fs.mkdir(nested, { recursive: true });
+        const result = await launchHandlerAsync({ cwd: nested });
+        expect(launchStudioAsync).toHaveBeenCalledWith({
+            placeId: 111,
+            universeId: 900,
+        });
+        expect(result).toMatchObject({
+            deployTarget: 'test',
+            placeId: 111,
+            universeId: 900,
+        });
+        expect(result.summary).toBe(`Studio launched with 'test' (place 111, universe 900) from ${path.join('..', '..', 'deploy.nevermore.json')}`);
+    });
+    it('opens a named target and narrows to one of its places', async () => {
+        await writeDeployConfigAsync(tempDir, {
+            targets: {
+                test: place(111),
+                integration: { places: [place(222, 'hub'), place(333, 'arena')] },
+            },
+        });
+        const result = await launchHandlerAsync({
+            deployTarget: 'integration.places.arena',
+            cwd: tempDir,
+        });
+        expect(launchStudioAsync).toHaveBeenCalledWith({
+            placeId: 333,
+            universeId: 900,
+        });
+        expect(result.deployTarget).toBe('integration.places.arena');
+    });
+    it('asks which place to open for a target with several', async () => {
+        await writeDeployConfigAsync(tempDir, {
+            targets: {
+                integration: { places: [place(222, 'hub'), place(333, 'arena')] },
+            },
+        });
+        await expect(launchHandlerAsync({ deployTarget: 'integration', cwd: tempDir })).rejects.toThrow("Target 'integration' has 2 places. Pick one:\n  - integration.places.hub\n  - integration.places.arena");
+        expect(launchStudioAsync).not.toHaveBeenCalled();
+    });
+    it('skips a config without targets, like a repo root universe id', async () => {
+        await writeDeployConfigAsync(tempDir, { universeId: 900 });
+        const result = await launchHandlerAsync({ cwd: tempDir });
+        expect(launchStudioAsync).toHaveBeenCalledWith({});
         expect(result.summary).toBe('Studio launched');
     });
-    it('propagates errors from launchStudioAsync', async () => {
-        vi.mocked(launchStudioAsync).mockRejectedValueOnce(new Error('Studio not found'));
-        await expect(launchHandlerAsync()).rejects.toThrow('Studio not found');
+    it('asks for a target when the config has no default', async () => {
+        await writeDeployConfigAsync(tempDir, {
+            targets: { alpha: place(1), beta: place(2) },
+        });
+        await expect(launchHandlerAsync({ cwd: tempDir })).rejects.toThrow('has several targets and no default. Name one: alpha, beta');
+    });
+    it('fails on a target when no deploy.nevermore.json is found', async () => {
+        await expect(launchHandlerAsync({ deployTarget: 'test', cwd: tempDir })).rejects.toThrow(/No deploy.nevermore.json in .* to find target 'test'/);
+    });
+    it('refuses a target together with --place', async () => {
+        await expect(launchHandlerAsync({
+            deployTarget: 'test',
+            placePath: '/tmp/game.rbxl',
+            cwd: tempDir,
+        })).rejects.toThrow('not both');
     });
-    it('result shape matches LaunchResult interface', async () => {
-        const result = await launchHandlerAsync();
-        expect(result).toHaveProperty('launched');
-        expect(result).toHaveProperty('summary');
-        expect(typeof result.launched).toBe('boolean');
-        expect(typeof result.summary).toBe('string');
+    it('prefers an explicit --place over the config', async () => {
+        await writeDeployConfigAsync(tempDir, { targets: { test: place(111) } });
+        await launchHandlerAsync({ placePath: '/tmp/game.rbxl', cwd: tempDir });
+        expect(launchStudioAsync).toHaveBeenCalledWith({
+            placePath: '/tmp/game.rbxl',
+        });
     });
 });
 //# sourceMappingURL=launch.test.js.map

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

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

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

@@ -1,6 +1,7 @@
 /**
  * `process list` — list connected Studio sessions.
  */
+import { type SessionTargeting } from '../../framework/define-command.js';
 import type { BridgeConnection } from '../../../bridge/index.js';
 import type { SessionInfo } from '../../../bridge/index.js';
 export interface SessionsResult {
@@ -10,7 +11,7 @@ export interface SessionsResult {
 /**
  * List all connected Studio sessions with a summary message.
  */
-export declare function listSessionsHandlerAsync(connection: BridgeConnection): Promise<SessionsResult>;
+export declare function listSessionsHandlerAsync(connection: BridgeConnection, targeting?: SessionTargeting): Promise<SessionsResult>;
 export declare function formatSessionsTable(result: SessionsResult): string;
 export declare const listCommand: import("../../framework/define-command.js").CommandDefinition<unknown, SessionsResult>;
 //# sourceMappingURL=list.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/list/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAM3C,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,EAC5B,SAAS,GAAE,gBAAqB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAiBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGlE;AAED,eAAO,MAAM,WAAW,wFActB,CAAC"}

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

@@ -1,19 +1,21 @@
 /**
  * `process list` — list connected Studio sessions.
  */
-import { defineCommand } from '../../framework/define-command.js';
+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();
+export async function listSessionsHandlerAsync(connection, targeting = {}) {
+    const sessions = connection.findSessions(targeting.target, targeting.context);
     if (sessions.length === 0) {
         return {
             sessions: [],
-            summary: 'No active sessions. Is Studio running with the studio-bridge plugin?',
+            summary: connection.listSessions().length > 0
+                ? 'No sessions match --target/--context.'
+                : 'No active sessions. Is Studio running with the studio-bridge plugin?',
         };
     }
     return {
@@ -24,7 +26,7 @@ export async function listSessionsHandlerAsync(connection) {
 const sessionColumns = [
     {
         header: 'Session',
-        value: (s) => s.sessionId.slice(0, 8),
+        value: (s) => s.sessionId,
         format: (v) => OutputHelper.formatHint(v),
     },
     { header: 'Context', value: (s) => s.context },
@@ -47,10 +49,11 @@ export const listCommand = defineCommand({
     category: 'infrastructure',
     safety: 'read',
     scope: 'connection',
+    coversAllSessions: true,
     args: {},
     cli: {
         format: formatSessionsTable,
     },
-    handler: async (connection) => listSessionsHandlerAsync(connection),
+    handler: async (connection, _args, targeting) => listSessionsHandlerAsync(connection, targeting),
 });
 //# sourceMappingURL=list.js.map

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

@@ -1 +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"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../src/commands/process/list/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,GAEd,MAAM,mCAAmC,CAAC;AAC3C,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,EAC5B,YAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAE9E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,OAAO,EACL,UAAU,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,CAAC;gBAClC,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,sEAAsE;SAC7E,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;QACzB,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,iBAAiB,EAAE,IAAI;IACvB,IAAI,EAAE,EAAE;IACR,GAAG,EAAE;QACH,MAAM,EAAE,mBAAmB;KAC5B;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAC9C,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC;CAClD,CAAC,CAAC"}

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

@@ -22,6 +22,7 @@ function createSessionInfo(overrides = {}) {
 function createMockConnection(sessions) {
     return {
         listSessions: () => sessions,
+        findSessions: () => sessions,
         getSession: (id) => sessions.find((s) => s.sessionId === id),
     };
 }

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

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

@@ -6,6 +6,7 @@
  * This is standalone (no existing connection needed) and is CLI-only.
  * MCP does NOT expose this command.
  */
+import type { SerializedReturnValue } from '../../../server/web-socket-protocol.js';
 export interface ProcessRunOptions {
     scriptContent: string;
     packageName: string;
@@ -14,9 +15,16 @@ export interface ProcessRunOptions {
     verbose: boolean;
     showLogs: boolean;
     filePath?: string;
+    quiet?: boolean;
+    /** Passed to the script as `...`. */
+    args?: string[];
 }
 export interface ProcessRunResult {
     success: boolean;
+    output: string[];
+    error?: string;
+    returnValues?: SerializedReturnValue[];
+    durationMs: number;
     summary: string;
 }
 interface ProcessRunArgs {
@@ -24,6 +32,7 @@ interface ProcessRunArgs {
     file?: string;
     place?: string;
     timeout?: number;
+    scriptArgs?: string[];
 }
 export declare function processRunHandlerAsync(options: ProcessRunOptions): Promise<ProcessRunResult>;
 export declare const processRunCommand: import("../../framework/define-command.js").CommandDefinition<ProcessRunArgs, ProcessRunResult>;

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

@@ -1 +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"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../../src/commands/process/run/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,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;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,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;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAED,eAAO,MAAM,iBAAiB,iGAuD5B,CAAC"}

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

@@ -10,15 +10,15 @@ 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';
+import { isJsonOutputEnabled } from '../../../cli/cli-output-context.js';
+import { formatReturnValues } from '../../console/exec/exec.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);
+    const result = await executeScriptAsync(options);
     return {
-        success: true,
-        summary: 'Script execution completed.',
+        ...result,
+        summary: result.success ? 'Script completed.' : 'Script failed.',
     };
 }
 export const processRunCommand = defineCommand({
@@ -45,6 +45,14 @@ export const processRunCommand = defineCommand({
             description: 'Execution timeout in milliseconds',
             type: 'number',
         }),
+        scriptArgs: arg.passthrough({
+            description: 'Arguments after --, passed to the script as ... (all strings)',
+        }),
+    },
+    cli: {
+        format: (result) => result.returnValues && result.returnValues.length > 0
+            ? formatReturnValues(result.returnValues)
+            : '',
     },
     handler: async (args) => {
         const { scriptContent, filePath } = await resolveScriptContentAsync(args);
@@ -56,6 +64,8 @@ export const processRunCommand = defineCommand({
             verbose: OutputHelper.isVerbose(),
             showLogs: true,
             filePath,
+            quiet: isJsonOutputEnabled(),
+            args: args.scriptArgs,
         });
     },
     // No MCP config -- process run is CLI-only

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

@@ -1 +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"}
+{"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;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAiChE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA0B;IAE1B,oEAAoE;IACpE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CACzC,iCAAiC,CAClC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEjD,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB;KACjE,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;QACF,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC;YAC1B,WAAW,EACT,+DAA+D;SAClE,CAAC;KACH;IACD,GAAG,EAAE;QACH,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YACnD,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC;YACzC,CAAC,CAAC,EAAE;KACT;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;YACR,KAAK,EAAE,mBAAmB,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,UAAU;SACtB,CAAC,CAAC;IACL,CAAC;IACD,2CAA2C;CAC5C,CAAC,CAAC"}

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

@@ -10,6 +10,8 @@ export interface ServeOptions {
 export interface ServeResult {
     port: number;
     event: string;
+    timestamp: string;
+    summary: string;
 }
 /** Blocks until shutdown signal or timeout. */
 export declare function serveHandlerAsync(options?: ServeOptions): Promise<ServeResult>;

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

@@ -1 +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"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../src/commands/serve/serve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,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;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAkItB;AAED,eAAO,MAAM,YAAY,uFAoBvB,CAAC"}

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

@@ -5,9 +5,13 @@
 import { defineCommand } from '../framework/define-command.js';
 import { arg } from '../framework/arg-builder.js';
 import { BridgeConnection } from '../../bridge/index.js';
+import { isJsonOutputEnabled } from '../../cli/cli-output-context.js';
 /** Blocks until shutdown signal or timeout. */
 export async function serveHandlerAsync(options = {}) {
     const port = options.port ?? 38741;
+    options = { ...options, json: options.json || isJsonOutputEnabled() };
+    const alreadyRunning = 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.`);
     let connection;
     try {
         connection = await BridgeConnection.connectAsync({
@@ -19,11 +23,15 @@ export async function serveHandlerAsync(options = {}) {
         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 alreadyRunning;
         }
         throw err;
     }
+    if (connection.role !== 'host') {
+        await connection.disconnectAsync();
+        throw alreadyRunning;
+    }
+    const listeningPort = connection.port;
     // Log startup
     if (options.json) {
         console.log(JSON.stringify({
@@ -103,12 +111,17 @@ export async function serveHandlerAsync(options = {}) {
             // Never resolves -- process runs until signal
         });
     }
-    return { port: connection.port, event: 'stopped' };
+    return {
+        port: listeningPort,
+        event: 'stopped',
+        timestamp: new Date().toISOString(),
+        summary: 'Bridge host stopped.',
+    };
 }
 export const serveCommand = defineCommand({
     group: null,
     name: 'serve',
-    description: 'Start the bridge server',
+    description: 'Start the bridge server (optional: keeps Studio connected, so commands run in about a second instead of ten)',
     category: 'infrastructure',
     safety: 'none',
     scope: 'standalone',