mobile-debug-mcp 0.30.2 → 0.31.0

package/dist/system/ios.js

@@ -11,14 +11,22 @@ export async function checkIOS() {
             iosAvailable = true;
             try {
                 const simOut = execSync(`${xcrun} simctl list devices booted --json`, { encoding: 'utf8', timeout: 1500, stdio: ['ignore', 'pipe', 'ignore'] });
-                const data = JSON.parse(simOut);
-                let count = 0;
-                for (const k in data.devices) {
-                    const arr = data.devices[k];
-                    if (Array.isArray(arr))
-                        count += arr.filter((d) => (d.state || '').toLowerCase() === 'booted').length;
+                try {
+                    const data = JSON.parse(simOut);
+                    let count = 0;
+                    for (const k in data.devices) {
+                        const arr = data.devices[k];
+                        if (Array.isArray(arr))
+                            count += arr.filter((d) => (d.state || '').toLowerCase() === 'booted').length;
+                    }
+                    iosDevices = count;
+                }
+                catch {
+                    // Some xcrun builds include extra text around the JSON response.
+                    // Fall back to counting explicit booted state markers so readiness remains deterministic.
+                    const bootedMatches = (simOut.match(/"state"\s*:\s*"Booted"/gi) || []).length;
+                    iosDevices = bootedMatches;
                 }
-                iosDevices = count;
                 if (iosDevices === 0)
                     issues.push('No iOS simulators/devices booted');
             }

package/dist/utils/android/utils.js

@@ -25,9 +25,12 @@ function findInPath(cmd) {
     return null;
 }
 export function resolveAdbCmd() {
-    // Priority: explicit env ADB_PATH -> ANDROID_SDK_ROOT/platform-tools/adb -> ANDROID_HOME/platform-tools/adb -> ~/Library/Android/sdk/platform-tools/adb -> PATH discovery -> 'adb'
+    // Priority: explicit env ADB_PATH -> PATH -> known SDK locations -> fallback to 'adb'
     if (process.env.ADB_PATH && process.env.ADB_PATH.trim())
         return process.env.ADB_PATH;
+    const found = findInPath('adb');
+    if (found)
+        return found;
     const sdkRoot = process.env.ANDROID_SDK_ROOT || process.env.ANDROID_HOME;
     if (sdkRoot) {
         const candidate = path.join(sdkRoot, 'platform-tools', process.platform === 'win32' ? 'adb.exe' : 'adb');
@@ -38,9 +41,6 @@ export function resolveAdbCmd() {
     const homeSdk = path.join(process.env.HOME || '', 'Library', 'Android', 'sdk', 'platform-tools', process.platform === 'win32' ? 'adb.exe' : 'adb');
     if (existsSync(homeSdk))
         return homeSdk;
-    const found = findInPath('adb');
-    if (found)
-        return found;
     return 'adb';
 }
 export function getAdbCmd() { return resolveAdbCmd(); }

package/dist/utils/cli/idb/check-idb.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execSync, spawnSync } from 'child_process';
 import { main as installMain } from './install-idb.js';
-import { getIdbCmd, isIDBInstalled } from './idb-helper.js';
+import { getIdbCmd, getIdbPackageVersion, isIDBInstalled } from './idb-helper.js';
 function which(cmd) {
     try {
         const r = spawnSync('command', ['-v', cmd], { stdio: ['ignore', 'pipe', 'ignore'] });
@@ -48,11 +48,18 @@ try {
     const idb = process.env.IDB_PATH || getIdbCmd();
     print('idb:', idb);
     if (idb && isIDBInstalled()) {
+        const version = getIdbPackageVersion();
+        if (version)
+            print('fb-idb version:', version);
         try {
-            print('idb --version:', execSync(`${idb} --version`, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim());
+            const output = execSync(`${idb} list-targets --json`, { stdio: ['ignore', 'pipe', 'pipe'], timeout: 5000 }).toString().trim();
+            print('idb list-targets --json: ok');
+            if (output)
+                print(output);
         }
         catch (e) {
-            print('idb --version: (failed)', e instanceof Error ? e.message : String(e));
+            print('idb list-targets --json: (failed)', e instanceof Error ? e.message : String(e));
+            process.exit(2);
         }
         const companion = which('idb_companion');
         print('which idb_companion:', companion);

package/dist/utils/cli/idb/idb-helper.js

@@ -71,21 +71,55 @@ export function getIdbCmd() {
     }
     return null;
 }
-export function isIDBInstalled() {
-    const cmd = getIdbCmd();
+export function getIdbPackageVersion() {
+    const runners = ['python3', 'python'];
+    for (const runner of runners) {
+        try {
+            const result = spawnSync(runner, ['-m', 'pip', 'show', 'fb-idb'], {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'pipe']
+            });
+            if (result.status !== 0)
+                continue;
+            const output = `${result.stdout || ''}\n${result.stderr || ''}`;
+            const match = output.match(/^Version:\s*(.+)$/mi);
+            if (match?.[1])
+                return match[1].trim();
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export function probeIdb(cmd = getIdbCmd()) {
     if (!cmd)
-        return false;
+        return { ok: false, raw: null, parsedVersion: null };
     try {
-        // command -v <cmd>
-        const r = spawnSync('command', ['-v', cmd], { stdio: ['ignore', 'pipe', 'ignore'] });
-        if (r && r.status === 0)
-            return true;
+        const result = spawnSync(cmd, ['list-targets', '--json'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 5000
+        });
+        if (result.status !== 0) {
+            return {
+                ok: false,
+                raw: `${result.stdout || ''}${result.stderr || ''}`.trim() || null,
+                parsedVersion: null
+            };
+        }
+        const version = getIdbPackageVersion();
+        const raw = version ? `fb-idb ${version}` : `${result.stdout || ''}${result.stderr || ''}`.trim() || null;
+        return {
+            ok: true,
+            raw,
+            parsedVersion: version
+        };
     }
-    catch { }
-    try {
-        execSync(`${cmd} list-targets --json`, { stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 });
-        return true;
+    catch {
+        return { ok: false, raw: null, parsedVersion: null };
     }
-    catch { }
-    return false;
+}
+export function isIDBInstalled() {
+    return probeIdb().ok;
 }

package/dist/utils/ios/utils.js

@@ -71,19 +71,15 @@ export function getIdbCmd() {
 }
 export async function isIDBInstalled() {
     const cmd = getIdbCmd();
+    if (!cmd)
+        return false;
     try {
-        execSync(`command -v ${cmd}`, { stdio: ['ignore', 'pipe', 'ignore'] });
+        execSync(`${cmd} list-targets --json`, { stdio: ['ignore', 'pipe', 'pipe'], timeout: 5000 });
         return true;
     }
     catch (e) {
-        try {
-            execSync(`${cmd} list-targets --json`, { stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 });
-            return true;
-        }
-        catch (e2) {
-            console.debug(`[isIDBInstalled] idb presence check failed for '${cmd}': ${e instanceof Error ? e.message : String(e2)}`);
-            return false;
-        }
+        console.debug(`[isIDBInstalled] idb probe failed for '${cmd}': ${e instanceof Error ? e.message : String(e)}`);
+        return false;
     }
 }
 // Validate bundle ID to prevent any potential injection or invalid characters

package/docs/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 All notable changes to the **Mobile Debug MCP** project will be documented in this file.
 
+## [0.31.0]
+- Added tool discovery/automation
+
 ## [0.30.2]
 - improved slider interaction
 

package/docs/ROADMAP.md

@@ -9,12 +9,12 @@
 - Action Trace and Execution Observability
 - Wait and Synchronization Reliability
 - Actionability Resolution
+- Environment Auto-Configuration and Toolchain Discovery
+- Adjustable Control Support
 
 ## Todo
 
-- Adjustable Control Support
 - Adjustable Control Precision Hardening
-- Environment Auto-Configuration and Toolchain Discovery
 - Signal-Oriented Diagnostic Filtering
 - Long Press Gesture
 - Runtime Debugger Introspection
@@ -205,7 +205,7 @@ Strengthens:
 ## Rationale
 Reduces failures caused by interacting with discoverable but non-actionable UI nodes.
 
-**Status:** Planned
+**Status:** Completed
 
 Addresses cases where:
 - visible text is not the true click target
@@ -251,7 +251,7 @@ Blocks or strengthens:
 ## Rationale
 High leverage improvement for sliders and parameterized controls.
 
-**Status:** Planned
+**Status:** Completed
 
 Addresses friction around:
 - coordinate-calibrated slider interaction

package/docs/specs/baseline-spec-v0.md

@@ -81,7 +81,7 @@ That flow is applied to `start_app`, `restart_app`, `tap`, `swipe`, `scroll_to_e
 | --- | --- | --- | --- | --- |
 | `classify_action_outcome` | Deterministic rule-based classifier over supplied signals. | `{ uiChanged: boolean, expectedElementVisible?: boolean, networkRequests?: { url?: string, status: 'success'\|'failure'\|'retryable' }[], hasLogErrors?: boolean }` | `{ outcome: 'success'\|'no_op'\|'backend_failure'\|'ui_failure'\|'unknown', reasoning: string, nextAction?: 'call_get_network_activity' }` | Pure computation. |
 | `get_network_activity` | Return normalized request events since last action window. | `{}` | `{ requests: NetworkRequestSummary[], count: number }` | Reads logs, advances internal `lastConsumedTimestamp`. |
-| `get_system_status` | Aggregate Android/iOS/Gradle readiness. | `{}` | `{ success, status: 'ready'\|'degraded'\|'blocked', adbAvailable, adbVersion, devices, deviceStates, logsAvailable, envValid, issues, appInstalled, iosAvailable, iosDevices, gradleJavaHome, gradleValid, gradleFilesChecked, gradleSuggestedFixes, summary }` | Reads toolchain/device state. |
+| `get_system_status` | Aggregate Android/iOS/Gradle readiness. | `{}` | Additive response: legacy flat fields remain available, with nested `host`, `android`, and `ios` objects added alongside them. | Reads toolchain/device state. |
 
 ## 3. Action Tools (Mutation Tools)