mobridge-mcp 0.2.0 → 0.3.0

package/dist/protocol/platform-capabilities.json

@@ -57,13 +57,24 @@
         "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": "NONE",
@@ -105,13 +116,9 @@
         "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"
@@ -177,10 +184,11 @@
       },
       "mobile.screen.inspect": {
         "level": "PARTIAL",
-        "reasonCode": "DELTA_AND_TARGET_ONLY_ON_IOS",
+        "reasonCode": "NO_VISIBLE_OR_CHILDREN_ON_IOS",
         "allowedOperations": [
           "DELTA",
-          "TARGET"
+          "TARGET",
+          "APP"
         ]
       }
     },
@@ -244,9 +252,11 @@
       },
       "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

@@ -59,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": "024caf7-20260805172927",
-  "bundleSha256": "8ce65e79be14dc229d97b3657b648e21488e5c702d7a2381e987c63cb75965dd"
+  "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 = "024caf7-20260805172927"; // 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.2.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

@@ -194,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) {

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,