@houwert/conductor 0.29.2 → 0.30.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

@@ -30,6 +30,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 {

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

@@ -29,6 +29,11 @@ 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();

package/dist/commands/list-devices.js

@@ -16,6 +16,7 @@ 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");
 // Captured during discoverAvailableDevices so listDevices() can report it.
 // Module-scoped because the discover function returns Device[]; bolting an
@@ -124,6 +125,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)()));

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

@@ -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,9 @@ exports.VALID_KEYS = [
     'TV Input HDMI 1',
     'TV Input HDMI 2',
     'TV Input HDMI 3',
+    'Remote Info',
+    'Remote Instant Replay',
+    'Remote Search',
 ];
 // iOS XCTest pressKey accepts these values (maps to XCUIKeyboardKey)
 const IOS_KEY_MAP = {
@@ -131,6 +136,9 @@ 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,
 };
 /**
  * Send `key` on an already-connected driver. Split out of `pressKey` so
@@ -191,6 +199,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-frames.js

@@ -647,8 +647,10 @@ async function profileFramesReport(opts, sessionName, frameOpts) {
         if (frameOpts.trackSec !== undefined && repeat === 1) {
             notes.push({
                 code: 'single-window',
-                message: 'One window carries no run-to-run variance, so a later --diff cannot tell a real ' +
-                    'change from noise. Capture a baseline with --repeat 5 to record its own spread.',
+                message: 'One window carries no run-to-run variance, so nothing here can be called a change. ' +
+                    'Measured on a Fire TV Stick, five identical captures of the same screen ranged ' +
+                    '37.8-72.9% janky and 6.2-13.0ms issueDraw p50 — wide enough to invent a regression ' +
+                    'or hide one. Treat --repeat 5 as the default on TV, not an option.',
             });
         }
         const report = {