openclaw-navigator 4.0.0 → 4.2.0

package/cli.mjs

@@ -344,6 +344,94 @@ function handleRequest(req, res) {
     return;
   }
 
+  // ── GET /navigator/capabilities ──
+  if (req.method === "GET" && path === "/navigator/capabilities") {
+    sendJSON(res, 200, {
+      ok: true,
+      version: "4.0.0",
+      commands: [
+        {
+          name: "navigate",
+          description: "Navigate to a URL in the OpenClaw group",
+          payload: { url: "required string", browserID: "optional string — target a specific tab" },
+        },
+        {
+          name: "tabs.list",
+          description: "List all tabs in the OpenClaw group",
+          payload: {},
+        },
+        {
+          name: "tabs.open",
+          description: "Open a new tab in the OpenClaw group",
+          payload: { url: "optional string — URL to load (blank tab if omitted)" },
+        },
+        {
+          name: "tabs.close",
+          description: "Close a tab in the OpenClaw group",
+          payload: { tabIndex: "optional int", tabId: "optional string — close by index or ID" },
+        },
+        {
+          name: "page.content",
+          description: "Get the text content of the active tab",
+          payload: {},
+        },
+        {
+          name: "snapshot",
+          description: "Get a snapshot of the OpenClaw group state",
+          payload: {},
+        },
+        {
+          name: "click",
+          description: "Click an element by CSS selector",
+          payload: { selector: "required string — CSS selector" },
+        },
+        {
+          name: "input.fill",
+          description: "Fill an input field with a value",
+          payload: {
+            selector: "required string — CSS selector",
+            value: "required string — text to fill",
+          },
+        },
+        {
+          name: "input.submit",
+          description: "Submit a form",
+          payload: { selector: "optional string — CSS selector of form or element inside form" },
+        },
+        {
+          name: "scroll",
+          description: "Scroll the page",
+          payload: {
+            direction: "optional string — 'up', 'down', 'top', 'bottom'",
+            x: "optional int — horizontal pixels",
+            y: "optional int — vertical pixels",
+          },
+        },
+        {
+          name: "execute",
+          description: "Execute arbitrary JavaScript and return the result",
+          payload: { code: "required string — JavaScript code to execute" },
+        },
+        {
+          name: "page.html",
+          description: "Get the full HTML of the page",
+          payload: {},
+        },
+        {
+          name: "dom.query",
+          description: "Query a DOM element for its tag, text, and attributes",
+          payload: { selector: "required string — CSS selector" },
+        },
+        {
+          name: "wait.ready",
+          description: "Wait until document.readyState is 'complete'",
+          payload: { timeout: "optional int — milliseconds (default: 10000)" },
+        },
+      ],
+    });
+    return;
+  }
+
   // ── GET /navigator/events ──
   if (req.method === "GET" && path === "/navigator/events") {
     const limit = parseInt(url.searchParams.get("limit") ?? "50", 10);
@@ -361,6 +449,32 @@ function handleRequest(req, res) {
   sendJSON(res, 404, { ok: false, error: "Not found" });
 }
 
+// ── Relay registration ────────────────────────────────────────────────────
+
+const RELAY_URL = "https://navigator-relay.nav8-relay.workers.dev";
+
+/**
+ * Register pairing code with the relay so Navigator can resolve it remotely.
+ * Returns true on success, false on failure (relay unavailable, etc.)
+ */
+async function registerWithRelay(code, url, token, name) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const res = await fetch(`${RELAY_URL}/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ code, url, token, name }),
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+    const data = await res.json();
+    return data.ok === true;
+  } catch {
+    return false;
+  }
+}
+
 // ── Display helpers ────────────────────────────────────────────────────────
 
 function showPairingCode(code) {
@@ -503,7 +617,17 @@ ${BOLD}How it works:${RESET}
   pairingCode = generatePairingCode();
   pairingData = { url: gatewayURL, token, name: displayName };
 
-  // ── Step 4: Show connection info ──────────────────────────────────────
+  // ── Step 4: Register with relay (for remote pairing) ────────────────
+  if (tunnelURL) {
+    const relayOk = await registerWithRelay(pairingCode, gatewayURL, token, displayName);
+    if (relayOk) {
+      ok("Code registered with relay — works from any device");
+    } else {
+      warn("Relay unavailable — code works on same machine only");
+    }
+  }
+
+  // ── Step 5: Show connection info ──────────────────────────────────────
   showPairingCode(pairingCode);
 
   // Deep link (always show as fallback)

package/package.json

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