@progmruansilva/omp-web 1.202608.0

package/extensions/omp-web.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 "@oh-my-pi/pi-coding-agent";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const cliPath = join(packageRoot, "dist", "cli.js");
+const serviceNames = ["omp-web-sessiond.service", "omp-web.service", "omp-web-ui-dev.service"];
+const macLogPaths = ["sessiond.log", "web.log", "ui-dev.log"].map((name) => join(homedir(), ".omp-web", "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 runOmpWeb(args: string[], env: NodeJS.ProcessEnv = {}): Promise<{ code: number; output: string }> {
+  if (existsSync(cliPath)) {
+    return run(process.execPath, [cliPath, ...args], env);
+  }
+  return run("omp-web", 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 WEB log files found in ~/.omp-web/logs." };
+    return run("tail", ["-n", "100", ...existingLogs]);
+  }
+  return run("journalctl", ["--user", ...serviceNames.flatMap((serviceName) => ["-u", serviceName]), "-n", "100", "--no-pager"]);
+}
+
+export default function ompWebExtension(pi: ExtensionAPI): void {
+  pi.registerCommand("omp-web", {
+    description: "Manage PI WEB 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 WEB commands:\n\n${subcommands.map((command) => `/omp-web ${command}`).join("\n")}\n\nLogs are bounded to the last 100 service log lines in the Pi command. Use \`omp-web logs\` in a shell to follow logs.`, "info");
+        return;
+      }
+
+      if (subcommand === "open") {
+        ctx.ui.notify("PI WEB default URL: http://127.0.0.1:8504", "info");
+        return;
+      }
+
+      if (!isSubcommand(subcommand)) {
+        ctx.ui.notify(`Unknown omp-web command: ${subcommand}. Try /omp-web help.`, "error");
+        return;
+      }
+
+      if (subcommand === "stop" || subcommand === "uninstall") {
+        const ok = await ctx.ui.confirm(`omp-web ${subcommand}`, `Run omp-web ${subcommand}?`);
+        if (!ok) return;
+      }
+
+      if (subcommand === "logs") {
+        showResult(ctx, "omp-web logs", await boundedLogs());
+        return;
+      }
+
+      showResult(ctx, `omp-web ${subcommand}`, await runOmpWeb([subcommand, ...rest]));
+    },
+  });
+}

package/install.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+set -eu
+
+bun add -g @progmruansilva/omp-web
+omp-web install

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@progmruansilva/omp-web",
+  "version": "1.202608.0",
+  "description": "Web UI for Oh My Pi Coding Agent",
+  "license": "MIT",
+  "author": "ProgmRuanSilva",
+  "type": "module",
+  "bin": {
+    "omp-web": "dist/cli.js",
+    "omp-web-server": "dist/server/index.js",
+    "omp-web-sessiond": "dist/server/sessiond.js"
+  },
+  "files": [
+    "dist",
+    "install.sh",
+    "README.md",
+    "LICENSE",
+    "extensions",
+    "docs/plugins.md",
+    "docs/config.md",
+    "docs/assets",
+    "plugin-api.d.ts",
+    "plugin-api/unstable.d.ts"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "dev": "bash -c 'trap \"kill 0\" EXIT; bun run dev:sessiond & bun run dev:web & bun run dev:client & wait'",
+    "dev:sessiond": "bun --watch src/server/sessiond.ts",
+    "dev:web": "bash -c 'set -e; bun run build:plugins; trap \"kill 0\" EXIT; bun run dev:plugins & bun --watch src/server/index.ts & wait'",
+    "dev:server": "bun run dev:web",
+    "dev:client": "vite --host 0.0.0.0",
+    "dev:plugins": "bun scripts/build-plugins.mjs --watch",
+    "build": "tsc -p tsconfig.build.json && bun run build:plugin-api && bun run build:plugins && vite build",
+    "build:plugin-api": "tsc -p tsconfig.plugin-api.json",
+    "build:plugins": "tsc -p tsconfig.plugins.json && bun scripts/build-plugins.mjs",
+    "capture:screenshots": "bun scripts/capture-screenshots.mjs",
+    "start": "bun src/server/index.ts",
+    "start:sessiond": "bun src/server/sessiond.ts",
+    "lint": "eslint \"src/**/*.ts\" \"extensions/**/*.ts\" \"omp-web-plugins/**/*.ts\" vite.config.ts vitest.config.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "verify": "bun run typecheck && bun run lint && bun run knip",
+    "clean": "rm -rf dist",
+    "prepack": "bun run build",
+    "pack:dry": "bun pm pack --dry-run",
+    "prepublishOnly": "bun run verify",
+    "publish:npm": "npm publish --access public",
+    "prepare": "bun scripts/install-git-hooks.mjs"
+  },
+  "dependencies": {
+    "@codemirror/commands": "^6.10.3",
+    "@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.3",
+    "@codemirror/legacy-modes": "^6.5.2",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.42.1",
+    "@fastify/static": "^9.1.3",
+    "@fastify/websocket": "^11.2.0",
+    "@oh-my-pi/pi-catalog": "^16.3.6",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "bun-pty": "^0.4.10",
+    "croner": "^10.0.1",
+    "diff": "^8.0.4",
+    "fastify": "^5.6.1",
+    "lit": "^3.3.1",
+    "marked": "^18.0.3",
+    "nanoid": "^5.0.0",
+    "node-pty": "^1.1.0",
+    "web-push": "^3.6.7",
+    "ws": "^8.20.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@oh-my-pi/pi-agent-core": "^16.3.6",
+    "@oh-my-pi/pi-ai": "^16.3.6",
+    "@oh-my-pi/pi-coding-agent": "^16.3.6",
+    "@types/node": "^24.10.1",
+    "@types/web-push": "^3.6.4",
+    "@types/ws": "^8.18.1",
+    "@vitejs/plugin-react": "^6.0.5",
+    "eslint": "^10.3.0",
+    "globals": "^17.6.0",
+    "knip": "^6.16.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.2",
+    "vite": "^7.2.4",
+    "vitest": "^4.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theruansilva/omp-web.git"
+  },
+  "bugs": {
+    "url": "https://github.com/theruansilva/omp-web/issues"
+  },
+  "homepage": "https://omp-web.dev/",
+  "packageManager": "bun@1.3.14",
+  "peerDependencies": {
+    "@oh-my-pi/pi-agent-core": ">=16.3.6 <17",
+    "@oh-my-pi/pi-ai": ">=16.3.6 <17",
+    "@oh-my-pi/pi-coding-agent": ">=16.3.6 <17"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "omp-web",
+    "omp-web-ui",
+    "omp-webui",
+    "omp-coding-agent",
+    "omp-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/ProgmRuanSilva/omp-web/main/docs/assets/omp-web-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";