@houwert/conductor 0.29.3 → 0.31.0

package/dist/commands/screenshot.js

@@ -28,6 +28,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");
 const png_crop_js_1 = require("../png-crop.js");
@@ -85,8 +86,10 @@ 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 || 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.
                 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

@@ -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 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");
@@ -78,8 +79,10 @@ 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 || 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.
                     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

@@ -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");
 const utils_js_1 = require("../utils.js");
 async function scroll(direction = 'down', opts = {}, sessionName = 'default') {
     const valid = ['down', 'up', 'left', 'right'];
@@ -32,7 +33,9 @@ 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 || 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 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);

package/dist/commands/start-device.js

@@ -11,7 +11,7 @@ exports.buildAvdmanagerCreateArgs = buildAvdmanagerCreateArgs;
 exports.raiseAvdConfigRam = raiseAvdConfigRam;
 exports.startDevice = startDevice;
 exports.HELP = `  start-device
-    --platform <ios|android|tvos|web|vega> Boot a simulator/emulator, start the web driver (Playwright), or boot/attach a Vega VVD
+    --platform <ios|android|tvos|web|vega|roku> Boot a simulator/emulator, start the web driver (Playwright), attach a Vega VVD, or check a Roku device
     --os-version <n>                  iOS/tvOS version (e.g. 18) or Android API level (e.g. 33)
     --avd <name>                      Android AVD name (default: first available; created if missing + --device-type)
     --name <name>                     Set a custom name on the device after creation (iOS/tvOS/web)
@@ -34,6 +34,7 @@ const bootstrap_js_1 = require("../drivers/bootstrap.js");
 const output_js_1 = require("../output.js");
 const utils_js_1 = require("../utils.js");
 const cli_js_1 = require("../drivers/vega/cli.js");
+const discovery_js_1 = require("../drivers/roku/discovery.js");
 const IOS_BOOT_TIMEOUT_MS = 120000;
 const ANDROID_BOOT_TIMEOUT_MS = 120000;
 const POLL_MS = 1000;
@@ -807,10 +808,31 @@ async function startVega(opts, deviceName) {
     (0, output_js_1.printSuccess)(`Vega device ready: ${device.serial}`, opts);
     return 0;
 }
+// ── Roku ────────────────────────────────────────────────────────────────────
+/**
+ * Roku is physical hardware with no emulator, so there is nothing to boot: this
+ * resolves the target device (explicit `--name <host>`, else `CONDUCTOR_ROKU_HOST`
+ * or an SSDP hit) and confirms it answers on ECP, so a misconfigured device is
+ * reported here rather than on the first `tap-on`.
+ */
+async function startRoku(opts, deviceName) {
+    const host = deviceName?.replace(/^roku:/, '') ?? process.env.CONDUCTOR_ROKU_HOST?.trim();
+    const device = host ? await (0, discovery_js_1.describe)(host) : (await (0, discovery_js_1.discoverRokuDevices)())[0];
+    if (!device) {
+        (0, output_js_1.printError)(host
+            ? `Cannot reach the Roku device at ${host} on ECP port 8060. Check that it is on ` +
+                `this network and in developer mode.`
+            : 'No Roku device found. Set CONDUCTOR_ROKU_HOST=<device-ip>, pass --name <device-ip>, ' +
+                'or set CONDUCTOR_ROKU_DISCOVERY=true to scan the LAN.', opts);
+        return 1;
+    }
+    (0, output_js_1.printSuccess)(`Roku device ready: ${device.friendlyName || device.modelName} (roku:${device.host})`, opts);
+    return 0;
+}
 // ── Entry point ───────────────────────────────────────────────────────────────
 async function startDevice(platform, opts, flags) {
     if (!platform) {
-        (0, output_js_1.printError)('start-device requires --platform ios|android|tvos|web|vega', opts);
+        (0, output_js_1.printError)('start-device requires --platform ios|android|tvos|web|vega|roku', opts);
         return 1;
     }
     switch (platform.toLowerCase()) {
@@ -824,8 +846,10 @@ async function startDevice(platform, opts, flags) {
             return startWebDriver(opts, flags.browser, flags.name);
         case 'vega':
             return startVega(opts, flags.name);
+        case 'roku':
+            return startRoku(opts, flags.name);
         default:
-            (0, output_js_1.printError)(`Unknown platform "${platform}". Use ios, android, tvos, web, or vega.`, opts);
+            (0, output_js_1.printError)(`Unknown platform "${platform}". Use ios, android, tvos, web, vega, or roku.`, opts);
             return 1;
     }
 }

package/dist/commands/stop-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 stopApp(appId, opts = {}, sessionName = 'default') {
     const session = await (0, session_js_1.getSession)(sessionName);
     const resolvedAppId = appId ?? session.appId;
@@ -24,7 +25,7 @@ async function stopApp(appId, opts = {}, sessionName = 'default') {
         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.stopApp(resolvedAppId);
         }
         else if (driver instanceof android_js_1.AndroidDriver) {

package/dist/commands/stop-device.js

@@ -3,13 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HELP = void 0;
 exports.stopDevice = stopDevice;
 exports.HELP = `  stop-device [<name-or-id>]
-    --platform <ios|tvos|android|web|vega> Scope to a single platform
+    --platform <ios|tvos|android|web|vega|roku> Scope to a single platform
     --all                             Stop all booted simulators / running emulators / web sessions`;
 const runner_js_1 = require("../runner.js");
 const sdk_js_1 = require("../android/sdk.js");
 const output_js_1 = require("../output.js");
 const client_js_1 = require("../daemon/client.js");
 const list_devices_js_1 = require("./list-devices.js");
+const bootstrap_js_1 = require("../drivers/bootstrap.js");
 // ── iOS / tvOS ───────────────────────────────────────────────────────────────
 async function shutdownSimulator(udid) {
     const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'shutdown', udid]);
@@ -36,6 +37,7 @@ async function stopDevice(nameOrId, opts, flags) {
     const includeAndroid = !platform || platform === 'android';
     const includeWeb = !platform || platform === 'web';
     const includeVega = !platform || platform === 'vega';
+    const includeRoku = !platform || platform === 'roku';
     const stopped = [];
     // ── --all mode ───────────────────────────────────────────────────────────
     if (flags.all) {
@@ -51,8 +53,15 @@ async function stopDevice(nameOrId, opts, flags) {
                 continue;
             if (d.platform === 'vega' && !includeVega)
                 continue;
+            if (d.platform === 'roku' && !includeRoku)
+                continue;
             try {
-                if (d.platform === 'ios' || d.platform === 'tvos') {
+                if ((d.platform === 'ios' || d.platform === 'tvos') &&
+                    (await (0, bootstrap_js_1.detectDeviceKind)(d.id)) === 'physical') {
+                    // Real hardware can't be shut down from here — just release our driver.
+                    await (0, client_js_1.stopDaemon)(d.id);
+                }
+                else if (d.platform === 'ios' || d.platform === 'tvos') {
                     await shutdownSimulator(d.id);
                 }
                 else if (d.platform === 'android') {
@@ -62,6 +71,10 @@ async function stopDevice(nameOrId, opts, flags) {
                     // Vega VVD lifecycle is owned by Amazon's tooling — we only stop our log daemon.
                     await (0, client_js_1.stopDaemon)(d.id);
                 }
+                else if (d.platform === 'roku') {
+                    // A Roku is physical hardware we never booted; there is nothing to stop.
+                    continue;
+                }
                 stopped.push({ id: d.id, name: d.name, platform: d.platform });
             }
             catch (e) {
@@ -94,7 +107,12 @@ async function stopDevice(nameOrId, opts, flags) {
         return 1;
     }
     try {
-        if (match.platform === 'ios' || match.platform === 'tvos') {
+        if ((match.platform === 'ios' || match.platform === 'tvos') &&
+            (await (0, bootstrap_js_1.detectDeviceKind)(match.id)) === 'physical') {
+            // Real hardware can't be shut down from here — just release our driver.
+            await (0, client_js_1.stopDaemon)(match.id);
+        }
+        else if (match.platform === 'ios' || match.platform === 'tvos') {
             await shutdownSimulator(match.id);
         }
         else if (match.platform === 'android') {
@@ -104,6 +122,10 @@ async function stopDevice(nameOrId, opts, flags) {
             // Vega VVD lifecycle is owned by Amazon's tooling — we only stop our log daemon.
             await (0, client_js_1.stopDaemon)(match.id);
         }
+        else if (match.platform === 'roku') {
+            (0, output_js_1.printError)(`${match.name} is a physical Roku device — conductor never booted it, so there is nothing to stop.`, opts);
+            return 1;
+        }
     }
     catch (e) {
         (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);

package/dist/commands/swipe.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 utils_js_1 = require("../utils.js");
 function parseCoordPair(s) {
     const [xs, ys] = s.split(',').map((p) => p.trim());
@@ -25,8 +26,10 @@ async function swipe(direction, opts = {}, sessionName = 'default', flags = {})
     }
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver && driver.platform === 'tvos') {
-            throw new Error('swipe is not supported on tvOS — Apple TV uses focus-based navigation.\n' +
-                'Use press-key to navigate (e.g. conductor press-key left).');
+            throw new Error('swipe is not supported on tvOS — XCTest has no Siri Remote touch-surface\n' +
+                'gesture ("Swipe events are only implemented for iOS, visionOS, and watchOS").\n' +
+                'Navigate with press-key "Remote Dpad Left"/"Right"/"Up"/"Down", or cover\n' +
+                'long lists faster with press-key "Remote Page Up"/"Remote Page Down".');
         }
         let startX, startY, endX, endY;
         if (driver instanceof ios_js_1.IOSDriver) {
@@ -71,7 +74,9 @@ async function swipe(direction, opts = {}, sessionName = 'default', flags = {})
             }
             await driver.swipe(startX, startY, endX, endY, durationMs);
         }
-        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 { widthPixels: w, heightPixels: h } = await driver.deviceInfo();
             const durationMs = flags.duration ?? 500;
             if (flags.start && flags.end) {

package/dist/commands/tap.js

@@ -28,6 +28,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");
 const snapshot_store_js_1 = require("../snapshot-store.js");
@@ -88,8 +89,8 @@ async function tap(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) {
-            // Vega emits uiautomator-style XML, so it reuses the Android resolver.
+        else if (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.
             el = await (0, wait_js_1.waitForAndroidElement)(() => driver.viewHierarchy(), sel);
         }
         else if (driver instanceof android_js_1.AndroidDriver) {

package/dist/commands/uninstall-app.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 uninstallApp(appId, opts = {}, sessionName = 'default') {
     if (!appId) {
         (0, output_js_1.printError)('uninstall-app requires <appId>', opts);
@@ -24,6 +25,9 @@ async function uninstallApp(appId, opts = {}, sessionName = 'default') {
         else if (driver instanceof vega_js_1.VegaDriver) {
             throw new Error('uninstall-app is not supported on vega (Amazon Fire TV)');
         }
+        else if (driver instanceof roku_js_1.RokuDriver) {
+            throw new Error('uninstall-app is not supported on roku');
+        }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.uninstallApp(appId);
         }

package/dist/daemon/input-backends.js

@@ -34,6 +34,15 @@ const IOS_BUTTON = {
     ArrowDown: 'down',
     ArrowLeft: 'left',
     ArrowRight: 'right',
+    // Newer remote buttons; the driver rejects these on older tvOS.
+    pageUp: 'pageUp',
+    PageUp: 'pageUp',
+    pageDown: 'pageDown',
+    PageDown: 'pageDown',
+    guide: 'guide',
+    tvProvider: 'tvProvider',
+    oneTwoThree: 'oneTwoThree',
+    fourColors: 'fourColors',
 };
 function iosBackend(driver) {
     let size = null;
@@ -52,7 +61,23 @@ function iosBackend(driver) {
                 touch: true,
                 drag: true,
                 multitouch: true,
-                buttons: ['home', 'lock'],
+                // Advertise what this platform actually accepts so clients can hide
+                // controls rather than discover failures at press time.
+                buttons: tvos
+                    ? [
+                        'home',
+                        'menu',
+                        'select',
+                        'up',
+                        'down',
+                        'left',
+                        'right',
+                        'playPause',
+                        'pageUp',
+                        'pageDown',
+                        'guide',
+                    ]
+                    : ['home', 'lock'],
                 keyboard: true,
                 text: true,
                 tvRemote: tvos,

package/dist/daemon/log-collector.js

@@ -35,6 +35,7 @@ const android_js_1 = require("../drivers/log-sources/android.js");
 const vega_js_1 = require("../drivers/log-sources/vega.js");
 const metro_js_1 = require("../drivers/log-sources/metro.js");
 const metro_discovery_js_1 = require("../drivers/log-sources/metro-discovery.js");
+const bootstrap_js_1 = require("../drivers/bootstrap.js");
 const MAX_BUFFER = 5000;
 const RESTART_DELAY_MS = 2000;
 const WEB_POLL_INTERVAL_MS = 500;
@@ -145,6 +146,11 @@ class LogCollector {
             return;
         try {
             if (this.platform === 'ios' || this.platform === 'tvos') {
+                // `simctl spawn ... log stream` has no devicectl equivalent, so OS logs
+                // are simulator-only. Metro still streams over the network below, which
+                // is the useful source for React Native apps anyway.
+                if ((await (0, bootstrap_js_1.detectDeviceKind)(this.deviceId)) === 'physical')
+                    return;
                 this.source = new ios_js_1.IOSLogSource(this.deviceId, this.appId);
             }
             else if (this.platform === 'android') {

package/dist/daemon/server.js

@@ -84,6 +84,20 @@ function dlog(msg) {
 // ── Driver lifecycle ──────────────────────────────────────────────────────────
 let driverPort = 1075;
 let driverPlatform = 'ios';
+/**
+ * Host the driver is reachable on. Simulators and every non-Apple platform use
+ * the host's loopback; a physical device runs the driver on its own, so we talk
+ * to it over the network. Memoised — resolution goes through mDNS.
+ */
+let _driverHost = null;
+async function driverHost() {
+    if (_driverHost)
+        return _driverHost;
+    if (driverPlatform !== 'ios' && driverPlatform !== 'tvos')
+        return '127.0.0.1';
+    _driverHost = await (0, bootstrap_js_1.resolveDriverHost)(sessionName).catch(() => '127.0.0.1');
+    return _driverHost;
+}
 let logCollector = null;
 let inputServer = null;
 let inputPort = null;
@@ -109,7 +123,7 @@ async function startInputServerForPlatform() {
         makeBackend = () => (0, input_backends_js_1.androidBackend)(driver);
     }
     else {
-        const driver = new ios_js_1.IOSDriver(driverPort, '127.0.0.1', sessionName, driverPlatform);
+        const driver = new ios_js_1.IOSDriver(driverPort, await driverHost(), sessionName, driverPlatform, (await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'physical');
         makeBackend = () => (0, input_backends_js_1.iosBackend)(driver);
         // Opt-in native held-touch backend for live drags (iOS only; single-touch).
         if (driverPlatform === 'ios' && process.env.CONDUCTOR_IOS_HID === '1') {
@@ -154,6 +168,12 @@ async function startVideoServerForPlatform() {
         return;
     if (driverPlatform !== 'ios' && driverPlatform !== 'tvos')
         return;
+    // Capture attaches to the Simulator's framebuffer via SimulatorKit, which has
+    // no counterpart on real hardware.
+    if ((await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'physical') {
+        dlog('video capture is simulator-only — stream server disabled for this device');
+        return;
+    }
     const binary = await (0, bootstrap_js_1.getCaptureBinaryPath)();
     if (!binary) {
         dlog('video capture binary not present — stream server disabled for this device');
@@ -177,8 +197,9 @@ let _driverStartError = null;
 async function ensureDriverRunning() {
     if (_restartInProgress || !_driverStarted)
         return;
-    // Vega has no driver process/port to health-check — control is host-side via the CLI.
-    if (driverPlatform === 'vega')
+    // Vega and Roku have no driver process/port to health-check — control is
+    // host-side (the vega CLI) or over the network (Roku ECP).
+    if (driverPlatform === 'vega' || driverPlatform === 'roku')
         return;
     let alive;
     if (driverPlatform === 'android') {
@@ -188,11 +209,13 @@ async function ensureDriverRunning() {
         probe.close();
     }
     else {
-        // 'ios', 'tvos', and 'web' all use an HTTP server — port open = alive
-        alive = await (0, bootstrap_js_1.isPortOpen)(driverPort);
+        // 'ios', 'tvos', and 'web' all use an HTTP server — port open = alive.
+        // Physical devices answer on the LAN rather than the host's loopback.
+        alive = await (0, bootstrap_js_1.isPortOpen)(driverPort, await driverHost());
     }
     if (!alive) {
         if ((driverPlatform === 'ios' || driverPlatform === 'tvos') &&
+            (await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'simulator' &&
             !(await (0, bootstrap_js_1.isSimulatorBooted)(sessionName))) {
             dlog(`Simulator ${sessionName} is not booted — skipping driver restart`);
             return;
@@ -200,7 +223,11 @@ async function ensureDriverRunning() {
         _restartInProgress = true;
         dlog(`Driver on port ${driverPort} not responding — restarting`);
         try {
-            if (driverPlatform === 'ios') {
+            if ((driverPlatform === 'ios' || driverPlatform === 'tvos') &&
+                (await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'physical') {
+                await (0, bootstrap_js_1.startDeviceDriver)(sessionName, driverPlatform, driverPort);
+            }
+            else if (driverPlatform === 'ios') {
                 await (0, bootstrap_js_1.startIOSDriver)(sessionName, driverPort);
             }
             else if (driverPlatform === 'tvos') {
@@ -317,6 +344,9 @@ async function main() {
             else if (driverPlatform === 'vega') {
                 dlog('vega: no driver process to stop (control is host-side via the CLI)');
             }
+            else if (driverPlatform === 'roku') {
+                dlog('roku: no driver process to stop (control is ECP over the network)');
+            }
             else if (driverPlatform === 'web') {
                 dlog('Stopping web driver');
                 try {
@@ -329,7 +359,10 @@ async function main() {
             else {
                 dlog(`Stopping driver on port ${driverPort}`);
                 try {
-                    if (driverPlatform === 'ios') {
+                    if (driverPlatform === 'ios' && (await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'physical') {
+                        await (0, bootstrap_js_1.stopDeviceDriver)(sessionName, 'ios');
+                    }
+                    else if (driverPlatform === 'ios') {
                         await (0, bootstrap_js_1.stopIOSDriver)(sessionName);
                     }
                     else {
@@ -449,6 +482,12 @@ async function main() {
                     _driverStarted = true;
                     dlog('vega: no driver process to start; collecting logs only');
                 }
+                else if (platform === 'roku') {
+                    // Roku has neither a driver process nor a log stream to collect, so
+                    // the daemon has nothing to do — commands drive the device directly.
+                    _driverStarted = true;
+                    dlog('roku: no driver process and no device logs; daemon is idle');
+                }
                 else {
                     await startDriverForPlatform(platform);
                 }
@@ -487,8 +526,8 @@ async function main() {
     });
 }
 /**
- * Bring up the driver process for a non-vega platform. Sets `_driverStarted` /
- * `_driverStartError`. Extracted so the vega path can skip it entirely.
+ * Bring up the driver process for a platform that has one. Sets `_driverStarted` /
+ * `_driverStartError`. Extracted so the vega and roku paths can skip it entirely.
  */
 async function startDriverForPlatform(platform) {
     let driverAlive;
@@ -500,7 +539,7 @@ async function startDriverForPlatform(platform) {
     }
     else {
         // 'ios', 'tvos', and 'web' all use an HTTP server — port open = alive
-        driverAlive = await (0, bootstrap_js_1.isPortOpen)(driverPort);
+        driverAlive = await (0, bootstrap_js_1.isPortOpen)(driverPort, await driverHost());
     }
     if (driverAlive) {
         _driverStarted = true;
@@ -523,7 +562,11 @@ async function startDriverForPlatform(platform) {
     }
     dlog(`Starting ${platform} driver on port ${driverPort}`);
     try {
-        if (platform === 'ios') {
+        if ((platform === 'ios' || platform === 'tvos') &&
+            (await (0, bootstrap_js_1.detectDeviceKind)(sessionName)) === 'physical') {
+            await (0, bootstrap_js_1.startDeviceDriver)(sessionName, platform, driverPort);
+        }
+        else if (platform === 'ios') {
             await (0, bootstrap_js_1.startIOSDriver)(sessionName, driverPort);
         }
         else if (platform === 'tvos') {