mobridge-mcp 0.10.3 → 0.10.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -59,7 +59,7 @@
59
59
  "required": ["query"],
60
60
  "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.",
61
61
  "properties": {
62
- "query": { "type": "object", "description": "SemanticQuery, same shape as mobile.screen.find." },
62
+ "query": { "type": "object", "additionalProperties": false, "minProperties": 1, "description": "SemanticQuery, same fields as mobile.screen.find (text/label may be a plain string). Unknown fields such as `index` or a node `id` are refused instead of silently matching every node.", "properties": { "role": { "type": "string" }, "text": {}, "label": {}, "resourceId": { "type": "string" }, "state": { "type": "object" }, "within": { "type": "object" }, "firstVisible": { "type": "boolean" }, "nth": { "type": "integer", "minimum": 0 } } },
63
63
  "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." },
64
64
  "waitMs": { "type": "integer", "minimum": 0, "maximum": 10000, "description": "How long to wait for a query that matches nothing YET before NODE_NOT_FOUND. Default 1500 (4000 behind a SystemUI overlay). 0 fails at once, for a target that is either there or not." }
65
65
  }
package/integrity.json CHANGED
@@ -1,4 +1,4 @@
1
1
  {
2
- "buildId": "ae04e85-20261104131248",
3
- "bundleSha256": "ef0bd0a881391e9b586923feab712d2857c34b4e6df2a136b15fc9ca699098db"
2
+ "buildId": "be44bc9-20261105164321",
3
+ "bundleSha256": "3afc7a177964510da34941c127a8fb1371e594b1302d96228315976732b88732"
4
4
  }
package/loader.cjs CHANGED
@@ -14,7 +14,7 @@ const os = require("node:os");
14
14
  const path = require("node:path");
15
15
  const crypto = require("node:crypto");
16
16
 
17
- const BUILD_ID = "ae04e85-20261104131248"; // pack-npx stamps the real build id
17
+ const BUILD_ID = "be44bc9-20261105164321"; // pack-npx stamps the real build id
18
18
  const ROOT = __dirname; // package root (loader.cjs sits here)
19
19
  const DIST = path.join(ROOT, "dist");
20
20
  const BUNDLE = path.join(DIST, "main.obf.cjs");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mobridge-mcp",
3
- "version": "0.10.3",
3
+ "version": "0.10.4",
4
4
  "description": "MoBridge MCP — a stdio MCP server exposing on-device Android 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.",
5
5
  "keywords": [
6
6
  "mcp",
@@ -9,11 +9,11 @@
9
9
  },
10
10
  "mobridge-core": {
11
11
  "version": "1.0.1",
12
- "digest": "9a2823d9aa9e6eaf"
12
+ "digest": "fec1c7331dabe6db"
13
13
  },
14
14
  "mobridge-debugging": {
15
15
  "version": "1.0.2",
16
- "digest": "8f754a895e91ac5a"
16
+ "digest": "e277e59f39d9f71f"
17
17
  },
18
18
  "mobridge-devices": {
19
19
  "version": "1.0.1",
@@ -102,6 +102,9 @@ More fields and the query grammar: `references/queries.md`, `references/response
102
102
  | Fewer tokens, faster runs, parallel reads, burst capture | `mobridge-efficiency` |
103
103
  | Compose, WebView, native, games, test matrix | `mobridge-surfaces` |
104
104
 
105
+ - `mobridge analyze` classifies the current screen (login, list, dialog...) without a capture. `mobridge guide --short` prints the tool guide. `mobridge disconnect` ends the session and clears the device binding.
106
+ - `mobridge fallback prepare|commit|cancel` gives a single-use ADB token for an action the accessibility executor cannot do (state NEEDS_VISION or rejected); prepare binds it to the target, commit within 30 s, never after an unknown prior result.
107
+
105
108
  ## Verification
106
109
 
107
110
  - Success is a `VERIFIED` verdict on the action, or a fresh `observe` that shows the expected node. Never report success from `DISPATCHED`.
@@ -51,7 +51,8 @@ command you may run, a `Guidance:` line is something only the person can do. `do
51
51
  1. `RESULT_UNKNOWN`: the action may or may not have happened (the link dropped after dispatch). Do not resend.
52
52
  `mobridge operation status <operationId>`, then `mobridge screen observe`, then decide.
53
53
  2. `AMBIGUOUS_MATCH`: several nodes fit. Narrow with `--role`, `--nth`, `--within`, or `--resource-id`. Do not use the
54
- first candidate.
54
+ first candidate. `candidates` holds at most 5; `candidatesTruncated: true` means more exist, so narrow further.
55
+ 2b. `SCROLL_LOOP`: `find --scroll` ended while the list still scrolls. Raise `--max-scrolls` or narrow the query.
55
56
  3. `NODE_NOT_FOUND`: wrong text, wrong match mode or the node is off screen. Default match is `NORMALIZED_EXACT`;
56
57
  a longer on-screen string needs `CONTAINS`. Scroll with `mobridge find --text ... --scroll`. For a control with no
57
58
  text try `--label`. If the screen has no accessibility tree you get `VISION_REQUIRED`, not `NODE_NOT_FOUND`.