@houwert/conductor 0.2.0 → 0.4.0

package/dist/commands/start-device.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.startDevice = startDevice;
+exports.HELP = `  start-device
+    --platform <ios|android|tvos>     Boot a simulator or emulator
+    --os-version <n>                  iOS/tvOS version (e.g. 18) or Android API level (e.g. 33)
+    --avd <name>                      Android AVD name (default: first available)
+    --name <name>                     Set a custom name on the simulator after boot (iOS/tvOS only)
+    --device-type <name>              iOS/tvOS device type (e.g. "iPhone 16 Pro", "Apple TV 4K"); creates if needed`;
 const child_process_1 = require("child_process");
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
@@ -15,6 +22,68 @@ async function listIOSSimulators() {
     const parsed = JSON.parse(result.stdout);
     return parsed.devices;
 }
+async function listDeviceTypes() {
+    const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'list', 'devicetypes', '--json']);
+    if (!result.success)
+        throw new Error(`xcrun simctl list devicetypes failed: ${result.stderr}`);
+    const parsed = JSON.parse(result.stdout);
+    return parsed.devicetypes;
+}
+async function listRuntimes() {
+    const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'list', 'runtimes', '--json']);
+    if (!result.success)
+        throw new Error(`xcrun simctl list runtimes failed: ${result.stderr}`);
+    const parsed = JSON.parse(result.stdout);
+    return parsed.runtimes;
+}
+function runtimeVersionNumber(version) {
+    // Convert "18.2" → 180200, "17.0.1" → 170001 for numeric comparison
+    const parts = version.split('.').map(Number);
+    return (parts[0] ?? 0) * 10000 + (parts[1] ?? 0) * 100 + (parts[2] ?? 0);
+}
+async function createIOSSimulator(deviceType, osVersion) {
+    const deviceTypes = await listDeviceTypes();
+    const runtimes = await listRuntimes();
+    const matchedType = deviceTypes.find((dt) => dt.name.toLowerCase() === deviceType.toLowerCase());
+    if (!matchedType) {
+        const iPhoneTypes = deviceTypes
+            .filter((dt) => dt.name.toLowerCase().includes('iphone'))
+            .map((dt) => dt.name);
+        throw new Error(`Unknown device type "${deviceType}". Available iPhone types:\n  ${iPhoneTypes.join('\n  ')}`);
+    }
+    // Filter to available iOS runtimes
+    let candidates = runtimes.filter((r) => r.isAvailable && r.identifier.startsWith('com.apple.CoreSimulator.SimRuntime.iOS'));
+    if (osVersion) {
+        candidates = candidates.filter((r) => r.version.startsWith(osVersion));
+    }
+    if (candidates.length === 0) {
+        const hint = osVersion ? ` matching version ${osVersion}` : '';
+        throw new Error(`No available iOS runtime found${hint}. Install one via Xcode → Settings → Platforms.`);
+    }
+    // Sort by version descending to pick the latest
+    candidates.sort((a, b) => runtimeVersionNumber(b.version) - runtimeVersionNumber(a.version));
+    // Filter by device type compatibility if min/max runtime version is specified
+    const compatible = candidates.filter((r) => {
+        const ver = runtimeVersionNumber(r.version);
+        if (matchedType.minRuntimeVersion && ver < matchedType.minRuntimeVersion)
+            return false;
+        if (matchedType.maxRuntimeVersion && ver > matchedType.maxRuntimeVersion)
+            return false;
+        return true;
+    });
+    const runtime = compatible.length > 0 ? compatible[0] : candidates[0];
+    const createResult = await (0, runner_js_1.spawnCommand)('xcrun', [
+        'simctl',
+        'create',
+        deviceType,
+        matchedType.identifier,
+        runtime.identifier,
+    ]);
+    if (!createResult.success) {
+        throw new Error(`Failed to create simulator: ${createResult.stderr.trim()}`);
+    }
+    return createResult.stdout.trim(); // UDID
+}
 async function bootIOSSimulator(udid) {
     const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'boot', udid]);
     // exit 149 = already booted, that's fine
@@ -28,7 +97,9 @@ async function waitForIOSBoot(udid) {
         const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'list', 'devices', 'booted', '--json']);
         if (result.success) {
             const parsed = JSON.parse(result.stdout);
-            const booted = Object.values(parsed.devices).flat().some((d) => d.udid === udid);
+            const booted = Object.values(parsed.devices)
+                .flat()
+                .some((d) => d.udid === udid);
             if (booted)
                 return;
         }
@@ -36,7 +107,13 @@ async function waitForIOSBoot(udid) {
     }
     throw new Error(`Simulator ${udid} did not boot within ${IOS_BOOT_TIMEOUT_MS / 1000}s`);
 }
-async function startIOS(osVersion, opts) {
+async function renameIOSSimulator(udid, name) {
+    const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'rename', udid, name]);
+    if (!result.success) {
+        throw new Error(`xcrun simctl rename failed: ${result.stderr.trim()}`);
+    }
+}
+async function startIOS(osVersion, opts, name, deviceType) {
     let devices;
     try {
         devices = await listIOSSimulators();
@@ -45,25 +122,74 @@ async function startIOS(osVersion, opts) {
         (0, output_js_1.printError)(`Failed to list simulators: ${e instanceof Error ? e.message : String(e)}`, opts);
         return 1;
     }
-    // Filter to available (installable) simulators, optionally by OS version
+    // Filter to available (installable) simulators, optionally by OS version and device type.
+    // Note: --device-type matches against sim.name, so renamed simulators won't match their
+    // original device type. This is a simctl limitation — device entries don't expose a stable
+    // deviceTypeIdentifier. A renamed sim will be skipped, potentially creating a duplicate.
     const candidates = [];
     for (const [runtime, sims] of Object.entries(devices)) {
         if (osVersion && !runtime.includes(osVersion))
             continue;
         for (const sim of sims) {
+            if (deviceType && sim.name.toLowerCase() !== deviceType.toLowerCase())
+                continue;
             if (sim.isAvailable && sim.state !== 'Booted') {
                 candidates.push({ runtime, device: sim });
             }
             // If already booted, just report it
             if (sim.isAvailable && sim.state === 'Booted') {
                 if (!osVersion || runtime.includes(osVersion)) {
-                    (0, output_js_1.printSuccess)(`Simulator already booted: ${sim.name} (${sim.udid})`, opts);
+                    if (name) {
+                        try {
+                            await renameIOSSimulator(sim.udid, name);
+                        }
+                        catch (e) {
+                            (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                            return 1;
+                        }
+                    }
+                    const displayName = name ?? sim.name;
+                    (0, output_js_1.printSuccess)(`Simulator already booted: ${displayName} (${sim.udid})`, opts);
                     return 0;
                 }
             }
         }
     }
     if (candidates.length === 0) {
+        // If a device type was requested, try to create the simulator
+        if (deviceType) {
+            console.log(`No existing simulator found for "${deviceType}". Creating one...`);
+            let udid;
+            try {
+                udid = await createIOSSimulator(deviceType, osVersion);
+            }
+            catch (e) {
+                (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                return 1;
+            }
+            console.log(`Created simulator: ${deviceType} (${udid}). Booting...`);
+            try {
+                await bootIOSSimulator(udid);
+                await waitForIOSBoot(udid);
+            }
+            catch (e) {
+                (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                return 1;
+            }
+            if (name) {
+                try {
+                    await renameIOSSimulator(udid, name);
+                }
+                catch (e) {
+                    (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                    return 1;
+                }
+            }
+            (0, child_process_1.spawn)('open', ['-a', 'Simulator'], { detached: true, stdio: 'ignore' }).unref();
+            const displayName = name ?? deviceType;
+            (0, output_js_1.printSuccess)(`Booted: ${displayName} (${udid})`, opts);
+            return 0;
+        }
         const hint = osVersion ? ` for iOS ${osVersion}` : '';
         (0, output_js_1.printError)(`No available iOS simulator found${hint}. Install one via Xcode → Settings → Platforms.`, opts);
         return 1;
@@ -84,9 +210,174 @@ async function startIOS(osVersion, opts) {
         (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
         return 1;
     }
+    if (name) {
+        try {
+            await renameIOSSimulator(device.udid, name);
+        }
+        catch (e) {
+            (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+            return 1;
+        }
+    }
+    // Open the Simulator.app so the window appears
+    (0, child_process_1.spawn)('open', ['-a', 'Simulator'], { detached: true, stdio: 'ignore' }).unref();
+    const displayName = name ?? device.name;
+    (0, output_js_1.printSuccess)(`Booted: ${displayName} (${device.udid})`, opts);
+    return 0;
+}
+// ── tvOS ──────────────────────────────────────────────────────────────────────
+async function createTvOSSimulator(deviceType, osVersion) {
+    const deviceTypes = await listDeviceTypes();
+    const runtimes = await listRuntimes();
+    const matchedType = deviceTypes.find((dt) => dt.name.toLowerCase() === deviceType.toLowerCase());
+    if (!matchedType) {
+        const tvTypes = deviceTypes
+            .filter((dt) => dt.name.toLowerCase().includes('apple tv'))
+            .map((dt) => dt.name);
+        throw new Error(`Unknown device type "${deviceType}". Available Apple TV types:\n  ${tvTypes.join('\n  ')}`);
+    }
+    // Filter to available tvOS runtimes
+    let candidates = runtimes.filter((r) => r.isAvailable && r.identifier.startsWith('com.apple.CoreSimulator.SimRuntime.tvOS'));
+    if (osVersion) {
+        candidates = candidates.filter((r) => r.version.startsWith(osVersion));
+    }
+    if (candidates.length === 0) {
+        const hint = osVersion ? ` matching version ${osVersion}` : '';
+        throw new Error(`No available tvOS runtime found${hint}. Install one via Xcode → Settings → Platforms.`);
+    }
+    // Sort by version descending to pick the latest
+    candidates.sort((a, b) => runtimeVersionNumber(b.version) - runtimeVersionNumber(a.version));
+    // Filter by device type compatibility if min/max runtime version is specified
+    const compatible = candidates.filter((r) => {
+        const ver = runtimeVersionNumber(r.version);
+        if (matchedType.minRuntimeVersion && ver < matchedType.minRuntimeVersion)
+            return false;
+        if (matchedType.maxRuntimeVersion && ver > matchedType.maxRuntimeVersion)
+            return false;
+        return true;
+    });
+    const runtime = compatible.length > 0 ? compatible[0] : candidates[0];
+    const createResult = await (0, runner_js_1.spawnCommand)('xcrun', [
+        'simctl',
+        'create',
+        deviceType,
+        matchedType.identifier,
+        runtime.identifier,
+    ]);
+    if (!createResult.success) {
+        throw new Error(`Failed to create tvOS simulator: ${createResult.stderr.trim()}`);
+    }
+    return createResult.stdout.trim(); // UDID
+}
+async function startTvOS(osVersion, opts, name, deviceType) {
+    let devices;
+    try {
+        devices = await listIOSSimulators();
+    }
+    catch (e) {
+        (0, output_js_1.printError)(`Failed to list simulators: ${e instanceof Error ? e.message : String(e)}`, opts);
+        return 1;
+    }
+    // Filter to available tvOS simulators, optionally by OS version and device type.
+    const candidates = [];
+    for (const [runtime, sims] of Object.entries(devices)) {
+        if (!runtime.includes('tvOS'))
+            continue;
+        if (osVersion && !runtime.includes(osVersion))
+            continue;
+        for (const sim of sims) {
+            if (deviceType && sim.name.toLowerCase() !== deviceType.toLowerCase())
+                continue;
+            if (sim.isAvailable && sim.state !== 'Booted') {
+                candidates.push({ runtime, device: sim });
+            }
+            // If already booted, just report it
+            if (sim.isAvailable && sim.state === 'Booted') {
+                if (!osVersion || runtime.includes(osVersion)) {
+                    if (name) {
+                        try {
+                            await renameIOSSimulator(sim.udid, name);
+                        }
+                        catch (e) {
+                            (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                            return 1;
+                        }
+                    }
+                    const displayName = name ?? sim.name;
+                    (0, output_js_1.printSuccess)(`Simulator already booted: ${displayName} (${sim.udid})`, opts);
+                    return 0;
+                }
+            }
+        }
+    }
+    if (candidates.length === 0) {
+        // If a device type was requested, try to create the simulator
+        if (deviceType) {
+            console.log(`No existing tvOS simulator found for "${deviceType}". Creating one...`);
+            let udid;
+            try {
+                udid = await createTvOSSimulator(deviceType, osVersion);
+            }
+            catch (e) {
+                (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                return 1;
+            }
+            console.log(`Created simulator: ${deviceType} (${udid}). Booting...`);
+            try {
+                await bootIOSSimulator(udid);
+                await waitForIOSBoot(udid);
+            }
+            catch (e) {
+                (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                return 1;
+            }
+            if (name) {
+                try {
+                    await renameIOSSimulator(udid, name);
+                }
+                catch (e) {
+                    (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+                    return 1;
+                }
+            }
+            (0, child_process_1.spawn)('open', ['-a', 'Simulator'], { detached: true, stdio: 'ignore' }).unref();
+            const displayName = name ?? deviceType;
+            (0, output_js_1.printSuccess)(`Booted: ${displayName} (${udid})`, opts);
+            return 0;
+        }
+        const hint = osVersion ? ` for tvOS ${osVersion}` : '';
+        (0, output_js_1.printError)(`No available tvOS simulator found${hint}. Install one via Xcode → Settings → Platforms.`, opts);
+        return 1;
+    }
+    // Prefer "Apple TV" models
+    const sorted = candidates.sort((a, b) => {
+        const ai = a.device.name.toLowerCase().includes('apple tv') ? 0 : 1;
+        const bi = b.device.name.toLowerCase().includes('apple tv') ? 0 : 1;
+        return ai - bi;
+    });
+    const { device } = sorted[0];
+    console.log(`Booting simulator: ${device.name} (${device.udid})...`);
+    try {
+        await bootIOSSimulator(device.udid);
+        await waitForIOSBoot(device.udid);
+    }
+    catch (e) {
+        (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+        return 1;
+    }
+    if (name) {
+        try {
+            await renameIOSSimulator(device.udid, name);
+        }
+        catch (e) {
+            (0, output_js_1.printError)(e instanceof Error ? e.message : String(e), opts);
+            return 1;
+        }
+    }
     // Open the Simulator.app so the window appears
     (0, child_process_1.spawn)('open', ['-a', 'Simulator'], { detached: true, stdio: 'ignore' }).unref();
-    (0, output_js_1.printSuccess)(`Booted: ${device.name} (${device.udid})`, opts);
+    const displayName = name ?? device.name;
+    (0, output_js_1.printSuccess)(`Booted: ${displayName} (${device.udid})`, opts);
     return 0;
 }
 // ── Android ───────────────────────────────────────────────────────────────────
@@ -94,7 +385,10 @@ async function listAVDs() {
     const result = await (0, runner_js_1.spawnCommand)('emulator', ['-list-avds']);
     if (!result.success)
         throw new Error(`emulator -list-avds failed: ${result.stderr}`);
-    return result.stdout.split('\n').map((l) => l.trim()).filter(Boolean);
+    return result.stdout
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean);
 }
 async function waitForAndroidBoot(avdName) {
     const deadline = Date.now() + ANDROID_BOOT_TIMEOUT_MS;
@@ -117,7 +411,13 @@ async function waitForAndroidBoot(avdName) {
             const status = parts[1];
             if (id && status === 'device' && !connectedBefore.has(id)) {
                 // Check boot completed
-                const boot = await (0, runner_js_1.spawnCommand)('adb', ['-s', id, 'shell', 'getprop', 'sys.boot_completed']);
+                const boot = await (0, runner_js_1.spawnCommand)('adb', [
+                    '-s',
+                    id,
+                    'shell',
+                    'getprop',
+                    'sys.boot_completed',
+                ]);
                 if (boot.stdout.trim() === '1')
                     return id;
             }
@@ -168,11 +468,13 @@ async function startDevice(platform, opts, flags) {
     }
     switch (platform.toLowerCase()) {
         case 'ios':
-            return startIOS(flags.osVersion, opts);
+            return startIOS(flags.osVersion, opts, flags.name, flags.deviceType);
+        case 'tvos':
+            return startTvOS(flags.osVersion, opts, flags.name, flags.deviceType);
         case 'android':
             return startAndroid(flags.avd, opts);
         default:
-            (0, output_js_1.printError)(`Unknown platform "${platform}". Use ios or android.`, opts);
+            (0, output_js_1.printError)(`Unknown platform "${platform}". Use ios, android, or tvos.`, opts);
             return 1;
     }
 }

package/dist/commands/stop-app.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.stopApp = stopApp;
+exports.HELP = `  stop-app [<appId>]                  Stop app`;
 const runner_js_1 = require("../runner.js");
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");

package/dist/commands/swipe.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.swipe = swipe;
+exports.HELP = `  swipe
+    --direction <up|down|left|right>  Swipe direction (required unless --start/--end are provided)
+    --start <x,y>                     Start coordinate (0–1 normalised or absolute px)
+    --end <x,y>                       End coordinate (0–1 normalised or absolute px)
+    --duration <ms>                   Swipe duration in milliseconds (default: 500)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
@@ -16,6 +22,10 @@ async function swipe(direction, opts = {}, sessionName = 'default', flags = {})
         return 1;
     }
     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).');
+        }
         let startX, startY, endX, endY;
         if (driver instanceof ios_js_1.IOSDriver) {
             const { widthPoints: w, heightPoints: h } = await driver.deviceInfo();

package/dist/commands/tap.js

@@ -1,6 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.tap = tap;
+exports.HELP = `  tap <element>                       Tap element by text or id
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --index <n>                       Pick the nth match (0-based)
+    --long-press                      Hold instead of tap
+    --double-tap                      Double-tap the element
+    --optional                        Do not fail if element is not found
+    --focused                         Match only focused elements
+    --enabled / --no-enabled          Match by enabled state
+    --checked / --no-checked          Match by checked state
+    --selected / --no-selected        Match by selected state
+    --below <text>                    Match element below the given reference
+    --above <text>                    Match element above the given reference
+    --left-of <text>                  Match element left of the given reference
+    --right-of <text>                 Match element right of the given reference`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
@@ -26,6 +42,10 @@ async function tap(query, opts = {}, sessionName = 'default', flags = {}) {
     };
     const label = flags.text ? `text="${flags.text}"` : flags.id ? `id="${flags.id}"` : `"${query}"`;
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        if (driver instanceof ios_js_1.IOSDriver && driver.platform === 'tvos') {
+            throw new Error('tap is not supported on tvOS — Apple TV uses focus-based navigation.\n' +
+                'Use press-key to navigate (e.g. conductor press-key "Remote Dpad Center").');
+        }
         let el;
         if (driver instanceof ios_js_1.IOSDriver) {
             el = await (0, wait_js_1.waitForIOSElement)(() => driver.viewHierarchy().then((h) => h.axElement), sel);

package/dist/commands/type.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.typeText = typeText;
+exports.HELP = `  type <text>                         Type text into focused field`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 async function typeText(text, opts = {}, sessionName = 'default') {

package/dist/commands/uninstall-app.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.uninstallApp = uninstallApp;
+exports.HELP = `  uninstall-app <appId>                Uninstall app from device`;
+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");
+async function uninstallApp(appId, opts = {}, sessionName = 'default') {
+    if (!appId) {
+        (0, output_js_1.printError)('uninstall-app requires <appId>', opts);
+        return 1;
+    }
+    const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        if (driver instanceof ios_js_1.IOSDriver) {
+            await driver.uninstallApp(appId);
+        }
+        else if (driver instanceof android_js_1.AndroidDriver) {
+            await driver.uninstallApp(appId);
+        }
+    }, sessionName);
+    if (result.success) {
+        (0, output_js_1.printSuccess)(`uninstall-app "${appId}" — done`, opts);
+        return 0;
+    }
+    else {
+        (0, output_js_1.printError)(`uninstall-app "${appId}" — failed\n${result.stderr}`, opts);
+        return 1;
+    }
+}

package/dist/daemon/server.js

@@ -19,6 +19,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const protocol_js_1 = require("./protocol.js");
 const bootstrap_js_1 = require("../drivers/bootstrap.js");
+const android_js_1 = require("../drivers/android.js");
 const sessionName = process.argv[2] ?? 'default';
 const SOCKET_PATH = (0, protocol_js_1.socketPath)(sessionName);
 const PID_FILE = (0, protocol_js_1.pidFile)(sessionName);
@@ -37,12 +38,24 @@ let driverPort = 1075;
 let driverPlatform = 'ios';
 const DRIVER_HEALTH_INTERVAL_MS = 10000; // Check driver health every 10s
 let _restartInProgress = false;
+let _driverStarted = false;
 async function ensureDriverRunning() {
-    if (_restartInProgress)
+    if (_restartInProgress || !_driverStarted)
         return;
-    const alive = await (0, bootstrap_js_1.isPortOpen)(driverPort);
+    let alive;
+    if (driverPlatform === 'android') {
+        const probe = new android_js_1.AndroidDriver(sessionName, driverPort);
+        await probe.connect();
+        alive = await probe.isAlive().catch(() => false);
+        probe.close();
+    }
+    else {
+        // Both 'ios' and 'tvos' use an HTTP server — port open = alive
+        alive = await (0, bootstrap_js_1.isPortOpen)(driverPort);
+    }
     if (!alive) {
-        if (driverPlatform === 'ios' && !(await (0, bootstrap_js_1.isSimulatorBooted)(sessionName))) {
+        if ((driverPlatform === 'ios' || driverPlatform === 'tvos') &&
+            !(await (0, bootstrap_js_1.isSimulatorBooted)(sessionName))) {
             dlog(`Simulator ${sessionName} is not booted — skipping driver restart`);
             return;
         }
@@ -52,6 +65,10 @@ async function ensureDriverRunning() {
             if (driverPlatform === 'ios') {
                 await (0, bootstrap_js_1.startIOSDriver)(sessionName, driverPort);
             }
+            else if (driverPlatform === 'tvos') {
+                // Health-check restart — don't dismiss, to avoid disrupting user's app
+                await (0, bootstrap_js_1.startTvOSDriver)(sessionName, driverPort, /* dismissAfterLaunch */ false);
+            }
             else {
                 await (0, bootstrap_js_1.startAndroidDriver)(sessionName, driverPort);
             }
@@ -116,25 +133,33 @@ async function main() {
         catch {
             /* ok */
         }
-        if (sessionName !== 'default') {
-            dlog(`Stopping driver on port ${driverPort}`);
-            try {
-                if (driverPlatform === 'ios') {
-                    await (0, bootstrap_js_1.stopIOSDriver)(sessionName);
+        if (_driverStarted) {
+            // tvOS: keep the driver process alive across daemon restarts.
+            // Stopping/reinstalling steals foreground focus and destroys
+            // the user's navigation state in the target app.
+            if (driverPlatform === 'tvos') {
+                dlog('tvOS: leaving driver running to preserve app state');
+            }
+            else {
+                dlog(`Stopping driver on port ${driverPort}`);
+                try {
+                    if (driverPlatform === 'ios') {
+                        await (0, bootstrap_js_1.stopIOSDriver)(sessionName);
+                    }
+                    else {
+                        await (0, bootstrap_js_1.stopAndroidDriver)(sessionName, driverPort);
+                    }
                 }
-                else {
-                    await (0, bootstrap_js_1.stopAndroidDriver)(sessionName);
+                catch (err) {
+                    dlog(`Stop driver error: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                dlog(`Uninstalling driver from ${sessionName}`);
+                try {
+                    await (0, bootstrap_js_1.uninstallDriver)(sessionName, driverPlatform);
+                }
+                catch (err) {
+                    dlog(`Uninstall driver error: ${err instanceof Error ? err.message : String(err)}`);
                 }
-            }
-            catch (err) {
-                dlog(`Stop driver error: ${err instanceof Error ? err.message : String(err)}`);
-            }
-            dlog(`Uninstalling driver from ${sessionName}`);
-            try {
-                await (0, bootstrap_js_1.uninstallDriver)(sessionName, driverPlatform);
-            }
-            catch (err) {
-                dlog(`Uninstall driver error: ${err instanceof Error ? err.message : String(err)}`);
             }
         }
     }
@@ -171,12 +196,24 @@ async function main() {
                 driverPlatform = platform;
                 driverPort = await (0, bootstrap_js_1.getDriverPort)(platform, sessionName);
                 dlog(`Platform: ${platform}, port: ${driverPort}`);
-                if (await (0, bootstrap_js_1.isPortOpen)(driverPort)) {
+                let driverAlive;
+                if (platform === 'android') {
+                    const probe = new android_js_1.AndroidDriver(sessionName, driverPort);
+                    await probe.connect();
+                    driverAlive = await probe.isAlive().catch(() => false);
+                    probe.close();
+                }
+                else {
+                    // Both 'ios' and 'tvos' use an HTTP server — port open = alive
+                    driverAlive = await (0, bootstrap_js_1.isPortOpen)(driverPort);
+                }
+                if (driverAlive) {
+                    _driverStarted = true;
                     dlog(`Driver already running on port ${driverPort}`);
                     return;
                 }
                 // Android: install APKs before starting the driver.
-                // iOS: startIOSDriver uses xcodebuild which installs silently via DependentProductPaths.
+                // iOS/tvOS: xcodebuild installs silently via DependentProductPaths.
                 if (platform === 'android') {
                     dlog(`Installing Android driver on ${sessionName}`);
                     await (0, bootstrap_js_1.installDriver)(sessionName);
@@ -187,9 +224,14 @@ async function main() {
                     if (platform === 'ios') {
                         await (0, bootstrap_js_1.startIOSDriver)(sessionName, driverPort);
                     }
+                    else if (platform === 'tvos') {
+                        // First install — dismiss the runner app to return to homescreen
+                        await (0, bootstrap_js_1.startTvOSDriver)(sessionName, driverPort, /* dismissAfterLaunch */ true);
+                    }
                     else {
                         await (0, bootstrap_js_1.startAndroidDriver)(sessionName, driverPort);
                     }
+                    _driverStarted = true;
                     dlog(`Driver started successfully`);
                 }
                 catch (err) {