@mindexec/cli 0.2.2 → 0.2.4

package/README.md

@@ -45,6 +45,56 @@ precompressed static files from the npm bundle by default. Use
 `-KeepPackagedGalleryImages` or `-KeepPackagedPrecompressedAssets` only when
 testing a full untrimmed local package.
 
+## Remote Direct quick start
+
+LocalBridge also starts a separate RemoteHub listener for direct remote-agent
+experiments. By default it binds to loopback only:
+
+```bash
+npx @mindexec/cli
+npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <pair-token>
+```
+
+Read the pair token from the protected local endpoint:
+
+```bash
+curl -H "X-Bridge-Token: <bridge-token>" http://127.0.0.1:5147/api/remote/status
+```
+
+LAN/direct mode must be enabled explicitly by changing the RemoteHub bind host:
+
+```powershell
+$env:REMOTE_HUB_HOST="0.0.0.0"
+$env:REMOTE_HUB_PORT="5197"
+$env:REMOTE_HUB_PAIR_TOKEN="<strong-token>"
+npx @mindexec/cli
+```
+
+Device inventory is intentionally not paginated:
+
+```bash
+curl -H "X-Bridge-Token: <bridge-token>" http://127.0.0.1:5147/api/remote/devices
+```
+
+Request and read the latest view-only thumbnail for a connected device:
+
+```bash
+curl -X POST -H "X-Bridge-Token: <bridge-token>" http://127.0.0.1:5147/api/remote/devices/<device-id>/thumbnail/request
+curl -H "X-Bridge-Token: <bridge-token>" http://127.0.0.1:5147/api/remote/devices/<device-id>/thumbnail
+```
+
+Queue a safe task-only instruction for one device or all connected devices:
+
+```bash
+curl -X POST -H "X-Bridge-Token: <bridge-token>" -H "Content-Type: application/json" \
+  -d "{\"instruction\":\"Check the desktop and report status.\"}" \
+  http://127.0.0.1:5147/api/remote/devices/<device-id>/tasks
+
+curl -X POST -H "X-Bridge-Token: <bridge-token>" -H "Content-Type: application/json" \
+  -d "{\"instruction\":\"Prepare a short status report.\",\"allConnected\":true}" \
+  http://127.0.0.1:5147/api/remote/tasks
+```
+
 ?먮뒗 ?꾩뿭 ?ㅼ튂 ???ㅽ뻾?⑸땲??
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
@@ -8,8 +8,9 @@
     "start-bridge.bat",
     "start-bridge.sh",
     "launch-bridge.cjs",
-    "server.js",
-    "codex-runtime.js",
+    "server.js",
+    "remote-hub.js",
+    "codex-runtime.js",
     "port-guard.cjs",
     "wwwroot/",
     "scripts/",
@@ -19,7 +20,8 @@
   "scripts": {
     "start": "node launch-bridge.cjs",
     "dev": "node launch-bridge.cjs --watch",
-    "test:syntax": "node --check server.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs",
+    "test:syntax": "node --check server.js && node --check remote-hub.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs && node --check scripts/remote-hub-smoke.mjs",
+    "test:remote": "node scripts/remote-hub-smoke.mjs",
     "pack:dry": "npm pack --dry-run",
     "setup:grammars": "node scripts/setup-tree-sitter-grammars.mjs",
     "postinstall": "npm run setup:grammars"