pi-web-ui 0.2.3 → 0.2.5

package/README.md

@@ -28,7 +28,9 @@ your existing pi auth/config/extensions — nothing extra to install or configur
 
 ## Quick start
 
-Requires Node.js ≥ 20.11 and a configured pi install (run `pi` once to log in).
+Requires Node.js ≥ 22.19 (the pi SDK requires it; older Node fails with
+`Unexpected token 'with'` when loading the SDK) and a configured pi install
+(run `pi` once to log in).
 
 ```bash
 npm install

package/bin/pi-web-ui.mjs

@@ -68,6 +68,24 @@ server 选项:
   PORT / PI_WEB_CWD / PI_WEB_DATA_DIR / PI_CODING_AGENT_DIR
 `;
 
+/** Minimum Node required by the pi SDK (its dist uses `import … with { type: "json" }`). */
+const NODE_MIN = [22, 19, 0];
+function checkNodeVersion() {
+	const v = process.versions.node.split(".").map(Number);
+	const tooOld =
+		v[0] < NODE_MIN[0] ||
+		(v[0] === NODE_MIN[0] && v[1] < NODE_MIN[1]) ||
+		(v[0] === NODE_MIN[0] && v[1] === NODE_MIN[1] && v[2] < NODE_MIN[2]);
+	if (tooOld) {
+		console.error(
+			`✖ pi-web-ui 需要 Node.js >= ${NODE_MIN.join(".")}（当前 ${process.versions.node}）。\n` +
+				`  pi SDK 的代码使用了 import attributes（with）语法，旧版 Node 无法解析。\n` +
+				`  请升级 Node：https://nodejs.org（或 nvm-windows / fnm）后重装：npm i -g pi-web-ui`,
+		);
+		process.exit(1);
+	}
+}
+
 function fail(msg) {
 	console.error(`✖ ${msg}`);
 	process.exit(1);
@@ -712,6 +730,7 @@ async function serverCmd(argv) {
 }
 
 async function main() {
+	checkNodeVersion();
 	const argv = process.argv.slice(2);
 	if (argv.length === 0) {
 		await startForeground({});

package/dist/server/agent-service.js

@@ -562,25 +562,40 @@ export class ClientSession {
         this.piCheckCache = { at: now, configured };
         return configured;
     }
-    /** Run a command async, collecting stdout+stderr; kills on timeout. */
+    /**
+     * Run a command async, collecting stdout+stderr; kills on timeout.
+     * Never throws / never crashes the server: spawn errors (ENOENT etc.)
+     * resolve with code -1 so callers can report them as notices.
+     */
     runAsync(cmd, args, timeoutMs) {
         return new Promise((resolve) => {
             let p;
             try {
-                p = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+                p = spawn(cmd, args, {
+                    stdio: ["ignore", "pipe", "pipe"],
+                    // Windows: npm and friends are .cmd shims — Node can only exec
+                    // them through the shell (otherwise spawn npm → ENOENT).
+                    shell: process.platform === "win32",
+                });
             }
             catch (err) {
                 resolve({ code: -1, out: String(err) });
                 return;
             }
             let out = "";
+            let settled = false;
+            const done = (code, text) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(t);
+                resolve({ code, out: text ?? out });
+            };
+            const t = setTimeout(() => p.kill(), timeoutMs);
             p.stdout?.on("data", (d) => (out += d.toString()));
             p.stderr?.on("data", (d) => (out += d.toString()));
-            const t = setTimeout(() => p.kill(), timeoutMs);
-            p.on("close", (code) => {
-                clearTimeout(t);
-                resolve({ code, out });
-            });
+            p.on("error", (err) => done(-1, String(err)));
+            p.on("close", (code) => done(code));
         });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-ui",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "url": "git+https://github.com/xing-shuyin/pi-web-ui.git"
   },
   "engines": {
-    "node": ">=20.11"
+    "node": ">=22.19.0"
   },
   "scripts": {
     "prepublishOnly": "npm run build",