openclaw-navigator 5.3.2 → 5.3.4

package/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * openclaw-navigator v5.3.2
+ * openclaw-navigator v5.3.4
  *
  * One-command bridge + tunnel for the Navigator browser.
  * Starts a local bridge, creates a Cloudflare tunnel automatically,
@@ -394,7 +394,8 @@ function handleRequest(req, res) {
       },
       routing: {
         "/ui/*": `localhost:${ocUIPort}`,
-        "/api/*": `localhost:${ocGatewayPort}`,
+        "/api/sessions/*": `localhost:${ocGatewayPort}`,
+        "/api/* (other)": `localhost:${ocUIPort} (web UI fallback)`,
         "/ws": `localhost:${ocGatewayPort} (WebSocket proxy)`,
       },
       tunnel: activeTunnelURL
@@ -889,9 +890,11 @@ function handleRequest(req, res) {
     return;
   }
 
-  // ── Reverse proxy: /api/* → OC Gateway (localhost:ocGatewayPort) ─────
-  // Keeps /api/ prefix intact — all API calls including chat go to the gateway.
-  if (path.startsWith("/api/")) {
+  // ── Reverse proxy: /api/sessions/* → OC Gateway (localhost:ocGatewayPort) ──
+  // ONLY proxy known OC gateway paths — /api/sessions/* (chat/agent endpoints).
+  // Other /api/* paths (e.g. /api/auth/* from NextAuth) fall through to the
+  // web UI fallback so login and other web UI API routes work correctly.
+  if (path.startsWith("/api/sessions/") || path === "/api/sessions") {
     const targetURL = `${path}${url.search}`;
 
     const proxyOpts = {
@@ -1147,8 +1150,9 @@ ${BOLD}Stability (recommended for production):${RESET}
   --tunnel-hostname <host>  Hostname for named tunnel (e.g. nav.yourdomain.com)
 
 ${BOLD}Routing (through Cloudflare tunnel):${RESET}
-  /ui/*                → localhost:<ui-port>      Web UI (proxied to OC gateway's UI server)
-  /api/*               → localhost:<gateway-port> OC gateway API (chat, sessions, etc.)
+  /ui/*                → localhost:<ui-port>      Web UI (Next.js on port 4000)
+  /api/sessions/*      → localhost:<gateway-port> OC gateway chat/agent API
+  /api/* (other)       → localhost:<ui-port>      Web UI API routes (auth, etc.)
   /ws, WebSocket       → localhost:<gateway-port> WebSocket proxy to OC gateway
   /health              → bridge itself            Health check
   /navigator/*         → bridge itself            Navigator control endpoints
@@ -1511,7 +1515,7 @@ module.exports = {
   const uiURL = tunnelURL ? `${tunnelURL}/ui/` : `http://localhost:${port}/ui/`;
   console.log(`  ${BOLD}OC Web UI:${RESET} ${CYAN}${uiURL}${RESET}`);
   info(`  /ui/*   → localhost:${ocUIPort} (web UI proxy)`);
-  info(`  /api/*  → localhost:${ocGatewayPort} (OC gateway)`);
+  info(`  /api/sessions/* → localhost:${ocGatewayPort} (OC gateway)`);
   info(`  /ws     → localhost:${ocGatewayPort} (WebSocket proxy)`);
 
   // ── Startup health checks ──────────────────────────────────────────
@@ -1911,6 +1915,122 @@ module.exports = {
       info("  You can manually configure mcporter for Navigator MCP");
     }
 
+    // ── Inject Navigator section into OC workspace TOOLS.md ──────────────
+    // OC Core reads ~/.openclaw/workspace/TOOLS.md on every agent run.
+    // This ensures the agent ALWAYS knows about Navigator browser integration.
+    try {
+      const toolsMdLocations = [
+        join(homedir(), ".openclaw/workspace"),
+        "/opt/homebrew/lib/node_modules/openclaw/workspace",
+      ];
+      let toolsDir = null;
+      for (const loc of toolsMdLocations) {
+        if (existsSync(loc)) {
+          toolsDir = loc;
+          break;
+        }
+      }
+      if (toolsDir) {
+        const toolsPath = join(toolsDir, "TOOLS.md");
+        const MARKER_START = "<!-- NAVIGATOR-BRIDGE-START -->";
+        const MARKER_END = "<!-- NAVIGATOR-BRIDGE-END -->";
+        const tunnelHint = activeTunnelURL || "https://<tunnel>.trycloudflare.com";
+        const navigatorSection = [
+          MARKER_START,
+          "",
+          "## Navigator Browser (Remote Control via mcporter)",
+          "",
+          "You can control a **remote** Navigator browser instance through MCP tools.",
+          "The Navigator bridge is connected and running — use `mcporter call navigator.<tool>` to interact.",
+          "",
+          "### Connection",
+          `- Bridge: http://localhost:${port}`,
+          `- Tunnel: ${tunnelHint}`,
+          `- Web UI: ${tunnelHint}/ui/`,
+          "- Protocol: mcporter → bridge HTTP → Navigator command queue → CEF browser",
+          "",
+          "### Key Tools (34 total, all prefixed with `navigator_`)",
+          "",
+          "**Browser Control:**",
+          "- `navigator_status` — Check if Navigator is connected",
+          "- `navigator_navigate url=<url>` — Go to a URL in the OpenClaw tab group",
+          "- `navigator_get_ui_url` — Get the OC Web UI URL (open it with navigator_navigate)",
+          "- `navigator_open_tab url=<url>` — Open a new tab",
+          "- `navigator_list_tabs` — List all open tabs",
+          "- `navigator_get_text` — Read visible page text",
+          "- `navigator_get_html` — Get full page HTML",
+          "- `navigator_click selector=<css>` — Click an element",
+          "- `navigator_fill selector=<css> value=<text>` — Fill an input",
+          "- `navigator_submit` — Submit a form",
+          "- `navigator_execute_js code=<js>` — Run JavaScript",
+          "- `navigator_wait_ready` — Wait for page to fully load",
+          "",
+          "**AI Intelligence:**",
+          "- `navigator_analyze_page` — Detect forms, buttons, inputs, links, tables",
+          "- `navigator_find_element intent=<text>` — Find element by description (e.g. 'login button')",
+          "- `navigator_extract_data selector=<css> type=text|table|json` — Extract data",
+          "- `navigator_smart_fill data='{...}'` — Fill forms by field name matching",
+          "",
+          "**Chat Pane:**",
+          "- `navigator_get_chat_messages` — Read chat messages from the Navigator sidebar",
+          "- `navigator_chat_respond message=<text>` — Send a message to the chat pane",
+          "- `navigator_chat_stream text=<partial>` — Stream text (typing effect)",
+          "",
+          "### Common Workflows",
+          "",
+          "**Open OC Dashboard:**",
+          "```bash",
+          "mcporter call navigator.navigator_get_ui_url",
+          "mcporter call navigator.navigator_navigate url=<uiURL>",
+          "```",
+          "",
+          "**Browse a website and read its content:**",
+          "```bash",
+          "mcporter call navigator.navigator_navigate url=https://example.com",
+          "mcporter call navigator.navigator_wait_ready",
+          "mcporter call navigator.navigator_get_text",
+          "```",
+          "",
+          "**Fill and submit a form:**",
+          "```bash",
+          "mcporter call navigator.navigator_analyze_page  # see what's on the page",
+          'mcporter call navigator.navigator_fill selector="#email" value="user@example.com"',
+          'mcporter call navigator.navigator_click selector="#submit"',
+          "```",
+          "",
+          "### Important Notes",
+          "- All browser actions happen in a dedicated **OpenClaw** tab group — they never interfere with the user's browsing",
+          "- Always call `navigator_wait_ready` after navigation before reading content",
+          "- Use `navigator_analyze_page` before clicking/filling — it shows you what's on the page",
+          "- The bridge polls Navigator every 5 seconds for command results",
+          "",
+          MARKER_END,
+        ].join("\n");
+
+        // Read existing TOOLS.md and replace or append Navigator section
+        let existing = "";
+        try {
+          existing = readFileSync(toolsPath, "utf8");
+        } catch {
+          /* file may not exist yet */
+        }
+        if (existing.includes(MARKER_START)) {
+          // Replace existing Navigator section
+          const before = existing.substring(0, existing.indexOf(MARKER_START));
+          const after = existing.substring(existing.indexOf(MARKER_END) + MARKER_END.length);
+          writeFileSync(toolsPath, before + navigatorSection + after, "utf8");
+        } else {
+          // Append Navigator section
+          writeFileSync(toolsPath, existing + "\n\n" + navigatorSection + "\n", "utf8");
+        }
+        ok("Updated TOOLS.md with Navigator integration docs");
+        info(`  Path: ${toolsPath}`);
+      }
+    } catch (err) {
+      // Non-fatal — TOOLS.md update is best-effort
+      warn(`TOOLS.md update failed: ${err.message}`);
+    }
+
     // ── Install launchd auto-start (macOS only) ──────────────────────────
     // Creates ~/Library/LaunchAgents/com.openclaw.navigator-bridge.plist
     // so the bridge + MCP server starts automatically on login.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-navigator",
-  "version": "5.3.2",
+  "version": "5.3.4",
   "description": "One-command bridge + tunnel for the Navigator browser — works on any machine, any OS",
   "keywords": [
     "browser",