@alivault/pico 0.12.0 → 0.14.0

package/bin/pico.mjs

@@ -2,6 +2,7 @@
 
 import { spawn, spawnSync } from "node:child_process"
 import { existsSync, readFileSync } from "node:fs"
+import { createServer } from "node:net"
 import process from "node:process"
 import { dirname, join } from "node:path"
 import { fileURLToPath } from "node:url"
@@ -9,6 +10,34 @@ import { fileURLToPath } from "node:url"
 const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
 const packageJsonPath = join(packageRoot, "package.json")
 const serverEntry = join(packageRoot, ".output", "server", "index.mjs")
+const minimumNodeVersion = [22, 19, 0]
+const minimumNodeVersionLabel = "22.19.0"
+const portSearchLimit = 100
+
+function nodeVersionMeetsMinimum(version) {
+  const parts = version.split(".").map((part) => Number(part))
+
+  for (let index = 0; index < minimumNodeVersion.length; index += 1) {
+    const actual = Number.isFinite(parts[index]) ? parts[index] : 0
+    const required = minimumNodeVersion[index]
+    if (actual > required) return true
+    if (actual < required) return false
+  }
+
+  return true
+}
+
+function ensureSupportedNodeVersion() {
+  if (nodeVersionMeetsMinimum(process.versions.node)) return
+
+  console.error(
+    `Pico requires Node.js >=${minimumNodeVersionLabel}; current version is ${process.versions.node}.`
+  )
+  console.error("Upgrade Node.js and run Pico again.")
+  process.exit(1)
+}
+
+ensureSupportedNodeVersion()
 
 function readPackageMetadata() {
   try {
@@ -41,7 +70,7 @@ Commands:
   update           Update the globally installed Pico package to latest
 
 Options:
-  --port <port>    Port to listen on (default: 3141)
+  --port <port>    Port to listen on (default: 3141; tries next free port)
   --host <host>    Host to bind to
   --open           Open Pico in your browser (default)
   --no-open        Do not open a browser window
@@ -209,6 +238,67 @@ function browserHostFor(host) {
   return host
 }
 
+function normalizePort(port) {
+  const portNumber = Number(port)
+  if (!Number.isInteger(portNumber) || portNumber < 0 || portNumber > 65_535) {
+    console.error(`Invalid port: ${port}`)
+    process.exit(1)
+  }
+  return portNumber
+}
+
+function canRetryPortError(error) {
+  return error?.code === "EADDRINUSE"
+}
+
+function isPortAvailable(port, host) {
+  return new Promise((resolve, reject) => {
+    const probe = createServer()
+    const listenOptions = host ? { port, host } : { port }
+
+    probe.once("error", (error) => {
+      if (canRetryPortError(error)) {
+        resolve(false)
+        return
+      }
+      reject(error)
+    })
+    probe.once("listening", () => {
+      probe.close((error) => {
+        if (error) {
+          reject(error)
+          return
+        }
+        resolve(true)
+      })
+    })
+    probe.listen(listenOptions)
+  })
+}
+
+async function resolveAvailablePort(port, host) {
+  const requestedPort = normalizePort(port)
+  if (requestedPort === 0) return String(requestedPort)
+
+  const lastPort = Math.min(65_535, requestedPort + portSearchLimit - 1)
+
+  for (let candidate = requestedPort; candidate <= lastPort; candidate += 1) {
+    if (await isPortAvailable(candidate, host)) {
+      if (candidate !== requestedPort) {
+        console.warn(
+          `Port ${requestedPort} is not available; using ${candidate} instead.`
+        )
+      }
+      return String(candidate)
+    }
+  }
+
+  console.error(
+    `No available port found between ${requestedPort} and ${lastPort}.`
+  )
+  process.exit(1)
+}
+
 async function waitForServer(url, timeoutMs = 15_000) {
   const startedAt = Date.now()
 
@@ -254,6 +344,18 @@ if (!existsSync(serverEntry)) {
   process.exit(1)
 }
 
+try {
+  options.port = await resolveAvailablePort(options.port, options.host)
+} catch (error) {
+  console.error(
+    `Could not check port ${options.port}${
+      options.host ? ` on ${options.host}` : ""
+    }.`
+  )
+  console.error(error?.message ?? String(error))
+  process.exit(1)
+}
+
 const url = `http://${browserHostFor(options.host)}:${options.port}`
 
 console.log(`Starting Pico at ${url}`)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alivault/pico",
-  "version": "0.12.0",
-  "description": "A local, keyboard-friendly browser workspace for Pi coding-agent sessions.",
+  "version": "0.14.0",
+  "description": "A local workspace for Pi coding-agent sessions with browser, macOS, and iOS clients.",
   "license": "AGPL-3.0-only",
   "type": "module",
   "bin": {
@@ -10,7 +10,6 @@
   "files": [
     ".output",
     "bin",
-    "scripts/patch-react-jsx-dev-runtime.mjs",
     "scripts/release.mjs",
     "public/screenshots",
     "vendor/node-domexception",
@@ -26,14 +25,14 @@
     "url": "https://github.com/alivault/pico/issues"
   },
   "engines": {
-    "node": ">=20.6.0"
+    "node": ">=22.19.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "dev": "vp dev",
-    "build": "vp build && node ./scripts/patch-react-jsx-dev-runtime.mjs",
+    "build": "vp build",
     "start": "node ./bin/pico.mjs",
     "prepack": "pnpm build",
     "preview": "vp preview",
@@ -45,7 +44,8 @@
     "update:pi": "pnpm update @earendil-works/pi-coding-agent --latest"
   },
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "0.74.0",
+    "@earendil-works/pi-coding-agent": "0.80.6",
+    "node-pty": "^1.1.0",
     "tslib": "^2.8.1"
   },
   "overrides": {
@@ -79,6 +79,8 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
     "babel-plugin-react-compiler": "^1.0.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -110,5 +112,10 @@
     "web-vitals": "^5.1.0",
     "zod": "^4.3.6"
   },
-  "packageManager": "pnpm@10.33.0"
+  "packageManager": "pnpm@10.33.0",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "node-pty"
+    ]
+  }
 }