openclaw-navigator 5.3.3 → 5.3.4

package/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * openclaw-navigator v5.3.3
+ * openclaw-navigator v5.3.4
  *
  * One-command bridge + tunnel for the Navigator browser.
  * Starts a local bridge, creates a Cloudflare tunnel automatically,
@@ -1915,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.3",
+  "version": "5.3.4",
   "description": "One-command bridge + tunnel for the Navigator browser — works on any machine, any OS",
   "keywords": [
     "browser",