@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/cli/adapters/target-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-resolver.test.js","sourceRoot":"","sources":["../../../../src/cli/adapters/target-resolver.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,SAAS,eAAe,CAAC,YAAkC,EAAE;IAC3D,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,QAAQ;QAC1C,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,WAAW;QAC7C,KAAK,EAAE,MAAa;QACpB,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,MAAM;QACpC,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,QAAQ;QAC5C,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,GAAG;QACjC,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,GAAG;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,WAA0B,EAAE;IAClD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC;QAC/C,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrD,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAU,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;KACI,CAAC;AACX,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CACnD,SAAS,EACT,SAAS,CACV,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpC,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC7B,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CACV,kBAAkB,CAAC,IAAI,EAAE;gBACvB,MAAM,EAAE,aAAa;gBACrB,MAAM,EAAE,QAAQ;aACjB,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YACpC,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtE,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CACV,kBAAkB,CAAC,IAAI,EAAE;gBACvB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,MAAM;aACf,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;YAC5E,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAE5C,MAAM,MAAM,CACV,kBAAkB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAC/C,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,MAAM,CACV,kBAAkB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC7C,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;YAC3E,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAE5C,MAAM,MAAM,CACV,kBAAkB,CAAC,IAAI,EAAE;gBACvB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,IAAI;aACZ,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG;YACf,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YACzD,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;SAC1D,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,QAAQ,GAAG,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3C,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/cli/args/global-args.d.ts

@@ -6,5 +6,7 @@ export interface StudioBridgeGlobalArgs {
     place?: string;
     timeout: number;
     logs: boolean;
+    remote?: string;
+    local?: boolean;
 }
 //# sourceMappingURL=global-args.d.ts.map

package/dist/src/cli/args/global-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-args.d.ts","sourceRoot":"","sources":["../../../../src/cli/args/global-args.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf"}
+{"version":3,"file":"global-args.d.ts","sourceRoot":"","sources":["../../../../src/cli/args/global-args.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/src/cli/cli.d.ts

@@ -2,10 +2,13 @@
 /**
  * CLI entry point for @quenty/studio-bridge.
  *
+ * Registry-driven: all commands are `defineCommand()` definitions discovered
+ * from `src/commands/`. The adapter layer converts them into yargs modules.
+ *
  * Usage:
- *   studio-bridge run <file.lua>
- *   studio-bridge exec 'print("hello")'
- *   studio-bridge terminal [--script <file.lua>]
+ *   studio-bridge console exec 'print("hello")'
+ *   studio-bridge console logs
+ *   studio-bridge process list
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/src/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/src/cli/cli.js

@@ -2,10 +2,13 @@
 /**
  * CLI entry point for @quenty/studio-bridge.
  *
+ * Registry-driven: all commands are `defineCommand()` definitions discovered
+ * from `src/commands/`. The adapter layer converts them into yargs modules.
+ *
  * Usage:
- *   studio-bridge run <file.lua>
- *   studio-bridge exec 'print("hello")'
- *   studio-bridge terminal [--script <file.lua>]
+ *   studio-bridge console exec 'print("hello")'
+ *   studio-bridge console logs
+ *   studio-bridge process list
  */
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
@@ -13,26 +16,73 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import { VersionChecker } from '@quenty/nevermore-cli-helpers';
-import { RunCommand } from './commands/run-command.js';
-import { ExecCommand } from './commands/exec-command.js';
-import { TerminalCommand } from './commands/terminal/terminal-command.js';
+import { CommandRegistry } from '../commands/framework/command-registry.js';
+import { buildGroupCommands } from './adapters/group-builder.js';
+// Command definitions (explicit imports for deterministic ordering)
+import { execCommand } from '../commands/console/exec/exec.js';
+import { logsCommand } from '../commands/console/logs/logs.js';
+import { queryCommand } from '../commands/explorer/query/query.js';
+import { screenshotCommand } from '../commands/viewport/screenshot/screenshot.js';
+import { infoCommand } from '../commands/process/info/info.js';
+import { listCommand } from '../commands/process/list/list.js';
+import { launchCommand } from '../commands/process/launch/launch.js';
+import { processRunCommand } from '../commands/process/run/run.js';
+import { processCloseCommand } from '../commands/process/close/close.js';
+import { installCommand } from '../commands/plugin/install/install.js';
+import { uninstallCommand } from '../commands/plugin/uninstall/uninstall.js';
+import { serveCommand } from '../commands/serve/serve.js';
+import { linuxSetupCommand } from '../commands/linux/setup/setup.js';
+import { linuxInjectCredentialsCommand } from '../commands/linux/inject-credentials/inject-credentials.js';
+import { linuxStatusCommand } from '../commands/linux/status/status.js';
+const registry = new CommandRegistry();
+// Execution commands
+registry.register(execCommand);
+registry.register(logsCommand);
+registry.register(queryCommand);
+registry.register(screenshotCommand);
+registry.register(processRunCommand);
+// Infrastructure commands
+registry.register(infoCommand);
+registry.register(listCommand);
+registry.register(launchCommand);
+registry.register(processCloseCommand);
+registry.register(installCommand);
+registry.register(uninstallCommand);
+registry.register(serveCommand);
+// Linux commands
+registry.register(linuxSetupCommand);
+registry.register(linuxInjectCredentialsCommand);
+registry.register(linuxStatusCommand);
+const { groups, topLevel } = buildGroupCommands(registry);
+const formatArg = process.argv.includes('--format')
+    ? process.argv[process.argv.indexOf('--format') + 1]
+    : undefined;
+const isMachineReadable = formatArg === 'json';
 const versionData = await VersionChecker.checkForUpdatesAsync({
     humanReadableName: 'Studio Bridge',
     packageName: '@quenty/studio-bridge',
     registryUrl: 'https://registry.npmjs.org/',
     packageJsonPath: join(dirname(fileURLToPath(import.meta.url)), '../../../package.json'),
+    silent: isMachineReadable,
 });
-yargs(hideBin(process.argv))
+// Expose version metadata so the adapter can inject it into JSON output
+if (isMachineReadable && versionData) {
+    const warnings = [];
+    if (versionData.isLocalDev) {
+        warnings.push(`Studio Bridge is running in local development mode. Run 'npm install -g @quenty/studio-bridge@latest' to switch to production copy.`);
+    }
+    else if (versionData.updateAvailable) {
+        warnings.push(`Studio Bridge update available: ${VersionChecker.getVersionDisplayName(versionData)} → ${versionData.latestVersion}. Run 'npm install -g @quenty/studio-bridge@latest' to update.`);
+    }
+    if (warnings.length > 0) {
+        globalThis.__studioBridgeWarnings = warnings;
+    }
+}
+const cli = yargs(hideBin(process.argv))
     .scriptName('studio-bridge')
     .version((versionData
     ? VersionChecker.getVersionDisplayName(versionData)
     : undefined))
-    .option('place', {
-    alias: 'p',
-    description: 'Path to a .rbxl place file (builds a minimal place via rojo if omitted)',
-    type: 'string',
-    global: true,
-})
     .option('timeout', {
     description: 'Timeout in milliseconds',
     type: 'number',
@@ -45,19 +95,31 @@ yargs(hideBin(process.argv))
     default: false,
     global: true,
 })
-    .option('logs', {
-    description: 'Show execution logs in spinner mode',
+    .option('remote', {
+    type: 'string',
+    description: 'Connect to a remote bridge host (host:port)',
+    global: true,
+})
+    .option('local', {
     type: 'boolean',
-    default: true,
+    description: 'Force local mode (skip devcontainer auto-detection)',
+    default: false,
     global: true,
+    conflicts: 'remote',
 })
     .middleware((argv) => {
     OutputHelper.setVerbose(argv.verbose);
 })
-    .usage(OutputHelper.formatInfo('Usage: $0 <command> [options]'))
-    .command(new ExecCommand())
-    .command(new RunCommand())
-    .command(new TerminalCommand())
+    .usage(OutputHelper.formatInfo('Usage: $0 <command> [options]'));
+// Register grouped commands (console, explorer, viewport, process, plugin)
+for (const group of groups) {
+    cli.command(group);
+}
+// Register top-level commands from registry (serve)
+for (const cmd of topLevel) {
+    cli.command(cmd);
+}
+cli
     .recommendCommands()
     .demandCommand(1, OutputHelper.formatHint("Hint: See 'studio-bridge help' for more help"))
     .wrap(null)

package/dist/src/cli/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,oBAAoB,CAAC;IAC5D,iBAAiB,EAAE,eAAe;IAClC,WAAW,EAAE,uBAAuB;IACpC,WAAW,EAAE,6BAA6B;IAC1C,eAAe,EAAE,IAAI,CACnB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,uBAAuB,CACxB;CACF,CAAC,CAAC;AAEH,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,UAAU,CAAC,eAAe,CAAC;KAC3B,OAAO,CACN,CAAC,WAAW;IACV,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,WAAW,CAAC;IACnD,CAAC,CAAC,SAAS,CAAQ,CACtB;KACA,MAAM,CAAC,OAAO,EAAE;IACf,KAAK,EAAE,GAAG;IACV,WAAW,EACT,yEAAyE;IAC3E,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,SAAS,EAAE;IACjB,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,SAAS,EAAE;IACjB,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,IAAI;CACb,CAAC;KACD,MAAM,CAAC,MAAM,EAAE;IACd,WAAW,EAAE,qCAAqC;IAClD,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;CACb,CAAC;KACD,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;IACnB,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,OAAkB,CAAC,CAAC;AACnD,CAAC,CAAC;KACD,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC;KAC/D,OAAO,CAAC,IAAI,WAAW,EAAS,CAAC;KACjC,OAAO,CAAC,IAAI,UAAU,EAAS,CAAC;KAChC,OAAO,CAAC,IAAI,eAAe,EAAS,CAAC;KACrC,iBAAiB,EAAE;KACnB,aAAa,CACZ,CAAC,EACD,YAAY,CAAC,UAAU,CAAC,8CAA8C,CAAC,CACxE;KACA,IAAI,CAAC,IAAI,CAAC;KACV,MAAM,EAAE,CAAC,IAAI,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/resolve-script-content.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared parsing for commands that accept either inline Luau code or a
+ * file path. Used by `console exec` and `process run`.
+ */
+export interface ScriptContentArgs {
+    code?: string;
+    file?: string;
+}
+export interface ResolvedScriptContent {
+    scriptContent: string;
+    /** Absolute path of the resolved file, or undefined when using inline code. */
+    filePath?: string;
+}
+/**
+ * Reads inline code or a file (resolved against CWD) into a string.
+ * Throws if neither is provided.
+ */
+export declare function resolveScriptContentAsync(args: ScriptContentArgs): Promise<ResolvedScriptContent>;
+//# sourceMappingURL=resolve-script-content.d.ts.map

package/dist/src/cli/resolve-script-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-script-content.d.ts","sourceRoot":"","sources":["../../../src/cli/resolve-script-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAUhC"}

package/dist/src/cli/resolve-script-content.js

@@ -0,0 +1,22 @@
+/**
+ * Shared parsing for commands that accept either inline Luau code or a
+ * file path. Used by `console exec` and `process run`.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Reads inline code or a file (resolved against CWD) into a string.
+ * Throws if neither is provided.
+ */
+export async function resolveScriptContentAsync(args) {
+    if (args.file) {
+        const absolutePath = path.resolve(args.file);
+        const scriptContent = await fs.readFile(absolutePath, 'utf-8');
+        return { scriptContent, filePath: absolutePath };
+    }
+    if (args.code) {
+        return { scriptContent: args.code };
+    }
+    throw new Error('Either inline code or --file must be provided');
+}
+//# sourceMappingURL=resolve-script-content.js.map

package/dist/src/cli/resolve-script-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-script-content.js","sourceRoot":"","sources":["../../../src/cli/resolve-script-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAa7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAuB;IAEvB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACnE,CAAC"}

package/dist/src/cli/resolve-session.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI utility for resolving which studio-bridge session to target
+ * based on command-line arguments.
+ */
+import type { BridgeConnection } from '../bridge/index.js';
+import type { SessionInfo, SessionContext } from '../bridge/index.js';
+export interface ResolveSessionOptions {
+    sessionId?: string;
+    instanceId?: string;
+    context?: SessionContext;
+}
+/**
+ * Resolve which session to target based on CLI args.
+ *
+ * - If sessionId is provided, looks up that specific session.
+ * - Otherwise lists all sessions and filters by instanceId/context.
+ * - Auto-selects when exactly one session matches.
+ * - Throws descriptive errors on zero or ambiguous matches.
+ */
+export declare function resolveSessionAsync(connection: BridgeConnection, options?: ResolveSessionOptions): Promise<SessionInfo>;
+//# sourceMappingURL=resolve-session.d.ts.map

package/dist/src/cli/resolve-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../src/cli/resolve-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,WAAW,CAAC,CAwCtB"}

package/dist/src/cli/resolve-session.js

@@ -0,0 +1,40 @@
+/**
+ * CLI utility for resolving which studio-bridge session to target
+ * based on command-line arguments.
+ */
+/**
+ * Resolve which session to target based on CLI args.
+ *
+ * - If sessionId is provided, looks up that specific session.
+ * - Otherwise lists all sessions and filters by instanceId/context.
+ * - Auto-selects when exactly one session matches.
+ * - Throws descriptive errors on zero or ambiguous matches.
+ */
+export async function resolveSessionAsync(connection, options = {}) {
+    if (options.sessionId) {
+        const sessions = connection.listSessions();
+        const session = sessions.find((s) => s.sessionId === options.sessionId);
+        if (!session) {
+            throw new Error(`Session '${options.sessionId}' not found.`);
+        }
+        return session;
+    }
+    let sessions = connection.listSessions();
+    if (options.instanceId) {
+        sessions = sessions.filter((s) => s.instanceId === options.instanceId);
+    }
+    if (options.context) {
+        sessions = sessions.filter((s) => s.context === options.context);
+    }
+    if (sessions.length === 1) {
+        return sessions[0];
+    }
+    if (sessions.length === 0) {
+        throw new Error('No matching sessions found. Is Studio running with the studio-bridge plugin?');
+    }
+    const listing = sessions
+        .map((s) => `  - ${s.sessionId} (instance=${s.instanceId}, context=${s.context})`)
+        .join('\n');
+    throw new Error(`Multiple sessions found. Use --session or --instance to select one:\n${listing}`);
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/src/cli/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../src/cli/resolve-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA4B,EAC5B,UAAiC,EAAE;IAEnC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,SAAS,cAAc,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,QAAQ,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ;SACrB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,SAAS,cAAc,CAAC,CAAC,UAAU,aAAa,CAAC,CAAC,OAAO,GAAG,CACxE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,KAAK,CACb,wEAAwE,OAAO,EAAE,CAClF,CAAC;AACJ,CAAC"}

package/dist/src/cli/resolve-session.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the CLI session resolution utility.
+ */
+export {};
+//# sourceMappingURL=resolve-session.test.d.ts.map

package/dist/src/cli/resolve-session.test.d.ts.map

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

package/dist/src/cli/resolve-session.test.js

@@ -0,0 +1,112 @@
+/**
+ * Unit tests for the CLI session resolution utility.
+ */
+import { describe, it, expect } from 'vitest';
+import { resolveSessionAsync } from './resolve-session.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('resolveSessionAsync', () => {
+    it('returns session when sessionId matches', async () => {
+        const session = createSessionInfo({ sessionId: 'abc-123' });
+        const conn = createMockConnection([session]);
+        const result = await resolveSessionAsync(conn, { sessionId: 'abc-123' });
+        expect(result.sessionId).toBe('abc-123');
+    });
+    it('throws when sessionId does not match', async () => {
+        const conn = createMockConnection([createSessionInfo()]);
+        await expect(resolveSessionAsync(conn, { sessionId: 'nonexistent' })).rejects.toThrow("Session 'nonexistent' not found.");
+    });
+    it('returns sole session when no filters and exactly one session', async () => {
+        const session = createSessionInfo({ sessionId: 'only-one' });
+        const conn = createMockConnection([session]);
+        const result = await resolveSessionAsync(conn);
+        expect(result.sessionId).toBe('only-one');
+    });
+    it('throws when no sessions match', async () => {
+        const conn = createMockConnection([]);
+        await expect(resolveSessionAsync(conn)).rejects.toThrow('No matching sessions found. Is Studio running with the studio-bridge plugin?');
+    });
+    it('throws descriptive error when multiple sessions match', async () => {
+        const sessions = [
+            createSessionInfo({ sessionId: 'ses-1', instanceId: 'inst-a' }),
+            createSessionInfo({ sessionId: 'ses-2', instanceId: 'inst-b' }),
+        ];
+        const conn = createMockConnection(sessions);
+        await expect(resolveSessionAsync(conn)).rejects.toThrow(/Multiple sessions found.*--session.*--instance/s);
+    });
+    it('filters by instanceId', async () => {
+        const sessions = [
+            createSessionInfo({ sessionId: 'ses-1', instanceId: 'inst-a' }),
+            createSessionInfo({ sessionId: 'ses-2', instanceId: 'inst-b' }),
+        ];
+        const conn = createMockConnection(sessions);
+        const result = await resolveSessionAsync(conn, { instanceId: 'inst-b' });
+        expect(result.sessionId).toBe('ses-2');
+    });
+    it('filters by context', async () => {
+        const sessions = [
+            createSessionInfo({ sessionId: 'ses-edit', context: 'edit' }),
+            createSessionInfo({ sessionId: 'ses-server', context: 'server' }),
+        ];
+        const conn = createMockConnection(sessions);
+        const result = await resolveSessionAsync(conn, { context: 'server' });
+        expect(result.sessionId).toBe('ses-server');
+    });
+    it('combines instanceId and context filters', async () => {
+        const sessions = [
+            createSessionInfo({
+                sessionId: 's1',
+                instanceId: 'inst-a',
+                context: 'edit',
+            }),
+            createSessionInfo({
+                sessionId: 's2',
+                instanceId: 'inst-a',
+                context: 'server',
+            }),
+            createSessionInfo({
+                sessionId: 's3',
+                instanceId: 'inst-b',
+                context: 'edit',
+            }),
+        ];
+        const conn = createMockConnection(sessions);
+        const result = await resolveSessionAsync(conn, {
+            instanceId: 'inst-a',
+            context: 'server',
+        });
+        expect(result.sessionId).toBe('s2');
+    });
+    it('throws when filters match zero sessions', async () => {
+        const sessions = [
+            createSessionInfo({
+                sessionId: 'ses-1',
+                instanceId: 'inst-a',
+                context: 'edit',
+            }),
+        ];
+        const conn = createMockConnection(sessions);
+        await expect(resolveSessionAsync(conn, { context: 'server' })).rejects.toThrow('No matching sessions found');
+    });
+});
+//# sourceMappingURL=resolve-session.test.js.map

package/dist/src/cli/resolve-session.test.js.map

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

package/dist/src/cli/script-executor.d.ts

@@ -9,6 +9,7 @@ export interface ExecuteScriptOptions {
     timeoutMs: number;
     verbose: boolean;
     showLogs: boolean;
+    filePath?: string;
 }
 /**
  * Resolves and validates a place file path. Returns undefined if no place

package/dist/src/cli/script-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-executor.d.ts","sourceRoot":"","sources":["../../../src/cli/script-executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,oBAAoB;IACnC,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;CACnB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+Ff"}
+{"version":3,"file":"script-executor.d.ts","sourceRoot":"","sources":["../../../src/cli/script-executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,oBAAoB;IACnC,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;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgHf"}

package/dist/src/cli/script-executor.js

@@ -29,7 +29,13 @@ export async function resolvePlacePathAsync(place) {
  * lifecycle (spinner or simple output).
  */
 export async function executeScriptAsync(options) {
-    const { scriptContent, packageName, placePath, timeoutMs, verbose, showLogs } = options;
+    const { shouldDelegateToDockerAsync, delegateToDockerAsync } = await import('../docker/docker-delegator.js');
+    if (await shouldDelegateToDockerAsync()) {
+        OutputHelper.verbose('[StudioBridge] No Wine detected, delegating to Docker');
+        await delegateToDockerAsync(options);
+        return; // unreachable — delegateToDockerAsync calls process.exit
+    }
+    const { scriptContent, packageName, placePath, timeoutMs, verbose, showLogs, } = options;
     const useSpinner = !!process.stdout.isTTY && !verbose;
     const reporter = new CompositeReporter([packageName], (state) => [
         useSpinner

package/dist/src/cli/script-executor.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Shared type definitions for studio-bridge CLI commands.
+ */
+/**
+ * Minimal command definition metadata used by the barrel export pattern.
+ */
+export interface CommandDefinition {
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/cli/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions for studio-bridge CLI commands.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,16 @@
+/**
+ * Handler for the `connect` command. Resolves a session by ID and
+ * returns metadata about it so the caller can set it as the active session.
+ */
+import type { BridgeConnection } from '../bridge/index.js';
+export interface ConnectOptions {
+    sessionId: string;
+}
+export interface ConnectResult {
+    sessionId: string;
+    context: string;
+    placeName: string;
+    summary: string;
+}
+export declare function connectHandlerAsync(connection: BridgeConnection, options: ConnectOptions): Promise<ConnectResult>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/dist/src/commands/connect.js

@@ -0,0 +1,15 @@
+/**
+ * Handler for the `connect` command. Resolves a session by ID and
+ * returns metadata about it so the caller can set it as the active session.
+ */
+export async function connectHandlerAsync(connection, options) {
+    const session = await connection.resolveSessionAsync(options.sessionId);
+    const info = session.info;
+    return {
+        sessionId: info.sessionId,
+        context: info.context,
+        placeName: info.placeName,
+        summary: `Connected to session ${info.sessionId} (${info.placeName}, ${info.context})`,
+    };
+}
+//# sourceMappingURL=connect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA4B,EAC5B,OAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,wBAAwB,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,GAAG;KACvF,CAAC;AACJ,CAAC"}

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

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

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

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