@37chengshan/ompweb 4.0.0 → 4.0.1

package/bin/omp-web-desktop.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * Desktop launcher for omp-web: starts the Next server with a hidden console
+ * (Windows: windowsHide on the child; macOS: no Terminal banner, designed to
+ * be launched from a double-clickable .command that hides its terminal) and
+ * opens the browser. The plain `ompweb` CLI remains the primary entry point;
+ * this is an additive convenience for app-style launches.
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { getUnsupportedNodeVersionMessage, isNodeVersionSupported } = require("./node-version");
+
+if (!isNodeVersionSupported(process.versions.node)) {
+  console.error(getUnsupportedNodeVersionMessage(process.versions.node));
+  process.exit(1);
+}
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { spawn, execFileSync } = 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 { parseLaunchOptions } = require("./omp-web-options");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { isPortAvailable } = require("./port-availability");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { wireChildProcessLifecycle } = require("./process-lifecycle");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { getBrowserUrl, isLoopbackHost } = require("./network-addresses");
+
+const pkgDir = path.join(__dirname, "..");
+const nextDir = path.join(pkgDir, ".next");
+
+let nextBin;
+try {
+  nextBin = require.resolve("next/dist/bin/next", { paths: [pkgDir] });
+} catch {
+  console.error("Could not resolve next. Is ompweb installed correctly?");
+  process.exit(1);
+}
+
+const launchOptions = parseLaunchOptions();
+if (launchOptions.help || launchOptions.version) {
+  process.exit(0);
+}
+
+// `ompweb-desktop --install`: copy the packaged OmpWeb.app template to
+// ~/Applications (macOS) so the app has a real double-clickable entry.
+if (process.argv.includes("--install")) {
+  installDesktopApp();
+  process.exit(0);
+}
+const port = launchOptions.port;
+const hostname = launchOptions.hostname;
+const password = launchOptions.password;
+if (password) process.env.OMP_WEB_PASSWORD = password;
+const passwordEnabled = typeof password === "string" && password.length > 0;
+
+if (!fs.existsSync(nextDir)) {
+  console.error("Build artifacts not found. Run `npm run build` once, or use `ompweb` for the dev flow.");
+  process.exit(1);
+}
+
+if (!isLoopbackHost(hostname) && !passwordEnabled) {
+  console.error(`Refusing to listen on ${hostname} without OMP_WEB_PASSWORD (or --password).`);
+  process.exit(1);
+}
+
+const browserUrl = getBrowserUrl(hostname, port);
+
+async function main() {
+  if (!await isPortAvailable(port, hostname)) {
+    // Already running: just surface it (a second desktop launch is a no-op).
+    console.error(`Port ${port} already in use — opening ${browserUrl}.`);
+    openBrowser();
+    process.exit(0);
+  }
+
+  const nextArgs = ["start", "-p", port, "-H", hostname];
+  // windowsHide keeps the console window off the screen on Windows; detached +
+  // stdio ignore turns the launcher into a fire-and-forget app start on macOS.
+  const child = spawn(process.execPath, [nextBin, ...nextArgs], {
+    cwd: pkgDir,
+    detached: process.platform !== "win32",
+    windowsHide: true,
+    stdio: process.platform === "win32" ? "ignore" : ["ignore", "pipe", "pipe"],
+    env: {
+      ...process.env,
+      OMP_WEB_PACKAGE_DIR: pkgDir,
+      OMP_WEB_LAUNCHER_PID: String(process.pid),
+      OMP_WEB_PORT: port,
+      OMP_WEB_HOSTNAME: hostname,
+    },
+  });
+  wireChildProcessLifecycle(child);
+
+  if (process.platform !== "win32") {
+    // Keep the child's output out of the way; only relay fatal startup errors.
+    child.stdout?.on("data", (chunk) => {
+      if (chunk.toString().includes("Error")) process.stdout.write(chunk);
+    });
+    child.stderr?.on("data", (chunk) => process.stderr.write(chunk));
+  }
+
+  let opened = false;
+  child.stdout?.on("data", (chunk) => {
+    if (!opened && chunk.toString().includes("Ready")) {
+      opened = true;
+      openBrowser();
+    }
+  });
+
+  // Fallback: open the browser shortly after spawn even if the ready banner
+  // is not detected (custom ports, log buffering).
+  setTimeout(() => {
+    if (!opened) {
+      opened = true;
+      openBrowser();
+    }
+  }, 4000);
+}
+
+function openBrowser() {
+  const isWindows = process.platform === "win32";
+  const isMac = process.platform === "darwin";
+  const openCmd = isWindows ? "explorer.exe" : isMac ? "open" : "xdg-open";
+  const opener = spawn(openCmd, [browserUrl], { stdio: "ignore", detached: true });
+  opener.on("error", () => { /* best effort */ });
+  opener.unref();
+}
+
+/** Copy the bundled OmpWeb.app to ~/Applications (macOS only). */
+function installDesktopApp() {
+  if (process.platform !== "darwin") {
+    console.error("--install creates a macOS .app; on Windows use the win-start.vbs template instead.");
+    process.exit(1);
+  }
+  const template = path.join(pkgDir, "templates", "desktop", "OmpWeb.app");
+  if (!fs.existsSync(path.join(template, "Contents", "MacOS", "ompweb-launcher"))) {
+    console.error("OmpWeb.app template not found in this package.");
+    process.exit(1);
+  }
+  const target = path.join(process.env.HOME || "", "Applications", "OmpWeb.app");
+  fs.rmSync(target, { recursive: true, force: true });
+  fs.cpSync(template, target, { recursive: true });
+  // Ad-hoc sign so macOS Gatekeeper does not quarantine the launcher.
+  try { execFileSync("codesign", ["--force", "--sign", "-", target], { stdio: "ignore" }); } catch { /* best effort */ }
+  console.log(`Installed OmpWeb.app → ${target}`);
+  console.log("Double-click it to start omp-web (or run: open " + target + ")");
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@37chengshan/ompweb",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Web UI for the oh-my-pi (omp) coding agent",
   "homepage": "https://github.com/kahme247/ompweb#readme",
   "repository": {
@@ -15,7 +15,8 @@
     "node": ">=22.19.0"
   },
   "bin": {
-    "ompweb": "bin/omp-web.js"
+    "ompweb": "bin/omp-web.js",
+    "ompweb-desktop": "bin/omp-web-desktop.js"
   },
   "files": [
     "bin",
@@ -29,7 +30,8 @@
     "!.next/**/*.map",
     "public",
     "next.config.ts",
-    "package.json"
+    "package.json",
+    "templates"
   ],
   "scripts": {
     "dev": "next dev -H 127.0.0.1 -p 30178",

package/templates/desktop/OmpWeb.app/Contents/Info.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDisplayName</key>
+	<string>OmpWeb</string>
+	<key>CFBundleExecutable</key>
+	<string>ompweb-launcher</string>
+	<key>CFBundleIconFile</key>
+	<string>OmpWeb</string>
+	<key>CFBundleIdentifier</key>
+	<string>io.github.37chengshan.ompweb</string>
+	<key>CFBundleName</key>
+	<string>OmpWeb</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>4.0.0</string>
+	<key>CFBundleVersion</key>
+	<string>4.0.0</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>12.0</string>
+	<key>NSHighResolutionCapable</key>
+	<true/>
+</dict>
+</plist>

package/templates/desktop/OmpWeb.app/Contents/MacOS/ompweb-launcher

@@ -0,0 +1,7 @@
+#!/bin/bash
+# OmpWeb desktop launcher — starts the omp-web server (hidden) and opens the browser.
+set -e
+# Hide this terminal-less launch context's window (when launched via Terminal).
+osascript -e 'tell application "Terminal" to set visible of front window to false' >/dev/null 2>&1 || true
+nohup ompweb-desktop --port 30177 >/dev/null 2>&1 &
+disown 2>/dev/null || true

package/templates/desktop/mac-start.command

@@ -0,0 +1,16 @@
+#!/bin/bash
+# macOS desktop launcher for omp-web: double-click to start without a
+# terminal window. Requires the ompweb package installed globally
+# (npm install -g @37chengshan/ompweb). The plain `ompweb` CLI is unchanged.
+set -e
+cd "$(dirname "$0")/../.."
+
+# Hide this Terminal window immediately (no black box).
+osascript -e 'tell application "Terminal" to set visible of front window to false' >/dev/null 2>&1 || true
+
+# Start the desktop launcher detached; it opens the browser itself.
+nohup ompweb-desktop --port 30177 >/dev/null 2>&1 &
+disown 2>/dev/null || true
+
+# Show a notification so the user knows the app started.
+osascript -e 'display notification "omp-web started — opening your browser" with title "omp-web"' >/dev/null 2>&1 || true

package/templates/desktop/win-start.vbs

@@ -0,0 +1,9 @@
+' Windows desktop launcher for omp-web: double-click to start without a
+' console window (WScript runs this with no visible window).
+' Requires the ompweb package installed globally (npm install -g @37chengshan/ompweb).
+' The plain `ompweb` CLI is unchanged.
+Option Explicit
+Dim shell
+Set shell = CreateObject("WScript.Shell")
+' 0 = hidden window; the desktop launcher opens the browser itself.
+shell.Run "ompweb-desktop --port 30177", 0, False

package/.next/static/G2FKm6vfWCTLf8u88ZEKD/_buildManifest.js

@@ -1 +0,0 @@
-self.__BUILD_MANIFEST={__rewrites:{afterFiles:[],beforeFiles:[],fallback:[]},__routerFilterStatic:{numItems:48,errorRate:1e-4,numBits:921,numHashes:14,bitArray:[0,1,0,0,1,0,1,0,1,1,0,0,0,1,0,0,0,1,1,0,1,1,0,1,0,0,0,0,1,1,1,0,0,1,1,0,1,0,0,1,1,0,1,0,1,0,0,0,1,1,1,0,1,0,0,1,1,0,0,1,0,0,1,1,0,0,0,1,0,1,0,1,0,0,1,1,0,1,1,1,0,0,1,0,0,1,0,1,1,1,0,0,1,0,0,1,1,0,0,1,1,1,1,0,1,0,0,1,1,1,0,0,1,0,1,1,0,0,0,1,0,0,1,1,0,0,0,1,0,0,1,1,1,1,0,0,1,1,1,0,0,0,1,0,0,1,0,1,0,1,0,0,0,0,1,0,0,1,0,0,0,0,1,1,1,0,1,1,0,1,1,0,1,1,1,0,1,1,0,1,0,1,0,0,0,0,0,0,1,0,1,1,0,1,1,0,0,1,1,1,1,0,0,0,1,1,0,1,0,0,1,1,1,0,1,0,0,1,1,1,1,1,0,1,1,0,0,0,0,0,1,1,1,0,1,1,1,0,1,1,0,1,0,1,0,0,1,0,1,1,0,1,1,1,0,0,1,0,0,1,1,0,0,1,0,1,0,1,1,1,0,1,1,0,0,0,0,0,0,1,1,1,0,1,1,1,0,0,0,0,0,1,0,1,0,1,0,1,1,0,1,0,0,0,0,1,1,0,0,1,1,1,1,0,1,0,0,1,0,1,0,0,1,1,1,1,1,0,1,1,1,1,0,0,1,1,0,1,0,0,1,1,0,0,1,1,0,1,0,1,0,1,0,0,1,0,0,1,1,0,1,0,1,1,1,1,1,0,0,0,0,0,1,0,1,1,1,0,0,1,1,1,0,0,1,0,0,1,1,1,0,1,0,1,1,0,0,0,1,1,1,1,0,1,0,1,0,1,1,0,1,1,1,1,1,0,0,1,0,0,0,1,1,1,0,1,1,1,0,1,1,0,1,1,1,0,0,1,1,1,0,0,1,1,0,0,1,0,0,1,1,0,0,0,1,1,0,1,1,0,1,0,0,0,0,1,1,1,0,0,0,0,0,1,0,1,0,1,1,1,1,1,0,1,1,0,1,1,1,1,1,0,1,1,0,1,0,0,0,1,0,1,0,1,0,1,1,0,1,1,1,0,1,1,1,1,0,1,0,0,0,1,1,1,1,0,0,1,1,0,1,1,1,0,1,0,0,0,1,0,0,1,0,1,0,0,1,0,0,0,1,0,0,1,0,0,0,0,1,1,1,0,0,0,0,1,1,1,1,0,1,1,1,0,0,1,0,1,0,1,1,1,1,1,1,1,1,0,0,0,0,1,0,1,1,0,0,1,0,0,1,0,1,1,1,1,1,0,0,0,1,1,0,0,0,0,1,0,1,1,0,0,0,0,0,0,1,1,0,0,1,0,0,1,1,0,1,1,1,0,0,0,0,1,0,1,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,1,0,0,1,0,1,1,1,0,1,1,1,0,1,1,0,1,0,1,0,0,1,0,0,1,0,1,1,1,0,1,0,0,0,1,0,0,1,0,1,1,0,1,1,1,0,1,0,1,0,0,0,1,1,1,1,1,1,0,0,0,1,0,0,1,1,0,1,1,0,0,0,1,1,1,1,1,0,1,1,0,1,1,0,1,0,0,1,1,1,0,1,1,1,1,0,1,0,1,1,1,0,1,0,1,1,1,1,1,1,0,0,0,1,1,0,0,1,0,1,1,1,0,1,0,1,1,0,0,1,1,1,0,1,0,1,1,0,1,1,1,1,0,1,0,1,0,0,1,1,1,0,0,1,0,1,0,1,1,0,1,1,1,1,1,0,1,0,0,1,1,1,0,0,1,1,0,1,0,1,0,1,0,0,0,0,0,0,1,1,0,1,1,0,1,1,1,0,1,1,1,0,1,0,0,0,0,1,0,1,1,0,0,0,0,0,1,0,0,1,0,0,1,0,1,0,0,1,0,0,1,1,1,0,0,1,1,0,0,0,1,1,1,1,1,0,1,1,1,0,1,0,0,0,1,1,0,0,1,1]},__routerFilterDynamic:{numItems:6,errorRate:1e-4,numBits:116,numHashes:14,bitArray:[1,1,0,0,0,1,0,1,1,1,1,0,1,0,1,0,0,1,1,1,0,1,1,0,1,1,0,1,0,1,1,0,0,0,1,0,0,1,0,1,1,0,0,1,1,1,0,0,0,1,0,0,1,1,0,0,0,0,1,1,1,1,1,0,0,1,1,1,1,0,0,0,0,0,1,0,0,0,1,1,1,0,1,0,0,1,0,1,0,0,0,1,0,0,1,0,0,0,1,1,1,1,1,1,0,0,1,0,1,0,0,1,1,0,0,0]},sortedPages:["/_app"]},self.__BUILD_MANIFEST_CB&&self.__BUILD_MANIFEST_CB();