execbro 0.0.1-reserve → 1.10.12

package/build/core/deviceResolver.js

@@ -0,0 +1,225 @@
+import { getConnectedApps } from "./connection.js";
+import { listAllDevices } from "./deviceDiscovery.js";
+const UDID_REGEX = /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+const ADB_SERIAL_REGEX = /^emulator-\d+$/;
+/**
+ * Lowercase and strip separators (whitespace, `_`, `-`) so substring matches
+ * survive punctuation drift between caller input and the device's reported
+ * name (e.g. "SM_A356N" vs "SM-A356N - 15 - API 35").
+ */
+function normalizeName(value) {
+    if (!value)
+        return "";
+    return value.toLowerCase().replace(/[\s_\-]+/g, "");
+}
+function err(code, message, candidates) {
+    return { ok: false, error: { code, message, candidates } };
+}
+function ok(target) {
+    return { ok: true, target };
+}
+/**
+ * Render a DeviceResolverError as a single string suitable for tool responses.
+ * Appends the candidates list when present so the agent can disambiguate
+ * without an extra list_devices call.
+ */
+export function formatResolverError(error) {
+    if (!error.candidates || error.candidates.length === 0)
+        return error.message;
+    const lines = error.candidates.map((c) => `  - ${c.name} (${c.platform}) → device="${c.identifier}"`);
+    return `${error.message}\nCandidates:\n${lines.join("\n")}`;
+}
+/**
+ * Resolve a single `device` string (UDID, adb serial, RN-registry deviceName,
+ * sim/emu name, or undefined) into a structured DeviceTarget.
+ *
+ * Resolution order:
+ *   1. UDID format → iOS simulator lookup (errors if shutdown).
+ *   2. emulator-NNNN format → Android serial lookup.
+ *   3. Substring match against the RN-connected registry.
+ *   4. Substring match against booted iOS sims and online Android devices.
+ *   5. No `device` argument → pick the single running device, or error.
+ */
+export async function resolveDeviceTarget(device) {
+    const trimmed = device?.trim();
+    // Step 1: UDID match.
+    if (trimmed && UDID_REGEX.test(trimmed)) {
+        const inv = await listAllDevices();
+        const sim = inv.ios.simulators.find((s) => s.udid.toLowerCase() === trimmed.toLowerCase());
+        if (!sim) {
+            return err("DEVICE_NOT_FOUND", `No iOS simulator with UDID "${trimmed}". Call list_devices to see available identifiers.`);
+        }
+        if (sim.state !== "booted") {
+            return err("SIMULATOR_NOT_BOOTED", `Simulator "${sim.name}" (${sim.udid}) is not booted. Boot it with ios_boot_simulator({ udid: "${sim.udid}" }).`);
+        }
+        return ok({
+            platform: "ios",
+            iosUdid: sim.udid,
+            deviceName: sim.name,
+            source: "udid"
+        });
+    }
+    // Step 2: adb serial format.
+    if (trimmed && ADB_SERIAL_REGEX.test(trimmed)) {
+        const inv = await listAllDevices();
+        const emu = inv.android.emulators.find((e) => e.serial === trimmed);
+        if (emu) {
+            // Prefer the RN registry's deviceName when an app is connected on
+            // this serial — the registry name (e.g. "sdk_gphone16k_arm64 - 16 -
+            // API 36") matches what every other code path emits; the AVD
+            // identifier ("Pixel_9_-_16kb") is confusing as a response label.
+            // OB2 (2026-05-20).
+            const registryApp = getConnectedApps().find((e) => e.app.platform === "android" && e.app.adbSerial === trimmed);
+            return ok({
+                platform: "android",
+                androidSerial: trimmed,
+                deviceName: registryApp?.app.deviceInfo.deviceName || emu.name,
+                source: "adb-serial"
+            });
+        }
+        const phys = inv.android.physical.find((p) => p.serial === trimmed);
+        if (phys) {
+            const registryApp = getConnectedApps().find((e) => e.app.platform === "android" && e.app.adbSerial === trimmed);
+            return ok({
+                platform: "android",
+                androidSerial: trimmed,
+                deviceName: registryApp?.app.deviceInfo.deviceName || phys.model,
+                source: "adb-serial"
+            });
+        }
+        return err("DEVICE_NOT_FOUND", `No Android device with serial "${trimmed}". Call list_devices to see attached devices.`);
+    }
+    // Step 3: Registry substring match.
+    if (trimmed) {
+        const apps = getConnectedApps();
+        const needle = normalizeName(trimmed);
+        const matches = apps.filter((entry) => {
+            const name = normalizeName(entry.app.deviceInfo.deviceName);
+            return name.includes(needle);
+        });
+        if (matches.length === 1) {
+            const m = matches[0].app;
+            // When the iOS app's UDID hasn't been backfilled yet (the
+            // findSimulatorByName race during connection), look it up on
+            // demand. Without this, downstream callers default to whichever
+            // simulator simctl reports as active — which on a multi-sim
+            // setup can be the OTHER device. Bug #5 (2026-05-20).
+            let iosUdid = m.simulatorUdid;
+            if (m.platform === "ios" && !iosUdid && m.deviceInfo.deviceName) {
+                try {
+                    const inv = await listAllDevices();
+                    const sim = inv.ios.simulators.find((s) => s.state === "booted" && s.name === m.deviceInfo.deviceName);
+                    if (sim)
+                        iosUdid = sim.udid;
+                }
+                catch {
+                    // best-effort; fall through with undefined udid
+                }
+            }
+            return ok({
+                platform: m.platform,
+                iosUdid,
+                androidSerial: m.adbSerial,
+                deviceName: m.deviceInfo.deviceName,
+                source: "registry"
+            });
+        }
+        if (matches.length > 1) {
+            return err("MULTIPLE_DEVICES_MATCH", `"${trimmed}" matches multiple connected devices. Pass a more specific identifier (full name, UDID, or adb serial).`, matches.map((m) => ({
+                name: m.app.deviceInfo.deviceName,
+                platform: m.app.platform,
+                identifier: m.app.simulatorUdid ?? m.app.adbSerial ?? m.app.deviceInfo.deviceName
+            })));
+        }
+    }
+    // Step 4: OS-level name match.
+    const inv = await listAllDevices();
+    if (trimmed) {
+        const needle = normalizeName(trimmed);
+        const iosBootedMatches = inv.ios.simulators.filter((s) => s.state === "booted" && normalizeName(s.name).includes(needle));
+        const androidRunningMatches = inv.android.emulators.filter((e) => e.state === "running" && normalizeName(e.name).includes(needle));
+        const androidPhysicalMatches = inv.android.physical.filter((p) => p.state === "device" && normalizeName(p.model).includes(needle));
+        const totalMatches = iosBootedMatches.length + androidRunningMatches.length + androidPhysicalMatches.length;
+        if (totalMatches === 1) {
+            if (iosBootedMatches.length === 1) {
+                const s = iosBootedMatches[0];
+                return ok({
+                    platform: "ios",
+                    iosUdid: s.udid,
+                    deviceName: s.name,
+                    source: "name-match"
+                });
+            }
+            if (androidRunningMatches.length === 1) {
+                const e = androidRunningMatches[0];
+                return ok({
+                    platform: "android",
+                    androidSerial: e.serial ?? undefined,
+                    deviceName: e.name,
+                    source: "name-match"
+                });
+            }
+            const p = androidPhysicalMatches[0];
+            return ok({
+                platform: "android",
+                androidSerial: p.serial,
+                deviceName: p.model,
+                source: "name-match"
+            });
+        }
+        if (totalMatches > 1) {
+            const candidates = [
+                ...iosBootedMatches.map((s) => ({ name: s.name, platform: "ios", identifier: s.udid })),
+                ...androidRunningMatches.map((e) => ({ name: e.name, platform: "android", identifier: e.serial ?? e.name })),
+                ...androidPhysicalMatches.map((p) => ({ name: p.model, platform: "android", identifier: p.serial }))
+            ];
+            return err("MULTIPLE_DEVICES_MATCH", `"${trimmed}" matches multiple devices. Pass a UDID or adb serial to disambiguate.`, candidates);
+        }
+        return err("DEVICE_NOT_FOUND", `"${trimmed}" did not match any connected RN app, booted simulator, or attached Android device. Call list_devices to enumerate options.`);
+    }
+    // Step 5: No `device` argument — pick the single available device.
+    const bootedSims = inv.ios.simulators.filter((s) => s.state === "booted");
+    const runningEmus = inv.android.emulators.filter((e) => e.state === "running");
+    const onlinePhys = inv.android.physical.filter((p) => p.state === "device");
+    const totalRunning = bootedSims.length + runningEmus.length + onlinePhys.length;
+    if (totalRunning === 0) {
+        // Final fallback: if a single RN app is connected (e.g. physical iOS
+        // not in simctl), use it.
+        const apps = getConnectedApps();
+        if (apps.length === 1) {
+            const m = apps[0].app;
+            return ok({
+                platform: m.platform,
+                iosUdid: m.simulatorUdid,
+                androidSerial: m.adbSerial,
+                deviceName: m.deviceInfo.deviceName,
+                source: "default"
+            });
+        }
+        return err("NO_DEVICES_FOUND", "No devices found. Boot an iOS simulator or start an Android emulator, then retry.");
+    }
+    if (totalRunning > 1) {
+        const candidates = [
+            ...bootedSims.map((s) => ({ name: s.name, platform: "ios", identifier: s.udid })),
+            ...runningEmus.map((e) => ({ name: e.name, platform: "android", identifier: e.serial ?? e.name })),
+            ...onlinePhys.map((p) => ({ name: p.model, platform: "android", identifier: p.serial }))
+        ];
+        return err("MULTIPLE_DEVICES_MATCH", "Multiple devices available. Specify device='...'. Call list_devices to enumerate.", candidates);
+    }
+    if (bootedSims.length === 1) {
+        const s = bootedSims[0];
+        return ok({ platform: "ios", iosUdid: s.udid, deviceName: s.name, source: "default" });
+    }
+    if (runningEmus.length === 1) {
+        const e = runningEmus[0];
+        return ok({
+            platform: "android",
+            androidSerial: e.serial ?? undefined,
+            deviceName: e.name,
+            source: "default"
+        });
+    }
+    const p = onlinePhys[0];
+    return ok({ platform: "android", androidSerial: p.serial, deviceName: p.model, source: "default" });
+}
+//# sourceMappingURL=deviceResolver.js.map

package/build/core/deviceResolver.js.map

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

package/build/core/errorScreenParser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Error Screen Parser
+ *
+ * Parses React Native error screens from OCR text to extract structured error information.
+ * Used as fallback when CDP connection cannot be established due to bundle errors.
+ */
+import { BundleError } from "./bundle.js";
+/**
+ * Result of parsing an error screen
+ */
+export interface ParsedErrorScreen {
+    found: boolean;
+    error?: BundleError;
+    rawText?: string;
+}
+/**
+ * Parse OCR text from a React Native error screen (red screen of death)
+ *
+ * Common error formats:
+ * - "Unable to resolve \"@/module\" from \"path/to/file.ts\""
+ * - "SyntaxError: ..."
+ * - "TransformError: ..."
+ * - "Error: ..."
+ */
+export declare function parseErrorScreenText(ocrText: string): ParsedErrorScreen;
+/**
+ * Format parsed error for display
+ */
+export declare function formatParsedError(parsed: ParsedErrorScreen): string;
+//# sourceMappingURL=errorScreenParser.d.ts.map

package/build/core/errorScreenParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorScreenParser.d.ts","sourceRoot":"","sources":["../../src/core/errorScreenParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA2FvE;AAiGD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAgCnE"}

package/build/core/errorScreenParser.js

@@ -0,0 +1,198 @@
+/**
+ * Error Screen Parser
+ *
+ * Parses React Native error screens from OCR text to extract structured error information.
+ * Used as fallback when CDP connection cannot be established due to bundle errors.
+ */
+/**
+ * Parse OCR text from a React Native error screen (red screen of death)
+ *
+ * Common error formats:
+ * - "Unable to resolve \"@/module\" from \"path/to/file.ts\""
+ * - "SyntaxError: ..."
+ * - "TransformError: ..."
+ * - "Error: ..."
+ */
+export function parseErrorScreenText(ocrText) {
+    if (!ocrText || ocrText.trim().length === 0) {
+        return { found: false };
+    }
+    const normalizedText = normalizeOcrText(ocrText);
+    // Check if this looks like an error screen
+    if (!looksLikeErrorScreen(normalizedText)) {
+        return { found: false, rawText: ocrText };
+    }
+    const error = {
+        timestamp: new Date(),
+        type: "other",
+        message: ""
+    };
+    // Try to parse different error types
+    // 1. Module resolution errors: "Unable to resolve \"module\" from \"file\""
+    const resolutionMatch = normalizedText.match(/unable\s+to\s+resolve\s+["']([^"']+)["']\s+from\s+["']([^"']+)["']/i);
+    if (resolutionMatch) {
+        error.type = "resolution";
+        error.message = `Unable to resolve "${resolutionMatch[1]}"`;
+        error.file = resolutionMatch[2];
+        // Try to extract import stack
+        error.importStack = extractImportStack(normalizedText);
+        return { found: true, error, rawText: ocrText };
+    }
+    // 2. Syntax errors
+    const syntaxMatch = normalizedText.match(/syntax\s*error[:\s]+(.+?)(?:\n|$)/i);
+    if (syntaxMatch) {
+        error.type = "syntax";
+        error.message = `SyntaxError: ${syntaxMatch[1].trim()}`;
+        // Try to extract file location
+        const locationInfo = extractFileLocation(normalizedText);
+        if (locationInfo) {
+            error.file = locationInfo.file;
+            error.line = locationInfo.line;
+            error.column = locationInfo.column;
+        }
+        return { found: true, error, rawText: ocrText };
+    }
+    // 3. Transform errors (Babel/Metro transforms)
+    const transformMatch = normalizedText.match(/transform\s*error[:\s]+(.+?)(?:\n|$)/i);
+    if (transformMatch) {
+        error.type = "transform";
+        error.message = `TransformError: ${transformMatch[1].trim()}`;
+        const locationInfo = extractFileLocation(normalizedText);
+        if (locationInfo) {
+            error.file = locationInfo.file;
+            error.line = locationInfo.line;
+            error.column = locationInfo.column;
+        }
+        return { found: true, error, rawText: ocrText };
+    }
+    // 4. Generic error pattern: "Error: message"
+    const errorMatch = normalizedText.match(/error[:\s]+(.+?)(?:\n|$)/i);
+    if (errorMatch) {
+        error.message = errorMatch[1].trim();
+        const locationInfo = extractFileLocation(normalizedText);
+        if (locationInfo) {
+            error.file = locationInfo.file;
+            error.line = locationInfo.line;
+            error.column = locationInfo.column;
+        }
+        return { found: true, error, rawText: ocrText };
+    }
+    // 5. Fallback: use the entire text as the error message
+    // Truncate if too long
+    const maxLength = 500;
+    error.message = normalizedText.length > maxLength
+        ? normalizedText.substring(0, maxLength) + "..."
+        : normalizedText;
+    return { found: true, error, rawText: ocrText };
+}
+/**
+ * Normalize OCR text by fixing common OCR errors and standardizing whitespace
+ */
+function normalizeOcrText(text) {
+    return text
+        // Replace multiple whitespace with single space
+        .replace(/\s+/g, " ")
+        // Fix common OCR misreadings
+        .replace(/[|l]mport/gi, "import")
+        .replace(/reso[|l]ve/gi, "resolve")
+        .replace(/unab[|l]e/gi, "unable")
+        .replace(/modu[|l]e/gi, "module")
+        // Normalize quotes
+        .replace(/[""'']/g, '"')
+        .trim();
+}
+/**
+ * Check if OCR text looks like a React Native error screen
+ */
+function looksLikeErrorScreen(text) {
+    const lowerText = text.toLowerCase();
+    const errorIndicators = [
+        "error",
+        "unable to resolve",
+        "syntax error",
+        "transform error",
+        "bundling failed",
+        "metro has encountered an error",
+        "failed to construct",
+        "unexpected token",
+        "module not found",
+        "cannot find module",
+        "import stack",
+        ".tsx",
+        ".ts",
+        ".js",
+        ".jsx"
+    ];
+    return errorIndicators.some(indicator => lowerText.includes(indicator));
+}
+/**
+ * Extract file location (file:line:column) from text
+ */
+function extractFileLocation(text) {
+    // Pattern: /path/to/file.tsx:123:45 or /path/to/file.tsx:123
+    const locationMatch = text.match(/([a-zA-Z0-9_\-./\\@]+\.(tsx?|jsx?|mjs|cjs)):(\d+)(?::(\d+))?/i);
+    if (locationMatch) {
+        return {
+            file: locationMatch[1],
+            line: parseInt(locationMatch[3], 10),
+            column: locationMatch[4] ? parseInt(locationMatch[4], 10) : undefined
+        };
+    }
+    // Try to find just a file path
+    const fileMatch = text.match(/([a-zA-Z0-9_\-./\\@]+\.(tsx?|jsx?|mjs|cjs))/i);
+    if (fileMatch) {
+        return { file: fileMatch[1] };
+    }
+    return null;
+}
+/**
+ * Extract import stack from error text
+ */
+function extractImportStack(text) {
+    const stack = [];
+    // Look for patterns like:
+    // - "import from file.tsx"
+    // - "app/hooks/useAuth.ts"
+    // - file references in the text
+    const filePattern = /([a-zA-Z0-9_\-./\\@]+\.(tsx?|jsx?|mjs|cjs))/gi;
+    let match;
+    while ((match = filePattern.exec(text)) !== null) {
+        const file = match[1];
+        // Avoid duplicates
+        if (!stack.includes(file)) {
+            stack.push(file);
+        }
+    }
+    return stack.length > 0 ? stack : undefined;
+}
+/**
+ * Format parsed error for display
+ */
+export function formatParsedError(parsed) {
+    if (!parsed.found || !parsed.error) {
+        return "No error detected in screenshot.";
+    }
+    const { error } = parsed;
+    const lines = [];
+    lines.push(`[Screenshot OCR] ${error.type.toUpperCase()} ERROR`);
+    lines.push(`Message: ${error.message}`);
+    if (error.file) {
+        let location = `File: ${error.file}`;
+        if (error.line) {
+            location += `:${error.line}`;
+            if (error.column) {
+                location += `:${error.column}`;
+            }
+        }
+        lines.push(location);
+    }
+    if (error.importStack && error.importStack.length > 0) {
+        lines.push("\nImport Stack:");
+        error.importStack.forEach(imp => {
+            lines.push(`  - ${imp}`);
+        });
+    }
+    lines.push("\n(Captured via screenshot OCR fallback)");
+    return lines.join("\n");
+}
+//# sourceMappingURL=errorScreenParser.js.map

package/build/core/errorScreenParser.js.map

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

package/build/core/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Marker class for errors caused by invalid agent input (wrong device name,
+ * missing required predicate, ambiguous match, etc). H2 (Step 9 in the
+ * 2026-05-15 plan): the top-level catch in index.ts skips PostHog
+ * captureException for these so error tracking surfaces real product bugs,
+ * not validation noise (~13% of recent dashboard volume).
+ *
+ * The trade-off vs regex-matching the message: this is self-documenting at
+ * the throw site and survives message reformatting / translation.
+ */
+export declare class UserInputError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI9B"}

package/build/core/errors.js

@@ -0,0 +1,17 @@
+/**
+ * Marker class for errors caused by invalid agent input (wrong device name,
+ * missing required predicate, ambiguous match, etc). H2 (Step 9 in the
+ * 2026-05-15 plan): the top-level catch in index.ts skips PostHog
+ * captureException for these so error tracking surfaces real product bugs,
+ * not validation noise (~13% of recent dashboard volume).
+ *
+ * The trade-off vs regex-matching the message: this is self-documenting at
+ * the throw site and survives message reformatting / translation.
+ */
+export class UserInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UserInputError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACrC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ"}

package/build/core/escapeNonAscii.d.ts

@@ -0,0 +1,18 @@
+export type EscapeResult = {
+    ok: true;
+    expression: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Walk a JS source string and rewrite non-ASCII-printable code points that
+ * occur inside string literals (single quote, double quote, template literal
+ * cooked body) to \uXXXX or \u{XXXXX} escape sequences. Code in regular
+ * expression bodies, comments, identifiers, and template-literal `${...}`
+ * substitution expressions is left untouched.
+ *
+ * Returns a structured error on unbalanced quotes / unterminated literals.
+ */
+export declare function escapeNonAsciiInStringLiterals(src: string): EscapeResult;
+//# sourceMappingURL=escapeNonAscii.d.ts.map

package/build/core/escapeNonAscii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeNonAscii.d.ts","sourceRoot":"","sources":["../../src/core/escapeNonAscii.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA4B5F;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAuVxE"}