@ceraph/react-native-mcp 0.3.3 → 0.4.5

package/dist/screen.js

@@ -1,931 +0,0 @@
-import { DEFAULT_DEVICE_WDA_BASE_URL, TargetResolver } from "./target.js";
-const WDA_TIMEOUT_MS = 5000;
-export class ScreenManager {
-    sessionId = null;
-    pixelRatio = null;
-    targetResolver;
-    sessionBaseUrl = null;
-    constructor(opts = {}) {
-        this.targetResolver = opts.targetResolver ?? new TargetResolver();
-    }
-    async snapshotTarget() {
-        try {
-            const info = await this.targetResolver.resolve();
-            return { baseUrl: info.baseUrl, ready: info.wdaReady };
-        }
-        catch {
-            return { baseUrl: DEFAULT_DEVICE_WDA_BASE_URL, ready: true };
-        }
-    }
-    async wdaFetchAt(baseUrl, path, options = {}, timeoutMs = WDA_TIMEOUT_MS) {
-        const url = `${baseUrl}${path}`;
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), timeoutMs);
-        try {
-            const response = await fetch(url, {
-                ...options,
-                signal: controller.signal,
-                headers: {
-                    "Content-Type": "application/json",
-                    ...options.headers,
-                },
-            });
-            return response;
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-    }
-    async wdaFetch(path, options = {}, timeoutMs = WDA_TIMEOUT_MS) {
-        const snapshot = await this.snapshotTarget();
-        if (!snapshot.ready) {
-            throw new Error("WebDriverAgent is not ready for the selected target. If you " +
-                "set CERAPH_TARGET=simulator (or are using a simulator with " +
-                "auto-detection), call `rn_wda_start` first to build and " +
-                "launch WDA against the simulator.");
-        }
-        const baseUrl = this.sessionBaseUrl ?? snapshot.baseUrl;
-        return this.wdaFetchAt(baseUrl, path, options, timeoutMs);
-    }
-    async isAvailable() {
-        const snapshot = await this.snapshotTarget();
-        if (!snapshot.ready)
-            return false;
-        try {
-            const res = await this.wdaFetchAt(snapshot.baseUrl, "/status");
-            return res.ok;
-        }
-        catch {
-            return false;
-        }
-    }
-    async ensureSession() {
-        const snapshot = await this.snapshotTarget();
-        if (!snapshot.ready) {
-            throw new Error("WebDriverAgent is not ready for the selected target. If you " +
-                "set CERAPH_TARGET=simulator (or are using a simulator with " +
-                "auto-detection), call `rn_wda_start` first to build and " +
-                "launch WDA against the simulator.");
-        }
-        const currentBaseUrl = snapshot.baseUrl;
-        if (this.sessionBaseUrl && this.sessionBaseUrl !== currentBaseUrl) {
-            this.sessionId = null;
-            this.pixelRatio = null;
-        }
-        this.sessionBaseUrl = currentBaseUrl;
-        if (this.sessionId) {
-            try {
-                const res = await this.wdaFetchAt(currentBaseUrl, `/session/${this.sessionId}`);
-                if (res.ok)
-                    return this.sessionId;
-            }
-            catch {
-            }
-            this.sessionId = null;
-        }
-        try {
-            const statusRes = await this.wdaFetchAt(currentBaseUrl, "/status");
-            if (statusRes.ok) {
-                const statusData = (await statusRes.json());
-                const existingId = statusData.sessionId || statusData.value?.sessionId;
-                if (existingId) {
-                    this.sessionId = existingId;
-                    return existingId;
-                }
-            }
-        }
-        catch {
-        }
-        const res = await this.wdaFetchAt(currentBaseUrl, "/session", {
-            method: "POST",
-            body: JSON.stringify({
-                capabilities: {
-                    alwaysMatch: {},
-                },
-            }),
-        });
-        if (!res.ok) {
-            const text = await res.text().catch(() => "unknown error");
-            throw new Error(`Failed to create WDA session: ${res.status} ${text}`);
-        }
-        const data = (await res.json());
-        const sessionId = data.sessionId || data.value?.sessionId;
-        if (!sessionId) {
-            throw new Error("WDA session creation succeeded but no sessionId returned");
-        }
-        this.sessionId = sessionId;
-        return sessionId;
-    }
-    async getPixelRatio() {
-        if (this.pixelRatio)
-            return this.pixelRatio;
-        const sessionId = await this.ensureSession();
-        const windowRes = await this.wdaFetch(`/session/${sessionId}/window/size`);
-        if (!windowRes.ok) {
-            throw new Error(`Failed to get window size: ${windowRes.status}`);
-        }
-        const windowData = (await windowRes.json());
-        const logicalWidth = windowData.value.width;
-        const screenshotRes = await this.wdaFetch(`/session/${sessionId}/screenshot`);
-        if (!screenshotRes.ok) {
-            this.pixelRatio = 3;
-            return this.pixelRatio;
-        }
-        const screenshotData = (await screenshotRes.json());
-        const base64 = screenshotData.value;
-        const pngBuffer = Buffer.from(base64, "base64");
-        if (pngBuffer.length < 24) {
-            this.pixelRatio = 3;
-            return this.pixelRatio;
-        }
-        const imageWidth = pngBuffer.readUInt32BE(16);
-        this.pixelRatio = Math.round(imageWidth / logicalWidth);
-        if (this.pixelRatio < 1 || this.pixelRatio > 4) {
-            this.pixelRatio = 3;
-        }
-        return this.pixelRatio;
-    }
-    async getWindowSize() {
-        const sessionId = await this.ensureSession();
-        const res = await this.wdaFetch(`/session/${sessionId}/window/size`);
-        if (!res.ok) {
-            throw new Error(`Failed to get window size: ${res.status}`);
-        }
-        const data = (await res.json());
-        return data.value;
-    }
-    async tap(x, y, fromScreenshot = true) {
-        try {
-            const sessionId = await this.ensureSession();
-            const ratio = await this.getPixelRatio();
-            const correctedX = fromScreenshot ? x / ratio : x;
-            const correctedY = fromScreenshot ? y / ratio : y;
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/tap/0`, {
-                method: "POST",
-                body: JSON.stringify({ x: correctedX, y: correctedY }),
-            });
-            if (!res.ok) {
-                const text = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    tappedAt: { x: correctedX, y: correctedY },
-                    pixelRatio: ratio,
-                    correction: fromScreenshot
-                        ? `Divided by ${ratio}x: (${x},${y}) -> (${correctedX.toFixed(1)},${correctedY.toFixed(1)})`
-                        : "No correction (device coordinates)",
-                    error: `WDA tap failed: ${res.status} ${text}`,
-                };
-            }
-            return {
-                success: true,
-                tappedAt: { x: correctedX, y: correctedY },
-                pixelRatio: ratio,
-                correction: fromScreenshot
-                    ? `Divided by ${ratio}x: (${x},${y}) -> (${correctedX.toFixed(1)},${correctedY.toFixed(1)})`
-                    : "No correction (device coordinates)",
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                tappedAt: { x, y },
-                pixelRatio: this.pixelRatio ?? 0,
-                correction: "Failed before correction could be applied",
-                error: err instanceof Error ? err.message : "Unknown error during tap",
-            };
-        }
-    }
-    async findAndTap(query) {
-        try {
-            const sessionId = await this.ensureSession();
-            const sourceRes = await this.wdaFetch(`/session/${sessionId}/source?format=json`);
-            if (!sourceRes.ok) {
-                return {
-                    success: false,
-                    error: `Failed to get element tree: ${sourceRes.status}`,
-                };
-            }
-            const sourceData = (await sourceRes.json());
-            const root = sourceData.value;
-            const matches = this.searchElements(root, query);
-            if (matches.length === 0) {
-                const visible = this.collectVisibleElements(root, 50);
-                return {
-                    success: false,
-                    availableElements: visible,
-                    error: `No element found matching query: ${JSON.stringify(query)}`,
-                };
-            }
-            const index = query.index ?? 0;
-            if (index >= matches.length) {
-                return {
-                    success: false,
-                    error: `Index ${index} out of range. Found ${matches.length} matching element(s).`,
-                    availableElements: matches.map((m) => ({
-                        type: m.type ?? "unknown",
-                        label: m.label ?? "",
-                        text: String(m.value ?? m.label ?? ""),
-                    })),
-                };
-            }
-            const element = matches[index];
-            const rect = element.rect;
-            if (!rect) {
-                return {
-                    success: false,
-                    error: "Matched element has no bounds/rect information.",
-                };
-            }
-            const centerX = rect.x + rect.width / 2;
-            const centerY = rect.y + rect.height / 2;
-            const tapRes = await this.wdaFetch(`/session/${sessionId}/wda/tap/0`, {
-                method: "POST",
-                body: JSON.stringify({ x: centerX, y: centerY }),
-            });
-            if (!tapRes.ok) {
-                const text = await tapRes.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA tap failed: ${tapRes.status} ${text}`,
-                    element: {
-                        type: element.type ?? "unknown",
-                        label: element.label ?? element.name ?? "",
-                        bounds: rect,
-                    },
-                    tappedAt: { x: centerX, y: centerY },
-                };
-            }
-            return {
-                success: true,
-                element: {
-                    type: element.type ?? "unknown",
-                    label: element.label ?? element.name ?? "",
-                    bounds: rect,
-                },
-                tappedAt: { x: centerX, y: centerY },
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error
-                    ? err.message
-                    : "Unknown error during findAndTap",
-            };
-        }
-    }
-    async findElement(query) {
-        try {
-            const sessionId = await this.ensureSession();
-            const sourceRes = await this.wdaFetch(`/session/${sessionId}/source?format=json`);
-            if (!sourceRes.ok) {
-                return {
-                    success: false,
-                    error: `Failed to get element tree: ${sourceRes.status}`,
-                };
-            }
-            const sourceData = (await sourceRes.json());
-            const matches = this.searchElements(sourceData.value, query);
-            if (matches.length === 0) {
-                return { success: false, matchCount: 0 };
-            }
-            const index = query.index ?? 0;
-            if (index >= matches.length) {
-                return { success: false, matchCount: matches.length };
-            }
-            return { success: true, element: matches[index], matchCount: matches.length };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during findElement",
-            };
-        }
-    }
-    async swipe(opts) {
-        try {
-            const sessionId = await this.ensureSession();
-            const windowSize = await this.getWindowSize();
-            const ratio = await this.getPixelRatio();
-            const fromScreenshot = (opts.coordinateSource ?? "device") === "screenshot";
-            let fromX = opts.from?.x ?? windowSize.width / 2;
-            let fromY = opts.from?.y ?? windowSize.height / 2;
-            if (fromScreenshot) {
-                fromX = fromX / ratio;
-                fromY = fromY / ratio;
-            }
-            const axis = opts.direction === "up" || opts.direction === "down"
-                ? windowSize.height
-                : windowSize.width;
-            const distance = opts.distancePx ?? Math.floor(axis * 0.6);
-            let toX = fromX;
-            let toY = fromY;
-            switch (opts.direction) {
-                case "up":
-                    toY = fromY - distance;
-                    break;
-                case "down":
-                    toY = fromY + distance;
-                    break;
-                case "left":
-                    toX = fromX - distance;
-                    break;
-                case "right":
-                    toX = fromX + distance;
-                    break;
-            }
-            toX = Math.max(0, Math.min(windowSize.width - 1, toX));
-            toY = Math.max(0, Math.min(windowSize.height - 1, toY));
-            fromX = Math.max(0, Math.min(windowSize.width - 1, fromX));
-            fromY = Math.max(0, Math.min(windowSize.height - 1, fromY));
-            const durationMs = opts.durationMs ?? 300;
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/dragfromtoforduration`, {
-                method: "POST",
-                body: JSON.stringify({
-                    fromX,
-                    fromY,
-                    toX,
-                    toY,
-                    duration: durationMs / 1000,
-                }),
-            });
-            if (!res.ok) {
-                const text = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    from: { x: fromX, y: fromY },
-                    to: { x: toX, y: toY },
-                    durationMs,
-                    error: `WDA swipe failed: ${res.status} ${text}`,
-                };
-            }
-            return {
-                success: true,
-                from: { x: fromX, y: fromY },
-                to: { x: toX, y: toY },
-                durationMs,
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                from: { x: 0, y: 0 },
-                to: { x: 0, y: 0 },
-                durationMs: opts.durationMs ?? 300,
-                error: err instanceof Error ? err.message : "Unknown error during swipe",
-            };
-        }
-    }
-    async scrollToElement(query, opts = {}) {
-        const maxSwipes = opts.maxSwipes ?? 10;
-        const direction = opts.direction ?? "up";
-        for (let i = 0; i <= maxSwipes; i++) {
-            const found = await this.findElement(query);
-            if (found.success && found.element?.rect) {
-                return {
-                    success: true,
-                    swipes: i,
-                    element: {
-                        type: found.element.type ?? "unknown",
-                        label: found.element.label ?? found.element.name ?? "",
-                        bounds: found.element.rect,
-                    },
-                };
-            }
-            if (i === maxSwipes)
-                break;
-            const swipeRes = await this.swipe({
-                direction,
-                distancePx: opts.distancePx,
-            });
-            if (!swipeRes.success) {
-                return {
-                    success: false,
-                    swipes: i,
-                    error: swipeRes.error ?? "Swipe failed during scrollToElement",
-                };
-            }
-        }
-        return {
-            success: false,
-            swipes: maxSwipes,
-            error: `Element not found after ${maxSwipes} swipes: ${JSON.stringify(query)}`,
-        };
-    }
-    async longPress(x, y, durationMs = 1000, fromScreenshot = false) {
-        try {
-            const sessionId = await this.ensureSession();
-            let pressX = x;
-            let pressY = y;
-            if (fromScreenshot) {
-                const ratio = await this.getPixelRatio();
-                pressX = x / ratio;
-                pressY = y / ratio;
-            }
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/touchAndHold`, {
-                method: "POST",
-                body: JSON.stringify({
-                    x: pressX,
-                    y: pressY,
-                    duration: durationMs / 1000,
-                }),
-            });
-            if (!res.ok) {
-                const text = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA touchAndHold failed: ${res.status} ${text}`,
-                };
-            }
-            return { success: true, details: { x: pressX, y: pressY, durationMs } };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during longPress",
-            };
-        }
-    }
-    async longPressElement(query, durationMs = 1000) {
-        const found = await this.findElement(query);
-        if (!found.success || !found.element?.rect) {
-            return {
-                success: false,
-                error: found.error ?? `No element found matching ${JSON.stringify(query)}`,
-            };
-        }
-        const rect = found.element.rect;
-        const centerX = rect.x + rect.width / 2;
-        const centerY = rect.y + rect.height / 2;
-        const res = await this.longPress(centerX, centerY, durationMs, false);
-        return {
-            ...res,
-            element: {
-                type: found.element.type ?? "unknown",
-                label: found.element.label ?? found.element.name ?? "",
-                bounds: rect,
-            },
-        };
-    }
-    async type(text, opts = {}) {
-        try {
-            const sessionId = await this.ensureSession();
-            const chars = Array.from(text);
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/keys`, {
-                method: "POST",
-                body: JSON.stringify({ value: chars }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA keys failed: ${res.status} ${t}`,
-                };
-            }
-            if (opts.hideKeyboardAfter) {
-                await this.wdaFetch(`/session/${sessionId}/wda/keys`, {
-                    method: "POST",
-                    body: JSON.stringify({ value: ["\n"] }),
-                }).catch(() => undefined);
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during type",
-            };
-        }
-    }
-    async clearText(query) {
-        try {
-            const found = await this.findElement(query);
-            if (!found.success || !found.element?.rect) {
-                return {
-                    success: false,
-                    error: found.error ?? `No element found matching ${JSON.stringify(query)}`,
-                };
-            }
-            const rect = found.element.rect;
-            const currentValue = String(found.element.value ?? "");
-            const tapRes = await this.tap(rect.x + rect.width / 2, rect.y + rect.height / 2, false);
-            if (!tapRes.success) {
-                return {
-                    success: false,
-                    error: tapRes.error ?? "Failed to focus element before clearing",
-                };
-            }
-            const backspaces = new Array(Math.max(1, currentValue.length)).fill("\uE003");
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/keys`, {
-                method: "POST",
-                body: JSON.stringify({ value: backspaces }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA keys (backspace) failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true, details: { cleared: currentValue.length } };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during clearText",
-            };
-        }
-    }
-    async pressKey(key) {
-        try {
-            const sessionId = await this.ensureSession();
-            if (key === "lock") {
-                const res = await this.wdaFetch(`/session/${sessionId}/wda/lock`, {
-                    method: "POST",
-                    body: JSON.stringify({}),
-                });
-                if (!res.ok) {
-                    const t = await res.text().catch(() => "unknown");
-                    return { success: false, error: `WDA lock failed: ${res.status} ${t}` };
-                }
-                return { success: true };
-            }
-            const name = key === "home" ? "home" : key === "volumeUp" ? "volumeup" : "volumedown";
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/pressButton`, {
-                method: "POST",
-                body: JSON.stringify({ name }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA pressButton failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during pressKey",
-            };
-        }
-    }
-    async unlock() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/unlock`, {
-                method: "POST",
-                body: JSON.stringify({}),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return { success: false, error: `WDA unlock failed: ${res.status} ${t}` };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during unlock",
-            };
-        }
-    }
-    async isLocked() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/locked`);
-            if (!res.ok)
-                return null;
-            const data = (await res.json());
-            return typeof data.value === "boolean" ? data.value : null;
-        }
-        catch {
-            return null;
-        }
-    }
-    async screenshot() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/screenshot`);
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return { success: false, error: `WDA screenshot failed: ${res.status} ${t}` };
-            }
-            const data = (await res.json());
-            return { success: true, base64: data.value };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during screenshot",
-            };
-        }
-    }
-    async getSource() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/source?format=json`);
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA source failed: ${res.status} ${t}`,
-                };
-            }
-            const data = (await res.json());
-            return { success: true, source: data.value };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during getSource",
-            };
-        }
-    }
-    async waitFor(query, opts = {}) {
-        const timeoutMs = opts.timeoutMs ?? 5000;
-        const pollIntervalMs = opts.pollIntervalMs ?? 500;
-        const disappear = opts.disappear ?? false;
-        const start = Date.now();
-        while (Date.now() - start < timeoutMs) {
-            const found = await this.findElement(query);
-            const matched = found.success && !!found.element;
-            if (!disappear && matched) {
-                const rect = found.element.rect;
-                return {
-                    success: true,
-                    found: true,
-                    elapsedMs: Date.now() - start,
-                    element: rect
-                        ? {
-                            type: found.element.type ?? "unknown",
-                            label: found.element.label ?? found.element.name ?? "",
-                            bounds: rect,
-                        }
-                        : undefined,
-                };
-            }
-            if (disappear && !matched) {
-                return {
-                    success: true,
-                    found: false,
-                    elapsedMs: Date.now() - start,
-                };
-            }
-            await new Promise((r) => setTimeout(r, pollIntervalMs));
-        }
-        return {
-            success: false,
-            found: !disappear,
-            elapsedMs: Date.now() - start,
-            error: disappear
-                ? `Element still visible after ${timeoutMs}ms: ${JSON.stringify(query)}`
-                : `Element not visible after ${timeoutMs}ms: ${JSON.stringify(query)}`,
-        };
-    }
-    async assertVisible(query) {
-        const found = await this.findElement(query);
-        if (found.error) {
-            return { success: false, visible: false, error: found.error };
-        }
-        if (found.success && found.element?.rect) {
-            return {
-                success: true,
-                visible: true,
-                element: {
-                    type: found.element.type ?? "unknown",
-                    label: found.element.label ?? found.element.name ?? "",
-                    bounds: found.element.rect,
-                },
-            };
-        }
-        return { success: true, visible: false };
-    }
-    async assertNotVisible(query) {
-        const found = await this.findElement(query);
-        if (found.error) {
-            return { success: false, visible: false, error: found.error };
-        }
-        const visible = found.success && !!found.element;
-        return { success: true, visible };
-    }
-    async getOrientation() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/orientation`);
-            if (!res.ok)
-                return null;
-            const data = (await res.json());
-            return data.value ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    async setOrientation(orientation) {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/orientation`, {
-                method: "POST",
-                body: JSON.stringify({
-                    orientation: orientation.toUpperCase(),
-                }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA setOrientation failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error
-                    ? err.message
-                    : "Unknown error during setOrientation",
-            };
-        }
-    }
-    async getActiveAppInfo() {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/activeAppInfo`);
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA activeAppInfo failed: ${res.status} ${t}`,
-                };
-            }
-            const data = (await res.json());
-            return {
-                success: true,
-                bundleId: data.value?.bundleId,
-                pid: data.value?.pid,
-                name: data.value?.name,
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error
-                    ? err.message
-                    : "Unknown error during getActiveAppInfo",
-            };
-        }
-    }
-    async activateApp(bundleId) {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/apps/launch`, {
-                method: "POST",
-                body: JSON.stringify({ bundleId }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA apps/launch failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error
-                    ? err.message
-                    : "Unknown error during activateApp",
-            };
-        }
-    }
-    async openUrl(url) {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/url`, {
-                method: "POST",
-                body: JSON.stringify({ url }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA openUrl failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error ? err.message : "Unknown error during openUrl",
-            };
-        }
-    }
-    async terminateAppViaWDA(bundleId) {
-        try {
-            const sessionId = await this.ensureSession();
-            const res = await this.wdaFetch(`/session/${sessionId}/wda/apps/terminate`, {
-                method: "POST",
-                body: JSON.stringify({ bundleId }),
-            });
-            if (!res.ok) {
-                const t = await res.text().catch(() => "unknown");
-                return {
-                    success: false,
-                    error: `WDA apps/terminate failed: ${res.status} ${t}`,
-                };
-            }
-            return { success: true };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: err instanceof Error
-                    ? err.message
-                    : "Unknown error during terminateAppViaWDA",
-            };
-        }
-    }
-    async pingStatus() {
-        try {
-            const res = await this.wdaFetch("/status", {}, 2000);
-            return res.ok;
-        }
-        catch {
-            return false;
-        }
-    }
-    searchElements(element, query) {
-        const results = [];
-        if (this.elementMatches(element, query)) {
-            results.push(element);
-        }
-        const children = element.children;
-        if (Array.isArray(children)) {
-            for (const child of children) {
-                results.push(...this.searchElements(child, query));
-            }
-        }
-        return results;
-    }
-    elementMatches(element, query) {
-        if (query.text !== undefined) {
-            const searchText = query.text.toLowerCase();
-            const fields = [element.value, element.label, element.name]
-                .filter(Boolean)
-                .map(v => String(v).toLowerCase());
-            if (!fields.some(f => f.includes(searchText))) {
-                return false;
-            }
-        }
-        if (query.accessibilityLabel !== undefined) {
-            const label = String(element.label ?? element.name ?? "");
-            if (!label
-                .toLowerCase()
-                .includes(query.accessibilityLabel.toLowerCase())) {
-                return false;
-            }
-        }
-        if (query.type !== undefined) {
-            const elemType = String(element.type ?? "");
-            if (!elemType.toLowerCase().includes(query.type.toLowerCase())) {
-                return false;
-            }
-        }
-        return (query.text !== undefined ||
-            query.accessibilityLabel !== undefined ||
-            query.type !== undefined);
-    }
-    collectVisibleElements(element, limit) {
-        const results = [];
-        if (limit <= 0)
-            return results;
-        const label = String(element.label ?? element.name ?? "");
-        const text = String(element.value ?? "");
-        const type = String(element.type ?? "");
-        if (label || text) {
-            results.push({ type, label, text });
-        }
-        const children = element.children;
-        if (Array.isArray(children)) {
-            for (const child of children) {
-                const remaining = limit - results.length;
-                if (remaining <= 0)
-                    break;
-                results.push(...this.collectVisibleElements(child, remaining));
-            }
-        }
-        return results;
-    }
-    reset() {
-        this.sessionId = null;
-        this.pixelRatio = null;
-        this.sessionBaseUrl = null;
-    }
-}