react-native-ai-debugger 2.17.1 → 2.19.0

package/build/tools/timelineTools.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { registerToolWithTelemetry } from "../core/register.js";
+import { lastAction } from "../core/actionLog.js";
+import { resolveWindow, trimEvents, formatTimeline, TIMELINE_SOURCES } from "../core/timeline.js";
+import { collectTimeline } from "../core/timelineSources.js";
+import { DEVICE_ALL_DESC } from "./_deviceArg.js";
+const DEFAULT_LIMIT = 100;
+export function registerTimelineTools(server) {
+    registerToolWithTelemetry(server, "get_timeline", {
+        description: "What happened, in order: your own actions, screen changes, network requests, console logs, app restarts and Fast Refresh edits in one time-ordered list.\n" +
+            "PURPOSE: Answer \"what did that cause?\" in one call instead of lining up get_logs, get_network_requests and get_screen_state by hand.\n" +
+            "WHEN TO USE: Right after a tap, navigate, input_text, reload_app or execute_in_app, to see its consequences; or with since=\"-5m\" to reconstruct how the app got into its current state.\n" +
+            "WORKFLOW: tap(...) -> get_timeline() -> get_request_details / get_log_details on the ids it prints.\n" +
+            "LIMITATIONS: Events are merged by time, not linked by cause. Shows only what the server captured (actions made through these tools, not by hand). Route and refresh times on Android and physical devices are corrected by an estimated clock offset.\n" +
+            "GOOD: get_timeline() after a tap; get_timeline({ since: \"-2m\", sources: [\"routes\", \"network\"] })\n" +
+            "BAD: get_timeline({ since: \"-1h\", limit: 500 }) as a first look; start from the last action.\n",
+        inputSchema: {
+            since: z.union([z.number(), z.string()]).optional()
+                .describe('Window start: "last_action" (default), a relative time like "-30s" / "-5m" / "-1h", or epoch ms.'),
+            until: z.union([z.number(), z.string()]).optional()
+                .describe('Window end, same formats as since except "last_action". Default: now.'),
+            sources: z.array(z.enum(TIMELINE_SOURCES)).optional()
+                .describe("Subset of actions, routes, network, logs, restarts, refresh, perf. Default: all. Restarts are always shown. perf is reserved and returns nothing yet."),
+            limit: z.coerce.number().int().min(1).max(500).optional().default(DEFAULT_LIMIT)
+                .describe("Maximum events (default 100). Actions, routes, restarts and errors are kept first."),
+            device: z.string().optional().describe(DEVICE_ALL_DESC),
+        },
+    }, async ({ since, until, sources, limit, device }) => {
+        const window = resolveWindow({ since, until, now: Date.now(), lastAction: lastAction(device) });
+        const wanted = sources?.length ? sources : [...TIMELINE_SOURCES];
+        const collected = await collectTimeline({ device, sources: wanted, window });
+        if (wanted.every((s) => collected.unavailable.includes(s))) {
+            const text = `Timeline unavailable: ${collected.notes.join("; ")}`;
+            return { isError: true, content: [{ type: "text", text }], _errorMessage: text };
+        }
+        const { kept, dropped } = trimEvents(collected.events, limit ?? DEFAULT_LIMIT);
+        const notes = window.fallback
+            ? ["No action recorded yet, so this shows the last 60s. Pass since to choose a window.", ...collected.notes]
+            : collected.notes;
+        const deviceLabel = collected.devices.length === 1 ? collected.devices[0]
+            : collected.devices.length === 0 ? "no devices" : "all devices";
+        const text = formatTimeline({
+            window, deviceLabel, events: kept, tagDevices: collected.devices.length > 1, dropped, notes, checked: wanted.filter((s) => s !== "perf"),
+        });
+        return { content: [{ type: "text", text }], _emptyResult: kept.length === 0 };
+    });
+}
+//# sourceMappingURL=timelineTools.js.map

package/build/tools/timelineTools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-ai-debugger",
-    "version": "2.17.1",
+    "version": "2.19.0",
     "mcpName": "com.execbro/execbro",
     "description": "React Native AI debugger: MCP server giving AI agents eyes and hands in your running app (logs, network, state inspection, tap, screenshot). Published as ExecBro.",
     "type": "module",

package/tools.json

@@ -1,6 +1,6 @@
 {
     "generatedFrom": "toolRegistry",
-    "count": 67,
+    "count": 68,
     "tools": [
         "activate_license",
         "android_key_event",
@@ -33,6 +33,7 @@
         "get_request_details",
         "get_screen_layout",
         "get_screen_state",
+        "get_timeline",
         "get_usage_guide",
         "handle_dialog",
         "http_request",
@@ -247,6 +248,13 @@
             "includeHistory",
             "pressablesOnly"
         ],
+        "get_timeline": [
+            "device",
+            "limit",
+            "since",
+            "sources",
+            "until"
+        ],
         "get_usage_guide": [
             "topic"
         ],
@@ -269,6 +277,7 @@
             "index",
             "native",
             "replace",
+            "showKeyboard",
             "testID",
             "text",
             "textMatch"
@@ -370,6 +379,7 @@
             "method",
             "mode",
             "networkError",
+            "operation",
             "remove",
             "set",
             "status",