@sensaiorg/adapter-android 0.1.0 → 0.1.1

package/dist/android-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"android-adapter.d.ts","sourceRoot":"","sources":["../src/android-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAUzC;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAGxD,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAQ;IACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC1C,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IACvD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;gBAEvC,MAAM,GAAE,oBAAyB;IAiBvC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsB7C,QAAQ,IAAI,IAAI;IAIhB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAM/C"}
+{"version":3,"file":"android-adapter.d.ts","sourceRoot":"","sources":["../src/android-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAUzC;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAGxD,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAQ;IACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC1C,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IACvD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;gBAEvC,MAAM,GAAE,oBAAyB;IAiBvC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA+B7C,QAAQ,IAAI,IAAI;IAIhB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAM/C"}

package/dist/android-adapter.js

@@ -45,10 +45,21 @@ class AndroidAdapter {
     }
     async initialize() {
         const status = await this.connectionManager.initialize();
-        // Update capabilities if agent is available
+        // Update capabilities based on agent-reported capabilities (if available)
         if (status.agent) {
-            this.capabilities.network = true;
-            this.capabilities.appState = true;
+            const agentCaps = this.connectionManager.getAgentCapabilities();
+            if (agentCaps) {
+                // Agent explicitly reports what it supports
+                if (agentCaps.network)
+                    this.capabilities.network = true;
+                if (agentCaps.reactNative)
+                    this.capabilities.appState = true;
+            }
+            else {
+                // Agent connected but doesn't support capabilities RPC — assume Phase 2 defaults
+                this.capabilities.network = true;
+                this.capabilities.appState = true;
+            }
         }
         return {
             platform: "android",
@@ -58,6 +69,7 @@ class AndroidAdapter {
             details: {
                 adb: status.adb,
                 agent: status.agent,
+                agentCapabilities: this.connectionManager.getAgentCapabilities(),
                 targetPackage: this.config.targetPackage,
             },
         };

package/dist/tools/accessibility.js

@@ -38,7 +38,7 @@ function registerAccessibilityTools(server, cm) {
             // Try the agent first for a richer accessibility tree
             if (cm.agent.isConnected()) {
                 try {
-                    const result = await cm.agent.call("getAccessibilityTree");
+                    const result = await cm.agent.call("ui.allWindows");
                     return {
                         content: [{ type: "text", text: JSON.stringify(result) }],
                     };

package/dist/tools/agent-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-management.d.ts","sourceRoot":"","sources":["../../src/tools/agent-management.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AA8C5E,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAqM3F"}

package/dist/tools/agent-management.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Agent Management Tools - Install the SensAI agent APK and query connection status.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentManagementTools = registerAgentManagementTools;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+/** Package name for the SensAI on-device agent. */
+const AGENT_PACKAGE = "com.sensai.agent";
+/** Service component to start after install. */
+const AGENT_SERVICE = `${AGENT_PACKAGE}/.DebugAgentService`;
+/** Accessibility service component for emulators. */
+const ACCESSIBILITY_SERVICE = `${AGENT_PACKAGE}/.accessibility.UITreeExtractor`;
+/**
+ * Resolve the agent APK path. Checks (in order):
+ *  1. SENSAI_AGENT_APK environment variable
+ *  2. android-agent/app/build/outputs/apk/debug/app-debug.apk relative to repo root
+ */
+function resolveApkPath() {
+    if (process.env.SENSAI_AGENT_APK) {
+        const envPath = (0, node_path_1.resolve)(process.env.SENSAI_AGENT_APK);
+        return (0, node_fs_1.existsSync)(envPath) ? envPath : null;
+    }
+    // Walk up from this file to find the repo root (contains android-agent/)
+    // __dirname is packages/adapter-android/dist/tools (or src/tools in dev)
+    const repoRoot = (0, node_path_1.resolve)(__dirname, "..", "..", "..", "..");
+    const defaultPath = (0, node_path_1.resolve)(repoRoot, "android-agent", "app", "build", "outputs", "apk", "debug", "app-debug.apk");
+    return (0, node_fs_1.existsSync)(defaultPath) ? defaultPath : null;
+}
+/**
+ * Detect whether the device serial looks like an emulator.
+ */
+function isEmulatorDevice(serial) {
+    return serial.startsWith("emulator-") || serial.includes("localhost:");
+}
+function registerAgentManagementTools(server, cm) {
+    // ---------- install_agent ----------
+    server.tool("install_agent", "Install the SensAI on-device agent APK via ADB. Starts the agent service, " +
+        "enables accessibility on emulators, sets up port forwarding, and attempts connection.", {
+        apkPath: zod_1.z
+            .string()
+            .optional()
+            .describe("Explicit path to the agent APK. If omitted, checks SENSAI_AGENT_APK env var " +
+            "then the default Gradle build output."),
+        forceReinstall: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Pass -r flag to adb install to replace existing install (default: true)"),
+    }, async (params) => {
+        const steps = [];
+        try {
+            // 1. Locate APK
+            const apkPath = params.apkPath ? (0, node_path_1.resolve)(params.apkPath) : resolveApkPath();
+            if (!apkPath || !(0, node_fs_1.existsSync)(apkPath)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: "Agent APK not found",
+                                searchedPaths: [
+                                    params.apkPath ?? "(not specified)",
+                                    process.env.SENSAI_AGENT_APK ?? "(env not set)",
+                                    "android-agent/app/build/outputs/apk/debug/app-debug.apk",
+                                ],
+                                hint: "Build the agent with: cd android-agent && ./gradlew assembleDebug",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            steps.push(`APK found: ${apkPath}`);
+            // 2. Install APK
+            const installArgs = params.forceReinstall === false ? ["install", apkPath] : ["install", "-r", apkPath];
+            const installOutput = await cm.adb.exec(installArgs, 60_000);
+            steps.push(`Install: ${installOutput.trim()}`);
+            // 3. Start the agent foreground service
+            try {
+                await cm.adb.shell(`am start-foreground-service -n ${AGENT_SERVICE}`);
+                steps.push("Agent service started");
+            }
+            catch (err) {
+                steps.push(`Service start warning: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // 4. On emulators, auto-enable accessibility service
+            const status = cm.getStatus();
+            if (isEmulatorDevice(status.device)) {
+                try {
+                    await cm.adb.shell(`settings put secure enabled_accessibility_services ${ACCESSIBILITY_SERVICE}`);
+                    steps.push("Accessibility service enabled (emulator)");
+                }
+                catch (err) {
+                    steps.push(`Accessibility warning: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            else {
+                steps.push("Physical device detected — enable accessibility manually in Settings > Accessibility");
+            }
+            // 5. Set up port forwarding
+            try {
+                await cm.adb.forward(status.agentPort, status.agentPort);
+                steps.push(`Port forward: tcp:${status.agentPort} -> tcp:${status.agentPort}`);
+            }
+            catch (err) {
+                steps.push(`Port forward warning: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // 6. Attempt connection (give the service a moment to start)
+            await new Promise((resolve) => setTimeout(resolve, 2_000));
+            let agentConnected = false;
+            try {
+                await cm.agent.connect();
+                agentConnected = cm.agent.isConnected();
+                steps.push(agentConnected ? "Agent connected" : "Agent not responding yet");
+            }
+            catch {
+                steps.push("Agent not responding yet — it may need a few seconds to initialize");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            agentConnected,
+                            steps,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                            steps,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ---------- agent_status ----------
+    server.tool("agent_status", "Report current SensAI agent connection state, capabilities, port forwarding, and device info.", {}, async () => {
+        try {
+            const connStatus = cm.getStatus();
+            const capabilities = cm.getAgentCapabilities();
+            // Check if the agent package is installed on the device
+            let installed = false;
+            try {
+                const pmOutput = await cm.adb.shell(`pm list packages ${AGENT_PACKAGE}`);
+                installed = pmOutput.includes(AGENT_PACKAGE);
+            }
+            catch {
+                // pm command failed — can't determine install status
+            }
+            // Gather device info if ADB is connected
+            let deviceInfo = null;
+            if (connStatus.adb) {
+                try {
+                    deviceInfo = await cm.adb.getDeviceInfo();
+                }
+                catch {
+                    // Best-effort
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            agent: {
+                                connected: connStatus.agent,
+                                installed,
+                                capabilities,
+                            },
+                            connection: {
+                                adb: connStatus.adb,
+                                device: connStatus.device,
+                                agentPort: connStatus.agentPort,
+                                isEmulator: isEmulatorDevice(connStatus.device),
+                            },
+                            deviceInfo,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Agent status error: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=agent-management.js.map

package/dist/tools/app-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/tools/app-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAe5E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAqKpF"}
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/tools/app-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAe5E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAgOpF"}

package/dist/tools/app-state.js

@@ -35,16 +35,73 @@ function registerAppStateTools(server, cm) {
     }, async (params) => {
         const categories = (params.categories ?? [...STATE_CATEGORIES]);
         const targetPackage = process.env.TARGET_PACKAGE ?? "com.emudebug.target";
-        // Phase 2: agent provides full app state
+        // Phase 2: agent provides full app state via specific RPC calls
         if (cm.agent.isConnected()) {
             try {
-                const result = await cm.agent.call("getAppState", {
-                    categories,
-                    asyncStorageKeys: params.asyncStorageKeys,
-                    queryCacheFilter: params.queryCacheFilter,
-                });
+                const agentState = {};
+                if (categories.includes("asyncStorage")) {
+                    agentState.asyncStorage = await cm.agent.call("rn.asyncStorage", {
+                        keys: params.asyncStorageKeys,
+                    });
+                }
+                if (categories.includes("queryCache")) {
+                    agentState.queryCache = await cm.agent.call("rn.queryCache", {
+                        filter: params.queryCacheFilter,
+                    });
+                }
+                if (categories.includes("featureFlags") || categories.includes("theme")) {
+                    // Feature flags and theme are typically stored in Redux or Context
+                    try {
+                        const reduxState = await cm.agent.call("rn.reduxState");
+                        if (categories.includes("featureFlags")) {
+                            agentState.featureFlags = reduxState;
+                        }
+                        if (categories.includes("theme")) {
+                            agentState.theme = reduxState;
+                        }
+                    }
+                    catch {
+                        // Redux may not be available
+                        if (categories.includes("featureFlags")) {
+                            agentState.featureFlags = { note: "Redux state not available. App may use Context instead." };
+                        }
+                        if (categories.includes("theme")) {
+                            agentState.theme = { note: "Redux state not available. App may use Context instead." };
+                        }
+                    }
+                }
+                if (categories.includes("navigation")) {
+                    try {
+                        agentState.navigation = await cm.agent.call("rn.context", {
+                            name: "NavigationContainer",
+                        });
+                    }
+                    catch {
+                        agentState.navigation = { note: "Navigation context not found." };
+                    }
+                }
+                if (categories.includes("auth")) {
+                    try {
+                        agentState.auth = await cm.agent.call("rn.context", {
+                            name: "AuthContext",
+                        });
+                    }
+                    catch {
+                        agentState.auth = { note: "Auth context not found." };
+                    }
+                }
+                if (categories.includes("offlineQueue")) {
+                    try {
+                        agentState.offlineQueue = await cm.agent.call("rn.asyncStorage", {
+                            keys: ["offlineQueue"],
+                        });
+                    }
+                    catch {
+                        agentState.offlineQueue = { note: "Offline queue not found in AsyncStorage." };
+                    }
+                }
                 return {
-                    content: [{ type: "text", text: JSON.stringify(result) }],
+                    content: [{ type: "text", text: JSON.stringify(agentState) }],
                 };
             }
             catch (err) {

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAe5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAc/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAgB5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAe/E"}

package/dist/tools/index.js

@@ -17,8 +17,9 @@ const diagnose_js_1 = require("./diagnose.js");
 const hot_reload_js_1 = require("./hot-reload.js");
 const smart_actions_js_1 = require("./smart-actions.js");
 const recording_js_1 = require("./recording.js");
+const agent_management_js_1 = require("./agent-management.js");
 /**
- * Register all 26 EmuDebug tools with the MCP server.
+ * Register all 28 SensAI tools with the MCP server.
  *
  * Tools registered:
  *  1. get_ui_tree         - UI hierarchy as JSON
@@ -47,6 +48,8 @@ const recording_js_1 = require("./recording.js");
  * 24. assert_screen       - Quick screen assertions
  * 25. open_deep_link      - Open app via deep link URL
  * 26. take_screenshot     - Capture screen as base64 PNG
+ * 27. install_agent       - Install SensAI agent APK via ADB
+ * 28. agent_status        - Report agent connection state and capabilities
  */
 function registerAllTools(server, cm) {
     (0, ui_tree_js_1.registerUiTreeTools)(server, cm); // 3 tools: get_ui_tree, get_screen_text, get_element_details
@@ -62,5 +65,6 @@ function registerAllTools(server, cm) {
     (0, hot_reload_js_1.registerHotReloadTools)(server, cm); // 1 tool:  hot_reload
     (0, smart_actions_js_1.registerSmartActionTools)(server, cm); // 7 tools: wait_for_text, scroll_to_text, fill_form, tap_and_wait, assert_screen, open_deep_link, take_screenshot
     (0, recording_js_1.registerRecordingTools)(server, cm); // 2 tools: start_recording, stop_recording
+    (0, agent_management_js_1.registerAgentManagementTools)(server, cm); // 2 tools: install_agent, agent_status
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/tools/interaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAmE5E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CA+WvF"}
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/tools/interaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAmE5E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CA2cvF"}

package/dist/tools/interaction.js

@@ -132,6 +132,50 @@ function registerInteractionTools(server, cm) {
             }
             // Invalidate cache — screen will change after tap
             cm.uiCache.invalidate();
+            // Try agent first if connected (accessibility-based tap is more reliable)
+            if (cm.agent.isConnected()) {
+                try {
+                    // Use text-based click if we have a text selector, otherwise coordinate-based
+                    if (params.text && !params.x) {
+                        const result = await cm.agent.call("ui.click", { text: params.text, resourceId: params.resourceId, contentDescription: params.contentDescription });
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        success: true,
+                                        tapped: { x: tapX, y: tapY },
+                                        matchedBy: matchInfo,
+                                        via: "agent (ui.click)",
+                                        agentResult: result,
+                                    }),
+                                },
+                            ],
+                        };
+                    }
+                    else {
+                        const result = await cm.agent.call("ui.clickAt", { x: tapX, y: tapY });
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        success: true,
+                                        tapped: { x: tapX, y: tapY },
+                                        matchedBy: matchInfo,
+                                        via: "agent (ui.clickAt)",
+                                        agentResult: result,
+                                    }),
+                                },
+                            ],
+                        };
+                    }
+                }
+                catch {
+                    // Fall through to ADB
+                }
+            }
+            // ADB fallback
             await cm.adb.shell(`input tap ${tapX} ${tapY}`);
             return {
                 content: [
@@ -141,6 +185,7 @@ function registerInteractionTools(server, cm) {
                             success: true,
                             tapped: { x: tapX, y: tapY },
                             matchedBy: matchInfo,
+                            via: "adb",
                         }),
                     },
                 ],
@@ -166,6 +211,29 @@ function registerInteractionTools(server, cm) {
         clearFirst: zod_1.z.boolean().optional().describe("Clear the field before typing (default: false)"),
     }, async (params) => {
         try {
+            // Invalidate cache — screen content changes after typing
+            cm.uiCache.invalidate();
+            // Try agent first if connected (handles Unicode and special chars better)
+            if (cm.agent.isConnected()) {
+                try {
+                    const result = await cm.agent.call("ui.type", {
+                        text: params.text,
+                        clearFirst: params.clearFirst ?? false,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ ok: true, via: "agent (ui.type)", agentResult: result }),
+                            },
+                        ],
+                    };
+                }
+                catch {
+                    // Fall through to ADB
+                }
+            }
+            // ADB fallback
             // Optionally clear existing text
             if (params.clearFirst) {
                 // Most reliable approach for React Native TextInput:
@@ -190,14 +258,12 @@ function registerInteractionTools(server, cm) {
                 .replace(/\)/g, "\\)")
                 .replace(/\$/g, "\\$")
                 .replace(/`/g, "\\`");
-            // Invalidate cache — screen content changes after typing
-            cm.uiCache.invalidate();
             await cm.adb.shell(`input text ${escaped}`);
             return {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify({ ok: true }),
+                        text: JSON.stringify({ ok: true, via: "adb" }),
                     },
                 ],
             };
@@ -228,12 +294,36 @@ function registerInteractionTools(server, cm) {
             const duration = params.durationMs ?? 300;
             // Invalidate cache — screen will change after swipe
             cm.uiCache.invalidate();
+            // Try agent first if connected
+            if (cm.agent.isConnected()) {
+                try {
+                    const result = await cm.agent.call("ui.swipe", {
+                        startX: params.startX,
+                        startY: params.startY,
+                        endX: params.endX,
+                        endY: params.endY,
+                        durationMs: duration,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ ok: true, via: "agent (ui.swipe)", agentResult: result }),
+                            },
+                        ],
+                    };
+                }
+                catch {
+                    // Fall through to ADB
+                }
+            }
+            // ADB fallback
             await cm.adb.shell(`input swipe ${params.startX} ${params.startY} ${params.endX} ${params.endY} ${duration}`);
             return {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify({ ok: true }),
+                        text: JSON.stringify({ ok: true, via: "adb" }),
                     },
                 ],
             };

package/dist/tools/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAiInF"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CA8InF"}

package/dist/tools/network.js

@@ -29,13 +29,27 @@ function registerNetworkTools(server, cm) {
         // Phase 2: full network interception via agent
         if (cm.agent.isConnected()) {
             try {
-                const result = await cm.agent.call("getNetwork", {
-                    mode: params.mode,
-                    urlFilter: params.urlFilter,
-                    statusFilter: params.statusFilter,
-                    maxEntries,
-                    includeBody: params.includeBody ?? false,
-                });
+                let result;
+                if (params.mode === "capture_start") {
+                    // Install the network interceptor to begin capture
+                    result = await cm.agent.call("network.install");
+                }
+                else if (params.mode === "capture_stop") {
+                    // Retrieve captured requests and stats
+                    const requests = await cm.agent.call("network.requests", {
+                        urlFilter: params.urlFilter,
+                        limit: maxEntries,
+                    });
+                    const stats = await cm.agent.call("network.stats");
+                    result = { requests, stats };
+                }
+                else {
+                    // "history" mode - get buffered requests
+                    result = await cm.agent.call("network.buffer", {
+                        urlFilter: params.urlFilter,
+                        limit: maxEntries,
+                    });
+                }
                 return {
                     content: [{ type: "text", text: JSON.stringify(result) }],
                 };

package/dist/tools/performance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/tools/performance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAgC5E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CA8HvF"}
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/tools/performance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAgC5E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAuLvF"}

package/dist/tools/performance.js

@@ -43,13 +43,64 @@ function registerPerformanceTools(server, cm) {
         // Phase 2: agent provides rich metrics
         if (cm.agent.isConnected()) {
             try {
-                const result = await cm.agent.call("getPerformance", {
-                    metrics,
-                    durationSec,
-                });
-                return {
-                    content: [{ type: "text", text: JSON.stringify(result) }],
-                };
+                const agentResult = {};
+                if (metrics.includes("memory")) {
+                    agentResult.memory = await cm.agent.call("perf.memory");
+                }
+                if (metrics.includes("fps")) {
+                    // Start frame monitor, wait for sampling, then get stats
+                    await cm.agent.call("perf.startFrameMonitor");
+                    await new Promise((r) => setTimeout(r, durationSec * 1000));
+                    agentResult.fps = await cm.agent.call("perf.frameStats");
+                    await cm.agent.call("perf.stopFrameMonitor");
+                }
+                if (metrics.includes("cpu")) {
+                    // No dedicated agent method for CPU - will fall through to ADB below
+                }
+                if (metrics.includes("bridge")) {
+                    // Bridge metrics via RN bridge interceptor
+                    try {
+                        agentResult.bridge = await cm.agent.call("rn.bridgeCalls", { limit: 50 });
+                    }
+                    catch {
+                        agentResult.bridge = { note: "Bridge interceptor not installed. Call rn.installBridge first." };
+                    }
+                }
+                // If we got at least some metrics from the agent, return them
+                // For CPU, fall through to ADB section below and merge
+                if (Object.keys(agentResult).length > 0 && !metrics.includes("cpu")) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(agentResult) }],
+                    };
+                }
+                // If CPU is requested, we need ADB for that - merge agent results into ADB path
+                if (metrics.includes("cpu") && Object.keys(agentResult).length > 0) {
+                    // Fall through to ADB for CPU, but pre-populate result with agent data
+                    const result = { ...agentResult };
+                    // CPU via top (single snapshot)
+                    try {
+                        const raw = await cm.adb.shell(`top -b -n 1 -d ${durationSec} | grep -i "${targetPackage}"`);
+                        const lines = raw.trim().split("\n").filter(Boolean);
+                        const cpuEntries = lines.map((line) => {
+                            const parts = line.trim().split(/\s+/);
+                            return {
+                                pid: parts[0],
+                                cpu: parts.length > 8 ? parts[8] : "?",
+                                mem: parts.length > 9 ? parts[9] : "?",
+                                raw: line.trim(),
+                            };
+                        });
+                        result.cpu = { processes: cpuEntries };
+                    }
+                    catch (err) {
+                        result.cpu = {
+                            error: `Failed to get CPU info: ${err instanceof Error ? err.message : String(err)}`,
+                        };
+                    }
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result) }],
+                    };
+                }
             }
             catch {
                 // Fall through to ADB

package/dist/tools/rn-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rn-tools.d.ts","sourceRoot":"","sources":["../../src/tools/rn-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAoB5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAgH9E"}
+{"version":3,"file":"rn-tools.d.ts","sourceRoot":"","sources":["../../src/tools/rn-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAoB5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI,CA4G9E"}