troubleshoot-hermes-mobile-connectivitylisted

# Troubleshoot Hermes Mobile connectivity ## Symptom → likely cause (check in order) | Symptom | Likely cause | Not the cause | |---------|--------------|---------------| | Banner: "can't reach Hermes/computer" + gateway is `10.x` or `192.168.x` | Phone off same Wi‑Fi (5G/cellular, different network) | Random app bug | | Pairing: `Gateway health missing localIp` | Gateway `/health` no longer returns `local_ip` | Phone USB broken | | Header shows computer IP but send fails | LAN-only URL unreachable from phone network | `session_in_use` (different message) | | Works on Mac mini IP, fails after reinstall | Fresh install + pair pushed **this Mac's** LAN IP, not saved profile | Stale APK | ## Evidence commands (run all; paste outputs) ```bash node tools/agent-session-start.js adb devices curl -sf -m 3 http://127.0.0.1:8642/health curl -sf -m 3 http://<gateway-host-from-screenshot>:8642/health # from Mac node tools/hermes-mobile-pair.js # only after gateway up ``` On Mac, also: ```bash xcrun simctl list runtimes # empty = no iOS sim for E2E fallback ipconfig getifaddr en0 2>/dev/null # compare to paired URL ``` ## Decision tree ``` Phone gateway URL private LAN (10.x / 192.168.x / *.local)? ├─ YES → Phone on same Wi‑Fi as that host? │ ├─ NO → REAL connectivity failure. Fix: same Wi‑Fi, Switch computer, or tunnel URL (Settings → Advanced). │ └─ YES → curl /health from Mac; if OK, check API key / chat errors (operational, not connectivity). └─ NO (https tu