mosey-browser 1.0.0 → 1.0.4

package/bin/mosey

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-// Tiny launcher: exec the vendored compiled binary.
-const { spawnSync } = require("child_process");
+// Tiny launcher: exec the vendored compiled binary, with a couple of UX wrappers:
+//   - `mosey install-deps`  : download Chromium / run setup (recovery for postinstall failures)
+//   - intercepts stderr to translate "daemon failed to start" into an actionable hint
+const { spawn, spawnSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
 
@@ -13,5 +15,40 @@ if (!fs.existsSync(bin)) {
   process.exit(1);
 }
 
-const res = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
-process.exit(res.status ?? 1);
+const argv = process.argv.slice(2);
+
+// Launcher-handled command: re-run the postinstall steps.
+if (argv[0] === "install-deps" || argv[0] === "install") {
+  spawnSync(bin, ["setup"], { stdio: "inherit" });
+  console.log("Downloading Chromium (~170MB, one-time)…");
+  const r = spawnSync(bin, ["navigate", "about:blank"], { stdio: "inherit", timeout: 10 * 60_000 });
+  spawnSync(bin, ["stop"], { stdio: "ignore" });
+  if (r.status === 0) {
+    console.log("✓ Ready. Try: mosey https://example.com");
+    process.exit(0);
+  } else {
+    console.error("✗ Chromium download failed. Check network and try again.");
+    process.exit(r.status ?? 1);
+  }
+}
+
+// Normal path: spawn binary, capture stderr so we can translate known failure modes.
+const child = spawn(bin, argv, { stdio: ["inherit", "inherit", "pipe"] });
+
+let stderrBuf = "";
+child.stderr.on("data", (chunk) => {
+  process.stderr.write(chunk);
+  stderrBuf += chunk.toString();
+  if (stderrBuf.length > 64 * 1024) stderrBuf = stderrBuf.slice(-32 * 1024);
+});
+
+child.on("exit", (code) => {
+  if (code !== 0 && /daemon failed to start/i.test(stderrBuf)) {
+    process.stderr.write(
+      "\n[mosey] The daemon failed to start. This usually means Chromium isn't installed yet.\n" +
+        "[mosey] Fix: run `mosey install-deps` in a terminal (downloads Chromium ~170MB, one-time), then retry.\n" +
+        "[mosey] AI agent: ask the user to run `mosey install-deps` — do not retry the same command first.\n"
+    );
+  }
+  process.exit(code ?? 1);
+});

package/bin/postinstall.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+// Postinstall: wire up CLAUDE.md and download Chromium so the first `mosey <url>` is instant.
+// Best-effort: any failure here is non-fatal — the user can retry with `mosey install-deps`.
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+
+const bin = path.join(
+  __dirname,
+  "..",
+  "vendor",
+  "mosey" + (process.platform === "win32" ? ".exe" : "")
+);
+
+if (!fs.existsSync(bin)) {
+  // Binary missing for this platform — silent exit, the bin/mosey launcher will print a clear error later.
+  process.exit(0);
+}
+
+console.log("\n  ✓ mosey-browser installed.");
+
+// 1. CLAUDE.md wire-up (idempotent — safe to re-run on every install).
+spawnSync(bin, ["setup"], { stdio: "inherit" });
+
+// 2. Trigger Chromium download by starting the daemon once against about:blank.
+//    Playwright's chromium download is the slow step; daemon startup itself is <1s once Chromium is present.
+console.log("  Downloading Chromium for first run (~170MB, one-time)…");
+const navRes = spawnSync(bin, ["navigate", "about:blank"], {
+  stdio: "inherit",
+  // generous timeout: cold Playwright Chromium download can take a few minutes on slow links
+  timeout: 10 * 60_000,
+});
+spawnSync(bin, ["stop"], { stdio: "ignore" });
+
+if (navRes.status === 0) {
+  console.log("  ✓ Ready. Try: mosey https://example.com\n");
+} else {
+  console.log(
+    "  ⚠ Chromium not downloaded (network/timeout). Run `mosey install-deps` to retry.\n"
+  );
+  // Don't fail the npm install for this — user can recover later.
+}

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "mosey-browser",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "description": "Web CLI for AI agents — navigate and interact with pages via snapshots",
   "license": "UNLICENSED",
   "private": false,
   "bin": {
     "mosey": "./bin/mosey"
   },
+  "scripts": {
+    "postinstall": "node ./bin/postinstall.js"
+  },
   "files": [
     "bin",
     "vendor",
@@ -26,6 +29,11 @@
   "cpu": [
     "arm64"
   ],
+  "dependencies": {
+    "commander": "^14.0.3",
+    "mosey-browser": "^1.0.1",
+    "patchright": "^1.52.0"
+  },
   "devDependencies": {
     "@types/bun": "^1.3.0",
     "@types/node": "^25.6.0",