mobile-debug-mcp 0.12.5 → 0.12.7

package/dist/ios/manage.js

@@ -303,15 +303,105 @@ export class iOSManage {
                 console.error('MCP-STARTAPP-EXEC', JSON.stringify(instrumentation));
             }
             catch (e) { }
-            const result = await execCommand(['simctl', 'launch', deviceId, bundleId], deviceId);
+        }
+        catch { }
+        // Attempt to launch
+        let launchResult = null;
+        try {
+            launchResult = await execCommand(['simctl', 'launch', deviceId, bundleId], deviceId);
+        }
+        catch (launchErr) {
+            // Collect diagnostics when simctl launch fails
+            const launchDiag = execCommandWithDiagnostics(['simctl', 'launch', deviceId, bundleId], deviceId);
             const device = await getIOSDeviceMetadata(deviceId);
-            return { device, appStarted: !!result.output, launchTimeMs: 1000, instrumentation };
+            const post = await this.collectPostLaunchDiagnostics(bundleId, deviceId);
+            return { device, appStarted: false, launchTimeMs: 0, error: launchErr instanceof Error ? launchErr.message : String(launchErr), diagnostics: { launchDiag, post }, instrumentation };
+        }
+        // Basic success — but verify RunningBoard/installcoordination didn't mark it as placeholder
+        const device = await getIOSDeviceMetadata(deviceId);
+        // short wait to let system settle
+        await new Promise(r => setTimeout(r, 1000));
+        let appinfo = '';
+        try {
+            const ai = await execCommand(['simctl', 'appinfo', deviceId, bundleId], deviceId);
+            appinfo = ai.output || '';
+        }
+        catch { }
+        // capture recent runningboard/installcoordination logs
+        const logDiag = execCommandWithDiagnostics(['simctl', 'spawn', deviceId, 'log', 'show', '--style', 'syslog', '--predicate', `(process == "${bundleId}" ) OR eventMessage CONTAINS "installcoordinationd" OR eventMessage CONTAINS "runningboard"`, '--last', '1m'], deviceId);
+        const placeholderDetected = (appinfo && /isPlaceholder[:=]?\s*Y/i.test(appinfo)) || (logDiag && ((logDiag.runResult && ((logDiag.runResult.stdout || '').includes('isPlaceholder')) || (logDiag.runResult.stderr || '').includes('isPlaceholder'))));
+        if (placeholderDetected) {
+            const post = await this.collectPostLaunchDiagnostics(bundleId, deviceId, appinfo);
+            return { device, appStarted: false, launchTimeMs: 0, diagnostics: { appinfo, logDiag, post }, instrumentation };
+        }
+        return { device, appStarted: !!(launchResult && launchResult.output), launchTimeMs: 1000, instrumentation };
+    }
+    appExecutableName(bundleId) {
+        // Best-effort executable name: prefer last component of bundleId
+        try {
+            const candidate = bundleId.split('.').pop();
+            return candidate || bundleId;
+        }
+        catch {
+            return bundleId;
+        }
+    }
+    // Collect bundle- and system-level diagnostics after a failed or placeholder launch
+    async collectPostLaunchDiagnostics(bundleId, deviceId = "booted", appinfo) {
+        const diagnostics = { ts: new Date().toISOString(), bundleId, deviceId };
+        // gather simctl appinfo (if not provided)
+        try {
+            diagnostics.appinfo = appinfo || ((await execCommand(['simctl', 'appinfo', deviceId, bundleId], deviceId)).output || '');
         }
         catch (e) {
-            const diag = execCommandWithDiagnostics(['simctl', 'launch', deviceId, bundleId], deviceId);
-            const device = await getIOSDeviceMetadata(deviceId);
-            return { device, appStarted: false, launchTimeMs: 0, error: e instanceof Error ? e.message : String(e), diagnostics: diag, instrumentation };
+            diagnostics.appinfoError = String(e);
+        }
+        // attempt to discover bundle path from appinfo
+        let bundlePath = null;
+        if (diagnostics.appinfo) {
+            const m = diagnostics.appinfo.match(/Path\s*=\s*"?([\S]+)"?/) || diagnostics.appinfo.match(/Container: (\/\S+)/);
+            if (m)
+                bundlePath = m[1];
+        }
+        // lipo / file / otool / codesign / xattr
+        if (bundlePath) {
+            diagnostics.bundlePath = bundlePath;
+            const execs = [
+                { name: 'file', cmd: ['file', bundlePath + '/' + this.appExecutableName(bundleId)] },
+                { name: 'lipo', cmd: ['lipo', '-info', bundlePath + '/' + this.appExecutableName(bundleId)] },
+                { name: 'otool-L', cmd: ['otool', '-L', bundlePath + '/' + this.appExecutableName(bundleId)] },
+                { name: 'otool-load', cmd: ['otool', '-l', bundlePath + '/' + this.appExecutableName(bundleId)] },
+                { name: 'plutil', cmd: ['plutil', '-p', bundlePath + '/Info.plist'] },
+                { name: 'codesign', cmd: ['codesign', '-dvvv', bundlePath] },
+                { name: 'xattr', cmd: ['xattr', '-l', bundlePath] },
+                { name: 'ls', cmd: ['ls', '-la', bundlePath] },
+            ];
+            diagnostics.bundle = {};
+            for (const e of execs) {
+                try {
+                    const r = execCommandWithDiagnostics(e.cmd, deviceId);
+                    diagnostics.bundle[e.name] = r && r.runResult ? { stdout: r.runResult.stdout, stderr: r.runResult.stderr, code: r.runResult.exitCode } : { error: 'no-result' };
+                }
+                catch (err) {
+                    diagnostics.bundle[e.name] = { error: String(err) };
+                }
+            }
+        }
+        // collect recent system logs and a screenshot
+        try {
+            diagnostics.recentLogs = execCommandWithDiagnostics(['simctl', 'spawn', deviceId, 'log', 'show', '--style', 'syslog', '--predicate', `eventMessage CONTAINS "installcoordinationd" OR eventMessage CONTAINS "runningboard"`, '--last', '5m'], deviceId);
+        }
+        catch (e) {
+            diagnostics.recentLogsError = String(e);
+        }
+        try {
+            const shot = await execCommandWithDiagnostics(['simctl', 'io', deviceId, 'screenshot', '--type', 'png', '/tmp/mcp_post_launch_screenshot.png'], deviceId);
+            diagnostics.screenshot = { created: true, path: '/tmp/mcp_post_launch_screenshot.png', result: shot && shot.runResult };
+        }
+        catch (e) {
+            diagnostics.screenshotError = String(e);
         }
+        return diagnostics;
     }
     async terminateApp(bundleId, deviceId = "booted") {
         validateBundleId(bundleId);

package/dist/server.js

@@ -390,10 +390,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (name === "start_app") {
             const { platform, appId, deviceId } = args;
             const res = await (platform === 'android' ? new AndroidManage().startApp(appId, deviceId) : new iOSManage().startApp(appId, deviceId));
+            // Preserve diagnostics and instrumentation from platform managers so agents receive full context
             const response = {
                 device: res.device,
                 appStarted: res.appStarted,
-                launchTimeMs: res.launchTimeMs
+                launchTimeMs: res.launchTimeMs,
+                error: res.error,
+                diagnostics: res.diagnostics,
+                instrumentation: res.instrumentation
             };
             return wrapResponse(response);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-debug-mcp",
-  "version": "0.12.5",
+  "version": "0.12.7",
   "description": "MCP server for mobile app debugging (Android + iOS), with focus on security and reliability",
   "type": "module",
   "bin": {

package/src/ios/manage.ts

@@ -300,19 +300,100 @@ export class iOSManage {
     validateBundleId(bundleId)
     // Prepare instrumentation object upfront so it can be returned to callers
     const instrumentation = { ts: new Date().toISOString(), action: 'startApp', cmd: 'xcrun', args: ['simctl','launch', deviceId, bundleId], cwd: process.cwd(), env: { PATH: process.env.PATH, XCRUN_PATH: process.env.XCRUN_PATH } }
+
     try {
       // Instrumentation: persist and emit to stderr for server logs
       try { await fs.appendFile('/tmp/mcp_startapp_instrument.log', JSON.stringify(instrumentation) + '\n') } catch (e) {}
       try { console.error('MCP-STARTAPP-EXEC', JSON.stringify(instrumentation)) } catch (e) {}
+    } catch {}
 
-      const result = await execCommand(['simctl', 'launch', deviceId, bundleId], deviceId)
-      const device = await getIOSDeviceMetadata(deviceId)
-      return { device, appStarted: !!result.output, launchTimeMs: 1000, instrumentation }
-    } catch (e:any) {
-      const diag = execCommandWithDiagnostics(['simctl', 'launch', deviceId, bundleId], deviceId)
+    // Attempt to launch
+    let launchResult: any = null
+    try {
+      launchResult = await execCommand(['simctl', 'launch', deviceId, bundleId], deviceId)
+    } catch (launchErr:any) {
+      // Collect diagnostics when simctl launch fails
+      const launchDiag = execCommandWithDiagnostics(['simctl', 'launch', deviceId, bundleId], deviceId)
       const device = await getIOSDeviceMetadata(deviceId)
-      return { device, appStarted: false, launchTimeMs: 0, error: e instanceof Error ? e.message : String(e), diagnostics: diag, instrumentation } as any
+      const post = await this.collectPostLaunchDiagnostics(bundleId, deviceId)
+      return { device, appStarted: false, launchTimeMs: 0, error: launchErr instanceof Error ? launchErr.message : String(launchErr), diagnostics: { launchDiag, post }, instrumentation } as any
+    }
+
+    // Basic success — but verify RunningBoard/installcoordination didn't mark it as placeholder
+    const device = await getIOSDeviceMetadata(deviceId)
+    // short wait to let system settle
+    await new Promise(r => setTimeout(r, 1000))
+
+    let appinfo = ''
+    try {
+      const ai = await execCommand(['simctl', 'appinfo', deviceId, bundleId], deviceId)
+      appinfo = ai.output || ''
+    } catch {}
+
+    // capture recent runningboard/installcoordination logs
+    const logDiag = execCommandWithDiagnostics(['simctl','spawn',deviceId,'log','show','--style','syslog','--predicate',`(process == "${bundleId}" ) OR eventMessage CONTAINS "installcoordinationd" OR eventMessage CONTAINS "runningboard"`, '--last', '1m'], deviceId)
+
+    const placeholderDetected = (appinfo && /isPlaceholder[:=]?\s*Y/i.test(appinfo)) || (logDiag && ((logDiag.runResult && ((logDiag.runResult.stdout || '').includes('isPlaceholder')) || (logDiag.runResult.stderr || '').includes('isPlaceholder'))))
+
+    if (placeholderDetected) {
+      const post = await this.collectPostLaunchDiagnostics(bundleId, deviceId, appinfo)
+      return { device, appStarted: false, launchTimeMs: 0, diagnostics: { appinfo, logDiag, post }, instrumentation } as any
     }
+
+    return { device, appStarted: !!(launchResult && launchResult.output), launchTimeMs: 1000, instrumentation }
+  }
+
+  appExecutableName(bundleId: string) {
+    // Best-effort executable name: prefer last component of bundleId
+    try { const candidate = bundleId.split('.').pop(); return candidate || bundleId }
+    catch { return bundleId }
+  }
+
+  // Collect bundle- and system-level diagnostics after a failed or placeholder launch
+  async collectPostLaunchDiagnostics(bundleId: string, deviceId: string = "booted", appinfo?: string) {
+    const diagnostics: any = { ts: new Date().toISOString(), bundleId, deviceId }
+
+    // gather simctl appinfo (if not provided)
+    try { diagnostics.appinfo = appinfo || ((await execCommand(['simctl','appinfo', deviceId, bundleId], deviceId)).output || '') } catch (e) { diagnostics.appinfoError = String(e) }
+
+    // attempt to discover bundle path from appinfo
+    let bundlePath: string | null = null
+    if (diagnostics.appinfo) {
+      const m = diagnostics.appinfo.match(/Path\s*=\s*"?([\S]+)"?/) || diagnostics.appinfo.match(/Container: (\/\S+)/)
+      if (m) bundlePath = m[1]
+    }
+
+    // lipo / file / otool / codesign / xattr
+    if (bundlePath) {
+      diagnostics.bundlePath = bundlePath
+      const execs = [
+        { name: 'file', cmd: ['file', bundlePath + '/' + this.appExecutableName(bundleId)] },
+        { name: 'lipo', cmd: ['lipo', '-info', bundlePath + '/' + this.appExecutableName(bundleId)] },
+        { name: 'otool-L', cmd: ['otool', '-L', bundlePath + '/' + this.appExecutableName(bundleId)] },
+        { name: 'otool-load', cmd: ['otool', '-l', bundlePath + '/' + this.appExecutableName(bundleId)] },
+        { name: 'plutil', cmd: ['plutil', '-p', bundlePath + '/Info.plist'] },
+        { name: 'codesign', cmd: ['codesign', '-dvvv', bundlePath] },
+        { name: 'xattr', cmd: ['xattr', '-l', bundlePath] },
+        { name: 'ls', cmd: ['ls', '-la', bundlePath] },
+      ]
+
+      diagnostics.bundle = {}
+      for (const e of execs) {
+        try {
+          const r = execCommandWithDiagnostics(e.cmd, deviceId)
+          diagnostics.bundle[e.name] = r && r.runResult ? { stdout: r.runResult.stdout, stderr: r.runResult.stderr, code: r.runResult.exitCode } : { error: 'no-result' }
+        } catch (err) { diagnostics.bundle[e.name] = { error: String(err) } }
+      }
+    }
+
+    // collect recent system logs and a screenshot
+    try { diagnostics.recentLogs = execCommandWithDiagnostics(['simctl','spawn',deviceId,'log','show','--style','syslog','--predicate',`eventMessage CONTAINS "installcoordinationd" OR eventMessage CONTAINS "runningboard"`, '--last', '5m'], deviceId) } catch (e) { diagnostics.recentLogsError = String(e) }
+    try {
+      const shot = await execCommandWithDiagnostics(['simctl','io', deviceId, 'screenshot', '--type', 'png', '/tmp/mcp_post_launch_screenshot.png'], deviceId)
+      diagnostics.screenshot = { created: true, path: '/tmp/mcp_post_launch_screenshot.png', result: shot && shot.runResult }
+    } catch (e) { diagnostics.screenshotError = String(e) }
+
+    return diagnostics
   }
 
   async terminateApp(bundleId: string, deviceId: string = "booted"): Promise<TerminateAppResponse> {

package/src/server.ts

@@ -413,10 +413,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     if (name === "start_app") {
       const { platform, appId, deviceId } = args as any
       const res = await (platform === 'android' ? new AndroidManage().startApp(appId, deviceId) : new iOSManage().startApp(appId, deviceId))
+      // Preserve diagnostics and instrumentation from platform managers so agents receive full context
       const response: StartAppResponse = {
         device: res.device,
         appStarted: res.appStarted,
-        launchTimeMs: res.launchTimeMs
+        launchTimeMs: res.launchTimeMs,
+        error: (res as any).error,
+        diagnostics: (res as any).diagnostics,
+        instrumentation: (res as any).instrumentation
       }
       return wrapResponse(response)
     }