mobridge-mcp 0.1.0 → 0.2.0

package/dist/protocol/platform-capabilities.json

@@ -66,19 +66,26 @@
         "note": "APP ok; CLIPBOARD limited; no general notification listener."
       },
       "mobile.batch": {
-        "level": "FULL"
+        "level": "NONE",
+        "reasonCode": "NOT_IMPLEMENTED_ON_IOS",
+        "note": "The Runner serves no batch method and nothing composes it host-side. Advertised FULL until the I10 parity gate proved otherwise."
       },
       "mobile.gesture.perform": {
         "level": "FULL"
       },
       "mobile.screen.scrollTo": {
-        "level": "FULL"
+        "level": "PARTIAL",
+        "reasonCode": "BOUNDED_SWIPE_SEARCH",
+        "note": "Host-side bounded swipe search; the query is the only stop condition. No native scroll-to-element on iOS."
       },
       "mobile.screen.capture": {
-        "level": "FULL"
+        "level": "NONE",
+        "reasonCode": "NOT_IMPLEMENTED_ON_IOS",
+        "note": "The Runner serves no screenshot method yet."
       },
       "mobile.input.text": {
-        "level": "FULL"
+        "level": "FULL",
+        "note": "Host-side: routed to the Runner's screen.act SET_TEXT (same re-resolution and evidence)."
       },
       "mobile.workflow.run": {
         "level": "FULL"
@@ -108,16 +115,22 @@
       },
       "mobile.app.control": {
         "level": "FULL"
+      },
+      "mobile.screen.target": {
+        "level": "FULL",
+        "note": "Resolved host-side in TS (the Runner has no screen.target): ancestor-chain collapse when actionable:true."
       }
     },
     "physical": {
       "mobile.device.state": {
         "level": "PARTIAL",
-        "reasonCode": "ORIENTATION_AND_APPSTATE_ONLY"
+        "reasonCode": "ORIENTATION_AND_APPSTATE_ONLY",
+        "note": "Host-side from the snapshot; battery/network/locale/storage are not available to a UI-test process."
       },
       "mobile.app.list": {
         "level": "PARTIAL",
-        "reasonCode": "DEVICECTL_OR_MDM"
+        "reasonCode": "DEVICECTL_OR_MDM",
+        "note": "Host-side via devicectl/simctl; bundle ids only."
       },
       "mobile.app.forceStop": {
         "level": "NONE",
@@ -164,9 +177,10 @@
       },
       "mobile.screen.inspect": {
         "level": "PARTIAL",
-        "reasonCode": "DELTA_ONLY_ON_IOS",
+        "reasonCode": "DELTA_AND_TARGET_ONLY_ON_IOS",
         "allowedOperations": [
-          "DELTA"
+          "DELTA",
+          "TARGET"
         ]
       }
     },
@@ -237,4 +251,4 @@
       }
     }
   }
-}
+}

package/dist/protocol/schemas/tools.schema.json

@@ -34,6 +34,8 @@
               "sessionId": { "type": "string" },
               "capabilities": { "type": "array", "items": { "type": "string" } },
               "expiresInMinutes": { "type": "integer" },
+              "simulated": { "type": "boolean", "description": "TRUE when this session is the built-in fixture backend, not a real device. Nothing done in a simulated session reaches hardware." },
+              "warning": { "type": "string", "description": "Human-readable caveat about the session, e.g. that it is simulated and how to reach a real device." },
               "platform": { "enum": ["ANDROID", "IOS"], "description": "Session platform. Optional for back-compat." },
               "mode": { "type": ["string", "null"], "description": "iOS driver mode (PHYSICAL|SIMULATOR); null on Android." },
               "supportedTools": { "type": "array", "items": { "type": "string" }, "description": "Tool names actually advertised this session (platform ∩ profile). Informational; gating is at registration." },

package/integrity.json

@@ -1,4 +1,4 @@
 {
-  "buildId": "38d941d-20260804170901",
-  "bundleSha256": "0bbc92d88bbe706644d0099c0cdc46bc2b1934674826e07a865f85c3332a8baa"
+  "buildId": "024caf7-20260805172927",
+  "bundleSha256": "8ce65e79be14dc229d97b3657b648e21488e5c702d7a2381e987c63cb75965dd"
 }

package/loader.cjs

@@ -14,7 +14,7 @@ const os = require("node:os");
 const path = require("node:path");
 const crypto = require("node:crypto");
 
-const BUILD_ID = "38d941d-20260804170901"; // pack-npx stamps the real build id
+const BUILD_ID = "024caf7-20260805172927"; // pack-npx stamps the real build id
 const ROOT = __dirname; // package root (loader.cjs sits here)
 const DIST = path.join(ROOT, "dist");
 const BUNDLE = path.join(DIST, "main.obf.cjs");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobridge-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MoBridge MCP — a stdio MCP server exposing on-device Android/iOS UIs as fast semantic read / observe / find / act / verify tools plus screenshots. Ships an installer that wires it into Claude Code, Claude Desktop, Cursor and Codex.",
   "keywords": [
     "mcp",

package/resources/ios/MobileSemantic/UITests/BridgeServer.swift

@@ -63,6 +63,12 @@ final class BridgeServer: XCTestCase {
 
     // MARK: dispatch
 
+    /// Every method this Runner serves. Keep in lockstep with the switch in the dispatcher below.
+    static let servedMethods = [
+        "HELLO", "PING", "SHUTDOWN", "bridge.methods",
+        "device.connect", "app.open", "app.terminate", "screen.get", "screen.act", "gesture.perform", "system.action",
+    ]
+
     private func handle(_ req: [String: Any]) -> ([String: Any], Bool) {
         let requestId = req["requestId"] as? Int ?? 0
         let method = req["method"] as? String ?? ""
@@ -82,12 +88,30 @@ final class BridgeServer: XCTestCase {
             return ok(["protocolVersion": 1, "runnerInstanceId": runnerInstanceId, "sessionToken": sessionToken, "maxPayloadBytes": 16 * 1024 * 1024, "runnerState": "READY"])
         case "PING":
             return ok(["pong": true])
+        case "bridge.methods":
+            // The Runner's OWN list of served methods — the single source of truth the capability
+            // manifest is checked against (I10). Hand-maintaining the manifest is what let it claim
+            // FULL for methods that were never implemented; this list cannot drift from the switch
+            // below without someone editing it, and the parity gate fails loudly when it does.
+            return ok(["methods": Self.servedMethods])
         case "SHUTDOWN":
             return ([ "requestId": requestId, "result": ["bye": true] ], true)
         case "device.connect":
             return ok(["deviceId": params["deviceId"] as? String ?? "ios-sim", "sessionId": runnerInstanceId, "capabilities": ["screen.get", "screen.find", "screen.act", "screen.wait", "screen.diff"]])
         case "app.open":
             return appOpen(params, ok: ok, err: err)
+        case "app.terminate":
+            // The real terminate for a PHYSICAL device. The host path shelled out to `xcrun simctl
+            // terminate`, which is Simulator-only — it could never have worked on hardware. XCUITest
+            // owns the app process here, so this is both correct and the only thing available.
+            let bid = params["bundleId"] as? String ?? ""
+            guard !bid.isEmpty else {
+                return err("ACTION_REJECTED", "app.terminate needs a bundleId.", ["Pass the target app's bundle identifier."])
+            }
+            let target = XCUIApplication(bundleIdentifier: bid)
+            let wasRunning = target.state != .notRunning
+            target.terminate()
+            return ok(["terminated": true, "bundleId": bid, "wasRunning": wasRunning])
         case "screen.get":
             return ok(snapshot())
         case "screen.act":
@@ -200,11 +224,19 @@ final class BridgeServer: XCTestCase {
     private func screenAct(_ p: [String: Any], ok: ([String: Any]) -> ([String: Any], Bool), err: (String, String, [String]) -> ([String: Any], Bool)) -> ([String: Any], Bool) {
         let before = snapshot()
         let verb = p["verb"] as? String ?? "CLICK"
+        // Narrow the live re-query to the element TYPE TS resolved, not just its label: a table row and
+        // the static text inside it share a label, so a label-only query counted 2 and this defence
+        // refused every list tap. `nativeType` is this Runner's own "XCUIElementType<raw>" string coming
+        // back, so no role mapping is invented here; absent or unparsable, the scope stays .any and the
+        // behaviour is exactly what it was.
+        let scope: XCUIElement.ElementType = (p["nativeType"] as? String)
+            .flatMap { UInt(  $0.replacingOccurrences(of: "XCUIElementType", with: "")) }
+            .flatMap { XCUIElement.ElementType(rawValue: $0) } ?? .any
         let query: XCUIElementQuery
         if let aid = p["automationId"] as? String, !aid.isEmpty {
-            query = app.descendants(matching: .any).matching(identifier: aid)
+            query = app.descendants(matching: scope).matching(identifier: aid)
         } else if let label = p["label"] as? String, !label.isEmpty {
-            query = app.descendants(matching: .any).matching(NSPredicate(format: "label == %@", label))
+            query = app.descendants(matching: scope).matching(NSPredicate(format: "label == %@", label))
         } else {
             return err("NODE_NOT_FOUND", "screen.act needs automationId or label.", ["Resolve a NodeRef first."])
         }