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-readiness-cost.json ADDED Viewed

@@ -0,0 +1,106 @@
+{
+  "measuredAt": "2026-09-09T06:39:24.890Z",
+  "scope": "Relay only. Already-ready Add row control; action and final observation timed, setup and independent outcome assertion excluded. Measures opt-in stability waiting overhead, not a model comparison.",
+  "browser": "153.0.8010.12",
+  "viewport": {
+    "width": 1466,
+    "height": 925
+  },
+  "headless": false,
+  "summary": {
+    "0": {
+      "runs": 7,
+      "elapsedMs": 36.9
+    },
+    "2000": {
+      "runs": 7,
+      "elapsedMs": 85.2
+    }
+  },
+  "samples": [
+    {
+      "iteration": 0,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 89.2,
+      "success": true
+    },
+    {
+      "iteration": 0,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 91.3,
+      "success": true
+    },
+    {
+      "iteration": 1,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 88.3,
+      "success": true
+    },
+    {
+      "iteration": 1,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 36.9,
+      "success": true
+    },
+    {
+      "iteration": 2,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 43.7,
+      "success": true
+    },
+    {
+      "iteration": 2,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 84.4,
+      "success": true
+    },
+    {
+      "iteration": 3,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 85,
+      "success": true
+    },
+    {
+      "iteration": 3,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 38,
+      "success": true
+    },
+    {
+      "iteration": 4,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 33,
+      "success": true
+    },
+    {
+      "iteration": 4,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 89.2,
+      "success": true
+    },
+    {
+      "iteration": 5,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 85.2,
+      "success": true
+    },
+    {
+      "iteration": 5,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 32.4,
+      "success": true
+    },
+    {
+      "iteration": 6,
+      "readinessTimeoutMs": 0,
+      "elapsedMs": 32.6,
+      "success": true
+    },
+    {
+      "iteration": 6,
+      "readinessTimeoutMs": 2000,
+      "elapsedMs": 81.4,
+      "success": true
+    }
+  ]
+}

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

@@ -0,0 +1,412 @@
+{
+  "measuredAt": "2026-09-09T05:51:09.000Z",
+  "suite": "balanced",
+  "executionOrder": "rotating",
+  "injectedExtensionRttMs": 0,
+  "platform": "darwin",
+  "node": "v22.23.1",
+  "chromium": "153.0.8010.12",
+  "headless": false,
+  "viewport": {
+    "width": 1466,
+    "height": 925
+  },
+  "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": 265.25,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3521.5,
+      "snapshotBytes": 2301
+    },
+    "legacy-minimal": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 262.95,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    "actions": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 258.4,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3922,
+      "snapshotBytes": 2202
+    },
+    "playwright-cdp": {
+      "runs": 8,
+      "successes": 8,
+      "elapsedMs": 264.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    }
+  },
+  "delta": {
+    "fullSnapshotBytes": 1880,
+    "changedSnapshotBytes": 160
+  },
+  "samples": [
+    {
+      "variant": "legacy",
+      "iteration": 0,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 267.6,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 0,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 253.9,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1669,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 0,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 285.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3922,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 0,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 272.8,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 1,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 250,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1673,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 1,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 244.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3922,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 1,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 278.5,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 1,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 267.8,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 2,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 245.1,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3922,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 2,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 246.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 2,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 292.1,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3537,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 2,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 268.3,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 3,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 266.8,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 3,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 260.4,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3517,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 3,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 258.7,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 3,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 252.2,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3921,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "legacy",
+      "iteration": 4,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 431.9,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3522,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 4,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 248.8,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1665,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 4,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 271.9,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3917,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 4,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 265.9,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 5,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 287.2,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1669,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 5,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 258.8,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3923,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 5,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 263.1,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 5,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 262.9,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3521,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "actions",
+      "iteration": 6,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 258,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3923,
+      "snapshotBytes": 2202
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 6,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 256.9,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 6,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 260.5,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3533,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 6,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 269.6,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "playwright-cdp",
+      "iteration": 7,
+      "position": 0,
+      "success": true,
+      "elapsedMs": 244,
+      "httpCalls": 0,
+      "extensionRoundTrips": 73,
+      "responseBytes": null,
+      "snapshotBytes": 1425
+    },
+    {
+      "variant": "legacy",
+      "iteration": 7,
+      "position": 1,
+      "success": true,
+      "elapsedMs": 260.5,
+      "httpCalls": 10,
+      "extensionRoundTrips": 39,
+      "responseBytes": 3537,
+      "snapshotBytes": 2301
+    },
+    {
+      "variant": "legacy-minimal",
+      "iteration": 7,
+      "position": 2,
+      "success": true,
+      "elapsedMs": 267.2,
+      "httpCalls": 7,
+      "extensionRoundTrips": 30,
+      "responseBytes": 1670,
+      "snapshotBytes": 926
+    },
+    {
+      "variant": "actions",
+      "iteration": 7,
+      "position": 3,
+      "success": true,
+      "elapsedMs": 271.7,
+      "httpCalls": 2,
+      "extensionRoundTrips": 2,
+      "responseBytes": 3921,
+      "snapshotBytes": 2202
+    }
+  ]
+}