mobridge-mcp 0.2.0 → 0.4.0

package/dist/protocol/platform-capabilities.json

@@ -24,6 +24,10 @@
       "mobile.device.connect": {
         "level": "FULL"
       },
+      "mobile.device.list": {
+        "level": "FULL",
+        "note": "Host-side enumeration, platform-neutral. It was omitted here while staying registered and callable, so an iOS session's supportedTools hid a tool that worked — a contract lie in the direction nobody checks for."
+      },
       "mobile.app.open": {
         "level": "FULL",
         "allowedOperations": [
@@ -57,13 +61,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 +120,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 +188,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 +256,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": {
@@ -50,7 +51,17 @@
         "action": { "$ref": "#/$defs/actionVerb" },
         "target": {
           "$ref": "msm:node-ref.schema.json",
-          "description": "Required for node actions."
+          "description": "The NodeRef to act on, copied verbatim from a find/inspect result. Mutually exclusive with `find`."
+        },
+        "find": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["query"],
+          "description": "Locate the target and act in one call, instead of passing `target`. The query is resolved immediately before the action and re-resolved ONCE if the screen moved underneath, which closes the race the separate find-then-act pair leaves open. Matching several nodes is AMBIGUOUS_MATCH with candidates — it never picks one.",
+          "properties": {
+            "query": { "type": "object", "description": "SemanticQuery, same shape as mobile.screen.find." },
+            "actionable": { "type": "boolean", "default": true, "description": "Resolve to the nearest ACTIONABLE ancestor when the matched node cannot be acted on. Never climbs past an ancestor covering more than one match." }
+          }
         },
         "value": {
           "type": ["string", "null"],
@@ -87,6 +98,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": [
@@ -123,13 +139,34 @@
         },
         "target": {
           "type": "object",
-          "description": "Human-readable identity of the acted node.",
+          "description": "Human-readable identity of the acted node. For app.open, `label` is the package OBSERVED in front afterwards and `requested` is what the call asked for — they differ whenever the launch did not land where it was aimed.",
           "properties": {
             "role": { "$ref": "msm:common.schema.json#/$defs/role" },
-            "label": { "type": ["string", "null"] }
+            "label": { "type": ["string", "null"] },
+            "requested": { "type": ["string", "null"], "description": "app.open only: the package or deep link the caller asked for." }
           }
         },
-        "mutationClass": {
+        "app": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "The foreground app OBSERVED after the action. Present on app.open and system.action so a caller learns where it actually ended up without a second round trip.",
+          "properties": {
+            "platform": { "type": ["string", "null"] },
+            "appId": { "type": ["string", "null"], "description": "Package name on Android, bundle id on iOS." },
+            "title": { "type": ["string", "null"] },
+            "generation": { "type": ["integer", "null"] }
+          }
+        },
+        "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/scenario.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "msm:scenario.schema.json",
+  "title": "ScenarioRecord",
+  "description": "A saved, replayable test workflow. Stores the QUERY that located each target, never the NodeRef it produced: refs are generation-scoped, so every replay re-resolves from scratch.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "scenarioVersion", "id", "intent", "platform", "status", "steps", "warnings", "recordedAt"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1, "description": "File format. Independent of scenarioVersion." },
+    "scenarioVersion": { "type": "integer", "minimum": 1, "description": "The definition's revision. Owned by the store: 1 on create, previous+1 on update." },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,63}$", "description": "Names the user-visible goal (settings-network), never the steps (tap-button-1)." },
+    "intent": { "type": "string", "minLength": 1, "description": "One sentence. This is how a later agent recognises the scenario as a match for a task." },
+    "platform": { "enum": ["android", "ios"], "description": "Execution constraint: a mismatch is rejected before the device is touched." },
+    "status": {
+      "enum": ["RECORDED", "VERIFIED"],
+      "description": "RECORDED on save. VERIFIED only when explicitly saved after a successful run — a run never rewrites the artifact."
+    },
+    "arrange": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Precondition, deliberately limited to bringing one app to the front.",
+      "properties": { "packageName": { "type": "string" } }
+    },
+    "steps": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/step" } },
+    "warnings": { "type": "array", "items": { "type": "string" }, "description": "Why a step is not replayable as recorded: unverified action, unresolved target, redacted input." },
+    "recordedAt": { "type": "string" },
+    "recordedOn": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": { "deviceId": { "type": "string" }, "osVersion": { "type": "string" } }
+    }
+  },
+  "$defs": {
+    "step": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "action"],
+      "description": "The workflow step shape, plus inputRequired. One vocabulary, so replay is a delegation rather than a second executor.",
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "find": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["query"],
+          "properties": {
+            "query": { "type": "object", "description": "Re-resolved on every run. A target that moved is still found; a target that no longer exists fails rather than falling back to coordinates." },
+            "actionable": { "type": "boolean", "default": true }
+          }
+        },
+        "action": { "type": "string" },
+        "value": { "type": ["string", "null"] },
+        "inputRequired": {
+          "type": "boolean",
+          "description": "The value was redacted. RUN yields INPUT_REQUIRED and the caller supplies it for that run only; it is never written back."
+        },
+        "verify": { "type": "object", "description": "Recorded only when a verification actually occurred. Never inferred from the verb." },
+        "unresolved": { "type": "boolean", "description": "No query could be rebuilt for this step; kept for the reader, refused by RUN." },
+        "onError": { "enum": ["ABORT", "RETRY", "CONTINUE"], "default": "ABORT" },
+        "maxRetries": { "type": "integer", "minimum": 0, "default": 1 },
+        "pause": { "type": "boolean", "default": false }
+      }
+    }
+  }
+}

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

@@ -59,7 +59,12 @@
           "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" }
+          "expectPackage": {
+            "$ref": "msm:common.schema.json#/$defs/packageName",
+            "description": "The app you expect to be in front afterwards. Needed to VERIFY a deep link: without a packageName or this, the runtime has nothing to check the outcome against and returns CONDITION_UNKNOWN rather than guessing that any foreground change meant success."
+          },
+          "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": "fa820e4-20260811154759",
+  "bundleSha256": "eee1c1832e3b057e5ec10683658c87759866d7a85e1c24ba4982b39808894bdd"
 }

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 = "fa820e4-20260811154759"; // 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.4.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,