mobridge-mcp 0.3.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": [

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

@@ -51,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"],
@@ -129,10 +139,22 @@
         },
         "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." }
+          }
+        },
+        "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": {

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,6 +59,10 @@
           "packageName": { "$ref": "msm:common.schema.json#/$defs/packageName" },
           "bundleId": { "$ref": "msm:common.schema.json#/$defs/bundleId" },
           "deepLink": { "type": "string" },
+          "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." }
         }

package/integrity.json

@@ -1,4 +1,4 @@
 {
-  "buildId": "56de3b6-20260806163529",
-  "bundleSha256": "1a31c3e41873903c2e56233e86fcb5c216c666950bd64f62b7cd603fcb9f85f0"
+  "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 = "56de3b6-20260806163529"; // 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.3.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",