pi-app 0.7.0

package/bin/pi-app.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+"use strict";
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { spawn } = require("child_process");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const path = require("path");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const fs = require("fs");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { parseArgs } = require("util");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const os = require("os");
+
+const pkgDir = path.join(__dirname, "..");
+const nextDir = path.join(pkgDir, ".next");
+
+function resolveAgentDir() {
+  if (process.env.PI_CODING_AGENT_DIR) return process.env.PI_CODING_AGENT_DIR;
+  return path.join(os.homedir(), ".pi", "agent");
+}
+
+function applyRemoteEnvFromConfig() {
+  const configPath = path.join(resolveAgentDir(), "pi-web-remote.json");
+  try {
+    const raw = fs.readFileSync(configPath, "utf8");
+    const config = JSON.parse(raw);
+    if (config.enabled) {
+      process.env.PI_WEB_REMOTE = "1";
+      if (config.signingSecret) process.env.PI_WEB_REMOTE_SIGNING_SECRET = config.signingSecret;
+      if (config.readOnly) process.env.PI_WEB_REMOTE_READ_ONLY = "1";
+      else delete process.env.PI_WEB_REMOTE_READ_ONLY;
+    }
+  } catch {
+    // no remote config yet
+  }
+}
+
+// Resolve next's CLI entry directly to avoid relying on .bin symlinks (which
+// may not exist when installed via npx).
+let nextBin;
+try {
+  nextBin = require.resolve("next/dist/bin/next", { paths: [pkgDir] });
+} catch {
+  // Fallback: locate next package root and derive the bin path manually.
+  try {
+    const nextPkg = require.resolve("next/package.json", { paths: [pkgDir] });
+    nextBin = path.join(path.dirname(nextPkg), "dist", "bin", "next");
+  } catch {
+    nextBin = path.join(pkgDir, "node_modules", "next", "dist", "bin", "next");
+  }
+}
+
+const { values: cliArgs } = parseArgs({
+  options: {
+    port:     { type: "string", short: "p" },
+    hostname: { type: "string", short: "H" },
+    remote:   { type: "boolean" },
+  },
+  strict: false,
+});
+
+const port     = cliArgs.port     ?? process.env.PORT     ?? "30141";
+let hostname = cliArgs.hostname ?? process.env.HOSTNAME ?? null;
+const remoteFlag = cliArgs.remote === true || process.env.PI_WEB_REMOTE === "1";
+
+applyRemoteEnvFromConfig();
+
+if (remoteFlag) {
+  process.env.PI_WEB_REMOTE = "1";
+  if (!hostname) hostname = "0.0.0.0";
+}
+
+if (process.env.PI_WEB_REMOTE_TOKEN) {
+  process.env.PI_WEB_REMOTE = "1";
+}
+
+if (!fs.existsSync(nextDir)) {
+  console.error("Build artifacts not found. Please report this issue.");
+  process.exit(1);
+}
+
+const nextArgs = ["start", "-p", port];
+if (hostname) nextArgs.push("-H", hostname);
+
+const childEnv = { ...process.env };
+if (remoteFlag && !childEnv.PI_WEB_REMOTE) childEnv.PI_WEB_REMOTE = "1";
+
+// Always run next's JS entry with node directly — avoids .bin symlink issues
+// and path-with-spaces problems on Windows when shell: true is used.
+const child = spawn(process.execPath, [nextBin, ...nextArgs], {
+  cwd: pkgDir,
+  stdio: ["inherit", "pipe", "inherit"],
+  env: childEnv,
+});
+
+let browserOpened = false;
+const openHost = !hostname || hostname === "0.0.0.0" ? "localhost" : hostname;
+const url = `http://${openHost}:${port}`;
+
+child.stdout.on("data", (chunk) => {
+  const text = chunk.toString();
+  process.stdout.write(text);
+  if (!browserOpened && text.includes("Ready") && !remoteFlag) {
+    browserOpened = true;
+    const isWindows = process.platform === "win32";
+    const isMac = process.platform === "darwin";
+    const openCmd = isWindows ? "start" : isMac ? "open" : "xdg-open";
+    spawn(openCmd, [url], { shell: isWindows, stdio: "ignore", detached: true }).unref();
+  }
+});
+
+child.on("exit", (code) => process.exit(code ?? 0));

package/next.config.ts

@@ -0,0 +1,61 @@
+import type { NextConfig } from "next";
+import { readFileSync } from "fs";
+import { join } from "path";
+
+const packageJson = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8")) as {
+  version: string;
+  dependencies?: Record<string, string>;
+};
+const { version } = packageJson;
+const usesLocalPi = String(packageJson.dependencies?.["@earendil-works/pi-coding-agent"] ?? "").startsWith("file:");
+let piVersion = "unknown";
+try {
+  const piPkgPath = join(__dirname, "node_modules/@earendil-works/pi-coding-agent/package.json");
+  piVersion = (JSON.parse(readFileSync(piPkgPath, "utf8")) as { version: string }).version;
+} catch { /* package not found, use default */ }
+
+const piServerExternalPackages = [
+  "@earendil-works/pi-coding-agent",
+  "@earendil-works/pi-ai",
+  "@earendil-works/pi-agent-core",
+  "@earendil-works/pi-tui",
+  "jiti",
+  "typebox",
+];
+
+const nextConfig: NextConfig = {
+  distDir: process.env.NEXT_DIST_DIR ?? ".next",
+  serverExternalPackages: piServerExternalPackages,
+  webpack: (config, { isServer }) => {
+    if (!isServer) return config;
+    // file: linked pi packages are still bundled by webpack dev unless forced external.
+    const prev = config.externals;
+    config.externals = [
+      ...(Array.isArray(prev) ? prev : prev ? [prev] : []),
+      ({ request }: { request?: string }, callback: (err?: Error | null, result?: string) => void) => {
+        if (!request) return callback();
+        if (
+          piServerExternalPackages.some((pkg) => request === pkg || request.startsWith(`${pkg}/`))
+        ) {
+          return callback(undefined, `module ${request}`);
+        }
+        callback();
+      },
+    ];
+    return config;
+  },
+  devIndicators: process.env.NODE_ENV === "development" ? {
+    position: "bottom-right",
+  } : false,
+  turbopack: {
+    // Turbopack won't resolve file:/npm-link deps outside the app root unless root is widened.
+    root: usesLocalPi ? join(__dirname, "..") : __dirname,
+  },
+  allowedDevOrigins: ["192.168.*.*"],
+  env: {
+    NEXT_PUBLIC_APP_VERSION: version,
+    NEXT_PUBLIC_PI_VERSION: piVersion,
+  },
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "pi-app",
+  "version": "0.7.0",
+  "description": "Web UI for the pi coding agent",
+  "license": "MIT",
+  "bin": {
+    "pi-app": "bin/pi-app.js"
+  },
+  "files": [
+    "bin",
+    ".next",
+    "!.next/cache",
+    "!.next/dev",
+    "!.next/**/*.js.map",
+    "public",
+    "next.config.ts",
+    "package.json"
+  ],
+  "scripts": {
+    "dev": "PI_CODING_AGENT_DIR=~/tmp/pi-dev-agent NEXT_DIST_DIR=.next-dev-30142 next dev -p 30142 --webpack",
+    "dev:prod": "echo 'WARNING: next dev on 30141 hot-reloads with source edits; use npm start for daily 30141.' >&2 && next dev -p 30141",
+    "build": "next build --webpack",
+    "start": "next start -p 30141",
+    "lint": "eslint .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:workbench": "node scripts/workbench-smoke.mjs",
+    "test:m2": "node scripts/m2-preflight.mjs",
+    "test:m3": "node scripts/m3-preflight.mjs",
+    "test:m4": "node scripts/m4-preflight.mjs",
+    "package:macos": "bash scripts/package-macos-app.sh",
+    "tunnel:cloudflare": "bash scripts/tunnel-cloudflared.sh",
+    "relay:server": "node --experimental-strip-types scripts/pi-relay-server.ts",
+    "relay:host": "node --experimental-strip-types scripts/pi-relay-host.ts",
+    "relay:client": "node --experimental-strip-types scripts/pi-relay-client.ts",
+    "release": "npm version patch --no-git-tag-version && npm run build && npm publish --access public",
+    "prepublishOnly": "node_modules/.bin/tsc --noEmit && node_modules/.bin/vitest run"
+  },
+  "dependencies": {
+    "@earendil-works/pi-ai": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "^0.78.0",
+    "@lobehub/icons": "5.10.0",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "mammoth": "^1.12.0",
+    "mermaid": "11.15.0",
+    "next": "16.2.6",
+    "pdfjs-dist": "4.10.38",
+    "qrcode": "1.5.4",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-markdown": "^10.1.0",
+    "react-syntax-highlighter": "^16.1.1",
+    "remark-gfm": "^4.0.1",
+    "web-push": "3.6.7"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/node": "^25",
+    "@types/qrcode": "1.5.5",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.6",
+    "playwright": "^1.60.0",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.2.2",
+    "typescript": "^5",
+    "vitest": "^4.1.7"
+  },
+  "optionalDependencies": {
+    "pi-fetch-tool": "^0.1.5"
+  },
+  "overrides": {
+    "js-cookie": "3.0.8",
+    "mermaid": "11.15.0"
+  }
+}
+

package/public/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-label="Pi">
+  <rect width="512" height="512" rx="96" fill="#2563eb"/>
+  <text x="256" y="330" text-anchor="middle" font-family="Georgia, serif" font-size="280" fill="#ffffff">�</text>
+</svg>

package/public/manifest.webmanifest

@@ -0,0 +1,18 @@
+{
+  "name": "Pi Agent Web",
+  "short_name": "Pi Web",
+  "description": "Web UI for the pi coding agent",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#2563eb",
+  "orientation": "any",
+  "icons": [
+    {
+      "src": "/icon.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "any"
+    }
+  ]
+}