oomi-ai 0.2.7 → 0.2.12

package/README.md

@@ -59,6 +59,26 @@ If you need a fresh auth link later (without re-pairing), run:
 oomi openclaw invite --app-url https://your-oomi-app.vercel.app
 ```
 
+Bridge lifecycle handler (singleton, one bridge per host/device):
+```
+oomi openclaw bridge ensure --detach   # start if needed; no-op if already running
+oomi openclaw bridge ps                # list bridge pids
+oomi openclaw bridge stop              # stop all bridge workers
+oomi openclaw bridge restart --detach  # clean restart as background worker
+tail -f ~/.openclaw/logs/oomi-bridge-live.log  # detached bridge logs
+```
+`oomi openclaw bridge --detach` is equivalent to `oomi openclaw bridge start --detach`.
+
+macOS launchd supervision (recommended for durability):
+```
+oomi openclaw bridge service install      # install + start service
+oomi openclaw bridge service status
+oomi openclaw bridge service restart
+oomi openclaw bridge service stop
+oomi openclaw bridge service uninstall
+```
+Optional: `oomi openclaw bridge service install --no-start` to install without starting.
+
 Agent-intent mapping (recommended):
 - If user says `Connect yourself to Oomi. Use app URL https://www.oomi.ai.`
 - Run:
@@ -112,6 +132,12 @@ Restart OpenClaw after running `oomi init` or `oomi openclaw install`.
   - `OOMI_UPDATE_CHECK_TIMEOUT_MS=<ms>` changes network timeout
   - `OOMI_BRIDGE_GATEWAY_CONNECT_TIMEOUT_MS=<ms>` changes local gateway socket connect timeout
   - `OOMI_BRIDGE_CONNECT_CHALLENGE_TIMEOUT_MS=<ms>` changes wait timeout for gateway `connect.challenge` nonce
+  - `OOMI_BRIDGE_GATEWAY_REQUEST_TIMEOUT_MS=<ms>` changes timeout for forwarded gateway `connect`/`chat.send` request responses
+
+Bridge alert helper (reads `~/.openclaw/oomi-bridge-status.json` counters):
+```
+node <repo-root>/scripts/openclaw/bridge-alert-check.mjs
+```
 
 ## Package Audit + Publish (pnpm)
 ```

package/agent_instructions.md

@@ -26,10 +26,14 @@ If the user asks to connect OpenClaw to Oomi voice/web:
 5. Configure channel account (`channels.oomi.accounts.default`) from:
    - `oomi openclaw plugin --show-secrets --backend-url https://api.oomi.ai`
 6. Restart OpenClaw.
-7. If user provides an app URL (for example "Connect yourself to Oomi. Use app URL <URL>."):
+7. Ensure exactly one bridge worker is running (singleton handler):
+   - `oomi openclaw bridge ensure --detach`
+   - If stale/disconnected: `oomi openclaw bridge restart --detach`
+   - On macOS, prefer supervised mode: `oomi openclaw bridge service install`
+8. If user provides an app URL (for example "Connect yourself to Oomi. Use app URL <URL>."):
    - Use that URL directly in the pair command.
    - Example: `oomi openclaw pair --app-url <URL> --no-start`
-8. Return this exact result format to the user:
+9. Return this exact result format to the user:
    - `Oomi Connect Ready`
    - `Auth Link: ...`
    - No extra narrative text before or after those lines.