@houwert/conductor 0.2.0

package/dist/index.js

@@ -0,0 +1,426 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const minimist_1 = __importDefault(require("minimist"));
+const verbose_js_1 = require("./verbose.js");
+const list_devices_js_1 = require("./commands/list-devices.js");
+const launch_app_js_1 = require("./commands/launch-app.js");
+const stop_app_js_1 = require("./commands/stop-app.js");
+const tap_js_1 = require("./commands/tap.js");
+const type_js_1 = require("./commands/type.js");
+const back_js_1 = require("./commands/back.js");
+const scroll_js_1 = require("./commands/scroll.js");
+const swipe_js_1 = require("./commands/swipe.js");
+const assert_visible_js_1 = require("./commands/assert-visible.js");
+const screenshot_js_1 = require("./commands/screenshot.js");
+const inspect_js_1 = require("./commands/inspect.js");
+const run_flow_js_1 = require("./commands/run-flow.js");
+const run_flow_inline_js_1 = require("./commands/run-flow-inline.js");
+const press_key_js_1 = require("./commands/press-key.js");
+const session_js_1 = require("./commands/session.js");
+const cheat_sheet_js_1 = require("./commands/cheat-sheet.js");
+const daemon_js_1 = require("./commands/daemon.js");
+const install_js_1 = require("./commands/install.js");
+const device_pool_js_1 = require("./commands/device-pool.js");
+const run_parallel_js_1 = require("./commands/run-parallel.js");
+const foreground_app_js_1 = require("./commands/foreground-app.js");
+const list_apps_js_1 = require("./commands/list-apps.js");
+const erase_text_js_1 = require("./commands/erase-text.js");
+const assert_not_visible_js_1 = require("./commands/assert-not-visible.js");
+const open_link_js_1 = require("./commands/open-link.js");
+const hide_keyboard_js_1 = require("./commands/hide-keyboard.js");
+const scroll_until_visible_js_1 = require("./commands/scroll-until-visible.js");
+const set_location_js_1 = require("./commands/set-location.js");
+const set_orientation_js_1 = require("./commands/set-orientation.js");
+const start_device_js_1 = require("./commands/start-device.js");
+const runner_js_1 = require("./runner.js");
+const update_check_js_1 = require("./update-check.js");
+const HELP = `
+Usage: conductor <command> [args] [options]
+
+Commands:
+  start-device --platform <ios|android>  Boot a simulator or emulator
+    --os-version <n>                  iOS version (e.g. 18) or Android API level (e.g. 33)
+    --avd <name>                      Android AVD name (default: first available)
+  list-devices                        List connected devices/simulators
+  foreground-app                      Print bundle ID / package of the foreground app
+  list-apps                           List installed app IDs / package names
+  launch-app <appId>                  Launch app (saves to session)
+    --clear-state                     Clear app data/state before launching
+    --clear-keychain                  Clear keychain before launching
+    --no-stop-app                     Do not stop the app before launching (resume instead of restart)
+    --argument key=value              Set launch argument (repeatable)
+  stop-app [<appId>]                  Stop app
+  tap <element>                       Tap element by text or id
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --index <n>                       Pick the nth match (0-based)
+    --long-press                      Hold instead of tap
+    --double-tap                      Double-tap the element
+    --optional                        Do not fail if element is not found
+    --focused                         Match only focused elements
+    --enabled / --no-enabled          Match by enabled state
+    --checked / --no-checked          Match by checked state
+    --selected / --no-selected        Match by selected state
+    --below <text>                    Match element below the given reference
+    --above <text>                    Match element above the given reference
+    --left-of <text>                  Match element left of the given reference
+    --right-of <text>                 Match element right of the given reference
+    --verbose                         Log all candidates and chosen element
+  type <text>                         Type text into focused field
+  erase-text [n]                      Erase n characters (default: 50)
+  back                                Press back button
+  press-key <key>                     Press a key (Enter, Backspace, Home, ...)
+  hide-keyboard                       Dismiss the on-screen keyboard
+  scroll [--direction down|up|left|right]
+  swipe --direction <UP|DOWN|LEFT|RIGHT>
+    --start <x,y>                     Start coordinate (0–1 normalised or absolute px)
+    --end <x,y>                       End coordinate (0–1 normalised or absolute px)
+    --duration <ms>                   Swipe duration in milliseconds (default: 500)
+  scroll-until-visible <element>      Scroll until element is visible
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --direction <down|up|left|right>  Scroll direction (default: down)
+    --timeout <ms>                    Max time in milliseconds (default: 30000)
+  assert-visible <element>            Assert element is visible
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --index <n>                       Pick the nth match (0-based)
+    --timeout <ms>                    Max wait time in milliseconds
+    --optional                        Do not fail if element is not found
+    --focused                         Match only focused elements
+    --enabled / --no-enabled          Match by enabled state
+    --checked / --no-checked          Match by checked state
+    --selected / --no-selected        Match by selected state
+    --below <text>                    Match element below the given reference
+    --above <text>                    Match element above the given reference
+    --left-of <text>                  Match element left of the given reference
+    --right-of <text>                 Match element right of the given reference
+  assert-not-visible <element>        Assert element is absent from screen
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --timeout <ms>                    Max check time in milliseconds (default: 1000)
+  open-link <url>                     Open a URL / deep link
+  set-location --lat <n> --lng <n>    Set GPS coordinates
+  set-orientation <portrait|landscape> Set device orientation
+  screenshot [--output <path>]        Take screenshot
+  inspect                             Print UI hierarchy
+  run-flow <file> [--device <id>]     Run a Maestro YAML flow file
+    --env KEY=VALUE                   Inject env var (repeatable; overrides flow env block)
+    --benchmark                       Print elapsed time for each command and total flow time
+  run-flow-inline <yaml>              Run inline YAML commands
+    --benchmark                       Print elapsed time for each command and total flow time
+  session [--clear] [--list]          Show, clear, or list device sessions
+  cheat-sheet                         Print command reference
+  install                             Install/reinstall Claude Code plugin
+  daemon-start                        Start background daemon (manages driver process)
+  daemon-stop [--all]                 Stop background daemon (--all stops every session's daemon)
+  daemon-status                       Show daemon status
+  device-pool --list                  List all devices and pool status
+  device-pool --acquire               Claim a free device (prints device ID)
+  device-pool --release <id>          Release a device back to the pool
+  run-parallel --flows-dir <path>     Run flows in parallel across all devices
+
+Options:
+  --device <id>     Target device ID (also keys the session and daemon)
+  --json            Output as machine-readable JSON
+  --verbose, -v     Log daemon calls, fallbacks, and raw output
+  --help, -h        Show this help
+`.trim();
+async function main() {
+    (0, update_check_js_1.checkForUpdates)();
+    const argv = (0, minimist_1.default)(process.argv.slice(2), {
+        boolean: [
+            'json',
+            'help',
+            'clear',
+            'list',
+            'verbose',
+            'skills',
+            'all',
+            'acquire',
+            'release',
+            'clear-state',
+            'clear-keychain',
+            'stop-app',
+            'long-press',
+            'double-tap',
+            'optional',
+            'benchmark',
+        ],
+        string: [
+            'device',
+            'output',
+            'direction',
+            'flows-dir',
+            'yaml',
+            'id',
+            'text',
+            'start',
+            'end',
+            'env',
+            'below',
+            'above',
+            'left-of',
+            'right-of',
+            'lat',
+            'lng',
+            'platform',
+            'os-version',
+            'avd',
+        ],
+        alias: { h: 'help', v: 'verbose' },
+    });
+    if (argv['verbose'])
+        (0, verbose_js_1.setVerbose)(true);
+    const [command, ...rest] = argv._;
+    const opts = { json: argv['json'] };
+    // The device ID is the natural key for both the session file and the daemon.
+    // Use --device if given, otherwise detect the first booted device, otherwise 'default'.
+    const explicitDevice = argv['device'];
+    const sessionName = explicitDevice ?? (await (0, runner_js_1.detectFirstDevice)()) ?? 'default';
+    if (!command || argv['help']) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    let exitCode = 0;
+    switch (command) {
+        case 'start-device':
+            exitCode = await (0, start_device_js_1.startDevice)(argv['platform'], opts, {
+                osVersion: argv['os-version'],
+                avd: argv['avd'],
+            });
+            break;
+        case 'list-devices':
+            exitCode = await (0, list_devices_js_1.listDevices)(opts);
+            break;
+        case 'foreground-app':
+            exitCode = await (0, foreground_app_js_1.foregroundApp)(opts, sessionName);
+            break;
+        case 'list-apps':
+            exitCode = await (0, list_apps_js_1.listApps)(opts, sessionName);
+            break;
+        case 'launch-app': {
+            const appId = rest[0] ?? '';
+            // --argument key=value (repeatable) → Record<string, string>
+            const rawArgs = argv['argument'] ?? argv['arg'];
+            const argPairs = Array.isArray(rawArgs) ? rawArgs : rawArgs ? [rawArgs] : [];
+            const launchArgs = argPairs.length
+                ? Object.fromEntries(argPairs.map((a) => a.split('=', 2)))
+                : undefined;
+            exitCode = await (0, launch_app_js_1.launchApp)(appId, argv['device'], opts, sessionName, {
+                clearState: argv['clear-state'],
+                clearKeychain: argv['clear-keychain'],
+                stopApp: argv['stop-app'] !== false,
+                launchArgs,
+            });
+            break;
+        }
+        case 'stop-app': {
+            const appId = rest[0];
+            exitCode = await (0, stop_app_js_1.stopApp)(appId, opts, sessionName);
+            break;
+        }
+        case 'tap': {
+            const element = rest.join(' ');
+            exitCode = await (0, tap_js_1.tap)(element, opts, sessionName, {
+                id: argv['id'],
+                text: argv['text'],
+                index: argv['index'] !== undefined ? Number(argv['index']) : undefined,
+                longPress: argv['long-press'],
+                doubleTap: argv['double-tap'],
+                optional: argv['optional'],
+                focused: argv['focused'] !== undefined ? argv['focused'] : undefined,
+                enabled: argv['enabled'] !== undefined ? argv['enabled'] : undefined,
+                checked: argv['checked'] !== undefined ? argv['checked'] : undefined,
+                selected: argv['selected'] !== undefined ? argv['selected'] : undefined,
+                below: argv['below'],
+                above: argv['above'],
+                leftOf: argv['left-of'],
+                rightOf: argv['right-of'],
+            });
+            break;
+        }
+        case 'type': {
+            const text = rest.join(' ');
+            exitCode = await (0, type_js_1.typeText)(text, opts, sessionName);
+            break;
+        }
+        case 'erase-text': {
+            const n = rest[0] !== undefined
+                ? Number(rest[0])
+                : argv['characters'] !== undefined
+                    ? Number(argv['characters'])
+                    : 50;
+            exitCode = await (0, erase_text_js_1.eraseText)(n, opts, sessionName);
+            break;
+        }
+        case 'back':
+            exitCode = await (0, back_js_1.back)(opts, sessionName);
+            break;
+        case 'hide-keyboard':
+            exitCode = await (0, hide_keyboard_js_1.hideKeyboard)(opts, sessionName);
+            break;
+        case 'press-key': {
+            const key = rest[0] ?? '';
+            exitCode = await (0, press_key_js_1.pressKey)(key, opts, sessionName);
+            break;
+        }
+        case 'scroll': {
+            const dir = (argv['direction'] || 'down').toLowerCase();
+            exitCode = await (0, scroll_js_1.scroll)(dir, opts, sessionName);
+            break;
+        }
+        case 'swipe': {
+            const dir = argv['direction'] || '';
+            exitCode = await (0, swipe_js_1.swipe)(dir, opts, sessionName, {
+                start: argv['start'],
+                end: argv['end'],
+                duration: argv['duration'] !== undefined ? Number(argv['duration']) : undefined,
+            });
+            break;
+        }
+        case 'scroll-until-visible': {
+            const element = rest.join(' ');
+            const rawDir = (argv['direction'] || 'down').toLowerCase();
+            exitCode = await (0, scroll_until_visible_js_1.scrollUntilVisible)(element, opts, sessionName, {
+                id: argv['id'],
+                text: argv['text'],
+                index: argv['index'] !== undefined ? Number(argv['index']) : undefined,
+                direction: rawDir,
+                timeout: argv['timeout'] !== undefined ? Number(argv['timeout']) : undefined,
+                focused: argv['focused'] !== undefined ? argv['focused'] : undefined,
+                enabled: argv['enabled'] !== undefined ? argv['enabled'] : undefined,
+                checked: argv['checked'] !== undefined ? argv['checked'] : undefined,
+                selected: argv['selected'] !== undefined ? argv['selected'] : undefined,
+            });
+            break;
+        }
+        case 'assert-visible': {
+            const element = rest.join(' ');
+            exitCode = await (0, assert_visible_js_1.assertVisible)(element, opts, sessionName, {
+                id: argv['id'],
+                text: argv['text'],
+                index: argv['index'] !== undefined ? Number(argv['index']) : undefined,
+                timeout: argv['timeout'] !== undefined ? Number(argv['timeout']) : undefined,
+                optional: argv['optional'],
+                focused: argv['focused'] !== undefined ? argv['focused'] : undefined,
+                enabled: argv['enabled'] !== undefined ? argv['enabled'] : undefined,
+                checked: argv['checked'] !== undefined ? argv['checked'] : undefined,
+                selected: argv['selected'] !== undefined ? argv['selected'] : undefined,
+                below: argv['below'],
+                above: argv['above'],
+                leftOf: argv['left-of'],
+                rightOf: argv['right-of'],
+            });
+            break;
+        }
+        case 'assert-not-visible': {
+            const element = rest.join(' ');
+            exitCode = await (0, assert_not_visible_js_1.assertNotVisible)(element, opts, sessionName, {
+                id: argv['id'],
+                text: argv['text'],
+                index: argv['index'] !== undefined ? Number(argv['index']) : undefined,
+                timeout: argv['timeout'] !== undefined ? Number(argv['timeout']) : undefined,
+                focused: argv['focused'] !== undefined ? argv['focused'] : undefined,
+                enabled: argv['enabled'] !== undefined ? argv['enabled'] : undefined,
+                checked: argv['checked'] !== undefined ? argv['checked'] : undefined,
+                selected: argv['selected'] !== undefined ? argv['selected'] : undefined,
+                below: argv['below'],
+                above: argv['above'],
+                leftOf: argv['left-of'],
+                rightOf: argv['right-of'],
+            });
+            break;
+        }
+        case 'open-link': {
+            const url = rest[0] ?? argv['url'] ?? '';
+            exitCode = await (0, open_link_js_1.openLink)(url, opts, sessionName);
+            break;
+        }
+        case 'set-location': {
+            const lat = Number(argv['lat'] ?? argv['latitude']);
+            const lng = Number(argv['lng'] ?? argv['longitude']);
+            if (isNaN(lat) || isNaN(lng)) {
+                console.error('set-location requires --lat <n> --lng <n>');
+                exitCode = 1;
+            }
+            else {
+                exitCode = await (0, set_location_js_1.setLocation)(lat, lng, opts, sessionName);
+            }
+            break;
+        }
+        case 'set-orientation': {
+            const orientation = (rest[0] ??
+                argv['orientation'] ??
+                '').toLowerCase();
+            exitCode = await (0, set_orientation_js_1.setOrientation)(orientation, opts, sessionName);
+            break;
+        }
+        case 'screenshot': {
+            const outPath = argv['output'];
+            exitCode = await (0, screenshot_js_1.screenshot)(outPath, opts, sessionName);
+            break;
+        }
+        case 'inspect':
+            exitCode = await (0, inspect_js_1.inspect)(opts, sessionName);
+            break;
+        case 'run-flow': {
+            const file = rest[0] ?? '';
+            const rawEnv = argv['env'];
+            const envPairs = Array.isArray(rawEnv) ? rawEnv : rawEnv ? [rawEnv] : [];
+            const flowEnv = Object.fromEntries(envPairs.map((e) => e.split('=', 2)));
+            exitCode = await (0, run_flow_js_1.runFlow)(file, opts, sessionName, flowEnv, argv['benchmark']);
+            break;
+        }
+        case 'run-flow-inline': {
+            const yaml = argv['yaml'] || rest.join(' ');
+            exitCode = await (0, run_flow_inline_js_1.runFlowInline)(yaml, opts, sessionName, argv['benchmark']);
+            break;
+        }
+        case 'session':
+            exitCode = await (0, session_js_1.sessionCmd)(argv['clear'], argv['list'], opts, sessionName);
+            break;
+        case 'cheat-sheet':
+            exitCode = await (0, cheat_sheet_js_1.cheatSheet)();
+            break;
+        case 'install':
+            exitCode = await (0, install_js_1.installSkills)(opts);
+            break;
+        case 'daemon-start':
+            exitCode = await (0, daemon_js_1.daemonStart)(opts, sessionName);
+            break;
+        case 'daemon-stop':
+            exitCode = await (0, daemon_js_1.daemonStop)(opts, sessionName, argv['all']);
+            break;
+        case 'daemon-status':
+            exitCode = await (0, daemon_js_1.daemonStatusCmd)(opts, sessionName);
+            break;
+        case 'device-pool': {
+            const acquire = argv['acquire'];
+            const release = argv['release'];
+            const releaseId = typeof argv['release'] === 'string' ? argv['release'] : rest[0];
+            const action = acquire ? 'acquire' : release || releaseId ? 'release' : 'list';
+            exitCode = await (0, device_pool_js_1.devicePool)(action, releaseId, opts);
+            break;
+        }
+        case 'run-parallel': {
+            const flowsDir = argv['flows-dir'] ?? rest[0] ?? '';
+            exitCode = await (0, run_parallel_js_1.runParallel)(flowsDir, opts);
+            break;
+        }
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error('Run `conductor --help` for usage.');
+            exitCode = 1;
+    }
+    process.exit(exitCode);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+});

package/dist/output.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printSuccess = printSuccess;
+exports.printError = printError;
+exports.printData = printData;
+exports.exit = exit;
+function printSuccess(message, opts) {
+    if (opts?.json) {
+        console.log(JSON.stringify({ status: 'ok', message }));
+    }
+    else {
+        console.log(`✓ ${message}`);
+    }
+}
+function printError(message, opts) {
+    if (opts?.json) {
+        console.log(JSON.stringify({ status: 'error', message }));
+    }
+    else {
+        console.error(`✗ ${message}`);
+    }
+}
+function printData(data, opts) {
+    if (opts?.json) {
+        console.log(JSON.stringify(data));
+    }
+    else if (typeof data === 'string') {
+        console.log(data);
+    }
+    else {
+        console.log(JSON.stringify(data, null, 2));
+    }
+}
+function exit(code) {
+    process.exit(code);
+}

package/dist/pkg-root.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPkgRoot = findPkgRoot;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Walk up from __dirname to find the package root (the directory containing
+ * package.json). This handles both the normal build (dist/...) and the test
+ * build (dist-tests/packages/cli/src/...) where __dirname has extra path
+ * levels, making a fixed relative path incorrect.
+ */
+function findPkgRoot(fromDir) {
+    let dir = fromDir;
+    while (true) {
+        if (fs_1.default.existsSync(path_1.default.join(dir, 'package.json'))) {
+            return dir;
+        }
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: two levels up from the file's directory (dist/commands/ → pkg root)
+    return path_1.default.join(fromDir, '..', '..');
+}

package/dist/postinstall.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const install_js_1 = require("./commands/install.js");
+// Runs as `postinstall` after `npm install -g @houwert/conductor`.
+// Silent on failure so it never breaks the npm install.
+try {
+    (0, install_js_1.installPlugin)();
+    process.stdout.write('✓ Conductor Claude Code plugin installed\n');
+}
+catch {
+    // Silent on failure — never break npm install
+}