npm - @xnng/browser-relay - Versions diffs - 1.6.0 - Mend

@xnng/browser-relay 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (79) hide show

package/LICENSE +22 -0
package/README.md +445 -0
package/docs/README.zh-CN.md +421 -0
package/docs/benchmarks/browser-gaps-codex-ax.json +418 -0
package/docs/benchmarks/browser-gaps-relay-after.json +655 -0
package/docs/benchmarks/browser-gaps-relay-baseline.json +679 -0
package/docs/benchmarks/browser-readiness-cost.json +106 -0
package/docs/benchmarks/browser-runtime-balanced-headed.json +412 -0
package/docs/benchmarks/browser-runtime-balanced-rtt50.json +412 -0
package/docs/benchmarks/browser-runtime-balanced.json +412 -0
package/docs/benchmarks/browser-runtime-rtt50.json +194 -0
package/docs/benchmarks/browser-runtime.json +254 -0
package/docs/benchmarks/browser-use-parity.json +54 -0
package/docs/benchmarks/codex-extension-audit.json +131 -0
package/docs/benchmarks/codex-native-protocol.md +69 -0
package/docs/benchmarks/codex-native-replay.js +116 -0
package/docs/benchmarks/codex-native-status.json +81 -0
package/docs/benchmarks/codex-native.json +1003 -0
package/docs/benchmarks/extension-sessions.png +0 -0
package/docs/benchmarks/extension-tasks.png +0 -0
package/docs/benchmarks/iframe-routing-regression.json +37 -0
package/docs/browser-use-comparison.md +331 -0
package/docs/browser-use-gap-audit.md +141 -0
package/docs/browser-use-parity.md +105 -0
package/docs/demo/intranet.html +103 -0
package/docs/releases/v1.5.0.md +59 -0
package/docs/releases/v1.5.1.md +16 -0
package/docs/releases/v1.5.2.md +42 -0
package/docs/releases/v1.5.3.md +33 -0
package/docs/releases/v1.5.4.md +42 -0
package/docs/releases/v1.6.0.md +16 -0
package/docs/remote-control-hub.md +523 -0
package/extension/activity.js +328 -0
package/extension/automation.js +1839 -0
package/extension/background.js +1854 -0
package/extension/i18n.js +149 -0
package/extension/icons/icon128.png +0 -0
package/extension/icons/icon16.png +0 -0
package/extension/icons/icon32.png +0 -0
package/extension/icons/icon48.png +0 -0
package/extension/manifest.json +47 -0
package/extension/observations.js +109 -0
package/extension/options.html +289 -0
package/extension/options.js +269 -0
package/extension/popup.html +74 -0
package/extension/popup.js +105 -0
package/extension/protocol.js +45 -0
package/extension/remote-auth.js +18 -0
package/extension/sessions.js +134 -0
package/extension/snapshot.js +161 -0
package/extension/task-groups.js +108 -0
package/extension/tasks.js +186 -0
package/extension/wait.js +89 -0
package/hub/README.md +42 -0
package/hub/package-lock.json +1544 -0
package/hub/package.json +13 -0
package/hub/src/rpc.js +41 -0
package/hub/src/worker.js +322 -0
package/hub/wrangler.example.toml +19 -0
package/package.json +83 -0
package/server/cdp-bridge.js +200 -0
package/server/cli.js +1798 -0
package/server/hub-server.js +258 -0
package/server/install.js +250 -0
package/server/mcp-server.js +504 -0
package/server/npx-runner.js +96 -0
package/server/relay-server.js +1356 -0
package/server/remote-protocol.js +76 -0
package/server/runtime-worker.js +166 -0
package/server/script-runtime.js +189 -0
package/server/sdk.js +307 -0
package/server/service-state.js +103 -0
package/server/snapshot.js +161 -0
package/server/uninstall.js +61 -0
package/server/windows-service-entry.js +58 -0
package/server/windows-service.js +360 -0
package/skills/browser-relay/SKILL.md +192 -0
package/skills/browser-relay/references/legacy-api.md +163 -0
package/skills/browser-relay/references/runtime.md +240 -0

package/docs/benchmarks/browser-runtime-balanced.json ADDED Viewed

@@ -0,0 +1,412 @@
+{
+  "measuredAt": "2026-09-08T19:21:23.376Z",
+  "suite": "balanced",
+  "executionOrder": "rotating",
+  "injectedExtensionRttMs": 0,
+  "platform": "darwin",
+  "node": "v22.23.1",
+  "chromium": "153.0.8010.12",
+  "headless": true,
+  "viewport": {
+    "width": 1280,
+    "height": 1000
+  },
+  "task": "Search invoice / owner Alice / active only; await visible result",
+  "scope": "Deterministic browser/tool execution; no model inference or token accounting. Playwright over Relay is not Codex Browser Use.",
+  "summary": {
+    "legacy": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 262.05,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3522,
+      "snapshotBytes": 2301
+    },
+    "legacy-minimal": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 254.10000000000002,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    "actions": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 288.05,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3918.5,
+      "snapshotBytes": 2202
+    },
+    "playwright-cdp": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 329.2,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    }
+  },
+  "delta": {
+    "fullSnapshotBytes": 1880,
+    "changedSnapshotBytes": 160
+  },
+  "samples": [
+    {
+      "variant": "legacy",
+      "iteration": 0,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 285.9,
+      "httpCalls": 10,
+      "extensionRoundTrips": 40,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 0,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 252.4,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1669,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 0,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 276.4,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3919,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 0,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 293.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 1,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 246.2,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1673,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 1,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 286,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3923,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 1,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 324.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 1,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 262.6,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3537,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 2,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 290.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3923,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 2,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 328,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 2,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 269.8,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 2,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 254.4,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 3,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 331.7,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 3,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 257.1,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 3,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 260.3,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 3,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 293.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3918,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "legacy",
+      "iteration": 4,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 261.5,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3537,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 4,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 245.5,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 4,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 292.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3918,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 4,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 332.7,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 5,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 261.8,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 5,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 291,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3918,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 5,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 326.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 5,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 268.4,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3522,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 6,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 262.3,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3918,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 6,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 330.4,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 6,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 260.5,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3522,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 6,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 260.1,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1665,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 7,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 330.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 7,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 257.9,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3522,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 7,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 253.8,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1665,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 7,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 269.4,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3926,
+      "snapshotBytes": 2202
+    }
+  ]
+}

package/docs/benchmarks/browser-runtime-rtt50.json ADDED Viewed

@@ -0,0 +1,194 @@
+{
+  "measuredAt": "2026-09-08T11:15:47.299Z",
+  "injectedExtensionRttMs": 50,
+  "platform": "darwin",
+  "node": "v22.23.1",
+  "chromium": "153.0.8010.12",
+  "task": "Search invoice / owner Alice / active only; await visible result",
+  "scope": "Deterministic browser/tool execution; no model inference or token accounting. Playwright over Relay is not Codex Browser Use.",
+  "summary": {
+    "legacy": {
+      "runs": 5,
+      "successes": 5,
+      "elapsedMs": 2205.6,
+      "httpCalls": 10,
+      "extensionRoundTrips": 38,
+      "responseBytes": 3536,
+      "snapshotBytes": 2301
+    },
+    "actions": {
+      "runs": 5,
+      "successes": 5,
+      "elapsedMs": 403,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3924,
+      "snapshotBytes": 2202
+    },
+    "playwright-cdp": {
+      "runs": 5,
+      "successes": 5,
+      "elapsedMs": 2465.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    }
+  },
+  "delta": {
+    "fullSnapshotBytes": 1880,
+    "changedSnapshotBytes": 160
+  },
+  "samples": [
+    {
+      "variant": "legacy",
+      "iteration": 0,
+      "success": true,
+      "elapsedMs": 2218.2,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3540,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 0,
+      "success": true,
+      "elapsedMs": 411.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3923,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 0,
+      "success": true,
+      "elapsedMs": 2422.6,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 1,
+      "success": true,
+      "elapsedMs": 2205.2,
+      "httpCalls": 10,
+      "extensionRoundTrips": 38,
+      "responseBytes": 3535,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 1,
+      "success": true,
+      "elapsedMs": 385.3,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3926,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 1,
+      "success": true,
+      "elapsedMs": 2473.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 2,
+      "success": true,
+      "elapsedMs": 2205.6,
+      "httpCalls": 10,
+      "extensionRoundTrips": 38,
+      "responseBytes": 3536,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 2,
+      "success": true,
+      "elapsedMs": 403,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3924,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 2,
+      "success": true,
+      "elapsedMs": 2470.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 3,
+      "success": true,
+      "elapsedMs": 2204.1,
+      "httpCalls": 10,
+      "extensionRoundTrips": 38,
+      "responseBytes": 3539,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 3,
+      "success": true,
+      "elapsedMs": 410.4,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3922,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 3,
+      "success": true,
+      "elapsedMs": 2455.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 4,
+      "success": true,
+      "elapsedMs": 2209.3,
+      "httpCalls": 10,
+      "extensionRoundTrips": 38,
+      "responseBytes": 3535,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 4,
+      "success": true,
+      "elapsedMs": 382.9,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3926,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 4,
+      "success": true,
+      "elapsedMs": 2465.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 70,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    }
+  ]
+}