react-native-ai-devtools 1.1.8 → 1.2.0

package/build/index.js

@@ -6,6 +6,7 @@ import { createServer as createHttpServer } from "node:http";
 import { z } from "zod";
 import { getGuideOverview, getGuideByTopic, getAvailableTopics } from "./core/guides.js";
 import { initLicense, getLicenseStatus, getDashboardUrl } from "./core/license.js";
+import { isSDKInstalled, readSDKNetworkRequests, readSDKNetworkRequest, readSDKNetworkStats, clearSDKNetwork } from "./core/sdkBridge.js";
 import { tap } from "./pro/tap.js";
 import { logBuffer, networkBuffer, bundleErrorBuffer, connectedApps, getActiveSimulatorUdid, scanMetroPorts, fetchDevices, selectMainDevice, connectToDevice, getConnectedApps, executeInApp, listDebugGlobals, inspectGlobal, reloadApp, 
 // React Component Inspection
@@ -116,7 +117,7 @@ function estimateImageTokens(base64Data) {
 // Registry for dev meta-tool — stores handlers and configs for dynamic dispatch
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const toolRegistry = new Map();
-function registerToolWithTelemetry(toolName, config, handler) {
+function registerToolWithTelemetry(toolName, config, handler, emptyResultDetector) {
     toolRegistry.set(toolName, { config, handler });
     server.registerTool(toolName, config, async (args) => {
         const startTime = Date.now();
@@ -125,6 +126,7 @@ function registerToolWithTelemetry(toolName, config, handler) {
         let errorContext;
         let inputTokens;
         let outputTokens;
+        let emptyResult;
         try {
             inputTokens = Math.ceil(JSON.stringify(args).length / 4);
         }
@@ -140,6 +142,15 @@ function registerToolWithTelemetry(toolName, config, handler) {
                 // Extract error context if provided (e.g., the expression that caused a syntax error)
                 errorContext = result._errorContext;
             }
+            // Check for empty result (only on success, only if detector provided)
+            if (success && emptyResultDetector) {
+                try {
+                    emptyResult = emptyResultDetector(result);
+                }
+                catch {
+                    // Detector failure should never affect tool execution
+                }
+            }
             if (Array.isArray(result?.content)) {
                 let totalTokens = 0;
                 for (const item of result.content) {
@@ -162,7 +173,7 @@ function registerToolWithTelemetry(toolName, config, handler) {
         }
         finally {
             const duration = Date.now() - startTime;
-            trackToolInvocation(toolName, success, duration, errorMessage, errorContext, inputTokens, outputTokens, getTargetPlatform());
+            trackToolInvocation(toolName, success, duration, errorMessage, errorContext, inputTokens, outputTokens, getTargetPlatform(), emptyResult);
         }
     });
 }
@@ -556,7 +567,9 @@ registerToolWithTelemetry("get_logs", {
             }
         ]
     };
-});
+}, 
+// Empty result detector: buffer has no entries at all
+() => logBuffer.size === 0);
 // Tool: Search logs
 registerToolWithTelemetry("search_logs", {
     description: "Search console logs for text (case-insensitive)",
@@ -801,6 +814,13 @@ registerToolWithTelemetry("execute_in_app", {
             }
         ]
     };
+}, 
+// Empty result detector: successful execution but no meaningful output
+(result) => {
+    if (result?.isError)
+        return false;
+    const text = result?.content?.[0]?.text;
+    return text === undefined || text === "" || text === "undefined" || text === "null";
 });
 // Tool: List debug globals available in the app
 registerToolWithTelemetry("list_debug_globals", {
@@ -1369,7 +1389,7 @@ registerToolWithTelemetry("inspect_at_point", {
 });
 // Tool: Get network requests
 registerToolWithTelemetry("get_network_requests", {
-    description: "Retrieve captured network requests from connected React Native app. Shows URL, method, status, and timing. Tip: Use summary=true first for stats overview (counts by method, status, domain), then fetch specific requests as needed.",
+    description: "Retrieve captured network requests from connected React Native app. Shows URL, method, status, and timing. Note: On Bridgeless targets (Expo SDK 52+) without the SDK, capture may miss early startup requests. Install react-native-ai-devtools-sdk for full capture with headers and response bodies. Tip: Use summary=true first for stats overview.",
     inputSchema: {
         maxRequests: z
             .number()
@@ -1391,6 +1411,53 @@ registerToolWithTelemetry("get_network_requests", {
             .describe("Return statistics only (count, methods, domains, status codes). Use for quick overview.")
     }
 }, async ({ maxRequests, method, urlPattern, status, format, summary }) => {
+    // Check if SDK is installed — prefer SDK data over CDP/interceptor buffer
+    const sdkAvailable = await isSDKInstalled();
+    if (sdkAvailable) {
+        if (summary) {
+            const sdkStats = await readSDKNetworkStats();
+            if (sdkStats.success) {
+                const s = sdkStats.data;
+                const lines = [];
+                lines.push(`Total requests: ${s.total}`);
+                lines.push(`Completed: ${s.completed}`);
+                lines.push(`Errors: ${s.errors}`);
+                if (s.avgDuration != null)
+                    lines.push(`Avg duration: ${s.avgDuration}ms`);
+                if (s.byMethod && Object.keys(s.byMethod).length > 0) {
+                    lines.push("\nBy Method:");
+                    for (const [m, c] of Object.entries(s.byMethod))
+                        lines.push(`  ${m}: ${c}`);
+                }
+                if (s.byStatus && Object.keys(s.byStatus).length > 0) {
+                    lines.push("\nBy Status:");
+                    for (const [st, c] of Object.entries(s.byStatus))
+                        lines.push(`  ${st}: ${c}`);
+                }
+                if (s.byDomain && Object.keys(s.byDomain).length > 0) {
+                    lines.push("\nBy Domain:");
+                    for (const [d, c] of Object.entries(s.byDomain).sort((a, b) => b[1] - a[1]).slice(0, 10))
+                        lines.push(`  ${d}: ${c}`);
+                }
+                return { content: [{ type: "text", text: `Network Summary (SDK):\n\n${lines.join("\n")}` }] };
+            }
+        }
+        const sdkResult = await readSDKNetworkRequests({ count: maxRequests, method, urlPattern, status });
+        if (sdkResult.success && sdkResult.data) {
+            const entries = sdkResult.data;
+            if (entries.length === 0) {
+                return { content: [{ type: "text", text: "No network requests captured yet." }] };
+            }
+            const lines = entries.map((r) => {
+                const time = new Date(r.timestamp).toLocaleTimeString();
+                const st = r.status ?? "pending";
+                const dur = r.duration != null ? `${r.duration}ms` : "-";
+                return `[${r.id}] ${time} ${r.method} ${st} ${dur} ${r.url}`;
+            });
+            return { content: [{ type: "text", text: `Network Requests (${entries.length} entries, SDK):\n\n${lines.join("\n")}` }] };
+        }
+    }
+    // Fallback: read from in-process buffer (CDP/interceptor)
     // Return summary if requested
     if (summary) {
         const stats = getNetworkStats(networkBuffer);
@@ -1398,6 +1465,9 @@ registerToolWithTelemetry("get_network_requests", {
         if (networkBuffer.size === 0) {
             const connStatus = await checkAndEnsureConnection();
             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";
+            }
         }
         return {
             content: [
@@ -1419,6 +1489,9 @@ registerToolWithTelemetry("get_network_requests", {
     if (count === 0) {
         const connStatus = await checkAndEnsureConnection();
         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";
+        }
     }
     else {
         const passive = getPassiveConnectionStatus();
@@ -1461,7 +1534,9 @@ registerToolWithTelemetry("get_network_requests", {
             }
         ]
     };
-});
+}, 
+// Empty result detector: buffer has no entries at all
+() => networkBuffer.size === 0);
 // Tool: Search network requests
 registerToolWithTelemetry("search_network", {
     description: "Search network requests by URL pattern (case-insensitive)",
@@ -1511,7 +1586,7 @@ registerToolWithTelemetry("search_network", {
 });
 // Tool: Get request details
 registerToolWithTelemetry("get_request_details", {
-    description: "Get full details of a specific network request including headers, body, and timing. Use get_network_requests first to find the request ID.",
+    description: "Get full details of a specific network request including headers, body, and timing. With the SDK installed, includes full request/response bodies. Without SDK, bodies are not available on most targets. Use get_network_requests first to find the request ID.",
     inputSchema: {
         requestId: z.string().describe("The request ID to get details for"),
         maxBodyLength: z.coerce
@@ -1526,6 +1601,53 @@ registerToolWithTelemetry("get_request_details", {
             .describe("Disable body truncation. Tip: Use when you need to inspect full JSON payloads.")
     }
 }, async ({ requestId, maxBodyLength, verbose }) => {
+    // Check SDK first — it has full headers and body
+    const sdkAvailable = await isSDKInstalled();
+    if (sdkAvailable) {
+        const sdkResult = await readSDKNetworkRequest(requestId);
+        if (sdkResult.success && sdkResult.data) {
+            const r = sdkResult.data;
+            const lines = [];
+            lines.push(`=== ${r.method} ${r.url} ===`);
+            lines.push(`Request ID: ${r.id}`);
+            lines.push(`Time: ${new Date(r.timestamp).toISOString()}`);
+            lines.push(`Status: ${r.status ?? "pending"} ${r.statusText ?? ""}`);
+            if (r.duration != null)
+                lines.push(`Duration: ${r.duration}ms`);
+            if (r.mimeType)
+                lines.push(`Content-Type: ${r.mimeType}`);
+            if (r.error)
+                lines.push(`Error: ${r.error}`);
+            if (r.requestHeaders && Object.keys(r.requestHeaders).length > 0) {
+                lines.push("\n--- Request Headers ---");
+                for (const [k, v] of Object.entries(r.requestHeaders))
+                    lines.push(`${k}: ${v}`);
+            }
+            if (r.requestBody) {
+                lines.push("\n--- Request Body ---");
+                let body = r.requestBody;
+                if (!verbose && maxBodyLength > 0 && body.length > maxBodyLength) {
+                    body = body.slice(0, maxBodyLength) + `... [truncated: ${r.requestBody.length} chars]`;
+                }
+                lines.push(body);
+            }
+            if (r.responseHeaders && Object.keys(r.responseHeaders).length > 0) {
+                lines.push("\n--- Response Headers ---");
+                for (const [k, v] of Object.entries(r.responseHeaders))
+                    lines.push(`${k}: ${v}`);
+            }
+            if (r.responseBody) {
+                lines.push("\n--- Response Body ---");
+                let body = r.responseBody;
+                if (!verbose && maxBodyLength > 0 && body.length > maxBodyLength) {
+                    body = body.slice(0, maxBodyLength) + `... [truncated: ${r.responseBody.length} chars]`;
+                }
+                lines.push(body);
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+    }
+    // Fallback: read from in-process buffer
     const request = networkBuffer.get(requestId);
     if (!request) {
         const status = await checkAndEnsureConnection();
@@ -1575,18 +1697,28 @@ registerToolWithTelemetry("get_network_stats", {
             }
         ]
     };
-});
+}, 
+// Empty result detector: buffer has no entries at all
+() => networkBuffer.size === 0);
 // Tool: Clear network requests
 registerToolWithTelemetry("clear_network", {
     description: "Clear the network request buffer",
     inputSchema: {}
 }, async () => {
-    const count = networkBuffer.clear();
+    let totalCleared = networkBuffer.clear();
+    // Also clear SDK buffer if available
+    const sdkAvailable = await isSDKInstalled();
+    if (sdkAvailable) {
+        const sdkResult = await clearSDKNetwork();
+        if (sdkResult.success && sdkResult.count) {
+            totalCleared += sdkResult.count;
+        }
+    }
     return {
         content: [
             {
                 type: "text",
-                text: `Cleared ${count} network requests from buffer.`
+                text: `Cleared ${totalCleared} network requests from buffer.`
             }
         ]
     };