mobridge-mcp 0.1.0 → 0.3.0

package/dist/protocol/platform-capabilities.json

@@ -57,28 +57,46 @@
         "note": "iOS has no global BACK/RECENTS/NOTIFICATION_SHADE; BACK is a semantic UI action (find nav button + act)."
       },
       "mobile.capability.invoke": {
-        "level": "PARTIAL",
-        "allowedOperations": [
-          "APP",
-          "CLIPBOARD"
-        ],
-        "reasonCode": "NO_NOTIFICATION_LISTENER",
-        "note": "APP ok; CLIPBOARD limited; no general notification listener."
+        "level": "NONE",
+        "reasonCode": "NO_BRIDGE_METHOD",
+        "note": "The Runner serves no capability.invoke and nothing composes it host-side; every call answered ACTION_UNSUPPORTED. Advertised PARTIAL[APP,CLIPBOARD] until a live tool sweep called it."
+      },
+      "mobile.screen.watch": {
+        "level": "NONE",
+        "reasonCode": "NO_EVENT_STREAM_ON_IOS",
+        "note": "watch blocks on the Android companion's accessibility event stream; XCUITest exposes no equivalent. Use screen.wait (polling) on iOS."
+      },
+      "mobile.screen.analyze": {
+        "level": "NONE",
+        "reasonCode": "DEPENDS_ON_SCREEN_OBSERVE",
+        "note": "analyze is host-side but reads screen.observe, which the Runner does not serve."
+      },
+      "mobile.screen.record": {
+        "level": "NONE",
+        "reasonCode": "ANDROID_ONLY",
+        "note": "Host-side adb screenrecord. iOS recording would be a Runner/simctl path that does not exist."
       },
       "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"
@@ -98,26 +116,28 @@
         "replacesAndroidTool": "mobile.diag.batterystats"
       },
       "runtime.setup": {
-        "level": "PARTIAL",
-        "reasonCode": "OPEN_AND_VERIFY_ARE_ADVISORY_ON_IOS",
-        "allowedOperations": [
-          "STATUS",
-          "OPEN",
-          "VERIFY"
-        ]
+        "level": "NONE",
+        "reasonCode": "ANDROID_COMPANION_ONLY",
+        "note": "setup.status/open/verify are the Android companion's own permission centre. The Runner serves none of them; iOS setup is device.connect's provisioning path."
       },
       "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 +184,11 @@
       },
       "mobile.screen.inspect": {
         "level": "PARTIAL",
-        "reasonCode": "DELTA_ONLY_ON_IOS",
+        "reasonCode": "NO_VISIBLE_OR_CHILDREN_ON_IOS",
         "allowedOperations": [
-          "DELTA"
+          "DELTA",
+          "TARGET",
+          "APP"
         ]
       }
     },
@@ -230,11 +252,13 @@
       },
       "mobile.screen.inspect": {
         "level": "PARTIAL",
-        "reasonCode": "DELTA_ONLY_ON_IOS",
+        "reasonCode": "NO_VISIBLE_OR_CHILDREN_ON_IOS",
         "allowedOperations": [
-          "DELTA"
+          "DELTA",
+          "TARGET",
+          "APP"
         ]
       }
     }
   }
-}
+}

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

@@ -39,7 +39,8 @@
       "description": "Whether the after-snapshot was captured on a settled screen."
     },
     "actionMethod": {
-      "enum": ["ACCESSIBILITY_ACTION", "ACCESSIBILITY_ACTION_ANCESTOR", "GESTURE_FALLBACK"]
+      "enum": ["ACCESSIBILITY_ACTION", "ACCESSIBILITY_ACTION_ANCESTOR", "GESTURE_FALLBACK", "GLOBAL_ACTION"],
+      "description": "GLOBAL_ACTION = a device-level navigation key (Android performGlobalAction, iOS XCUIDevice press) — no node is targeted."
     },
 
     "actionRequest": {
@@ -87,6 +88,11 @@
         "generation": {
           "type": ["integer", "null"],
           "description": "Capture generation the target ref was built against (from screen.find/target). When set, the runtime hard-checks it and returns STALE_NODE_REF if the screen advanced — it never re-resolves a stale ref to a similar node."
+        },
+        "diffDetail": {
+          "enum": ["SUMMARY", "FULL"],
+          "default": "SUMMARY",
+          "description": "How much of the semantic delta observation.diff carries. SUMMARY caps each bucket at 8 entries and adds counts + truncated; FULL returns every node delta. A screen transition diffs hundreds of nodes and the caller rarely needs them all — observation.diffRef re-fetches the exact pair via mobile.screen.diff."
         }
       },
       "allOf": [
@@ -129,7 +135,16 @@
             "label": { "type": ["string", "null"] }
           }
         },
-        "mutationClass": {
+        "appInstallCheck": {
+        "enum": ["INSTALLED", "NOT_INSTALLED", "UNKNOWN_TIMEOUT", null],
+        "description": "app.open only (iOS): whether the target bundle was confirmed installed before launching. UNKNOWN_TIMEOUT means the inventory did not answer in time — the launch was attempted without asserting installation."
+      },
+      "warnings": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Non-fatal notices about how this result was produced (e.g. an unverified install state). Never a substitute for an error."
+      },
+      "mutationClass": {
           "enum": ["READ_ONLY", "REVERSIBLE", "SIDE_EFFECT", "EXTERNAL_SIDE_EFFECT", "DESTRUCTIVE"],
           "description": "Advisory, payload-derived classification of how mutating this specific action was. Metadata for the host, not a gate."
         },

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

@@ -23,7 +23,7 @@
   "$defs": {
     "code": {
       "enum": [
-        "DEVICE_OFFLINE", "SESSION_EXPIRED", "PERMISSION_REQUIRED", "WINDOW_UNAVAILABLE",
+        "DEVICE_OFFLINE", "SESSION_EXPIRED", "PERMISSION_REQUIRED", "WINDOW_UNAVAILABLE", "DEVICE_LOCKED",
         "SECURE_WINDOW", "NODE_NOT_FOUND", "AMBIGUOUS_MATCH", "STALE_NODE_REF",
         "WEAK_REFERENCE_UNRESOLVABLE",
         "ACTION_UNSUPPORTED", "ACTION_REJECTED", "NO_EFFECT", "VERIFY_TIMEOUT",

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." },
@@ -57,7 +59,8 @@
           "packageName": { "$ref": "msm:common.schema.json#/$defs/packageName" },
           "bundleId": { "$ref": "msm:common.schema.json#/$defs/bundleId" },
           "deepLink": { "type": "string" },
-          "verify": { "$ref": "msm:wait.schema.json" }
+          "verify": { "$ref": "msm:wait.schema.json" },
+          "diffDetail": { "enum": ["SUMMARY", "FULL"], "default": "SUMMARY", "description": "How much of the semantic delta observation.diff carries. SUMMARY caps each bucket at 8 entries and adds counts + truncated; FULL returns every node delta. Use observation.diffRef with mobile.screen.diff when the full delta is wanted." }
         }
       },
       "output": {

package/integrity.json

@@ -1,4 +1,4 @@
 {
-  "buildId": "38d941d-20260804170901",
-  "bundleSha256": "0bbc92d88bbe706644d0099c0cdc46bc2b1934674826e07a865f85c3332a8baa"
+  "buildId": "56de3b6-20260806163529",
+  "bundleSha256": "1a31c3e41873903c2e56233e86fcb5c216c666950bd64f62b7cd603fcb9f85f0"
 }

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 = "56de3b6-20260806163529"; // 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.3.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":
@@ -170,7 +194,7 @@ final class BridgeServer: XCTestCase {
         if let snap = try? app.snapshot() {
             return Xcui.toScreenSnapshot(snap, bundleId: bundle, deviceId: "ios-sim")
         }
-        return ["schemaVersion": 1, "platform": "IOS", "nodes": [], "treeHash": "0", "packageName": bundle, "appId": bundle, "snapshotId": "s_empty", "deviceId": "ios-sim", "windowId": 0, "orientation": "portrait", "screenStateId": "ios:0", "compact": true, "timestamp": ISO8601DateFormatter().string(from: Date())]
+        return ["schemaVersion": 1, "platform": "IOS", "nodes": [], "treeHash": "0", "packageName": bundle, "appId": bundle, "snapshotId": "s_empty", "deviceId": "ios-sim", "windowId": 0, "orientation": "portrait", "screenStateId": "ios:0", "compact": true, "timestamp": Int(Date().timeIntervalSince1970 * 1000)]
     }
 
     private func appOpen(_ p: [String: Any], ok: ([String: Any]) -> ([String: Any], Bool), err: (String, String, [String]) -> ([String: Any], Bool)) -> ([String: Any], Bool) {
@@ -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."])
         }

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

@@ -79,7 +79,9 @@ enum Xcui {
         return [
             "schemaVersion": 1, "platform": "IOS", "deviceId": deviceId,
             "snapshotId": "s_\(UUID().uuidString.prefix(8))",
-            "timestamp": ISO8601DateFormatter().string(from: Date()),
+            // Epoch MILLISECONDS, per common.schema.json#/$defs/timestampMs. An ISO8601 string here
+            // made every iOS screen.get fail a strict client's output-schema check.
+            "timestamp": Int(Date().timeIntervalSince1970 * 1000),
             "packageName": bundleId, "appId": bundleId, "windowId": 0, "orientation": "portrait",
             "screenStateId": "ios:\(th.prefix(4))", "compact": true, "nodes": nodes, "treeHash": th,
             "truncated": truncated,