@hyperdreamer/pi-webui 1.6.1

package/extensions/pi-webui.ts

@@ -0,0 +1,133 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const cliPath = join(packageRoot, "dist", "cli.js");
+const serviceNames = ["pi-webui-sessiond.service", "pi-webui.service", "pi-webui-ui-dev.service"];
+const macLogPaths = ["sessiond.log", "web.log", "ui-dev.log"].map((name) => join(homedir(), ".pi-webui", "logs", name));
+
+const subcommands = [
+  "install",
+  "status",
+  "logs",
+  "restart",
+  "start",
+  "stop",
+  "doctor",
+  "version",
+  "uninstall",
+  "open",
+  "help",
+] as const;
+
+type Subcommand = (typeof subcommands)[number];
+
+function parseArgs(args: string): string[] {
+  return args.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g)?.map((part) => {
+    if ((part.startsWith('"') && part.endsWith('"')) || (part.startsWith("'") && part.endsWith("'"))) {
+      return part.slice(1, -1);
+    }
+    return part;
+  }) ?? [];
+}
+
+function truncateOutput(output: string): string {
+  const trimmed = output.trim();
+  if (trimmed.length <= 3_500) return trimmed;
+  return `${trimmed.slice(0, 3_500)}\n… output truncated`;
+}
+
+function run(command: string, args: string[], env: NodeJS.ProcessEnv = {}): Promise<{ code: number; output: string }> {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, {
+      env: { ...process.env, ...env },
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+
+    let output = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk: string) => { output += chunk; });
+    child.stderr.on("data", (chunk: string) => { output += chunk; });
+    child.on("error", (error) => {
+      resolve({ code: 1, output: error.message });
+    });
+    child.on("close", (code) => {
+      resolve({ code: code ?? 1, output });
+    });
+  });
+}
+
+async function runPiWebUi(args: string[], env: NodeJS.ProcessEnv = {}): Promise<{ code: number; output: string }> {
+  if (existsSync(cliPath)) {
+    return run(process.execPath, [cliPath, ...args], env);
+  }
+  return run("pi-webui", args, env);
+}
+
+function showResult(ctx: { ui: { notify(message: string, type?: "info" | "warning" | "error" | "success"): void } }, title: string, result: { code: number; output: string }): void {
+  const body = truncateOutput(result.output) || (result.code === 0 ? "Done." : `Command failed with exit code ${String(result.code)}.`);
+  ctx.ui.notify(`${title}\n\n${body}`, result.code === 0 ? "info" : "error");
+}
+
+function isSubcommand(value: string): value is Subcommand {
+  return subcommands.some((command) => command === value);
+}
+
+async function boundedLogs(): Promise<{ code: number; output: string }> {
+  if (process.platform === "darwin") {
+    const existingLogs = macLogPaths.filter((path) => existsSync(path));
+    if (existingLogs.length === 0) return { code: 1, output: "No PI WEBUI log files found in ~/.pi-webui/logs." };
+    return run("tail", ["-n", "100", ...existingLogs]);
+  }
+  return run("journalctl", ["--user", ...serviceNames.flatMap((serviceName) => ["-u", serviceName]), "-n", "100", "--no-pager"]);
+}
+
+export default function piWebUiExtension(pi: ExtensionAPI): void {
+  pi.registerCommand("pi-webui", {
+    description: "Manage PI WEBUI services: install, status, logs, restart, start, stop, doctor, version, open",
+    getArgumentCompletions(prefix: string): { value: string; label: string }[] | null {
+      const [first = ""] = parseArgs(prefix);
+      const items = subcommands
+        .filter((command) => command.startsWith(first))
+        .map((command) => ({ value: command, label: command }));
+      return items.length > 0 ? items : null;
+    },
+    async handler(args, ctx) {
+      const parsedArgs = parseArgs(args);
+      const subcommand = parsedArgs[0] ?? "help";
+      const rest = parsedArgs.slice(1);
+
+      if (subcommand === "help") {
+        ctx.ui.notify(`PI WEBUI commands:\n\n${subcommands.map((command) => `/pi-webui ${command}`).join("\n")}\n\nLogs are bounded to the last 100 service log lines in the Pi command. Use \`pi-webui logs\` in a shell to follow logs.`, "info");
+        return;
+      }
+
+      if (subcommand === "open") {
+        ctx.ui.notify("PI WEBUI default URL: http://127.0.0.1:8808", "info");
+        return;
+      }
+
+      if (!isSubcommand(subcommand)) {
+        ctx.ui.notify(`Unknown pi-webui command: ${subcommand}. Try /pi-webui help.`, "error");
+        return;
+      }
+
+      if (subcommand === "stop" || subcommand === "uninstall") {
+        const ok = await ctx.ui.confirm(`pi-webui ${subcommand}`, `Run pi-webui ${subcommand}?`);
+        if (!ok) return;
+      }
+
+      if (subcommand === "logs") {
+        showResult(ctx, "pi-webui logs", await boundedLogs());
+        return;
+      }
+
+      showResult(ctx, `pi-webui ${subcommand}`, await runPiWebUi([subcommand, ...rest]));
+    },
+  });
+}

package/package.json

@@ -0,0 +1,143 @@
+{
+  "name": "@hyperdreamer/pi-webui",
+  "version": "1.6.1",
+  "description": "Web UI for persistent Pi Coding Agent sessions in real workspaces.",
+  "license": "MIT",
+  "author": "Federico Jaramillo Martinez and HyperDreamer",
+  "type": "module",
+  "bin": {
+    "pi-webui": "dist/cli.js",
+    "pi-webui-server": "dist/server/index.js",
+    "pi-webui-sessiond": "dist/server/sessiond.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.testSupport.*",
+    "README.md",
+    "LICENSE",
+    "extensions",
+    "docs/plugins.md",
+    "docs/config.md",
+    "docs/assets",
+    "plugin-api.d.ts",
+    "plugin-api/unstable.d.ts"
+  ],
+  "scripts": {
+    "dev": "bash -c 'trap \"kill 0\" EXIT; npm run dev:sessiond & npm run dev:web & npm run dev:client & wait'",
+    "dev:sessiond": "tsx watch src/server/sessiond.ts",
+    "dev:web": "bash -c 'set -e; npm run build:plugins; trap \"kill 0\" EXIT; npm run dev:plugins & tsx watch src/server/index.ts & wait'",
+    "dev:server": "npm run dev:web",
+    "dev:client": "vite --host 0.0.0.0",
+    "dev:plugins": "node scripts/build-plugins.mjs --watch",
+    "build": "npm run clean && tsc -p tsconfig.build.json && npm run build:plugin-api && npm run build:plugins && vite build && chmod +x dist/cli.js dist/server/index.js dist/server/sessiond.js",
+    "build:plugin-api": "tsc -p tsconfig.plugin-api.json",
+    "build:plugins": "tsc -p tsconfig.plugins.json && node scripts/build-plugins.mjs",
+    "capture:screenshots": "node scripts/capture-screenshots.mjs",
+    "typecheck": "tsc --noEmit",
+    "typecheck:cached": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/pi-webui/typecheck.tsbuildinfo",
+    "knip": "knip",
+    "lint": "eslint \"src/**/*.ts\" \"extensions/**/*.ts\" \"pi-webui-plugins/**/*.ts\" vite.config.ts vitest.config.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "verify": "npm run typecheck && npm run lint && npm run knip && npm test",
+    "verify:staged": "node scripts/verify-staged.mjs",
+    "start": "tsx src/server/index.ts",
+    "start:sessiond": "tsx src/server/sessiond.ts",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "prepack": "npm run build",
+    "pack:dry": "npm pack --dry-run",
+    "smoke:package-install": "node scripts/smoke-package-install.mjs",
+    "prepublishOnly": "npm run verify",
+    "prepare": "node scripts/install-git-hooks.mjs",
+    "changeset": "changeset",
+    "release:version": "changeset version",
+    "changelog:status": "changeset status"
+  },
+  "dependencies": {
+    "@codemirror/commands": "^6.10.4",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-go": "^6.0.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/lang-rust": "^6.0.2",
+    "@codemirror/language": "^6.12.4",
+    "@codemirror/legacy-modes": "^6.5.3",
+    "@codemirror/state": "^6.7.1",
+    "@codemirror/view": "^6.43.6",
+    "@fastify/compress": "^9.0.0",
+    "@fastify/static": "^10.1.2",
+    "@fastify/websocket": "^11.3.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "diff": "^9.0.0",
+    "fastify": "^5.10.0",
+    "lit": "^3.3.3",
+    "marked": "^18.0.6",
+    "node-pty": "^1.1.0",
+    "typebox": "1.3.6",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@earendil-works/pi-agent-core": "^0.80.8",
+    "@earendil-works/pi-ai": "^0.80.8",
+    "@earendil-works/pi-coding-agent": "^0.80.8",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.13.3",
+    "@types/ws": "^8.18.1",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0",
+    "knip": "^6.25.0",
+    "tsx": "^4.23.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.63.0",
+    "vite": "^8.1.4",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hyperdreamer/pi-webui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hyperdreamer/pi-webui/issues"
+  },
+  "homepage": "https://pi-webui.dev/",
+  "packageManager": "npm@11.11.0",
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": ">=0.80.8 <0.81",
+    "@earendil-works/pi-ai": ">=0.80.8 <0.81",
+    "@earendil-works/pi-coding-agent": ">=0.80.8 <0.81"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-webui",
+    "pi-webui-ui",
+    "pi-webui",
+    "pi-coding-agent",
+    "pi-coding-agent-web-ui",
+    "coding-agent",
+    "ai-coding-agent",
+    "agentic-development",
+    "developer-tools",
+    "web-ui",
+    "webui",
+    "browser-ui",
+    "remote-development",
+    "persistent-sessions"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ],
+    "image": "https://raw.githubusercontent.com/hyperdreamer/pi-webui/main/docs/assets/pi-webui-banner.png"
+  }
+}

package/plugin-api/unstable.d.ts

@@ -0,0 +1 @@
+export * from "../dist/plugin-api/unstable.js";

package/plugin-api.d.ts

@@ -0,0 +1 @@
+export * from "./dist/plugin-api.js";