@shipvo/mcp 0.0.8 → 0.0.10

package/dist/wait.d.ts

@@ -10,6 +10,5 @@ export type Waited = {
     ms: number;
 };
 export declare function present(tree: string, w: WaitFor): boolean;
-export declare const wantsMatch: (w: WaitFor) => boolean;
 export declare const satisfied: (tree: string, w: WaitFor) => boolean;
 export declare const sameTree: (a: string, b: string) => boolean;

package/dist/wait.js

@@ -11,7 +11,6 @@ export function present(tree, w) {
         return ls.some((l) => { const p = parse(l); return !!p && p.role === w.role && p.text.includes(w.name); });
     return false;
 }
-export const wantsMatch = (w) => !!(w.ref || w.text || (w.role && w.name));
 export const satisfied = (tree, w) => present(tree, w) !== !!w.gone;
 // Two reads are equal when they differ only in ref numbers.
 export const sameTree = (a, b) => a.replace(/\s*\[ref=\w+\]/g, "") === b.replace(/\s*\[ref=\w+\]/g, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipvo/mcp",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "license": "Apache-2.0",
   "description": "MCP server that lets AI agents open, see and operate Shipvo apps without a phone: a phone-sized simulator of the real app, plus the app's typed commands and owner API.",
@@ -15,7 +15,10 @@
   "devDependencies": {
     "typescript": "^5.6.3",
     "@types/node": "^22.8.0",
-    "vitest": "^2.1.4"
+    "vitest": "^2.1.4",
+    "playwright": "1.63.0",
+    "esbuild": "^0.21.5",
+    "@shipvo/mcp-tools": "0.0.1"
   },
   "keywords": [
     "mcp",
@@ -34,6 +37,7 @@
     "directory": "packages/mcp"
   },
   "files": [
+    "skills",
     "dist",
     "README.md"
   ],
@@ -45,8 +49,16 @@
     "node": ">=20"
   },
   "mcpName": "io.github.shipvo/shipvo",
+  "peerDependencies": {
+    "playwright": ">=1.50"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/inline-tools.mjs",
     "test": "vitest run"
   }
 }

package/skills/shipvo-mcp/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: shipvo-mcp
+description: Drive a React Native app through the @shipvo/mcp server. Use when the project depends on @shipvo/mcp and you need to open the app, read the screen, tap, type, scroll or take a screenshot.
+---
+
+# @shipvo/mcp
+
+An MCP server that gives you a headless phone. Start the simulator first: `shipvo sim` (http://localhost:4545).
+
+Add the server to your MCP config:
+
+```json
+{ "mcpServers": { "shipvo": { "command": "npx", "args": ["-y", "@shipvo/mcp"] } } }
+```
+
+## Drive the app
+
+1. `open_app("<app id>")` returns a session and the first screen.
+2. `screen(session)` returns the accessibility tree. Each element has a ref, for example `[ref=e12]`.
+3. `tap(session, ref)`, `type(session, ref, text)`, `scroll(session, direction, ref?)`, `back(session)`.
+4. `screenshot(session)` returns a PNG.
+5. `end_session(session)` when done.
+
+Each action result starts with `Change: none | content changed | new screen | scrolled`, then the screen. Refs are renumbered between screens: read the screen again before you tap.
+
+Wait for an effect instead of sleeping: pass `wait_for: { text: "Cart" }` or `settle: true` to `tap`, `type`, `scroll` or `back`. The result gets `Waited: matched | timed out after <ms> ms`.
+
+## When a call fails
+
+A failed call has `isError: true` and `structuredContent: { ok: false, code, error }`. Read `code`, then `error`. On `sim_timeout` call `screen`: the action may have run.
+
+Use `set_device` for location, permissions, biometrics, payment and network. The full tool list is in the package README.