execbro 0.0.1-reserve → 1.10.13

package/build/tools/accountTools.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare function getActivateLicenseConfig(): {
+    description: string;
+    inputSchema: {
+        token: z.ZodString;
+    };
+};
+export declare function handleActivateLicense({ token }: {
+    token: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function getDeleteAccountConfig(): {
+    description: string;
+    inputSchema: {
+        confirm: z.ZodOptional<z.ZodString>;
+    };
+};
+export declare function handleDeleteAccount({ confirm }: {
+    confirm?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAccountTools(server: McpServer): void;
+//# sourceMappingURL=accountTools.d.ts.map

package/build/tools/accountTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountTools.d.ts","sourceRoot":"","sources":["../../src/tools/accountTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,wBAAgB,wBAAwB;;;;;EASvC;AAED,wBAAsB,qBAAqB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA8FvE;AAED,wBAAgB,sBAAsB;;;;;EAarC;AAED,wBAAsB,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAuF1E;AAWD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAa5D"}

package/build/tools/accountTools.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { getInstallationId, getServerVersion, getPackageName } from "../core/telemetry.js";
+import { getDeviceFingerprint } from "../core/fingerprint.js";
+import { resetLicense, getDashboardUrl, ensureLicense } from "../core/license.js";
+import { existsSync, unlinkSync } from "fs";
+import { join } from "path";
+import { getPostHogClient } from "../core/posthog.js";
+import { CONFIG_DIR } from "../core/paths.js";
+import { API_BASE_URL } from "../core/config.js";
+const API_URL = API_BASE_URL;
+const API_KEY = "fb4b5d8f410ff8d0dfe3ade01adc0b2444479ac9380b3f256554dd9d7044f5d2";
+const API_TIMEOUT_MS = 10_000;
+const TELEMETRY_FILE = join(CONFIG_DIR, "telemetry.json");
+const LICENSE_FILE = join(CONFIG_DIR, "license.json");
+export function getActivateLicenseConfig() {
+    return {
+        description: "Activate a Pro license using an activation token from your dashboard. " +
+            "Use this if you signed up on the website and need to link your account to this MCP installation.",
+        inputSchema: {
+            token: z.string().describe("Activation token from your dashboard"),
+        },
+    };
+}
+export async function handleActivateLicense({ token }) {
+    if (!API_URL) {
+        return {
+            content: [{ type: "text", text: "License activation is not configured yet." }],
+            isError: true,
+        };
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+        const response = await fetch(`${API_URL}/api/accounts/activate`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            body: JSON.stringify({
+                installationId: getInstallationId(),
+                fingerprint: getDeviceFingerprint(),
+                token,
+            }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        const data = await response.json();
+        if (response.ok) {
+            resetLicense();
+            await ensureLicense();
+            const distinctId = getInstallationId();
+            const posthog = getPostHogClient();
+            if (posthog) {
+                posthog.identify({
+                    distinctId,
+                    properties: {
+                        $set: { plan: data.tier },
+                    },
+                });
+                posthog.capture({
+                    distinctId,
+                    event: "license activated",
+                    properties: {
+                        tier: data.tier,
+                        server_version: getServerVersion(),
+                        package_name: getPackageName(),
+                    },
+                });
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `License activated. You're now on the ${data.tier === "pro" ? "Pro" : data.tier} plan.`,
+                    }],
+            };
+        }
+        if (data.error === "invalid_token") {
+            const dashboardUrl = getDashboardUrl();
+            return {
+                content: [{
+                        type: "text",
+                        text: `Invalid or expired token. Generate a new one from your dashboard${dashboardUrl ? ` at ${dashboardUrl}` : ""}.`,
+                    }],
+                isError: true,
+            };
+        }
+        if (data.error === "fingerprint_mismatch") {
+            return {
+                content: [{ type: "text", text: "Activation failed. This token cannot be used on this device." }],
+                isError: true,
+            };
+        }
+        if (data.error === "installation_not_found") {
+            return {
+                content: [{ type: "text", text: "Installation not found. Please restart your MCP server and try again." }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Activation failed: ${data.error || "unknown error"}` }],
+            isError: true,
+        };
+    }
+    catch {
+        return {
+            content: [{ type: "text", text: "Activation failed due to a network error. Please try again." }],
+            isError: true,
+        };
+    }
+}
+export function getDeleteAccountConfig() {
+    return {
+        description: "Permanently delete your account and reset this MCP installation. " +
+            "Removes your server-side data and local cache. You will get a new installation ID on next restart. " +
+            "Requires confirm: 'DELETE' to proceed.",
+        inputSchema: {
+            confirm: z
+                .string()
+                .optional()
+                .describe("Must be exactly 'DELETE' to confirm account deletion"),
+        },
+    };
+}
+export async function handleDeleteAccount({ confirm }) {
+    if (confirm !== "DELETE") {
+        return {
+            content: [{
+                    type: "text",
+                    text: "This will permanently delete your account and all associated data.\n" +
+                        "Your installation ID, license, and any linked account data will be removed.\n" +
+                        "Local cache files will be cleared. You will get a new installation ID on next restart.\n\n" +
+                        "To confirm, call: delete_account({ confirm: 'DELETE' })",
+                }],
+        };
+    }
+    if (!API_URL) {
+        cleanupLocalFiles();
+        return {
+            content: [{
+                    type: "text",
+                    text: "Local data cleared. You will get a new installation ID on next MCP server restart.",
+                }],
+        };
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+        const response = await fetch(`${API_URL}/api/accounts/delete`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            body: JSON.stringify({
+                installationId: getInstallationId(),
+                fingerprint: getDeviceFingerprint(),
+            }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        cleanupLocalFiles();
+        if (response.ok || response.status === 404) {
+            const posthog = getPostHogClient();
+            if (posthog) {
+                posthog.capture({
+                    distinctId: getInstallationId(),
+                    event: "account deleted",
+                    properties: {
+                        server_version: getServerVersion(),
+                        package_name: getPackageName(),
+                    },
+                });
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: "Account deleted. You will get a new installation ID on next MCP server restart.",
+                    }],
+            };
+        }
+        const data = await response.json();
+        if (data.error === "fingerprint_mismatch") {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Deletion failed: fingerprint mismatch. Local files have been cleared.",
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: "Account deletion may not have completed on the server. Local files have been cleared." }],
+        };
+    }
+    catch {
+        cleanupLocalFiles();
+        return {
+            content: [{
+                    type: "text",
+                    text: "Could not reach the server. Local data has been cleared. Server-side data may still exist.",
+                }],
+        };
+    }
+}
+function cleanupLocalFiles() {
+    try {
+        if (existsSync(LICENSE_FILE))
+            unlinkSync(LICENSE_FILE);
+    }
+    catch { /* best-effort */ }
+    try {
+        if (existsSync(TELEMETRY_FILE))
+            unlinkSync(TELEMETRY_FILE);
+    }
+    catch { /* best-effort */ }
+}
+import { registerToolWithTelemetry } from "../core/register.js";
+export function registerAccountTools(server) {
+    registerToolWithTelemetry(server, "activate_license", getActivateLicenseConfig(), handleActivateLicense);
+    registerToolWithTelemetry(server, "delete_account", getDeleteAccountConfig(), handleDeleteAccount);
+}
+//# sourceMappingURL=accountTools.js.map

package/build/tools/accountTools.js.map

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

package/build/tools/bundleTools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerBundleTools(server: McpServer): void;
+//# sourceMappingURL=bundleTools.d.ts.map

package/build/tools/bundleTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleTools.d.ts","sourceRoot":"","sources":["../../src/tools/bundleTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsb3D"}

package/build/tools/bundleTools.js

@@ -0,0 +1,375 @@
+import { z } from "zod";
+import { registerToolWithTelemetry } from "../core/register.js";
+import { resolveAndroidDeviceId, resolveIosUdid } from "./_deviceArg.js";
+import { getBundleStatusWithErrors, getBundleErrors, checkMetroState, parseErrorScreenText, bundleErrorBuffer, pushLogBox, dismissLogBox, formatDismissedEntries, addLogBoxIgnorePatterns, getLastLogBoxError, detectLogBox, connectedApps, androidScreenshot, iosScreenshot, inferIOSDevicePixelRatio, recognizeText, formatParsedError, } from "../core/index.js";
+export function registerBundleTools(server) {
+    // Tool: LogBox control (replaces dismiss_logbox)
+    registerToolWithTelemetry(server, "logbox", {
+        description: "Interact with React Native's LogBox overlay (dev mode only). " +
+            'Actions: "dismiss" clears all entries and returns their content. ' +
+            '"push" displays a message in the LogBox error banner (visible to the developer watching the device). ' +
+            '"ignore" adds patterns to suppress future LogBox entries for this session. ' +
+            '"detect" reads current LogBox state without modifying it. ' +
+            "Only works in __DEV__ mode — LogBox does not exist in production builds.\n" +
+            "PURPOSE: Control RN's on-device red/yellow overlay — clear it when it blocks UI, suppress noisy repeats, or push a message back to the developer.\n" +
+            "WHEN TO USE: Screenshot/tap reports LogBox is obstructing the screen, an error banner prevents interaction, or you want to surface info to the dev watching the simulator.\n" +
+            "WORKFLOW: logbox(action=\"detect\") -> if present: logbox(action=\"dismiss\") to read + clear -> continue UI work. Use action=\"ignore\" with patterns to stop repeat noise.\n" +
+            "LIMITATIONS: Dev-only — no effect in production builds. \"push\" at level=\"warning\" won't show a banner unless LogBox is already open.\n" +
+            "GOOD: logbox({ action: \"dismiss\" }); logbox({ action: \"ignore\", patterns: [\"[APOLLO]\"] })\n" +
+            "BAD: Spamming logbox(action=\"push\") for every tool step — annoys the developer.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"logs\") for the full logs playbook.",
+        inputSchema: {
+            action: z.enum(["dismiss", "push", "ignore", "detect"]).describe('Action to perform: "dismiss", "push", "ignore", or "detect"'),
+            message: z.string().optional().describe('Message to push into LogBox (required when action="push")'),
+            level: z.enum(["error", "warning"]).optional().describe('LogBox level for push (default: "error"). Only "error" shows a visible bottom banner; "warning" is stored but not visually shown unless LogBox is already open'),
+            expanded: z.boolean().optional().describe('When true, opens the full-screen LogBox detail view instead of the minimized bottom banner. Useful for important messages with clickable URLs (default: false)'),
+            subtitle: z.string().optional().describe('Additional info shown in the call stack area when expanded=true (default: "MCP Server"). Use for context like "License Check", "Usage Limit", etc.'),
+            target: z.enum(["logbox", "metro"]).optional().describe('Where to push the message (default: "logbox"). "logbox" shows on device screen, "metro" outputs to Metro terminal via console.log'),
+            patterns: z.array(z.string()).optional().describe('Patterns to ignore (required when action="ignore"), e.g. ["[APOLLO]", "deprecated"]'),
+            device: z.string().optional().describe("Target device name (substring match). Omit for default device. Run get_apps to see connected devices.")
+        }
+    }, async ({ action, message, level, expanded, subtitle, target, patterns, device }) => {
+        const explainLogBoxError = (base) => {
+            const reason = getLastLogBoxError();
+            const reasonHints = {
+                dev_false: "__DEV__ is false — either a production build OR a stale/zombie CDP target whose JS context is in a degraded state. Try scan_metro to drop stale connections, then retry.",
+                no_get_modules: "__r.getModules is missing — usually a stale CDP target (not a real runtime). Try scan_metro to refresh.",
+                modules_not_iterable: "Module registry returned an unexpected shape.",
+                logbox_module_not_found: "LogBoxData module not found in the Metro registry — possible if LogBox is tree-shaken or the app overrode it.",
+                execute_failed: "executeInApp failed — no connected app or evaluate timed out.",
+                exception: "Exception thrown during detection.",
+            };
+            const detail = reason ? (reasonHints[reason] ?? reason) : "unknown cause";
+            return `${base}\nReason: ${reason ?? "unknown"} — ${detail}`;
+        };
+        if (action === "dismiss") {
+            const result = await dismissLogBox(device);
+            if (result === null) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: explainLogBoxError("LogBox not available.")
+                        }
+                    ]
+                };
+            }
+            if (result.totalDismissed === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No LogBox entries to dismiss."
+                        }
+                    ]
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatDismissedEntries(result)
+                    }
+                ]
+            };
+        }
+        if (action === "push") {
+            if (!message) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: 'Error: "message" parameter is required when action is "push".'
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            const success = await pushLogBox(message, level || "error", expanded || false, target || "logbox", subtitle, device);
+            if (!success) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: explainLogBoxError("Failed to push message to LogBox.")
+                        }
+                    ]
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: target === "metro"
+                            ? `Message pushed to Metro terminal: "${message}"`
+                            : `Message pushed to LogBox as ${level || "error"}: "${message}"`
+                    }
+                ]
+            };
+        }
+        if (action === "ignore") {
+            if (!patterns || patterns.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: 'Error: "patterns" parameter is required when action is "ignore" (non-empty array of strings).'
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            const activePatterns = await addLogBoxIgnorePatterns(patterns, device);
+            if (activePatterns === null) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: explainLogBoxError("Failed to add ignore patterns.")
+                        }
+                    ]
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Added ignore patterns: ${patterns.map((p) => `"${p}"`).join(", ")}\n\nAll active ignore patterns: ${activePatterns.map((p) => `"${p}"`).join(", ")}`
+                    }
+                ]
+            };
+        }
+        if (action === "detect") {
+            const state = await detectLogBox(device);
+            if (state === null) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: explainLogBoxError("LogBox not available.")
+                        }
+                    ]
+                };
+            }
+            if (state.total === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No LogBox entries detected."
+                        }
+                    ]
+                };
+            }
+            const MAX_MSG_LENGTH = 150;
+            let output = `LogBox state: ${state.total} entr${state.total === 1 ? "y" : "ies"} (${state.errors} error${state.errors !== 1 ? "s" : ""}, ${state.warnings} warning${state.warnings !== 1 ? "s" : ""}, ${state.fatals} fatal${state.fatals !== 1 ? "s" : ""})\n`;
+            for (const entry of state.entries) {
+                const truncated = entry.message.length > MAX_MSG_LENGTH ? entry.message.substring(0, MAX_MSG_LENGTH) + "..." : entry.message;
+                const countStr = entry.count > 1 ? ` (x${entry.count})` : "";
+                output += `\n[${entry.level}] ${truncated}${countStr}`;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: output
+                    }
+                ]
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Unknown action: "${action}". Use "dismiss", "push", "ignore", or "detect".`
+                }
+            ],
+            isError: true
+        };
+    });
+    // Tool: Get bundle status
+    registerToolWithTelemetry(server, "get_bundle_status", {
+        description: "Get the current Metro bundler status including build state and any recent bundling errors. Use this to check if there are compilation/bundling errors that prevent the app from loading.\n" +
+            "PURPOSE: Snapshot Metro's current build state (idle / transforming / error) together with any captured errors — a fast \"is the bundler healthy?\" check.\n" +
+            "WHEN TO USE: Before diving into runtime debugging — rules out compile-time failures that would make get_logs and tap pointless.\n" +
+            "WORKFLOW: get_bundle_status -> if errors present: get_bundle_errors for detail -> fix -> clear_bundle_errors.\n" +
+            "LIMITATIONS: Relies on Metro's WebSocket event stream; if Metro isn't running or the connection dropped, status may be stale.\n" +
+            "GOOD: get_bundle_status() at the start of a debug session.\n" +
+            "BAD: Polling every second — Metro events are push-based; just call once and act on the result.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"bundle\") for the full bundle-check playbook.",
+        inputSchema: {}
+    }, async () => {
+        // Get port from first connected app if available
+        const apps = Array.from(connectedApps.values());
+        const metroPort = apps.length > 0 ? apps[0].port : undefined;
+        const { formatted } = await getBundleStatusWithErrors(bundleErrorBuffer, metroPort);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatted
+                }
+            ]
+        };
+    });
+    // Tool: Get bundle errors
+    registerToolWithTelemetry(server, "get_bundle_errors", {
+        description: "Retrieve captured Metro bundling/compilation errors. These are errors that occur during the bundle build process (import resolution, syntax errors, transform errors) that prevent the app from loading. If no errors are captured but Metro is running without connected apps, automatically falls back to screenshot+OCR to capture the error from the device screen.\n" +
+            "PURPOSE: Surface Metro's build-time failures (not runtime JS errors) that keep the app from booting or hot-reloading.\n" +
+            "WHEN TO USE: App shows the red error screen, refuses to connect, or Fast Refresh stops working after an edit. Also use when get_logs is silent but the app is clearly broken.\n" +
+            "WORKFLOW: get_bundle_status -> get_bundle_errors -> fix source -> clear_bundle_errors -> reload_app.\n" +
+            "LIMITATIONS: Captures errors Metro emits via its WebSocket; the screenshot+OCR fallback requires a booted simulator and the platform param.\n" +
+            "GOOD: get_bundle_errors({ platform: \"ios\" })\n" +
+            "BAD: Using get_bundle_errors to look for runtime TypeErrors — those live in get_logs, not the bundler.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"bundle\") for the full bundle-check playbook.",
+        inputSchema: {
+            maxErrors: z.number().optional().default(10).describe("Maximum number of errors to return (default: 10)"),
+            platform: z
+                .enum(["ios", "android"])
+                .optional()
+                .describe("Platform for screenshot fallback when no errors are captured via CDP. Required to enable fallback."),
+            deviceId: z
+                .string()
+                .optional()
+                .describe("Optional device target for screenshot fallback. Accepts an adb serial / iOS UDID, an emulator/simulator name, or a substring of the connected RN device name. Uses first available device if not specified.")
+        }
+    }, async ({ maxErrors, platform, deviceId }) => {
+        // First, try to get errors from the buffer (captured via CDP/Metro WebSocket)
+        const { errors, formatted } = getBundleErrors(bundleErrorBuffer, { maxErrors });
+        if (errors.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bundle Errors (${errors.length} captured):\n\n${formatted}`
+                    }
+                ]
+            };
+        }
+        // No errors in buffer - check if we should try fallback
+        if (!platform) {
+            // No platform specified, return empty result with hint
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bundle Errors (0 captured):\n\nNo bundle errors captured.\n\nTip: If the app failed to load and you see a red error screen on the device, use the 'platform' parameter (ios/android) to enable screenshot+OCR fallback for error capture.`
+                    }
+                ]
+            };
+        }
+        // Check Metro state to see if fallback is warranted
+        const metroState = await checkMetroState(connectedApps.size);
+        if (!metroState.needsFallback) {
+            // Metro not running or apps are connected - fallback not needed
+            const statusMsg = metroState.metroRunning
+                ? "Metro is running and apps are connected."
+                : "Metro is not running.";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bundle Errors (0 captured):\n\nNo bundle errors captured. ${statusMsg}`
+                    }
+                ]
+            };
+        }
+        // Metro is running but no apps connected - try screenshot fallback
+        try {
+            let screenshotResult;
+            if (platform === "android") {
+                const r = await resolveAndroidDeviceId(deviceId);
+                if (!r.ok)
+                    return r.response;
+                screenshotResult = await androidScreenshot(undefined, r.serial);
+            }
+            else {
+                const r = await resolveIosUdid(deviceId);
+                if (!r.ok)
+                    return r.response;
+                screenshotResult = await iosScreenshot(undefined, r.udid);
+            }
+            if (!screenshotResult.success || !screenshotResult.data) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Bundle Errors (0 captured):\n\nNo bundle errors captured via CDP.\n\nMetro is running on port(s) ${metroState.metroPorts.join(", ")} but no apps are connected (possible bundle error).\n\nScreenshot fallback failed: ${screenshotResult.error || "No image data"}`
+                        }
+                    ]
+                };
+            }
+            // Calculate device pixel ratio for iOS
+            const devicePixelRatio = platform === "ios" && screenshotResult.originalWidth && screenshotResult.originalHeight
+                ? inferIOSDevicePixelRatio(screenshotResult.originalWidth, screenshotResult.originalHeight)
+                : 1;
+            // Run OCR on the screenshot
+            const ocrResult = await recognizeText(screenshotResult.data, {
+                scaleFactor: screenshotResult.scaleFactor || 1,
+                platform,
+                devicePixelRatio
+            });
+            if (!ocrResult.success || !ocrResult.fullText) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Bundle Errors (0 captured):\n\nNo bundle errors captured via CDP.\n\nMetro is running on port(s) ${metroState.metroPorts.join(", ")} but no apps are connected.\n\nScreenshot captured but OCR found no text. The screen may not show an error message.`
+                        }
+                    ]
+                };
+            }
+            // Parse the OCR text for error information
+            const parsedError = parseErrorScreenText(ocrResult.fullText);
+            if (!parsedError.found || !parsedError.error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Bundle Errors (0 captured):\n\nNo bundle errors captured via CDP.\n\nMetro is running on port(s) ${metroState.metroPorts.join(", ")} but no apps are connected.\n\nScreenshot OCR text:\n${ocrResult.fullText.substring(0, 1000)}${ocrResult.fullText.length > 1000 ? "..." : ""}\n\n(No error pattern detected in text)`
+                        }
+                    ]
+                };
+            }
+            // Add the parsed error to the buffer for future reference
+            bundleErrorBuffer.add(parsedError.error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bundle Errors (1 captured via screenshot fallback):\n\n${formatParsedError(parsedError)}`
+                    }
+                ]
+            };
+        }
+        catch (fallbackError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bundle Errors (0 captured):\n\nNo bundle errors captured via CDP.\n\nMetro is running on port(s) ${metroState.metroPorts.join(", ")} but no apps are connected.\n\nScreenshot fallback error: ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`
+                    }
+                ]
+            };
+        }
+    });
+    // Tool: Clear bundle errors
+    registerToolWithTelemetry(server, "clear_bundle_errors", {
+        description: "Clear the bundle error buffer.\n" +
+            "PURPOSE: Reset captured Metro build errors after a fix so get_bundle_status/get_bundle_errors reflect the current state.\n" +
+            "WHEN TO USE: After fixing a bundling error and before re-triggering Metro to confirm the error is gone.\n" +
+            "SEE ALSO: call get_usage_guide(topic=\"bundle\") for the full bundle-check playbook.",
+        inputSchema: {}
+    }, async () => {
+        const count = bundleErrorBuffer.clear();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Cleared ${count} bundle errors from buffer.`
+                }
+            ]
+        };
+    });
+}
+//# sourceMappingURL=bundleTools.js.map