react-native-ai-devtools 1.4.12 → 1.4.13

package/build/index.js

@@ -3,12 +3,13 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { createServer as createHttpServer } from "node:http";
+import { existsSync, unlinkSync } from "fs";
 import { z } from "zod";
 import { getGuideOverview, getGuideByTopic, getAvailableTopics } from "./core/guides.js";
 import { getLicenseStatus, getDashboardUrl, getUsageInfo } from "./core/license.js";
 import { API_BASE_URL } from "./core/config.js";
 import { getPostHogClient, identifyIfDevMode, shutdownPostHog } from "./core/posthog.js";
-import { getInstallationId, getServerVersion } from "./core/telemetry.js";
+import { getInstallationId, getServerVersion, isDevMode, TELEMETRY_JSONL_PATH } from "./core/telemetry.js";
 import { isSDKInstalled, querySDKNetwork, getSDKNetworkEntry, getSDKNetworkStats, clearSDKNetwork, querySDKConsole, getSDKConsoleStats, clearSDKConsole } from "./core/sdkBridge.js";
 import { tap } from "./pro/tap.js";
 import { getActivateLicenseConfig, handleActivateLicense, getDeleteAccountConfig, handleDeleteAccount, } from "./tools/accountTools.js";
@@ -16,7 +17,7 @@ import { logBuffers, networkBuffers, getLogBuffer, getNetworkBuffer, getTotalLog
 // React Component Inspection
 getComponentTree, getScreenLayout, inspectComponent, findComponents, inspectAtPoint, toggleElementInspector, isInspectorActive, getInspectorSelection, getFirstConnectedApp, getLogs, searchLogs, getLogSummary, getNetworkRequests, searchNetworkRequests, getNetworkStats, formatRequestDetails, 
 // Connection state
-getAllConnectionStates, getAllConnectionMetadata, getRecentGaps, formatDuration, cancelAllReconnectionTimers, cancelReconnectionTimer, clearAllConnectionState, suppressReconnection, suppressReconnectionForKey, clearReconnectionSuppression, 
+getAllConnectionStates, getAllConnectionMetadata, getRecentGaps, formatDuration, cancelAllReconnectionTimers, cancelReconnectionTimer, clearAllConnectionState, clearAllCDPMessageTimes, suppressReconnection, suppressReconnectionForKey, clearReconnectionSuppression, 
 // Context health tracking
 getContextHealth, 
 // Connection resilience
@@ -48,7 +49,7 @@ initTelemetry, trackToolInvocation, getTargetPlatform,
 // Format utilities (TONL)
 formatLogsAsTonl, formatNetworkAsTonl, 
 // LogBox detection & control
-detectLogBox, formatLogBoxWarning, dismissLogBox, formatDismissedEntries, pushLogBox, addLogBoxIgnorePatterns } from "./core/index.js";
+detectLogBox, formatLogBoxWarning, dismissLogBox, formatDismissedEntries, pushLogBox, addLogBoxIgnorePatterns, verifyLogPipeline } from "./core/index.js";
 // Helper: resolve log buffer for a device (or create a merged buffer from all devices)
 function resolveLogBuffer(device) {
     if (device) {
@@ -182,6 +183,8 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
         let meaningful;
         let changeRate;
         let tapStrategy;
+        let responsePreview;
+        let emptyReason;
         try {
             inputTokens = Math.ceil(JSON.stringify(args).length / 4);
         }
@@ -214,6 +217,8 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
                 changeRate = result._changeRate;
             if (result?._tapStrategy)
                 tapStrategy = result._tapStrategy;
+            if (result?._emptyReason)
+                emptyReason = result._emptyReason;
             if (Array.isArray(result?.content)) {
                 let totalTokens = 0;
                 for (const item of result.content) {
@@ -227,6 +232,15 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
                 if (totalTokens > 0)
                     outputTokens = totalTokens;
             }
+            // Capture response text preview for local dev dashboard
+            if (Array.isArray(result?.content)) {
+                const textParts = result.content
+                    .filter((item) => item.type === "text")
+                    .map((item) => item.text);
+                if (textParts.length > 0) {
+                    responsePreview = textParts.join("\n").substring(0, 2000);
+                }
+            }
             return result;
         }
         catch (error) {
@@ -237,7 +251,7 @@ function registerToolWithTelemetry(toolName, config, handler, emptyResultDetecto
         }
         finally {
             const duration = Date.now() - startTime;
-            trackToolInvocation(toolName, success, duration, errorMessage, errorContext, inputTokens, outputTokens, getTargetPlatform(), emptyResult, meaningful, changeRate, tapStrategy);
+            trackToolInvocation(toolName, success, duration, errorMessage, errorContext, inputTokens, outputTokens, getTargetPlatform(), emptyResult, meaningful, changeRate, tapStrategy, responsePreview, emptyReason);
             getPostHogClient()?.capture({
                 distinctId: getInstallationId(),
                 event: toolName,
@@ -694,8 +708,17 @@ registerToolWithTelemetry("get_logs", {
         const summaryText = getLogSummary(resolveLogBuffer(device), { lastN: 5, maxMessageLength: 100 });
         let connectionWarning = "";
         if (getTotalLogCount() === 0) {
-            const status = await checkAndEnsureConnection();
+            const status = await checkAndEnsureConnection(device);
             connectionWarning = status.message ? `\n\n${status.message}` : "";
+            if (status.connected) {
+                const targetApp = device ? getConnectedAppByDevice(device) : getFirstConnectedApp();
+                if (targetApp) {
+                    const pipeline = await verifyLogPipeline(targetApp);
+                    if (pipeline.message) {
+                        connectionWarning += `\n\n${pipeline.message}`;
+                    }
+                }
+            }
         }
         return {
             content: [
@@ -715,9 +738,60 @@ registerToolWithTelemetry("get_logs", {
     });
     // Check connection health
     let connectionWarning = "";
+    let emptyReason;
     if (count === 0) {
-        const status = await checkAndEnsureConnection();
+        const status = await checkAndEnsureConnection(device);
         connectionWarning = status.message ? `\n\n${status.message}` : "";
+        // Track empty reason for telemetry
+        emptyReason = "no_logs";
+        if (!status.connected) {
+            emptyReason = "disconnected";
+        }
+        else if (status.wasReconnected) {
+            emptyReason = "post_reconnect";
+        }
+        // End-to-end log pipeline verification (with automatic recovery)
+        if (status.connected) {
+            const targetApp = device ? getConnectedAppByDevice(device) : getFirstConnectedApp();
+            if (targetApp) {
+                const pipeline = await verifyLogPipeline(targetApp);
+                if (pipeline.message) {
+                    connectionWarning += `\n\n${pipeline.message}`;
+                }
+                if (!pipeline.ok) {
+                    emptyReason = "pipeline_failed";
+                }
+                else if (pipeline.recovered) {
+                    emptyReason = "pipeline_recovered";
+                }
+                // If pipeline recovered, re-read the buffer — new logs may have arrived
+                if (pipeline.recovered && pipeline.ok) {
+                    const retryResult = getLogs(resolveLogBuffer(device), {
+                        maxLogs, level, startFromText, maxMessageLength, verbose
+                    });
+                    if (retryResult.count > 0) {
+                        // Return the recovered logs instead of empty
+                        return {
+                            _emptyReason: "pipeline_recovered",
+                            content: [{
+                                    type: "text",
+                                    text: `React Native Console Logs (${retryResult.count} entries):\n\n${retryResult.formatted}${connectionWarning}`
+                                }]
+                        };
+                    }
+                }
+            }
+        }
+        // Add diagnostic metadata for empty results (captured by telemetry via responsePreview)
+        if (count === 0) {
+            const diagParts = [
+                `empty_reason=${status?.wasReconnected ? "post_reconnect" : "no_logs"}`,
+                `connection=${getPassiveConnectionStatus().reason}`,
+                `device_count=${connectedApps.size}`,
+                `buffer_sizes=${JSON.stringify(Object.fromEntries([...logBuffers.entries()].map(([k, v]) => [k, v.size])))}`,
+            ];
+            connectionWarning += `\n\n[DIAG] ${diagParts.join(", ")}`;
+        }
     }
     else {
         const passive = getPassiveConnectionStatus();
@@ -745,6 +819,7 @@ registerToolWithTelemetry("get_logs", {
     if (format === "tonl") {
         const tonlOutput = formatLogsAsTonl(logs, { maxMessageLength: verbose ? 0 : maxMessageLength });
         return {
+            ...(emptyReason && { _emptyReason: emptyReason }),
             content: [
                 {
                     type: "text",
@@ -754,6 +829,7 @@ registerToolWithTelemetry("get_logs", {
         };
     }
     return {
+        ...(emptyReason && { _emptyReason: emptyReason }),
         content: [
             {
                 type: "text",
@@ -823,7 +899,7 @@ registerToolWithTelemetry("search_logs", {
     // Check connection health
     let connectionWarning = "";
     if (count === 0) {
-        const status = await checkAndEnsureConnection();
+        const status = await checkAndEnsureConnection(device);
         connectionWarning = status.message ? `\n\n${status.message}` : "";
     }
     else {
@@ -1008,6 +1084,7 @@ registerToolWithTelemetry("disconnect_metro", {
     disconnectMetroBuildEvents();
     // Clear connection state (but NOT log/network buffers)
     clearAllConnectionState();
+    clearAllCDPMessageTimes();
     const lines = [
         `Disconnected from ${disconnected.length} app(s):`,
         ...disconnected.map((d) => `  - ${d}`),
@@ -1813,7 +1890,7 @@ registerToolWithTelemetry("get_network_requests", {
         const stats = getNetworkStats(resolveNetworkBuffer(device));
         let connectionWarning = "";
         if (resolveNetworkBuffer(device).size === 0) {
-            const connStatus = await checkAndEnsureConnection();
+            const connStatus = await checkAndEnsureConnection(device);
             connectionWarning = connStatus.message ? `\n\n${connStatus.message}` : "";
             if (!sdkAvailable) {
                 connectionWarning += "\n\n[TIP] For full network capture including startup requests and response bodies, install the SDK: npm install react-native-ai-devtools-sdk";
@@ -1837,7 +1914,7 @@ registerToolWithTelemetry("get_network_requests", {
     // Check connection health
     let connectionWarning = "";
     if (count === 0) {
-        const connStatus = await checkAndEnsureConnection();
+        const connStatus = await checkAndEnsureConnection(device);
         connectionWarning = connStatus.message ? `\n\n${connStatus.message}` : "";
         if (!sdkAvailable) {
             connectionWarning += "\n\n[TIP] For full network capture including startup requests and response bodies, install the SDK: npm install react-native-ai-devtools-sdk";
@@ -1927,7 +2004,7 @@ registerToolWithTelemetry("search_network", {
     // Check connection health
     let connectionWarning = "";
     if (count === 0) {
-        const status = await checkAndEnsureConnection();
+        const status = await checkAndEnsureConnection(device);
         connectionWarning = status.message ? `\n\n${status.message}` : "";
     }
     else {
@@ -2024,7 +2101,7 @@ registerToolWithTelemetry("get_request_details", {
     // Fallback: read from in-process buffer
     const request = resolveNetworkBuffer(device).get(requestId);
     if (!request) {
-        const status = await checkAndEnsureConnection();
+        const status = await checkAndEnsureConnection(device);
         const connectionNote = status.message ? `\n\n${status.message}` : "";
         return {
             content: [
@@ -2086,7 +2163,7 @@ registerToolWithTelemetry("get_network_stats", {
     // Check connection health
     let connectionWarning = "";
     if (resolveNetworkBuffer(device).size === 0) {
-        const status = await checkAndEnsureConnection();
+        const status = await checkAndEnsureConnection(device);
         connectionWarning = status.message ? `\n\n${status.message}` : "";
     }
     else {
@@ -3804,6 +3881,23 @@ registerToolWithTelemetry("restart_http_server", {
 registerToolWithTelemetry("activate_license", getActivateLicenseConfig(), handleActivateLicense);
 // Tool: Delete account
 registerToolWithTelemetry("delete_account", getDeleteAccountConfig(), handleDeleteAccount);
+// Dev-only tool: reset local telemetry data
+if (isDevMode()) {
+    registerToolWithTelemetry("reset_telemetry", {
+        description: "Clear local telemetry data file (/tmp/rn-devtools-telemetry.jsonl). Only available in development mode.",
+        inputSchema: {},
+    }, async () => {
+        if (existsSync(TELEMETRY_JSONL_PATH)) {
+            unlinkSync(TELEMETRY_JSONL_PATH);
+            return {
+                content: [{ type: "text", text: "Local telemetry data cleared." }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: "No local telemetry data file found." }],
+        };
+    });
+}
 /**
  * Auto-connect to Metro bundler on startup
  * Scans common ports and connects to any running Metro servers