@houwert/conductor 0.29.3 → 0.31.0

package/README.md

@@ -26,7 +26,7 @@ conductor assert-visible "Dashboard"
 conductor take-screenshot --output /tmp/screen.png
 ```
 
-Targets iOS and tvOS simulators, physical iOS/tvOS devices, Android emulators and devices, Amazon Fire TV, and web via Playwright.
+Targets iOS and tvOS simulators, physical iOS/tvOS devices, Android emulators and devices, Amazon Fire TV, Roku, and web via Playwright.
 
 ## Quick start
 

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

@@ -12,6 +12,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 const wait_js_1 = require("../drivers/wait.js");
 async function assertNotVisible(element, opts = {}, sessionName = 'default', flags = {}) {
     if (!element && !flags.id && !flags.text) {
@@ -43,7 +44,9 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver ||
+            driver instanceof vega_js_1.VegaDriver ||
+            driver instanceof roku_js_1.RokuDriver) {
             // Vega emits uiautomator-style XML, so it reuses the Android resolver.
             await (0, wait_js_1.waitUntilAndroidElementGone)(() => driver.viewHierarchy(), sel, flags.timeout);
         }

package/dist/commands/assert-visible.js

@@ -22,6 +22,7 @@ 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 roku_js_1 = require("../drivers/roku.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 = {}) {
@@ -56,8 +57,10 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
-                // Vega emits uiautomator-style XML, so it reuses the Android resolver.
+            else if (driver instanceof android_js_1.AndroidDriver ||
+                driver instanceof vega_js_1.VegaDriver ||
+                driver instanceof roku_js_1.RokuDriver) {
+                // Vega and Roku emit uiautomator-style XML, so they reuse the Android resolver.
                 return (0, wait_js_1.waitForAndroidElement)(() => driver.viewHierarchy(), sel, timeoutMs);
             }
         };

package/dist/commands/back.js

@@ -9,6 +9,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 async function back(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
@@ -20,7 +21,7 @@ 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) {
+        else if (driver instanceof vega_js_1.VegaDriver || driver instanceof roku_js_1.RokuDriver) {
             await driver.back();
         }
         else if (driver instanceof android_js_1.AndroidDriver) {

package/dist/commands/capture-ui.js

@@ -14,6 +14,7 @@ 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 roku_js_1 = require("../drivers/roku.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') {
@@ -67,9 +68,12 @@ async function captureUI(outputPath, opts = {}, sessionName = 'default') {
             a11ySnapshot = built.a11ySnapshot;
             screenshotBuf = shot;
         }
-        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';
+        else if (driver instanceof android_js_1.AndroidDriver ||
+            driver instanceof vega_js_1.VegaDriver ||
+            driver instanceof roku_js_1.RokuDriver) {
+            // Vega and Roku emit uiautomator-style XML, so they reuse the Android a11y builder.
+            platform =
+                driver instanceof vega_js_1.VegaDriver ? 'vega' : driver instanceof roku_js_1.RokuDriver ? 'roku' : 'android';
             const [info, xml, shot] = await Promise.all([
                 driver.deviceInfo(),
                 driver.viewHierarchy(),

package/dist/commands/clipboard.js

@@ -13,6 +13,7 @@ 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 roku_js_1 = require("../drivers/roku.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) => {
@@ -24,6 +25,8 @@ async function clipboardRead(opts = {}, sessionName = 'default') {
             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');
+        if (driver instanceof roku_js_1.RokuDriver)
+            throw new Error('clipboard read is not supported on roku');
         return '';
     }, sessionName);
     if (result.success) {
@@ -52,6 +55,9 @@ async function clipboardWrite(text, opts = {}, sessionName = 'default') {
         else if (driver instanceof vega_js_1.VegaDriver) {
             throw new Error('clipboard write is not supported on vega');
         }
+        else if (driver instanceof roku_js_1.RokuDriver) {
+            throw new Error('clipboard write is not supported on roku');
+        }
     }, sessionName);
     if (result.success) {
         (0, output_js_1.printSuccess)('clipboard write — done', opts);
@@ -81,6 +87,9 @@ async function paste(opts = {}, sessionName = 'default') {
         else if (driver instanceof vega_js_1.VegaDriver) {
             throw new Error('paste is not supported on vega');
         }
+        else if (driver instanceof roku_js_1.RokuDriver) {
+            throw new Error('paste is not supported on roku');
+        }
     }, sessionName);
     if (result.success) {
         (0, output_js_1.printSuccess)('paste — done', opts);

package/dist/commands/copy-text-from.js

@@ -12,6 +12,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 const wait_js_1 = require("../drivers/wait.js");
 const direct_ios_selector_js_1 = require("../drivers/direct-ios-selector.js");
 async function copyTextFrom(query, opts = {}, sessionName = 'default', flags = {}) {
@@ -33,7 +34,7 @@ async function copyTextFrom(query, opts = {}, sessionName = 'default', flags = {
         else if (driver instanceof web_js_1.WebDriver) {
             el = await (0, wait_js_1.waitForWebElement)(() => driver.viewHierarchy(), sel);
         }
-        else if (driver instanceof vega_js_1.VegaDriver) {
+        else if (driver instanceof vega_js_1.VegaDriver || driver instanceof roku_js_1.RokuDriver) {
             el = await (0, wait_js_1.waitForAndroidElement)(() => driver.viewHierarchy(), sel);
         }
         else if (driver instanceof android_js_1.AndroidDriver) {

package/dist/commands/crashes.js

@@ -180,6 +180,11 @@ async function crashesList(opts, sessionName, listOpts) {
         if (!opts.json)
             console.error('note: crash reports are not supported on vega (Amazon Fire TV)');
     }
+    else if (platform === 'roku') {
+        // ECP exposes no crash log; Roku's are read from the dev console by hand.
+        if (!opts.json)
+            console.error('note: crash reports are not supported on roku');
+    }
     if (opts.json) {
         (0, output_js_1.printData)({ count: reports.length, reports }, opts);
     }

package/dist/commands/delete-device.js

@@ -110,6 +110,11 @@ async function deleteDevice(nameOrId, opts, flags) {
         (0, output_js_1.printError)("delete-device is not supported on vega (Amazon Fire TV) — manage VVDs via Amazon's tooling.", opts);
         return 1;
     }
+    // A Roku is physical hardware conductor never created.
+    if (platform === 'roku' || (nameOrId && nameOrId.startsWith('roku:'))) {
+        (0, output_js_1.printError)('delete-device is not supported on roku — it is physical hardware.', opts);
+        return 1;
+    }
     const includeIOS = !platform || platform === 'ios';
     const includeTvOS = !platform || platform === 'tvos';
     const includeAndroid = !platform || platform === 'android';

package/dist/commands/download-app.js

@@ -37,6 +37,10 @@ async function downloadApp(appId, output, opts = {}, sessionName = 'default') {
         (0, output_js_1.printError)('download-app is not supported on vega (Amazon Fire TV).', opts);
         return 1;
     }
+    if (platform === 'roku') {
+        (0, output_js_1.printError)('download-app is not supported on roku.', 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

@@ -9,9 +9,12 @@ 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 roku_js_1 = require("../drivers/roku.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 || driver instanceof vega_js_1.VegaDriver) {
+        if (driver instanceof android_js_1.AndroidDriver ||
+            driver instanceof vega_js_1.VegaDriver ||
+            driver instanceof roku_js_1.RokuDriver) {
             await driver.eraseAllText(characters);
         }
         else if (driver instanceof web_js_1.WebDriver) {

package/dist/commands/focused.js

@@ -12,6 +12,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 const element_resolver_js_1 = require("../drivers/element-resolver.js");
 // XCUIElementType rawValue → human-readable name.
 // Source: XCUIElementType enum in XCTest framework.
@@ -209,8 +210,10 @@ async function queryFocused(driver) {
         const node = findFocusedWeb(hierarchy.elements);
         return node ? formatWebElement(node) : null;
     }
-    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.
+    else if (driver instanceof android_js_1.AndroidDriver ||
+        driver instanceof vega_js_1.VegaDriver ||
+        driver instanceof roku_js_1.RokuDriver) {
+        // Vega and Roku emit uiautomator-style XML, so they reuse 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

@@ -10,6 +10,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
         return sessionName;
@@ -41,7 +42,9 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver ||
+            driver instanceof vega_js_1.VegaDriver ||
+            driver instanceof roku_js_1.RokuDriver) {
             appId = await driver.getForegroundApp();
         }
         else {

package/dist/commands/gestures.js

@@ -20,6 +20,7 @@ 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");
+const roku_js_1 = require("../drivers/roku.js");
 function parseCenter(s) {
     if (!s)
         return null;
@@ -111,6 +112,8 @@ async function pinch(opts, sessionName, pinchOpts) {
             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)');
+        if (driver instanceof roku_js_1.RokuDriver)
+            throw new Error('pinch is not supported on roku — Roku is D-pad driven, with no touch input');
         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.
@@ -135,6 +138,8 @@ async function rotateGesture(opts, sessionName, rotateOpts) {
             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)');
+        if (driver instanceof roku_js_1.RokuDriver)
+            throw new Error('rotate-gesture is not supported on roku — Roku is D-pad driven, with no touch input');
         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;
@@ -192,6 +197,8 @@ async function gesture(rawJson, filePath, opts, sessionName) {
             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)');
+        if (driver instanceof roku_js_1.RokuDriver)
+            throw new Error('gesture is not supported on roku — Roku is D-pad driven, with no touch input');
         await playPaths(driver, paths);
     }, sessionName);
     if (result.success) {

package/dist/commands/hide-keyboard.js

@@ -9,6 +9,7 @@ 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 roku_js_1 = require("../drivers/roku.js");
 async function hideKeyboard(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
@@ -22,6 +23,10 @@ async function hideKeyboard(opts = {}, sessionName = 'default') {
         else if (driver instanceof vega_js_1.VegaDriver) {
             // Vega has no keyboard-hide primitive — no-op
         }
+        else if (driver instanceof roku_js_1.RokuDriver) {
+            // Roku dismisses its on-screen keyboard with Back.
+            await driver.back();
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.pressKeyEvent(111); // KEYCODE_ESCAPE
         }

package/dist/commands/inspect.js

@@ -10,6 +10,7 @@ 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 roku_js_1 = require("../drivers/roku.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 = {}) {
@@ -29,7 +30,9 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver ||
+                driver instanceof vega_js_1.VegaDriver ||
+                driver instanceof roku_js_1.RokuDriver) {
                 const xml = await driver.viewHierarchy();
                 hit = (0, element_resolver_js_1.findAndroidViewAtPoint)(xml, x, y, tappable);
             }
@@ -68,7 +71,9 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
+            else if (driver instanceof android_js_1.AndroidDriver ||
+                driver instanceof vega_js_1.VegaDriver ||
+                driver instanceof roku_js_1.RokuDriver) {
                 const xml = await driver.viewHierarchy();
                 const built = (0, a11y_js_1.buildAndroidA11y)(xml);
                 raw = JSON.stringify(built.hierarchy, null, 2);
@@ -93,7 +98,9 @@ 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 || driver instanceof vega_js_1.VegaDriver) {
+        else if (driver instanceof android_js_1.AndroidDriver ||
+            driver instanceof vega_js_1.VegaDriver ||
+            driver instanceof roku_js_1.RokuDriver) {
             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 devicectl_js_1 = require("../drivers/devicectl.js");
 const cli_js_1 = require("../drivers/vega/cli.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
@@ -30,6 +31,11 @@ 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 === 'roku') {
+        (0, output_js_1.printError)('install-app is not supported on roku — sideload the channel through the ' +
+            "device's developer web server (http://<device-ip>).", opts);
+        return 1;
+    }
     else if (platform === 'vega') {
         // Vega installs a `.vpkg` through Amazon's CLI; strip the `vega:` id prefix.
         try {
@@ -41,10 +47,21 @@ async function installApp(appPath, opts = {}, sessionName = 'default') {
         }
     }
     else if (platform === 'ios' || platform === 'tvos') {
-        const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'install', deviceId, appPath]);
-        if (!result.success) {
-            (0, output_js_1.printError)(`install-app failed: ${result.stderr}`, opts);
-            return 1;
+        if ((await (0, bootstrap_js_1.detectDeviceKind)(deviceId)) === 'physical') {
+            try {
+                await (0, devicectl_js_1.installApp)(deviceId, appPath);
+            }
+            catch (e) {
+                (0, output_js_1.printError)(`install-app failed: ${e instanceof Error ? e.message : String(e)}`, opts);
+                return 1;
+            }
+        }
+        else {
+            const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'install', deviceId, appPath]);
+            if (!result.success) {
+                (0, output_js_1.printError)(`install-app failed: ${result.stderr}`, opts);
+                return 1;
+            }
         }
     }
     else {

package/dist/commands/launch-app.js

@@ -28,6 +28,7 @@ const fs_1 = __importDefault(require("fs"));
 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 roku_js_1 = require("../drivers/roku.js");
 async function launchApp(appId, deviceId, opts = {}, sessionName = 'default', flags = {}) {
     if (!appId) {
         (0, output_js_1.printError)('launch-app requires <appId>', opts);
@@ -50,7 +51,7 @@ 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)
+            else if (driver instanceof vega_js_1.VegaDriver || driver instanceof roku_js_1.RokuDriver)
                 await driver.terminateApp(appId);
             else if (driver instanceof android_js_1.AndroidDriver)
                 await driver.stopApp(appId);
@@ -79,7 +80,7 @@ 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) {
+        else if (driver instanceof vega_js_1.VegaDriver || driver instanceof roku_js_1.RokuDriver) {
             await driver.launchApp(appId, flags.launchArgs);
         }
         else if (driver instanceof android_js_1.AndroidDriver) {

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 devicectl_js_1 = require("../drivers/devicectl.js");
 const cli_js_1 = require("../drivers/vega/cli.js");
 async function resolveDeviceId(sessionName) {
     if (sessionName !== 'default')
@@ -29,10 +30,25 @@ 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 === 'roku') {
+        // ECP can name only the *active* channel, not enumerate installed ones.
+        (0, output_js_1.printError)('list-apps is not supported on roku. Use foreground-app to get the active channel id.', 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') &&
+        (await (0, bootstrap_js_1.detectDeviceKind)(deviceId)) === 'physical') {
+        try {
+            appIds = (await (0, devicectl_js_1.listApps)(deviceId)).map((a) => a.id).sort();
+        }
+        catch (e) {
+            (0, output_js_1.printError)(`list-apps 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)('bash', [
             '-c',

package/dist/commands/list-devices.js

@@ -16,7 +16,9 @@ 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");
+const discovery_js_1 = require("../drivers/roku/discovery.js");
 const cdp_discovery_js_1 = require("../drivers/cdp-discovery.js");
+const devicectl_js_1 = require("../drivers/devicectl.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.
@@ -109,6 +111,18 @@ async function discoverBootedDevices() {
             }
         }
     }
+    // Physical iOS/tvOS devices: paired and reachable is the closest analogue to
+    // a booted simulator — that's when conductor can actually drive them.
+    for (const d of await (0, devicectl_js_1.listPhysicalDevices)()) {
+        if (!d.available)
+            continue;
+        devices.push({
+            id: d.identifier,
+            name: d.name,
+            platform: d.platform,
+            status: d.developerModeEnabled ? 'connected' : 'developer mode off',
+        });
+    }
     // Vega (Amazon Fire TV): booted devices reported by the vega CLI. Best-effort —
     // the CLI is absent unless the Vega SDK is installed.
     try {
@@ -124,6 +138,17 @@ async function discoverBootedDevices() {
     catch {
         /* vega CLI not installed */
     }
+    // Roku: the pinned CONDUCTOR_ROKU_HOST device, plus SSDP hits when
+    // CONDUCTOR_ROKU_DISCOVERY is on. Physical hardware only — Roku has no emulator.
+    for (const d of await (0, discovery_js_1.discoverRokuDevices)().catch(() => [])) {
+        devices.push({
+            id: `roku:${d.host}`,
+            name: d.friendlyName || d.modelName,
+            platform: 'roku',
+            status: 'booted',
+            formFactor: 'tv',
+        });
+    }
     // External CDP endpoints (e.g. an Electron app started with
     // --remote-debugging-port): one device per discovered webview/tile.
     devices.push(...(await (0, cdp_discovery_js_1.discoverCdpDevices)()));
@@ -154,6 +179,18 @@ async function discoverAvailableDevices() {
             // ignore parse errors
         }
     }
+    // Physical devices that aren't currently reachable — listed so users can see
+    // why a device they expect is missing.
+    for (const d of await (0, devicectl_js_1.listPhysicalDevices)()) {
+        if (d.available)
+            continue;
+        devices.push({
+            id: d.identifier,
+            name: d.name,
+            platform: d.platform,
+            status: 'unavailable',
+        });
+    }
     // Android: list available AVDs
     const emu = await (0, runner_js_1.spawnCommand)((0, sdk_js_1.resolveAndroidTool)('emulator'), ['-list-avds'], {
         env: (0, sdk_js_1.androidSpawnEnv)(),

package/dist/commands/memory.js

@@ -1121,6 +1121,11 @@ async function memory(appIdArg, opts = {}, sessionName = 'default', memOpts = {}
         (0, output_js_1.printError)('memory is not yet supported on vega (Amazon Fire TV)', opts);
         return 1;
     }
+    if (platform === 'roku') {
+        // ECP exposes no memory counters, and there is no host-side tooling to ask.
+        (0, output_js_1.printError)('memory is not supported on roku', opts);
+        return 1;
+    }
     let report;
     if (platform === 'web') {
         report = await collectWeb(deviceId, sessionName, memOpts);

package/dist/commands/press-key.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ANDROID_KEYCODE = exports.VALID_KEYS = exports.HELP = void 0;
+exports.ANDROID_KEYCODE = exports.TVOS_REMOTE_BUTTONS = exports.VALID_KEYS = exports.HELP = void 0;
 exports.dispatchKey = dispatchKey;
 exports.pressKey = pressKey;
 exports.HELP = `  press-key <key>                     Press a key (Enter, Backspace, Home, ...)
@@ -19,6 +19,8 @@ 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 roku_js_1 = require("../drivers/roku.js");
+const key_mapping_js_1 = require("../drivers/roku/key-mapping.js");
 exports.VALID_KEYS = [
     'Enter',
     'Backspace',
@@ -54,6 +56,15 @@ exports.VALID_KEYS = [
     'TV Input HDMI 1',
     'TV Input HDMI 2',
     'TV Input HDMI 3',
+    'Remote Info',
+    'Remote Instant Replay',
+    'Remote Search',
+    'Remote Page Up',
+    'Remote Page Down',
+    'Remote Guide',
+    'Remote TV Provider',
+    'Remote One Two Three',
+    'Remote Four Colors',
 ];
 // iOS XCTest pressKey accepts these values (maps to XCUIKeyboardKey)
 const IOS_KEY_MAP = {
@@ -69,7 +80,9 @@ const IOS_BUTTON_MAP = {
     Power: 'lock',
 };
 // tvOS remote: map key names to pressButton values
-const TVOS_REMOTE_BUTTONS = {
+// Page Up/Down and Guide need tvOS 14.3; the last three need tvOS 18.1. The
+// driver reports a precondition error when the device's OS is older.
+exports.TVOS_REMOTE_BUTTONS = {
     'Remote Dpad Up': 'up',
     'Remote Dpad Down': 'down',
     'Remote Dpad Left': 'left',
@@ -77,6 +90,12 @@ const TVOS_REMOTE_BUTTONS = {
     'Remote Dpad Center': 'select',
     'Remote Menu': 'menu',
     'Remote Media Play Pause': 'playPause',
+    'Remote Page Up': 'pageUp',
+    'Remote Page Down': 'pageDown',
+    'Remote Guide': 'guide',
+    'Remote TV Provider': 'tvProvider',
+    'Remote One Two Three': 'oneTwoThree',
+    'Remote Four Colors': 'fourColors',
 };
 // vega (Amazon Fire TV) remote: map key names to VegaDriver button values.
 const VEGA_REMOTE_BUTTONS = {
@@ -131,6 +150,13 @@ exports.ANDROID_KEYCODE = {
     'TV Input HDMI 1': 243,
     'TV Input HDMI 2': 244,
     'TV Input HDMI 3': 245,
+    'Remote Info': 165,
+    'Remote Instant Replay': 273, // KEYCODE_MEDIA_SKIP_BACKWARD
+    'Remote Search': 84,
+    // Paging keys — the fast way through a long list. Whether a given app honours
+    // them varies, the same as on tvOS.
+    'Remote Page Up': 92,
+    'Remote Page Down': 93,
 };
 /**
  * Send `key` on an already-connected driver. Split out of `pressKey` so
@@ -140,7 +166,7 @@ exports.ANDROID_KEYCODE = {
 async function dispatchKey(driver, matched, holdSeconds) {
     if (driver instanceof ios_js_1.IOSDriver) {
         if (driver.platform === 'tvos') {
-            const tvosButton = TVOS_REMOTE_BUTTONS[matched];
+            const tvosButton = exports.TVOS_REMOTE_BUTTONS[matched];
             const iosButton = IOS_BUTTON_MAP[matched];
             if (tvosButton) {
                 await driver.pressButton(tvosButton, holdSeconds);
@@ -191,6 +217,13 @@ async function dispatchKey(driver, matched, holdSeconds) {
         }
         // Keys not mapped on vega are silently ignored
     }
+    else if (driver instanceof roku_js_1.RokuDriver) {
+        // Keys not mapped on roku are silently ignored, as on tvOS and vega — but a
+        // mapped key that the device rejects must still fail.
+        if ((0, key_mapping_js_1.rokuEcpKey)(matched)) {
+            await driver.pressKeyNamed(matched);
+        }
+    }
     else if (driver instanceof android_js_1.AndroidDriver) {
         const code = exports.ANDROID_KEYCODE[matched];
         if (code !== undefined) {

package/dist/commands/profile.js

@@ -244,6 +244,10 @@ async function profileCpu(opts, sessionName, profileOpts) {
         else if (platform === 'android') {
             entries = await recordAndroidCpu(sessionName, profileOpts.appId, profileOpts.durationSec, out, profileOpts.report ? { top: profileOpts.top ?? 30 } : undefined);
         }
+        else if (platform === 'roku') {
+            (0, output_js_1.printError)('profile cpu is not supported on roku — ECP exposes no CPU counters.', opts);
+            return 1;
+        }
         else if (platform === 'vega') {
             // Vega is Amazon's own OS, not Android — no simpleperf, no dumpsys. A
             // physical Fire TV Stick runs Fire OS (Android) over adb and is a