@blitzdev/iphone-mcp 0.1.7

package/dist/wda/wda-client.d.ts

@@ -0,0 +1,38 @@
+export declare class WDAClient {
+    private static instances;
+    private baseUrl;
+    private sessionId;
+    private udid;
+    private port;
+    private constructor();
+    static getInstance(udid: string, port?: number, host?: string): WDAClient;
+    static getExistingInstance(udid: string, port?: number): WDAClient | null;
+    static removeInstance(udid: string, port?: number): void;
+    private request;
+    isReachable(): Promise<boolean>;
+    createSession(): Promise<void>;
+    destroySession(): Promise<void>;
+    private ensureSession;
+    tap(x: number, y: number, duration?: number): Promise<void>;
+    swipe(fromX: number, fromY: number, toX: number, toY: number, duration?: number): Promise<void>;
+    inputText(text: string): Promise<void>;
+    pressButton(button: string, duration?: number): Promise<void>;
+    pressKey(key: number | string, _duration?: number): Promise<void>;
+    pressKeySequence(keySequence: (number | string)[]): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    getWindowSize(): Promise<{
+        width: number;
+        height: number;
+    }>;
+    getSource(): Promise<string>;
+    describeAll(nested?: boolean): Promise<unknown>;
+    describePoint(x: number, y: number, nested?: boolean): Promise<unknown>;
+    parseAccessibilityXml(xml: string, nested?: boolean): Record<string, unknown>[];
+    private parseXmlAttributes;
+    private normalizeElementType;
+    private normalizeElement;
+    private findElementAtPoint;
+    activateApp(bundleId: string): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function getWDAClient(udid: string, port?: number): WDAClient;

package/dist/wda/wda-client.js

@@ -0,0 +1,314 @@
+import { log } from '../logger.js';
+export class WDAClient {
+    static instances = new Map();
+    baseUrl;
+    sessionId = null;
+    udid;
+    port;
+    constructor(udid, port = 8100, host) {
+        this.udid = udid;
+        this.port = port;
+        if (host) {
+            const hostPart = host.includes(':') ? `[${host}]` : host;
+            this.baseUrl = `http://${hostPart}:${port}`;
+        }
+        else {
+            this.baseUrl = `http://localhost:${port}`;
+        }
+    }
+    static getInstance(udid, port = 8100, host) {
+        const key = `${udid}:${port}`;
+        const existing = WDAClient.instances.get(key);
+        if (existing) {
+            if (host) {
+                const hostPart = host.includes(':') ? `[${host}]` : host;
+                existing.baseUrl = `http://${hostPart}:${port}`;
+            }
+            return existing;
+        }
+        const instance = new WDAClient(udid, port, host);
+        WDAClient.instances.set(key, instance);
+        return instance;
+    }
+    static getExistingInstance(udid, port = 8100) {
+        return WDAClient.instances.get(`${udid}:${port}`) ?? null;
+    }
+    static removeInstance(udid, port = 8100) {
+        WDAClient.instances.delete(`${udid}:${port}`);
+    }
+    async request(method, path, body, _retried) {
+        const url = `${this.baseUrl}${path}`;
+        const options = {
+            method,
+            headers: { 'Content-Type': 'application/json' },
+        };
+        if (body)
+            options.body = JSON.stringify(body);
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const text = await response.text();
+            if (response.status === 404 && (text.includes('invalid session id') || text.includes('Session does not exist'))) {
+                log('WDAClient', 'warn', `Session ${this.sessionId} is stale, clearing and retrying`);
+                this.sessionId = null;
+                if (!_retried && path.includes('/session/')) {
+                    await this.createSession();
+                    const newPath = path.replace(/\/session\/[^/]+/, `/session/${this.sessionId}`);
+                    return this.request(method, newPath, body, true);
+                }
+            }
+            let shortMessage = text;
+            try {
+                const parsed = JSON.parse(text);
+                if (parsed?.value?.message) {
+                    const msg = parsed.value.message;
+                    const nsDesc = msg.match(/NSLocalizedDescription=([^,}]+)/);
+                    shortMessage = nsDesc ? nsDesc[1] : msg.split('UserInfo=')[0].trim();
+                }
+            }
+            catch { /* not JSON, use raw text */ }
+            log('WDAClient', 'error', `WDA ${method} ${path} -> ${response.status}: ${text}`);
+            throw new Error(shortMessage);
+        }
+        return response.json();
+    }
+    async isReachable() {
+        try {
+            const status = await this.request('GET', '/status');
+            return status.value?.ready === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async createSession() {
+        if (this.sessionId)
+            return;
+        log('WDAClient', 'log', `Creating WDA session for ${this.udid}...`);
+        const response = await this.request('POST', '/session', {
+            capabilities: { alwaysMatch: {}, firstMatch: [{}] },
+        });
+        this.sessionId = response.value?.sessionId ?? response.sessionId;
+        log('WDAClient', 'log', `WDA session created: ${this.sessionId}`);
+    }
+    async destroySession() {
+        if (!this.sessionId)
+            return;
+        try {
+            await this.request('DELETE', `/session/${this.sessionId}`);
+        }
+        catch (e) {
+            log('WDAClient', 'warn', `Failed to destroy WDA session: ${e}`);
+        }
+        this.sessionId = null;
+    }
+    async ensureSession() {
+        if (!this.sessionId)
+            await this.createSession();
+        return this.sessionId;
+    }
+    async tap(x, y, duration) {
+        const sessionId = await this.ensureSession();
+        log('WDAClient', 'log', `Tap at (${x}, ${y}) duration=${duration}`);
+        if (duration && duration > 0) {
+            await this.request('POST', `/session/${sessionId}/wda/touchAndHold`, { x, y, duration });
+        }
+        else {
+            await this.request('POST', `/session/${sessionId}/actions`, {
+                actions: [{
+                        type: 'pointer',
+                        id: 'finger1',
+                        parameters: { pointerType: 'touch' },
+                        actions: [
+                            { type: 'pointerMove', duration: 0, x, y },
+                            { type: 'pointerDown', button: 0 },
+                            { type: 'pause', duration: 100 },
+                            { type: 'pointerUp', button: 0 },
+                        ],
+                    }],
+            });
+        }
+    }
+    async swipe(fromX, fromY, toX, toY, duration) {
+        const sessionId = await this.ensureSession();
+        const moveDuration = Math.round((duration ?? 0.3) * 1000);
+        log('WDAClient', 'log', `Swipe from (${fromX}, ${fromY}) to (${toX}, ${toY}) duration=${moveDuration}ms`);
+        await this.request('POST', `/session/${sessionId}/actions`, {
+            actions: [{
+                    type: 'pointer',
+                    id: 'finger1',
+                    parameters: { pointerType: 'touch' },
+                    actions: [
+                        { type: 'pointerMove', duration: 0, x: fromX, y: fromY },
+                        { type: 'pointerDown', button: 0 },
+                        { type: 'pointerMove', duration: moveDuration, x: toX, y: toY, origin: 'viewport' },
+                        { type: 'pointerUp', button: 0 },
+                    ],
+                }],
+        });
+    }
+    async inputText(text) {
+        const sessionId = await this.ensureSession();
+        log('WDAClient', 'log', `Input text: "${text.slice(0, 50)}"`);
+        await this.request('POST', `/session/${sessionId}/wda/keys`, { value: [...text] });
+    }
+    async pressButton(button, duration) {
+        const sessionId = await this.ensureSession();
+        log('WDAClient', 'log', `Press button: ${button} duration=${duration}`);
+        const buttonMap = {
+            HOME: 'home',
+            LOCK: 'lock',
+            SIDE_BUTTON: 'lock',
+            VOLUME_UP: 'volumeUp',
+            VOLUME_DOWN: 'volumeDown',
+        };
+        const wdaButton = buttonMap[button] ?? button.toLowerCase();
+        await this.request('POST', `/session/${sessionId}/wda/pressButton`, {
+            name: wdaButton,
+            ...(duration ? { duration } : {}),
+        });
+    }
+    async pressKey(key, _duration) {
+        if (typeof key === 'string') {
+            await this.inputText(key);
+            return;
+        }
+        log('WDAClient', 'warn', `pressKey with HID keycode ${key} not supported on physical device`);
+    }
+    async pressKeySequence(keySequence) {
+        const text = keySequence.filter((k) => typeof k === 'string').join('');
+        if (text)
+            await this.inputText(text);
+    }
+    async screenshot() {
+        let sessionId = await this.ensureSession();
+        try {
+            const response = await this.request('GET', `/session/${sessionId}/screenshot`);
+            return Buffer.from(response.value, 'base64');
+        }
+        catch (e) {
+            if (!this.sessionId) {
+                sessionId = await this.ensureSession();
+                const response = await this.request('GET', `/session/${sessionId}/screenshot`);
+                return Buffer.from(response.value, 'base64');
+            }
+            throw e;
+        }
+    }
+    async getWindowSize() {
+        const sessionId = await this.ensureSession();
+        const response = await this.request('GET', `/session/${sessionId}/window/size`);
+        return response.value;
+    }
+    async getSource() {
+        const sessionId = await this.ensureSession();
+        const response = await this.request('GET', `/session/${sessionId}/source`);
+        return response.value;
+    }
+    async describeAll(nested) {
+        const xml = await this.getSource();
+        return this.parseAccessibilityXml(xml, nested);
+    }
+    async describePoint(x, y, nested) {
+        const xml = await this.getSource();
+        return this.findElementAtPoint(this.parseAccessibilityXml(xml, nested ?? true), x, y);
+    }
+    parseAccessibilityXml(xml, nested) {
+        const elements = [];
+        const elementRegex = /<(XCUIElementType\w+)\s+([^>]*?)(\s*\/>|>)/g;
+        let match;
+        while ((match = elementRegex.exec(xml)) !== null) {
+            const attrs = this.parseXmlAttributes(match[2]);
+            const elementType = this.normalizeElementType(match[1]);
+            const element = {
+                type: elementType,
+                AXLabel: attrs.label ?? null,
+                AXValue: attrs.value ?? null,
+                title: attrs.name ?? null,
+                frame: {
+                    x: Number(attrs.x ?? 0),
+                    y: Number(attrs.y ?? 0),
+                    width: Number(attrs.width ?? 0),
+                    height: Number(attrs.height ?? 0),
+                },
+                AXUniqueId: attrs.accessible === 'true' ? attrs.name : null,
+                enabled: attrs.enabled === 'true',
+                visible: attrs.visible === 'true',
+            };
+            if (!nested) {
+                if (element.visible && (element.enabled || elementType === 'StaticText')) {
+                    elements.push(element);
+                }
+            }
+            else {
+                elements.push(element);
+            }
+        }
+        return elements;
+    }
+    parseXmlAttributes(attrString) {
+        const attrs = {};
+        const attrRegex = /(\w+)="([^"]*)"/g;
+        let match;
+        while ((match = attrRegex.exec(attrString)) !== null) {
+            attrs[match[1]] = match[2];
+        }
+        return attrs;
+    }
+    normalizeElementType(wdaType) {
+        return wdaType.replace('XCUIElementType', '');
+    }
+    normalizeElement(raw) {
+        return {
+            type: this.normalizeElementType(raw.type ?? ''),
+            AXLabel: raw.label ?? null,
+            AXValue: raw.value ?? null,
+            frame: raw.rect ?? { x: 0, y: 0, width: 0, height: 0 },
+            enabled: raw.isEnabled ?? true,
+            visible: raw.isVisible ?? true,
+        };
+    }
+    findElementAtPoint(tree, x, y) {
+        if (!tree || typeof tree !== 'object')
+            return null;
+        const elements = Array.isArray(tree) ? tree : tree.children ?? [];
+        let best = null;
+        let bestArea = Infinity;
+        for (const el of elements) {
+            const r = el.rect ?? { x: 0, y: 0, width: 0, height: 0 };
+            if (x >= r.x && x <= r.x + r.width && y >= r.y && y <= r.y + r.height) {
+                const area = r.width * r.height;
+                if (area < bestArea) {
+                    bestArea = area;
+                    best = el;
+                }
+            }
+            if (el.children) {
+                const child = this.findElementAtPoint({ children: el.children }, x, y);
+                if (child) {
+                    const cr = child.rect;
+                    if (cr) {
+                        const childArea = cr.width * cr.height;
+                        if (childArea < bestArea) {
+                            bestArea = childArea;
+                            best = child;
+                        }
+                    }
+                }
+            }
+        }
+        return best ? this.normalizeElement(best) : null;
+    }
+    async activateApp(bundleId) {
+        const sessionId = await this.ensureSession();
+        await this.request('POST', `/session/${sessionId}/wda/apps/activate`, { bundleId });
+    }
+    async shutdown() {
+        await this.destroySession();
+        WDAClient.removeInstance(this.udid, this.port);
+        log('WDAClient', 'log', `[${this.udid}] Shutdown complete`);
+    }
+}
+export function getWDAClient(udid, port = 8100) {
+    return WDAClient.getInstance(udid, port);
+}
+//# sourceMappingURL=wda-client.js.map

package/dist/wda/wda-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wda-client.js","sourceRoot":"","sources":["../../src/wda/wda-client.ts"],"names":[],"mappings":"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"}

package/dist/wda/wda-manager.d.ts

@@ -0,0 +1,29 @@
+import { WDAClient } from './wda-client.js';
+export type WDASetupStep = 'connecting' | 'building_wda' | 'installing_wda' | 'establishing_connection' | 'ready';
+export interface WDASetupProgress {
+    step: WDASetupStep;
+    message: string;
+    error?: string;
+}
+type ProgressCallback = (progress: WDASetupProgress) => void;
+export declare class WDAManager {
+    private static instance;
+    private wdaProcesses;
+    static getInstance(): WDAManager;
+    private getWdaProjectPath;
+    private ensureWdaSource;
+    private getDerivedDataPath;
+    private detectTeamId;
+    getTunnelAddress(udid: string): Promise<string>;
+    isWDARunning(udid: string, port?: number): Promise<boolean>;
+    setupDevice(udid: string, onProgress?: ProgressCallback, port?: number): Promise<WDAClient>;
+    quickConnect(udid: string, onProgress?: ProgressCallback, port?: number): Promise<WDAClient>;
+    private verifyDeviceConnected;
+    private buildWDA;
+    private launchWDA;
+    private waitForWDA;
+    teardownDevice(udid: string): Promise<void>;
+    shutdownAll(): Promise<void>;
+}
+export declare const wdaManager: WDAManager;
+export {};

package/dist/wda/wda-manager.js

@@ -0,0 +1,263 @@
+import { spawn, exec } from 'child_process';
+import { promisify } from 'util';
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { log } from '../logger.js';
+import { childEnv } from '../child-env.js';
+import { WDAClient } from './wda-client.js';
+const execAsync = promisify(exec);
+export class WDAManager {
+    static instance = null;
+    wdaProcesses = new Map();
+    static getInstance() {
+        if (!WDAManager.instance) {
+            WDAManager.instance = new WDAManager();
+        }
+        return WDAManager.instance;
+    }
+    getWdaProjectPath() {
+        const mcpPath = join(homedir(), '.blitz-iphone-mcp', 'wda-build', 'WebDriverAgent');
+        if (existsSync(join(mcpPath, 'WebDriverAgent.xcodeproj')))
+            return mcpPath;
+        const blitzPath = join(homedir(), '.blitz', 'wda-build', 'WebDriverAgent');
+        if (existsSync(join(blitzPath, 'WebDriverAgent.xcodeproj')))
+            return blitzPath;
+        throw new Error('WebDriverAgent not found. Run `npx @blitzdev/iphone-mcp --setup` to install it.');
+    }
+    async ensureWdaSource() {
+        try {
+            return this.getWdaProjectPath();
+        }
+        catch {
+            const targetDir = join(homedir(), '.blitz-iphone-mcp', 'wda-build');
+            mkdirSync(targetDir, { recursive: true });
+            const wdaDir = join(targetDir, 'WebDriverAgent');
+            log('WDAManager', 'log', 'Cloning WebDriverAgent from GitHub...');
+            await execAsync(`git clone --depth 1 https://github.com/appium/WebDriverAgent.git "${wdaDir}"`, { timeout: 120_000, env: childEnv() });
+            log('WDAManager', 'log', 'WebDriverAgent cloned successfully');
+            return wdaDir;
+        }
+    }
+    getDerivedDataPath() {
+        const dir = join(homedir(), '.blitz-iphone-mcp', 'wda-build');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    async detectTeamId() {
+        try {
+            const { stdout } = await execAsync('defaults read com.apple.dt.Xcode IDEProvisioningTeams', { env: childEnv() });
+            const match = stdout.match(/teamID\s*=\s*([A-Z0-9]{10})/);
+            if (match)
+                return match[1];
+        }
+        catch {
+            // Xcode prefs not available
+        }
+        throw new Error('No development team found. Sign in to Xcode with your Apple ID first (Xcode -> Settings -> Accounts).');
+    }
+    async getTunnelAddress(udid) {
+        try {
+            const { stdout } = await execAsync('xcrun devicectl list devices --json-output /dev/stdout 2>/dev/null', { env: childEnv() });
+            const jsonStart = stdout.indexOf('{');
+            if (jsonStart < 0)
+                throw new Error('No JSON in devicectl output');
+            const json = JSON.parse(stdout.substring(jsonStart));
+            const devices = json?.result?.devices ?? [];
+            for (const d of devices) {
+                const devUdid = d.hardwareProperties?.udid;
+                if (devUdid !== udid)
+                    continue;
+                const tunnelIP = d.connectionProperties?.tunnelIPAddress;
+                if (tunnelIP) {
+                    log('WDAManager', 'log', `Tunnel IP for ${udid}: ${tunnelIP}`);
+                    return tunnelIP;
+                }
+            }
+        }
+        catch (e) {
+            log('WDAManager', 'error', `Failed to get tunnel address: ${e.message}`);
+        }
+        throw new Error('No CoreDevice tunnel found. Ensure iPhone is connected via USB and trusted.');
+    }
+    async isWDARunning(udid, port = 8100) {
+        try {
+            const tunnelIP = await this.getTunnelAddress(udid);
+            const client = WDAClient.getInstance(udid, port, tunnelIP);
+            return client.isReachable();
+        }
+        catch {
+            return false;
+        }
+    }
+    async setupDevice(udid, onProgress, port = 8100) {
+        const report = (step, message) => {
+            log('WDAManager', 'log', `[${udid}] ${step}: ${message}`);
+            onProgress?.({ step, message });
+        };
+        report('connecting', 'Verifying device connection...');
+        await this.verifyDeviceConnected(udid);
+        report('connecting', 'Device connected.');
+        if (await this.isWDARunning(udid, port)) {
+            report('establishing_connection', 'WDA already running, creating session...');
+            const tunnelIP = await this.getTunnelAddress(udid);
+            const client = WDAClient.getInstance(udid, port, tunnelIP);
+            await client.createSession();
+            report('ready', 'Connected to device.');
+            return client;
+        }
+        report('building_wda', 'Building WebDriverAgent...');
+        await this.buildWDA(udid);
+        report('building_wda', 'Build complete.');
+        report('installing_wda', 'Launching WebDriverAgent on device...');
+        await this.launchWDA(udid);
+        report('installing_wda', 'WebDriverAgent launched.');
+        report('establishing_connection', 'Waiting for WebDriverAgent...');
+        const tunnelIP = await this.getTunnelAddress(udid);
+        await this.waitForWDA(udid, port, tunnelIP);
+        const client = WDAClient.getInstance(udid, port, tunnelIP);
+        await client.createSession();
+        report('ready', 'Connected to device.');
+        return client;
+    }
+    async quickConnect(udid, onProgress, port = 8100) {
+        const report = (step, message) => {
+            log('WDAManager', 'log', `[${udid}] ${step}: ${message}`);
+            onProgress?.({ step, message });
+        };
+        report('establishing_connection', 'Connecting to WebDriverAgent...');
+        const tunnelIP = await this.getTunnelAddress(udid);
+        await this.waitForWDA(udid, port, tunnelIP);
+        const client = WDAClient.getInstance(udid, port, tunnelIP);
+        await client.createSession();
+        report('ready', 'Connected to device.');
+        return client;
+    }
+    async verifyDeviceConnected(udid) {
+        try {
+            const { stdout } = await execAsync('xcrun devicectl list devices --json-output /dev/stdout 2>/dev/null', { env: childEnv() });
+            const jsonStart = stdout.indexOf('{');
+            if (jsonStart < 0)
+                throw new Error(`Device ${udid} not found. Connect your iPhone via USB.`);
+            const json = JSON.parse(stdout.substring(jsonStart));
+            const devices = json?.result?.devices ?? [];
+            const found = devices.some((d) => d.hardwareProperties?.udid === udid || d.identifier === udid);
+            if (!found)
+                throw new Error(`Device ${udid} not found. Connect your iPhone via USB.`);
+        }
+        catch (e) {
+            if (e.message.includes('not found'))
+                throw e;
+            throw new Error(`Failed to verify device connection: ${e.message}`);
+        }
+    }
+    async buildWDA(udid) {
+        const wdaPath = await this.ensureWdaSource();
+        const derivedData = this.getDerivedDataPath();
+        const teamId = await this.detectTeamId();
+        const args = [
+            'build-for-testing',
+            '-project', join(wdaPath, 'WebDriverAgent.xcodeproj'),
+            '-scheme', 'WebDriverAgentRunner',
+            '-destination', `id=${udid}`,
+            '-derivedDataPath', derivedData,
+            '-allowProvisioningUpdates',
+            `DEVELOPMENT_TEAM=${teamId}`,
+        ];
+        log('WDAManager', 'log', `Building WDA: xcodebuild ${args.join(' ')}`);
+        return new Promise((resolve, reject) => {
+            const proc = spawn('xcodebuild', args, { stdio: ['pipe', 'pipe', 'pipe'], env: childEnv() });
+            let stderr = '';
+            proc.stderr?.on('data', (data) => { stderr += data.toString(); });
+            proc.on('close', (code) => {
+                if (code === 0) {
+                    log('WDAManager', 'log', 'WDA build succeeded');
+                    resolve();
+                }
+                else {
+                    log('WDAManager', 'error', `WDA build failed (code ${code}): ${stderr.slice(-500)}`);
+                    if (stderr.includes('Developer Mode')) {
+                        reject(new Error('Enable Developer Mode on your iPhone: Settings -> Privacy & Security -> Developer Mode'));
+                    }
+                    else if (stderr.includes('provisioning')) {
+                        reject(new Error('Provisioning error. Ensure your Apple ID is signed into Xcode.'));
+                    }
+                    else if (stderr.includes('Trust This Computer')) {
+                        reject(new Error('Tap "Trust This Computer" on your iPhone.'));
+                    }
+                    else {
+                        reject(new Error(`WDA build failed with code ${code}`));
+                    }
+                }
+            });
+            proc.on('error', (err) => {
+                reject(new Error(`Failed to start xcodebuild: ${err.message}`));
+            });
+        });
+    }
+    async launchWDA(udid) {
+        const existing = this.wdaProcesses.get(udid);
+        if (existing) {
+            existing.kill('SIGTERM');
+            this.wdaProcesses.delete(udid);
+        }
+        const wdaPath = this.getWdaProjectPath();
+        const derivedData = this.getDerivedDataPath();
+        const args = [
+            'test-without-building',
+            '-project', join(wdaPath, 'WebDriverAgent.xcodeproj'),
+            '-scheme', 'WebDriverAgentRunner',
+            '-destination', `id=${udid}`,
+            '-derivedDataPath', derivedData,
+        ];
+        log('WDAManager', 'log', `Launching WDA: xcodebuild ${args.join(' ')}`);
+        const proc = spawn('xcodebuild', args, { stdio: ['pipe', 'pipe', 'pipe'], env: childEnv() });
+        this.wdaProcesses.set(udid, proc);
+        proc.stderr?.on('data', (data) => {
+            const text = data.toString();
+            if (text.includes('ServerURLHere')) {
+                log('WDAManager', 'log', `WDA server started on device ${udid}`);
+            }
+        });
+        proc.on('exit', (code, signal) => {
+            log('WDAManager', 'log', `WDA process exited for ${udid}: code=${code} signal=${signal}`);
+            this.wdaProcesses.delete(udid);
+        });
+        proc.on('error', (err) => {
+            log('WDAManager', 'error', `WDA process error for ${udid}: ${err.message}`);
+            this.wdaProcesses.delete(udid);
+        });
+        await new Promise(resolve => setTimeout(resolve, 3000));
+    }
+    async waitForWDA(udid, port, tunnelIP, maxRetries = 30) {
+        const client = WDAClient.getInstance(udid, port, tunnelIP);
+        for (let i = 0; i < maxRetries; i++) {
+            if (await client.isReachable()) {
+                log('WDAManager', 'log', `WDA reachable on attempt ${i + 1}`);
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+        }
+        throw new Error('WebDriverAgent did not become reachable in time. Check that your iPhone is unlocked.');
+    }
+    async teardownDevice(udid) {
+        const wdaProc = this.wdaProcesses.get(udid);
+        if (wdaProc) {
+            wdaProc.kill('SIGTERM');
+            this.wdaProcesses.delete(udid);
+        }
+        const client = WDAClient.getInstance(udid);
+        await client.shutdown();
+        log('WDAManager', 'log', `[${udid}] Device torn down`);
+    }
+    async shutdownAll() {
+        for (const [udid, proc] of this.wdaProcesses) {
+            proc.kill('SIGTERM');
+            log('WDAManager', 'log', `Killed WDA process for ${udid}`);
+        }
+        this.wdaProcesses.clear();
+    }
+}
+export const wdaManager = WDAManager.getInstance();
+//# sourceMappingURL=wda-manager.js.map