@houwert/conductor 0.21.0 → 0.23.0

package/dist/commands/assert-not-visible.js

@@ -11,6 +11,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const wait_js_1 = require("../drivers/wait.js");
 async function assertNotVisible(element, opts = {}, sessionName = 'default', flags = {}) {
     if (!element && !flags.id && !flags.text) {
@@ -42,7 +43,8 @@ async function assertNotVisible(element, opts = {}, sessionName = 'default', fla
         else if (driver instanceof web_js_1.WebDriver) {
             await (0, wait_js_1.waitUntilWebElementGone)(() => driver.viewHierarchy(), sel, flags.timeout);
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+            // Vega emits uiautomator-style XML, so it reuses the Android resolver.
             await (0, wait_js_1.waitUntilAndroidElementGone)(() => driver.viewHierarchy(), sel, flags.timeout);
         }
         (0, output_js_1.printSuccess)(`assert-not-visible ${label} — element not found`, opts);

package/dist/commands/assert-visible.js

@@ -21,6 +21,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const wait_js_1 = require("../drivers/wait.js");
 const direct_ios_selector_js_1 = require("../drivers/direct-ios-selector.js");
 async function assertVisible(element, opts = {}, sessionName = 'default', flags = {}) {
@@ -55,7 +56,8 @@ async function assertVisible(element, opts = {}, sessionName = 'default', flags
             else if (driver instanceof web_js_1.WebDriver) {
                 return (0, wait_js_1.waitForWebElement)(() => driver.viewHierarchy(), sel, timeoutMs);
             }
-            else if (driver instanceof android_js_1.AndroidDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+                // Vega emits uiautomator-style XML, so it reuses the Android resolver.
                 return (0, wait_js_1.waitForAndroidElement)(() => driver.viewHierarchy(), sel, timeoutMs);
             }
         };

package/dist/commands/back.js

@@ -8,6 +8,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 async function back(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
@@ -19,6 +20,9 @@ async function back(opts = {}, sessionName = 'default') {
         else if (driver instanceof web_js_1.WebDriver) {
             await driver.goBack();
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            await driver.back();
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.back(); // adb shell input keyevent 4
         }

package/dist/commands/capture-ui.js

@@ -13,6 +13,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const a11y_js_1 = require("../drivers/a11y.js");
 const snapshot_store_js_1 = require("../snapshot-store.js");
 async function captureUI(outputPath, opts = {}, sessionName = 'default') {
@@ -66,8 +67,9 @@ async function captureUI(outputPath, opts = {}, sessionName = 'default') {
             a11ySnapshot = built.a11ySnapshot;
             screenshotBuf = shot;
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
-            platform = 'android';
+        else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+            // Vega emits uiautomator-style XML, so it reuses the Android a11y builder.
+            platform = driver instanceof vega_js_1.VegaDriver ? 'vega' : 'android';
             const [info, xml, shot] = await Promise.all([
                 driver.deviceInfo(),
                 driver.viewHierarchy(),

package/dist/commands/clipboard.js

@@ -12,6 +12,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const ANDROID_MSG = 'clipboard is iOS-only. On Android, use `conductor input-text` to type instead.';
 async function clipboardRead(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
@@ -21,6 +22,8 @@ async function clipboardRead(opts = {}, sessionName = 'default') {
             throw new Error(ANDROID_MSG);
         if (driver instanceof web_js_1.WebDriver)
             throw new Error('clipboard read is not supported on Web');
+        if (driver instanceof vega_js_1.VegaDriver)
+            throw new Error('clipboard read is not supported on vega');
         return '';
     }, sessionName);
     if (result.success) {
@@ -46,6 +49,9 @@ async function clipboardWrite(text, opts = {}, sessionName = 'default') {
         else if (driver instanceof web_js_1.WebDriver) {
             throw new Error('clipboard write is not supported on Web');
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            throw new Error('clipboard write is not supported on vega');
+        }
     }, sessionName);
     if (result.success) {
         (0, output_js_1.printSuccess)('clipboard write — done', opts);
@@ -72,6 +78,9 @@ async function paste(opts = {}, sessionName = 'default') {
         else if (driver instanceof web_js_1.WebDriver) {
             throw new Error('paste is not supported on Web');
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            throw new Error('paste is not supported on vega');
+        }
     }, sessionName);
     if (result.success) {
         (0, output_js_1.printSuccess)('paste — done', opts);

package/dist/commands/crashes.js

@@ -175,6 +175,11 @@ async function crashesList(opts, sessionName, listOpts) {
     if (platform === 'android' && sessionName !== 'default') {
         reports.push(...(await listAndroidReports(sessionName, { app: listOpts.app, sinceMs })));
     }
+    else if (platform === 'vega') {
+        // No crash-log retrieval channel on Vega in v1.
+        if (!opts.json)
+            console.error('note: crash reports are not supported on vega (Amazon Fire TV)');
+    }
     if (opts.json) {
         (0, output_js_1.printData)({ count: reports.length, reports }, opts);
     }

package/dist/commands/delete-device.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HELP = void 0;
 exports.deleteDevice = deleteDevice;
 exports.HELP = `  delete-device <name-or-id>
-    --platform <ios|tvos|android|web> Scope to a single platform
+    --platform <ios|tvos|android|web> Scope to a single platform (Vega VVDs are managed by Amazon's tooling)
     --all                             Delete all shutdown simulators / non-running AVDs / web sessions`;
 const fs_1 = __importDefault(require("fs"));
 const runner_js_1 = require("../runner.js");
@@ -105,6 +105,11 @@ async function deleteDevice(nameOrId, opts, flags) {
         return 1;
     }
     const platform = flags.platform?.toLowerCase();
+    // Vega VVD lifecycle is owned by Amazon's tooling — we can't delete one.
+    if (platform === 'vega' || (nameOrId && nameOrId.startsWith('vega:'))) {
+        (0, output_js_1.printError)("delete-device is not supported on vega (Amazon Fire TV) — manage VVDs via Amazon's tooling.", opts);
+        return 1;
+    }
     const includeIOS = !platform || platform === 'ios';
     const includeTvOS = !platform || platform === 'tvos';
     const includeAndroid = !platform || platform === 'android';

package/dist/commands/download-app.js

@@ -33,6 +33,10 @@ async function downloadApp(appId, output, opts = {}, sessionName = 'default') {
         (0, output_js_1.printError)('download-app is not supported on web.', opts);
         return 1;
     }
+    if (platform === 'vega') {
+        (0, output_js_1.printError)('download-app is not supported on vega (Amazon Fire TV).', opts);
+        return 1;
+    }
     if (platform === 'ios' || platform === 'tvos') {
         // Get the .app bundle path from the simulator
         const getPath = await (0, runner_js_1.spawnCommand)('xcrun', [

package/dist/commands/erase-text.js

@@ -8,9 +8,10 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 async function eraseText(characters, opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
-        if (driver instanceof android_js_1.AndroidDriver) {
+        if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
             await driver.eraseAllText(characters);
         }
         else if (driver instanceof web_js_1.WebDriver) {

package/dist/commands/focused.js

@@ -9,6 +9,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const element_resolver_js_1 = require("../drivers/element-resolver.js");
 // XCUIElementType rawValue → human-readable name.
 // Source: XCUIElementType enum in XCTest framework.
@@ -206,7 +207,8 @@ async function queryFocused(driver) {
         const node = findFocusedWeb(hierarchy.elements);
         return node ? formatWebElement(node) : null;
     }
-    else if (driver instanceof android_js_1.AndroidDriver) {
+    else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+        // Vega emits uiautomator-style XML, so it reuses the Android parser.
         const xml = await driver.viewHierarchy();
         const nodes = (0, element_resolver_js_1.parseAndroidHierarchy)(xml);
         const node = nodes.find((n) => n.focused);

package/dist/commands/foreground-app.js

@@ -9,6 +9,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
         return sessionName;
@@ -40,7 +41,7 @@ async function foregroundApp(opts = {}, sessionName = 'default') {
         else if (driver instanceof web_js_1.WebDriver) {
             appId = await driver.runningApp();
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
             appId = await driver.getForegroundApp();
         }
         else {

package/dist/commands/gestures.js

@@ -19,6 +19,7 @@ const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 function parseCenter(s) {
     if (!s)
         return null;
@@ -108,6 +109,8 @@ async function pinch(opts, sessionName, pinchOpts) {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof web_js_1.WebDriver)
             throw new Error('pinch is not supported on Web');
+        if (driver instanceof vega_js_1.VegaDriver)
+            throw new Error('pinch is not supported on vega (Amazon Fire TV)');
         const { width, height, cx: defCx, cy: defCy } = await screenCenter(driver);
         const center = parseCenter(pinchOpts.center) ?? { x: defCx, y: defCy };
         // Start span is half the shorter screen dimension; end is scaled.
@@ -130,6 +133,8 @@ async function rotateGesture(opts, sessionName, rotateOpts) {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof web_js_1.WebDriver)
             throw new Error('rotate-gesture is not supported on Web');
+        if (driver instanceof vega_js_1.VegaDriver)
+            throw new Error('rotate-gesture is not supported on vega (Amazon Fire TV)');
         const { width, height, cx: defCx, cy: defCy } = await screenCenter(driver);
         const center = parseCenter(rotateOpts.center) ?? { x: defCx, y: defCy };
         const radius = Math.min(width, height) * 0.25;
@@ -185,6 +190,8 @@ async function gesture(rawJson, filePath, opts, sessionName) {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof web_js_1.WebDriver)
             throw new Error('gesture is not supported on Web');
+        if (driver instanceof vega_js_1.VegaDriver)
+            throw new Error('gesture is not supported on vega (Amazon Fire TV)');
         await playPaths(driver, paths);
     }, sessionName);
     if (result.success) {

package/dist/commands/hide-keyboard.js

@@ -8,6 +8,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 async function hideKeyboard(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
@@ -18,6 +19,9 @@ async function hideKeyboard(opts = {}, sessionName = 'default') {
         else if (driver instanceof web_js_1.WebDriver) {
             // No virtual keyboard on web — no-op
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            // Vega has no keyboard-hide primitive — no-op
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.pressKeyEvent(111); // KEYCODE_ESCAPE
         }

package/dist/commands/inspect.js

@@ -9,6 +9,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const element_resolver_js_1 = require("../drivers/element-resolver.js");
 const a11y_js_1 = require("../drivers/a11y.js");
 async function inspect(opts = {}, sessionName = 'default', inspectOpts = {}) {
@@ -28,7 +29,7 @@ async function inspect(opts = {}, sessionName = 'default', inspectOpts = {}) {
                 const hierarchy = await driver.viewHierarchy(false);
                 hit = (0, element_resolver_js_1.findIOSViewAtPoint)(hierarchy.axElement, x, y, tappable);
             }
-            else if (driver instanceof android_js_1.AndroidDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
                 const xml = await driver.viewHierarchy();
                 hit = (0, element_resolver_js_1.findAndroidViewAtPoint)(xml, x, y, tappable);
             }
@@ -67,7 +68,7 @@ async function inspect(opts = {}, sessionName = 'default', inspectOpts = {}) {
                 const built = (0, a11y_js_1.buildWebA11y)(vh);
                 raw = JSON.stringify({ ...vh, elements: built.hierarchy }, null, 2);
             }
-            else if (driver instanceof android_js_1.AndroidDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
                 const xml = await driver.viewHierarchy();
                 const built = (0, a11y_js_1.buildAndroidA11y)(xml);
                 raw = JSON.stringify(built.hierarchy, null, 2);
@@ -92,7 +93,7 @@ async function inspect(opts = {}, sessionName = 'default', inspectOpts = {}) {
             const hierarchy = await driver.viewHierarchy();
             text = (0, element_resolver_js_1.inspectWebToText)(hierarchy);
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
             const xml = await driver.viewHierarchy();
             text = (0, element_resolver_js_1.inspectAndroidToText)(xml);
         }

package/dist/commands/install-app.js

@@ -8,6 +8,7 @@ const sdk_js_1 = require("../android/sdk.js");
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");
 const bootstrap_js_1 = require("../drivers/bootstrap.js");
+const cli_js_1 = require("../drivers/vega/cli.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
         return sessionName;
@@ -29,6 +30,16 @@ async function installApp(appPath, opts = {}, sessionName = 'default') {
         (0, output_js_1.printError)('install-app is not supported on web. Use launch-app with a URL instead.', opts);
         return 1;
     }
+    else if (platform === 'vega') {
+        // Vega installs a `.vpkg` through Amazon's CLI; strip the `vega:` id prefix.
+        try {
+            await new cli_js_1.VegaCli(deviceId.replace(/^vega:/, '')).installApp(appPath);
+        }
+        catch (e) {
+            (0, output_js_1.printError)(`install-app failed: ${e instanceof Error ? e.message : String(e)}`, opts);
+            return 1;
+        }
+    }
     else if (platform === 'ios' || platform === 'tvos') {
         const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'install', deviceId, appPath]);
         if (!result.success) {

package/dist/commands/launch-app.js

@@ -19,6 +19,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 async function launchApp(appId, deviceId, opts = {}, sessionName = 'default', flags = {}) {
     if (!appId) {
         (0, output_js_1.printError)('launch-app requires <appId>', opts);
@@ -40,6 +41,8 @@ async function launchApp(appId, deviceId, opts = {}, sessionName = 'default', fl
                 await driver.terminateApp(appId);
             else if (driver instanceof web_js_1.WebDriver)
                 await driver.terminateApp();
+            else if (driver instanceof vega_js_1.VegaDriver)
+                await driver.terminateApp(appId);
             else if (driver instanceof android_js_1.AndroidDriver)
                 await driver.stopApp(appId);
         }
@@ -49,6 +52,9 @@ async function launchApp(appId, deviceId, opts = {}, sessionName = 'default', fl
         else if (driver instanceof web_js_1.WebDriver) {
             await driver.launchApp(appId);
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            await driver.launchApp(appId, flags.launchArgs);
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.launchApp(appId, flags.launchArgs);
         }

package/dist/commands/list-apps.js

@@ -8,6 +8,7 @@ const sdk_js_1 = require("../android/sdk.js");
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");
 const bootstrap_js_1 = require("../drivers/bootstrap.js");
+const cli_js_1 = require("../drivers/vega/cli.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
         return sessionName;
@@ -26,6 +27,10 @@ async function listApps(opts = {}, sessionName = 'default') {
         (0, output_js_1.printError)('list-apps is not supported on web. Use foreground-app to get the current URL.', opts);
         return 1;
     }
+    else if (platform === 'vega') {
+        // Vega is driven through Amazon's CLI, not adb; strip the `vega:` id prefix.
+        appIds = (await new cli_js_1.VegaCli(deviceId.replace(/^vega:/, '')).listInstalledApps()).sort();
+    }
     else if (platform === 'ios' || platform === 'tvos') {
         const result = await (0, runner_js_1.spawnCommand)('bash', [
             '-c',

package/dist/commands/list-devices.js

@@ -15,6 +15,7 @@ const output_js_1 = require("../output.js");
 const bootstrap_js_1 = require("../drivers/bootstrap.js");
 const client_js_1 = require("../daemon/client.js");
 const protocol_js_1 = require("../daemon/protocol.js");
+const cli_js_1 = require("../drivers/vega/cli.js");
 // Captured during discoverAvailableDevices so listDevices() can report it.
 // Module-scoped because the discover function returns Device[]; bolting an
 // extra return field onto the public type would ripple beyond this fix.
@@ -88,6 +89,21 @@ async function discoverBootedDevices() {
             }
         }
     }
+    // Vega (Amazon Fire TV): booted devices reported by the vega CLI. Best-effort —
+    // the CLI is absent unless the Vega SDK is installed.
+    try {
+        for (const d of await new cli_js_1.VegaCli().listDevices()) {
+            devices.push({
+                id: `vega:${d.serial}`,
+                name: d.description,
+                platform: 'vega',
+                status: 'booted',
+            });
+        }
+    }
+    catch {
+        /* vega CLI not installed */
+    }
     return devices;
 }
 async function discoverAvailableDevices() {

package/dist/commands/memory.js

@@ -1116,6 +1116,11 @@ async function memory(appIdArg, opts = {}, sessionName = 'default', memOpts = {}
         return 1;
     }
     const platform = await (0, bootstrap_js_1.detectPlatform)(deviceId);
+    if (platform === 'vega') {
+        // Memory relies on adb/simctl host tooling that has no Vega equivalent yet.
+        (0, output_js_1.printError)('memory is not yet supported on vega (Amazon Fire TV)', opts);
+        return 1;
+    }
     let report;
     if (platform === 'web') {
         report = await collectWeb(deviceId, sessionName, memOpts);

package/dist/commands/press-key.js

@@ -2,12 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VALID_KEYS = exports.HELP = void 0;
 exports.pressKey = pressKey;
-exports.HELP = `  press-key <key>                     Press a key (Enter, Backspace, Home, ...)`;
+exports.HELP = `  press-key <key>                     Press a key (Enter, Backspace, Home, ...)
+    --long-press                      Hold the button ~1.5s (tvOS remote buttons)
+    --duration <seconds>              Hold for a custom duration (tvOS remote buttons)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 exports.VALID_KEYS = [
     'Enter',
     'Backspace',
@@ -67,6 +70,22 @@ const TVOS_REMOTE_BUTTONS = {
     'Remote Menu': 'menu',
     'Remote Media Play Pause': 'playPause',
 };
+// vega (Amazon Fire TV) remote: map key names to VegaDriver button values.
+const VEGA_REMOTE_BUTTONS = {
+    'Remote Dpad Up': 'up',
+    'Remote Dpad Down': 'down',
+    'Remote Dpad Left': 'left',
+    'Remote Dpad Right': 'right',
+    'Remote Dpad Center': 'select',
+    'Remote Menu': 'menu',
+    'Remote Media Play Pause': 'playPause',
+    'Remote Media Rewind': 'rewind',
+    'Remote Media Fast Forward': 'fastForward',
+    Home: 'home',
+    Back: 'back',
+    VolumeUp: 'volumeUp',
+    VolumeDown: 'volumeDown',
+};
 // Android keyevent codes
 const ANDROID_KEYCODE = {
     Home: 3,
@@ -105,7 +124,9 @@ const ANDROID_KEYCODE = {
     'TV Input HDMI 2': 244,
     'TV Input HDMI 3': 245,
 };
-async function pressKey(key, opts = {}, sessionName = 'default') {
+async function pressKey(key, opts = {}, sessionName = 'default', flags = {}) {
+    // A held press is requested via --long-press (default 1.5s) or an explicit --duration.
+    const holdSeconds = flags.duration ?? (flags.longPress ? 1.5 : undefined);
     if (!key) {
         (0, output_js_1.printError)(`press-key requires <key>. Valid keys: ${exports.VALID_KEYS.join(', ')}`, opts);
         return 1;
@@ -121,10 +142,10 @@ async function pressKey(key, opts = {}, sessionName = 'default') {
                 const tvosButton = TVOS_REMOTE_BUTTONS[matched];
                 const iosButton = IOS_BUTTON_MAP[matched];
                 if (tvosButton) {
-                    await driver.pressButton(tvosButton);
+                    await driver.pressButton(tvosButton, holdSeconds);
                 }
                 else if (iosButton) {
-                    await driver.pressButton(iosButton);
+                    await driver.pressButton(iosButton, holdSeconds);
                 }
                 // Keys not mapped on tvOS are silently ignored
             }
@@ -162,6 +183,13 @@ async function pressKey(key, opts = {}, sessionName = 'default') {
                 await driver.pressKey(webKey);
             }
         }
+        else if (driver instanceof vega_js_1.VegaDriver) {
+            const vegaButton = VEGA_REMOTE_BUTTONS[matched];
+            if (vegaButton) {
+                await driver.pressButton(vegaButton);
+            }
+            // Keys not mapped on vega are silently ignored
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             const code = ANDROID_KEYCODE[matched];
             if (code !== undefined) {

package/dist/commands/profile.js

@@ -99,6 +99,11 @@ async function profileCpu(opts, sessionName, profileOpts) {
         else if (platform === 'android') {
             await recordAndroidCpu(sessionName, profileOpts.appId, profileOpts.durationSec, out);
         }
+        else if (platform === 'vega') {
+            // No native CPU-trace tooling (xctrace/simpleperf) on Vega yet.
+            (0, output_js_1.printError)('profile cpu is not yet supported on vega (Amazon Fire TV)', opts);
+            return 1;
+        }
         else {
             (0, output_js_1.printError)(`profile cpu is not supported on platform ${platform ?? '(unknown)'}`, opts);
             return 1;

package/dist/commands/screenshot.js

@@ -27,6 +27,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const wait_js_1 = require("../drivers/wait.js");
 const direct_ios_selector_js_1 = require("../drivers/direct-ios-selector.js");
 const png_crop_js_1 = require("../png-crop.js");
@@ -84,7 +85,8 @@ async function screenshot(outputPath, opts = {}, sessionName = 'default', fullPa
                 hierarchyH = info.heightPixels;
                 el = await (0, wait_js_1.waitForWebElement)(() => driver.viewHierarchy(), sel);
             }
-            else if (driver instanceof android_js_1.AndroidDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+                // Vega emits uiautomator-style XML, so it reuses the Android resolver.
                 const xml = await driver.viewHierarchy();
                 // Android XML root bounds: derive from the first parseable <node bounds="[0,0][W,H]">
                 const m = xml.match(/<node[^>]*bounds="\[0,0\]\[(\d+),(\d+)\]"/);

package/dist/commands/scroll-until-visible.js

@@ -12,6 +12,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const element_resolver_js_1 = require("../drivers/element-resolver.js");
 const direct_ios_selector_js_1 = require("../drivers/direct-ios-selector.js");
 const utils_js_1 = require("../utils.js");
@@ -77,7 +78,8 @@ async function scrollUntilVisible(element, opts = {}, sessionName = 'default', f
                     const { widthPixels: w, heightPixels: h } = info;
                     await driver.swipe(coords.startX * w, coords.startY * h, coords.endX * w, coords.endY * h, 500);
                 }
-                else if (driver instanceof android_js_1.AndroidDriver) {
+                else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
+                    // Vega emits uiautomator-style XML, so it reuses the Android resolver.
                     const xml = await driver.viewHierarchy();
                     if ((0, element_resolver_js_1.findAndroidElement)(xml, sel)) {
                         (0, output_js_1.printSuccess)(`scroll-until-visible ${label} — found`, opts);

package/dist/commands/scroll.js

@@ -8,6 +8,7 @@ const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
 const android_js_1 = require("../drivers/android.js");
 const web_js_1 = require("../drivers/web.js");
+const vega_js_1 = require("../drivers/vega.js");
 const utils_js_1 = require("../utils.js");
 async function scroll(direction = 'down', opts = {}, sessionName = 'default') {
     const valid = ['down', 'up', 'left', 'right'];
@@ -31,7 +32,7 @@ async function scroll(direction = 'down', opts = {}, sessionName = 'default') {
             const { widthPixels: w, heightPixels: h } = info;
             await driver.swipe(coords.startX * w, coords.startY * h, coords.endX * w, coords.endY * h, 500);
         }
-        else if (driver instanceof android_js_1.AndroidDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver || driver instanceof vega_js_1.VegaDriver) {
             const info = await driver.deviceInfo();
             const { widthPixels: w, heightPixels: h } = info;
             await driver.swipe(coords.startX * w, coords.startY * h, coords.endX * w, coords.endY * h, 500);