@xenon-device-management/xenon 2.9.1 → 2.10.0

package/lib/src/dashboard/event-manager.js

@@ -64,8 +64,6 @@ const asset_manager_1 = require("./asset-manager");
 const commands_1 = require("./commands");
 const SessionStatus_1 = require("../types/SessionStatus");
 const appium_ios_device_1 = require("appium-ios-device");
-const AndroidAppProfiler_1 = require("../profiling/AndroidAppProfiler");
-const appium_adb_1 = require("appium-adb");
 const config_1 = require("../config");
 const helpers_2 = require("../helpers");
 const typedi_1 = require("typedi");
@@ -80,6 +78,7 @@ const SocketEvents_1 = require("../enums/SocketEvents");
 const types_1 = require("../services/healing/types");
 const SelectorStateService_1 = require("../services/SelectorStateService");
 const recording_store_1 = require("../services/recording/recording-store");
+const SessionMetricsService_1 = require("../services/metrics/SessionMetricsService");
 const typedi_2 = require("typedi");
 /**
  * What a Session row keeps of the capabilities the driver returned. The row
@@ -105,8 +104,6 @@ let DashboardEventManager = class DashboardEventManager {
         this.sessionToUdid = new Map();
         // Map session ID to device info
         this.sessionToDevice = new Map();
-        // Store app profilers for Android sessions
-        this.appProfilers = new Map();
         // Track last log line for each session (for device logs)
         this.lastLogLine = new Map();
         // Track start time for each command to calculate duration
@@ -124,8 +121,10 @@ let DashboardEventManager = class DashboardEventManager {
             };
             // create directory to store screenshots, videos and log files for the session
             (0, asset_manager_1.prepareDirectory)(session.getId());
-            // Initialize app profiling for Android sessions
-            const { is_profiling_available, device_info } = yield this.startAppProfiling(session.getId(), device, session.getCapabilities());
+            // CPU and memory for the session page's Performance panel; sampling
+            // starts once the session's row exists, since the samples point at it.
+            const metrics = typedi_1.Container.get(SessionMetricsService_1.SessionMetricsService);
+            const sampled = metrics.appliesTo(device);
             // If iOS real device, start performance recording (Time Profiler)
             // Note: This only works on real devices with XCUITest driver 4.5+
             let isIosProfilingStarted = false;
@@ -149,10 +148,17 @@ let DashboardEventManager = class DashboardEventManager {
             const sessionResponse = lodash_1.default.assign({}, session.getCapabilities());
             const tracingService = typedi_1.Container.get(TracingService_1.TracingService);
             const traceId = tracingService.getTraceId(session.getId());
-            const createData = Object.assign(Object.assign({ id: session.getId(), build: build.id ? { connect: { id: build.id } } : undefined, name: capabilities[XenonCapabilityManager_1.XENON_CAPABILITIES.SESSION_NAME] || undefined }, storedSessionCapabilities(sessionResponse)), { node_id: device.nodeId || '', has_live_video: session.getLiveVideoUrl() !== null, video_recording_enabled: capabilities[XenonCapabilityManager_1.XENON_CAPABILITIES.VIDEO_RECORDING] === true, is_profiling_available: is_profiling_available || isIosProfilingStarted, device_info: device_info ? JSON.stringify(device_info) : null, device_udid: device.udid || '', device_platform: device.platform || '', device_version: device.sdk || '', device_name: device.name, trace_id: traceId, status: 'running', api_key_id: (_a = session.apiKeyId) !== null && _a !== void 0 ? _a : null, user_id: (_b = session.userId) !== null && _b !== void 0 ? _b : null });
+            const createData = Object.assign(Object.assign({ id: session.getId(), build: build.id ? { connect: { id: build.id } } : undefined, name: capabilities[XenonCapabilityManager_1.XENON_CAPABILITIES.SESSION_NAME] || undefined }, storedSessionCapabilities(sessionResponse)), { node_id: device.nodeId || '', has_live_video: session.getLiveVideoUrl() !== null, video_recording_enabled: capabilities[XenonCapabilityManager_1.XENON_CAPABILITIES.VIDEO_RECORDING] === true, is_profiling_available: sampled || isIosProfilingStarted, device_udid: device.udid || '', device_platform: device.platform || '', device_version: device.sdk || '', device_name: device.name, trace_id: traceId, status: 'running', api_key_id: (_a = session.apiKeyId) !== null && _a !== void 0 ? _a : null, user_id: (_b = session.userId) !== null && _b !== void 0 ? _b : null });
             yield prisma_1.prisma.session.create({
                 data: createData,
             });
+            if (sampled) {
+                metrics.start({
+                    sessionId: session.getId(),
+                    device,
+                    capabilities: session.getCapabilities(),
+                });
+            }
             // Emit session started event
             void typedi_1.Container.get(SocketServer_1.SocketServer).emitToDashboardForDevices(SocketEvents_1.SocketEvents.SESSION_STARTED, Object.assign(Object.assign({}, createData), { status: 'running', build_name: buildName }), { udid: device.udid });
             // Increment Metrics
@@ -198,14 +204,14 @@ let DashboardEventManager = class DashboardEventManager {
             this.stoppingSessionIds.add(sessionId);
             try {
                 logger_1.default.info(`🟢 onSessionStopped called for session ${sessionId}`);
+                // However the session ended, in memory or not, its sampler stops here.
+                yield typedi_1.Container.get(SessionMetricsService_1.SessionMetricsService).stop(sessionId);
                 // Video recording is now handled in plugin.ts deleteSession() before the session is deleted
                 // This ensures we can call stop_recording_screen while the session is still active
                 // Here we just handle the session status update
                 const session = SessionManager_1.SESSION_MANAGER.getSession(sessionId);
                 if (session) {
                     logger_1.default.info(`Session ${sessionId} found in SESSION_MANAGER`);
-                    // Save Android profiling data before cleanup
-                    yield this.saveAppProfilingData(sessionId);
                     // iOS profiling is now handled in plugin.ts deleteSession() before the session is deleted
                     // This ensures we can call mobile: stopPerfRecord while the driver is still alive
                     // Clean up syslog service for real iOS devices
@@ -689,96 +695,6 @@ let DashboardEventManager = class DashboardEventManager {
             }
         });
     }
-    startAppProfiling(sessionId, device, sessionCapabilities) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // Only support Android profiling
-            if (device.platform.toLowerCase() !== 'android') {
-                return { is_profiling_available: false };
-            }
-            // Check if we have an app package
-            const appPackage = (sessionCapabilities === null || sessionCapabilities === void 0 ? void 0 : sessionCapabilities.appPackage) || (sessionCapabilities === null || sessionCapabilities === void 0 ? void 0 : sessionCapabilities['appium:appPackage']);
-            if (!appPackage) {
-                logger_1.default.info(`[Profiling] No app package found for session ${sessionId}, skipping profiling`);
-                return { is_profiling_available: false };
-            }
-            try {
-                // Principal Intelligence: Use the Properly configured ADB from the manager
-                // instead of a naked instance, to avoid 'defaultArgs not iterable' crashes.
-                const deviceManager = typedi_1.Container.get(device_managers_1.XenonManager);
-                const androidManager = (yield deviceManager.deviceInstances()).find((m) => m instanceof AndroidDeviceManager_1.default);
-                let adb;
-                if (androidManager) {
-                    adb = yield androidManager.getAdbForDevice(device.udid);
-                }
-                else {
-                    adb = yield appium_adb_1.ADB.createADB({});
-                }
-                // Create app profiler
-                const profiler = new AndroidAppProfiler_1.AndroidAppProfiler({
-                    adb,
-                    deviceUDID: device.udid,
-                    appPackage,
-                });
-                // Get device info and start capture
-                const device_info = yield profiler.getDeviceInfo();
-                yield profiler.startCapture();
-                // Store profiler for this session
-                this.appProfilers.set(sessionId, profiler);
-                logger_1.default.info(`[Profiling] Started app profiling for session ${sessionId}`);
-                return {
-                    is_profiling_available: true,
-                    device_info,
-                };
-            }
-            catch (err) {
-                logger_1.default.error(`[Profiling] Error initializing app profiler for session ${sessionId}: ${err.message}`);
-                return { is_profiling_available: false };
-            }
-        });
-    }
-    saveAppProfilingData(sessionId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const profiler = this.appProfilers.get(sessionId);
-            if (!profiler) {
-                return;
-            }
-            try {
-                // Stop capture
-                yield profiler.stopCapture();
-                // Get logs
-                const logs = profiler.getLogs();
-                if (logs.length === 0) {
-                    logger_1.default.info(`[Profiling] No profiling data to save for session ${sessionId}`);
-                    return;
-                }
-                // Save to database
-                const profilingEntries = logs.map((log) => ({
-                    session_id: sessionId,
-                    cpu: log.cpu,
-                    memory: log.memory,
-                    total_cpu_used: log.total_cpu_used.toString(),
-                    total_memory_used: log.total_memory_used.toString(),
-                    raw_cpu_log: log.raw_cpu_log,
-                    raw_memory_log: log.raw_memory_log,
-                    timestamp: new Date(log.timestamp),
-                }));
-                // Batch insert profiling data
-                for (const entry of profilingEntries) {
-                    yield prisma_1.prisma.profiling.create({
-                        data: entry,
-                    });
-                }
-                logger_1.default.info(`[Profiling] Saved ${profilingEntries.length} profiling entries for session ${sessionId}`);
-            }
-            catch (err) {
-                logger_1.default.error(`[Profiling] Error saving profiling data for session ${sessionId}: ${err.message}`);
-            }
-            finally {
-                // Clean up profiler
-                this.appProfilers.delete(sessionId);
-            }
-        });
-    }
     // ─── Recording (free-form mosaic) events ─────────────────────────────────
     // Emitted by RecordingOrchestrator. Distinct namespace from SESSION_*; the
     // dashboard listens to both independently. Team-scoped: a group's started

package/lib/src/device-managers/ios/IOSDiscoveryService.js

@@ -1,43 +1,10 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
@@ -60,10 +27,8 @@ const node_simctl_1 = __importDefault(require("node-simctl"));
 const lodash_1 = require("lodash");
 const appium_ios_device_1 = require("appium-ios-device");
 const appleIdentity_1 = require("./appleIdentity");
-const goIosBinary_1 = require("./goIosBinary");
 const deviceIdentity_1 = require("../deviceIdentity");
 const logger_1 = __importDefault(require("../../logger"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
 const device_utils_1 = require("../../device-utils");
 const device_store_1 = require("../../data-service/device-store");
 const PluginContext_1 = require("../../PluginContext");
@@ -160,8 +125,7 @@ let IOSDiscoveryService = class IOSDiscoveryService {
                 try {
                     const existingDevice = existingDeviceDetails.find((device) => device.udid === udid && device.host === ownHost);
                     if (existingDevice) {
-                        const networkIp = yield this.fetchRealDeviceNetworkIp(udid);
-                        return Object.assign(Object.assign({}, existingDevice), { ip: networkIp || (0, networkAddresses_1.sanitizeDeviceNetworkIp)(existingDevice.ip) || '' });
+                        return Object.assign(Object.assign({}, existingDevice), { ip: (0, networkAddresses_1.sanitizeDeviceNetworkIp)(existingDevice.ip) || '' });
                     }
                     return yield this.getDeviceInfo(udid);
                 }
@@ -192,7 +156,6 @@ let IOSDiscoveryService = class IOSDiscoveryService {
             const totalUtilizationTimeMilliSec = yield (0, device_utils_1.getUtilizationTime)(udid);
             let sdk = 'Unknown';
             let name = 'iPhone';
-            const ipAddress = yield this.fetchRealDeviceNetworkIp(udid);
             try {
                 [sdk, name] = yield Promise.all([appium_ios_device_1.utilities.getOSVersion(udid), appium_ios_device_1.utilities.getDeviceName(udid)]);
             }
@@ -211,7 +174,11 @@ let IOSDiscoveryService = class IOSDiscoveryService {
                 mjpegServerPort,
                 udid,
                 sdk,
-                name, ip: ipAddress, busy: false, realDevice: true, deviceType: 'real', cpuArchitecture: 'arm64', platform: (name.toLowerCase().includes('tv') ? 'tvos' : 'ios'), host: host, totalUtilizationTimeMilliSec, sessionStartTime: 0, state: (storeDevice === null || storeDevice === void 0 ? void 0 : storeDevice.state) || 'Unknown', userBlocked: (storeDevice === null || storeDevice === void 0 ? void 0 : storeDevice.userBlocked) || false }, (storeDevice || {})), (0, deviceIdentity_1.nonNullIdentity)(identity));
+                name, 
+                // go-ios can't tell a phone's network address (its lockdown values
+                // carry none), and Xenon reaches a phone only through its forwarded
+                // ports, so nothing asks for it.
+                ip: '', busy: false, realDevice: true, deviceType: 'real', cpuArchitecture: 'arm64', platform: (name.toLowerCase().includes('tv') ? 'tvos' : 'ios'), host: host, totalUtilizationTimeMilliSec, sessionStartTime: 0, state: (storeDevice === null || storeDevice === void 0 ? void 0 : storeDevice.state) || 'Unknown', userBlocked: (storeDevice === null || storeDevice === void 0 ? void 0 : storeDevice.userBlocked) || false }, (storeDevice || {})), (0, deviceIdentity_1.nonNullIdentity)(identity));
         });
     }
     getSimulators() {
@@ -280,32 +247,6 @@ let IOSDiscoveryService = class IOSDiscoveryService {
     resolveNodeLanIp() {
         return (0, networkAddresses_1.resolveAdvertisedBindHost)(this.pluginArgs.bindHostOrIp);
     }
-    fetchRealDeviceNetworkIp(udid) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return (0, networkAddresses_1.sanitizeDeviceNetworkIp)(yield this.fetchIpViaGoIos(udid));
-        });
-    }
-    fetchIpViaGoIos(udid) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const goIOSPath = (0, goIosBinary_1.goIosBinaryPath)();
-            if (!fs_extra_1.default.existsSync(goIOSPath))
-                return '';
-            const { exec } = yield Promise.resolve().then(() => __importStar(require('child_process')));
-            const { promisify } = yield Promise.resolve().then(() => __importStar(require('util')));
-            const execPromise = promisify(exec);
-            try {
-                const { stdout } = yield execPromise(`"${goIOSPath}" info --udid ${udid}`, {
-                    env: Object.assign(Object.assign({}, process.env), { ENABLE_GO_IOS_AGENT: 'yes' }),
-                });
-                const info = JSON.parse(stdout);
-                return info.IPAddress || '';
-            }
-            catch (e) {
-                logger_1.default.debug(`Failed to fetch IP via go-ios for ${udid}: ${e}`);
-                return '';
-            }
-        });
-    }
     trackIOSDevices() {
         if (this.trackingInitialized)
             return;

package/lib/src/device-managers/ios/IOSStreamService.js

@@ -401,9 +401,10 @@ let IOSStreamService = class IOSStreamService {
         });
     }
     /**
-     * Comprehensive process-level and endpoint-level health check.
-     * Principal Intelligence: Differentiates between 'Process dead' and 'Network unreachable'.
-     * If only the tunnel is dead but WDA is alive via IP, it will trigger a tunnel restart.
+     * Comprehensive process-level and endpoint-level health check: WDA and its
+     * forwarders are running, and WDA answers on the stream's own port. Only
+     * that port: WDA names no phone, so nothing that answers elsewhere (a
+     * simulator's address is this Mac's own) is known to be this phone's.
      */
     isStreamResponsive(udid) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -419,78 +420,18 @@ let IOSStreamService = class IOSStreamService {
                 return false;
             }
             if (!isWdaIproxyAlive || !isMjpegIproxyAlive) {
-                logger_1.default.warn(`🛡️ [${udid}] [Watchdog] Tunnel processes are dead. Attempting tunnel-only recovery...`);
-                const device = yield (0, ownDeviceRow_1.findOwnDevice)(udid);
-                if (device && device.ip) {
-                    // Double check if WDA is alive via network IP
-                    const isWdaAccessibleViaNetwork = yield this.isWDARunningOnHost(device.ip, 8100);
-                    if (isWdaAccessibleViaNetwork) {
-                        logger_1.default.info(`🛡️ [${udid}] [Watchdog] WDA is alive on network ${device.ip}. Restarting tunnels...`);
-                        yield this.restartTunnelsOnly(session);
-                        return true; // We healed it!
-                    }
-                }
-                return false; // Cannot heal without network access or if WDA is also dead
+                logger_1.default.warn(`🛡️ [${udid}] [Watchdog] Port forwarder processes are dead.`);
+                return false;
             }
             // 2. Network Check: verify endpoint is responding via tunnel
             const isRespondingViaTunnel = yield this.isWDARunning(session.wdaPort);
             if (!isRespondingViaTunnel) {
-                logger_1.default.warn(`🛡️ [${udid}] [Watchdog] WDA tunnel on port ${session.wdaPort} is unresponsive. checking network...`);
-                const device = yield (0, ownDeviceRow_1.findOwnDevice)(udid);
-                if (device && device.ip) {
-                    const isWdaAccessibleViaNetwork = yield this.isWDARunningOnHost(device.ip, 8100);
-                    if (isWdaAccessibleViaNetwork) {
-                        logger_1.default.info(`🛡️ [${udid}] [Watchdog] WDA is alive on network but tunnel is hung. Restarting tunnels...`);
-                        yield this.restartTunnelsOnly(session);
-                        return true;
-                    }
-                }
+                logger_1.default.warn(`🛡️ [${udid}] [Watchdog] WDA on port ${session.wdaPort} is unresponsive.`);
                 return false;
             }
             return true;
         });
     }
-    /**
-     * Check if WDA is running on a specific host/port
-     */
-    isWDARunningOnHost(host, port) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const axios = (yield Promise.resolve().then(() => __importStar(require('axios')))).default;
-            try {
-                const response = yield axios.get(`http://${host}:${port}/status`, {
-                    timeout: 3000,
-                    validateStatus: (status) => status === 200,
-                });
-                return ((_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.value) === null || _b === void 0 ? void 0 : _b.ready) === true;
-            }
-            catch (e) {
-                return false;
-            }
-        });
-    }
-    /**
-     * Restarts only the iproxy tunnels without stopping WDA
-     */
-    restartTunnelsOnly(session) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const udid = session.udid;
-            const isolationService = typedi_2.Container.get(ResourceIsolationService_1.ResourceIsolationService);
-            // 1. Kill old tunnels
-            if (session.forwardWDAProcess)
-                session.forwardWDAProcess.kill('SIGKILL');
-            if (session.forwardMJPEGProcess)
-                session.forwardMJPEGProcess.kill('SIGKILL');
-            // 2. Start new tunnels
-            const wdaIproxy = isolationService.wrapSpawn('iproxy', ['-u', udid, `${session.wdaPort}:8100`], 'Performance');
-            const mjpegIproxy = isolationService.wrapSpawn('iproxy', ['-u', udid, `${session.mjpegPort}:9100`], 'Performance');
-            session.forwardWDAProcess = (0, child_process_1.spawn)(wdaIproxy.command, wdaIproxy.args);
-            typedi_2.Container.get(ProcessRegistry_1.ProcessRegistry).track({ kind: 'other', udid, process: session.forwardWDAProcess });
-            session.forwardMJPEGProcess = (0, child_process_1.spawn)(mjpegIproxy.command, mjpegIproxy.args);
-            typedi_2.Container.get(ProcessRegistry_1.ProcessRegistry).track({ kind: 'ios-mjpeg', udid, process: session.forwardMJPEGProcess });
-            logger_1.default.info(`🛡️ [${udid}] [Watchdog] Tunnels restarted successfully.`);
-        });
-    }
     /**
      * Start streaming for a device
      */

package/lib/src/device-managers/ios/WDAClient.js

@@ -92,96 +92,75 @@ let WDAClient = WDAClient_1 = class WDAClient {
             }
             const prefixes = (cached === null || cached === void 0 ? void 0 : cached.sessionId) ? [`/session/${cached.sessionId}`] : ['', '/session/any'];
             let lastError;
-            // Principal Intelligence: Prioritize the host that worked last time.
-            // Usually localhost (tunnel) is fastest, but if it's lagging, network IP is a solid fallback.
-            const hosts = [];
-            if (cached === null || cached === void 0 ? void 0 : cached.host) {
-                hosts.push(cached.host);
-                if (cached.host === '127.0.0.1' && device.ip)
-                    hosts.push(device.ip);
-                if (cached.host !== '127.0.0.1')
-                    hosts.push('127.0.0.1');
-            }
-            else {
-                hosts.push('127.0.0.1');
-                if (device.ip)
-                    hosts.push(device.ip);
-            }
-            for (const targetHost of hosts) {
-                const isNetworkHost = targetHost !== '127.0.0.1';
-                const targetPort = isNetworkHost ? 8100 : port;
-                for (const prefix of prefixes) {
-                    try {
-                        const isSessionless = !(options === null || options === void 0 ? void 0 : options.useSessionPath) &&
-                            (['/status', '/health', '/wda/healthcheck'].includes(endpoint));
-                        const url = `http://${targetHost}:${targetPort}${isSessionless ? '' : prefix}${endpoint}`;
-                        // Principal Stability: Screenshots, activation, and script execution need longer timeouts.
-                        // Heartbeats and Status checks should be snappy to fail-over quickly.
-                        const isHeavyCommand = endpoint.includes('screenshot') ||
-                            endpoint.includes('source') ||
-                            endpoint.includes('swipe') ||
-                            endpoint.includes('touchAndHold') ||
-                            endpoint.includes('activate') ||
-                            endpoint.includes('execute') ||
-                            endpoint.includes('actions');
-                        const timeout = isHeavyCommand ? 30000 : 5000; // Snappy 5s timeout for standard commands
-                        const res = method === 'post'
-                            ? yield axios_1.default.post(url, data || {}, { timeout })
-                            : yield axios_1.default.get(url, { timeout });
-                        // If we reached a host but it returned a logical error (e.g. 404 for session),
-                        // we should update our cache and potentially stop retrying this host/prefix combo.
-                        // However, for simplicity, we treat any successful HTTP response as "Host is alive".
-                        if (isNetworkHost && targetHost !== (cached === null || cached === void 0 ? void 0 : cached.host)) {
-                            this.log.debug(`[WDA] Successful fallback to network IP ${targetHost} for ${udid}`);
-                        }
-                        const sid = ((_a = res.data) === null || _a === void 0 ? void 0 : _a.sessionId) || ((_c = (_b = res.data) === null || _b === void 0 ? void 0 : _b.value) === null || _c === void 0 ? void 0 : _c.sessionId);
-                        if (sid && sid !== (cached === null || cached === void 0 ? void 0 : cached.sessionId)) {
-                            this.log.debug(`[WDA] Detected new session ID: ${sid} via ${targetHost}`);
-                            this.wdaConnectionCache.set(cacheKey, {
-                                host: targetHost,
-                                pathPrefix: `/session/${sid}`,
-                                sessionId: sid,
-                            });
-                            typedi_1.Container.get(IOSStreamService_1.default).setWDASessionId(udid, sid);
-                        }
-                        return res;
+            // Only the phone's own forwarded port. WDA names no phone, so no address
+            // on the network is known to be this phone's: a simulator's is this
+            // Mac's own, where port 8100 can be an iPhone's WDA forward.
+            const targetHost = '127.0.0.1';
+            for (const prefix of prefixes) {
+                try {
+                    const isSessionless = !(options === null || options === void 0 ? void 0 : options.useSessionPath) &&
+                        (['/status', '/health', '/wda/healthcheck'].includes(endpoint));
+                    const url = `http://${targetHost}:${port}${isSessionless ? '' : prefix}${endpoint}`;
+                    // Principal Stability: Screenshots, activation, and script execution need longer timeouts.
+                    // Heartbeats and Status checks should be snappy to fail-over quickly.
+                    const isHeavyCommand = endpoint.includes('screenshot') ||
+                        endpoint.includes('source') ||
+                        endpoint.includes('swipe') ||
+                        endpoint.includes('touchAndHold') ||
+                        endpoint.includes('activate') ||
+                        endpoint.includes('execute') ||
+                        endpoint.includes('actions');
+                    const timeout = isHeavyCommand ? 30000 : 5000; // Snappy 5s timeout for standard commands
+                    const res = method === 'post'
+                        ? yield axios_1.default.post(url, data || {}, { timeout })
+                        : yield axios_1.default.get(url, { timeout });
+                    // If we reached a host but it returned a logical error (e.g. 404 for session),
+                    // we should update our cache and potentially stop retrying this host/prefix combo.
+                    // However, for simplicity, we treat any successful HTTP response as "Host is alive".
+                    const sid = ((_a = res.data) === null || _a === void 0 ? void 0 : _a.sessionId) || ((_c = (_b = res.data) === null || _b === void 0 ? void 0 : _b.value) === null || _c === void 0 ? void 0 : _c.sessionId);
+                    if (sid && sid !== (cached === null || cached === void 0 ? void 0 : cached.sessionId)) {
+                        this.log.debug(`[WDA] Detected new session ID: ${sid} via ${targetHost}`);
+                        this.wdaConnectionCache.set(cacheKey, {
+                            host: targetHost,
+                            pathPrefix: `/session/${sid}`,
+                            sessionId: sid,
+                        });
+                        typedi_1.Container.get(IOSStreamService_1.default).setWDASessionId(udid, sid);
                     }
-                    catch (err) {
-                        lastError = err;
-                        if (err.response) {
-                            const status = err.response.status;
-                            const errorMsg = JSON.stringify(err.response.data);
-                            this.log.info(`[WDA] Command ${method.toUpperCase()} ${endpoint} failed (${status}): ${errorMsg}`);
-                            // Principal Resiliency: Multi-Phase Recovery
-                            if (retryCount < 2) {
-                                // Phase 1: Dead Session Recovery (404)
-                                if (status === 404 && prefix.includes('/session/')) {
-                                    // Special Intelligence: Some WDA versions don't support /execute, /wda/homescreen, etc.
-                                    // We should NOT clear the session if these specific commands fail with 404,
-                                    // as they might just be unsupported features.
-                                    const NON_FATAL_ENDPOINTS = ['execute', 'homescreen', 'pressButton'];
-                                    if (NON_FATAL_ENDPOINTS.some((e) => endpoint.includes(e))) {
-                                        this.log.debug(`[WDA] Command ${endpoint} failed with 404 (Unsupported or Logical Error). Skipping session reset.`);
-                                        throw err;
-                                    }
-                                    this.log.warn(`[WDA] Session ${cached === null || cached === void 0 ? void 0 : cached.sessionId} appears dead. Resetting and retrying...`);
-                                    this.wdaConnectionCache.delete(cacheKey);
-                                    typedi_1.Container.get(IOSStreamService_1.default).setWDASessionId(udid, '');
-                                    return this.performWDACommand(udid, method, endpoint, data, retryCount + 1, options);
-                                }
-                                // Phase 2: Transient State Recovery (500)
-                                // This handles "Focused" errors, "Internal" errors, or transient locks during app switches.
-                                if (status === 500) {
-                                    this.log.warn(`[WDA] Transient error (500) for ${udid}, retrying in 1s... (Reason: ${errorMsg})`);
-                                    yield new Promise((r) => setTimeout(r, 1000));
-                                    return this.performWDACommand(udid, method, endpoint, data, retryCount + 1, options);
+                    return res;
+                }
+                catch (err) {
+                    lastError = err;
+                    if (err.response) {
+                        const status = err.response.status;
+                        const errorMsg = JSON.stringify(err.response.data);
+                        this.log.info(`[WDA] Command ${method.toUpperCase()} ${endpoint} failed (${status}): ${errorMsg}`);
+                        // Principal Resiliency: Multi-Phase Recovery
+                        if (retryCount < 2) {
+                            // Phase 1: Dead Session Recovery (404)
+                            if (status === 404 && prefix.includes('/session/')) {
+                                // Special Intelligence: Some WDA versions don't support /execute, /wda/homescreen, etc.
+                                // We should NOT clear the session if these specific commands fail with 404,
+                                // as they might just be unsupported features.
+                                const NON_FATAL_ENDPOINTS = ['execute', 'homescreen', 'pressButton'];
+                                if (NON_FATAL_ENDPOINTS.some((e) => endpoint.includes(e))) {
+                                    this.log.debug(`[WDA] Command ${endpoint} failed with 404 (Unsupported or Logical Error). Skipping session reset.`);
+                                    throw err;
                                 }
+                                this.log.warn(`[WDA] Session ${cached === null || cached === void 0 ? void 0 : cached.sessionId} appears dead. Resetting and retrying...`);
+                                this.wdaConnectionCache.delete(cacheKey);
+                                typedi_1.Container.get(IOSStreamService_1.default).setWDASessionId(udid, '');
+                                return this.performWDACommand(udid, method, endpoint, data, retryCount + 1, options);
+                            }
+                            // Phase 2: Transient State Recovery (500)
+                            // This handles "Focused" errors, "Internal" errors, or transient locks during app switches.
+                            if (status === 500) {
+                                this.log.warn(`[WDA] Transient error (500) for ${udid}, retrying in 1s... (Reason: ${errorMsg})`);
+                                yield new Promise((r) => setTimeout(r, 1000));
+                                return this.performWDACommand(udid, method, endpoint, data, retryCount + 1, options);
                             }
-                            throw err;
                         }
-                        // If network host fails, don't retry other prefixes if it's just a status check
-                        if (isNetworkHost && ['/status', '/health'].includes(endpoint))
-                            break;
+                        throw err;
                     }
                 }
             }