nunmai 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# nunmai
+
+Install [Nunmai Engine](https://nunmai.in) with npm — everything included.
+
+```bash
+npm install -g nunmai
+nunmai
+```
+
+`npm install` runs the official installer (https://nunmai-engine.nunmai.in) in
+**full, non-interactive** mode: the engine, Python, git, Node.js, browser and
+computer-use tools are all provisioned automatically into Nunmai's own
+directories — your system toolchain is never modified. Then `nunmai` starts the
+engine; the first run opens the AI-account wizard (Claude, ChatGPT, Kimi,
+Gemini, OpenRouter).
+
+- macOS, Linux, Windows 10/11 (PowerShell), Android (Termux). `npx nunmai` works too.
+- If npm ran with `--ignore-scripts` (or `CI` is set), the install happens on the
+  first `nunmai` run instead.
+- Lightweight install (no browser/computer-use): `NUNMAI_INSTALL_LITE=1 npm i -g nunmai`.
+- Extra installer flags: `NUNMAI_INSTALL_ARGS="--branch dev" npm i -g nunmai`.
+- Updates: `nunmai update`. Remove: `nunmai uninstall`, then `npm uninstall -g nunmai`.
+
+This package only contains the launcher; the engine's source lives at
+https://github.com/Nunmai-Private-Limited/nunmai-engine.

package/bin/nunmai.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+"use strict";
+/*
+ * npm bootstrap for Nunmai Engine.
+ *
+ * Nunmai Engine is a Python application (managed by uv), so this package is a
+ * small launcher around the official installer (https://nunmai-engine.nunmai.in):
+ *
+ *   npm install -g nunmai   -> postinstall runs the FULL, non-interactive install
+ *                              (engine, Python, git, Node, browser + computer-use
+ *                              tools). Nothing on the system is modified — every
+ *                              dependency is provisioned into Nunmai's own dirs.
+ *   nunmai                  -> launches the installed engine (first run opens the
+ *                              AI-account wizard). If the engine is missing (e.g.
+ *                              npm ran with --ignore-scripts), it installs first.
+ *
+ *   NUNMAI_HOME                  respected (Windows launchers: %NUNMAI_HOME%\bin)
+ *   NUNMAI_INSTALL_LITE=1        lightweight install instead of --full
+ *   NUNMAI_INSTALL_ARGS="..."    extra installer flags (appended)
+ *   NUNMAI_NPM_NO_POSTINSTALL=1  skip the install at `npm install` time
+ *   NUNMAI_BOOTSTRAP_DRY_RUN=1   print what would run instead of installing
+ */
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const INSTALL_SH = "https://nunmai-engine.nunmai.in/install.sh";
+const INSTALL_PS1 = "https://nunmai-engine.nunmai.in/install.ps1";
+const IS_WIN = process.platform === "win32";
+const SELF = fs.realpathSync(__filename);
+const DRY = process.env.NUNMAI_BOOTSTRAP_DRY_RUN === "1";
+
+function candidates() {
+  const home = os.homedir();
+  if (IS_WIN) {
+    const nunmaiHome = process.env.NUNMAI_HOME || path.join(process.env.LOCALAPPDATA || path.join(home, "AppData", "Local"), "nunmai");
+    const bin = path.join(nunmaiHome, "bin");
+    return [path.join(bin, "nunmai.exe"), path.join(bin, "nunmai.cmd")];
+  }
+  const list = [];
+  if (process.env.PREFIX && fs.existsSync(path.join(process.env.PREFIX, "bin"))) {
+    list.push(path.join(process.env.PREFIX, "bin", "nunmai")); // Termux
+  }
+  list.push(path.join(home, ".local", "bin", "nunmai"), "/usr/local/bin/nunmai");
+  return list;
+}
+
+function findLauncher() {
+  for (const p of candidates()) {
+    try {
+      if (fs.realpathSync(p) === SELF) continue; // never recurse into this shim
+      fs.accessSync(p, fs.constants.X_OK);
+      return p;
+    } catch (_) { /* not there */ }
+  }
+  return null;
+}
+
+function run(cmd, args, opts) {
+  const env = Object.assign({}, process.env, { NUNMAI_NPM_SHIM: "1" });
+  const r = spawnSync(cmd, args, Object.assign({ stdio: "inherit", env }, opts || {}));
+  if (r.error) {
+    console.error(`nunmai: could not start ${cmd}: ${r.error.message}`);
+    return 127;
+  }
+  return r.status == null ? 1 : r.status;
+}
+
+function installerFlags(nonInteractive) {
+  const flags = [];
+  if (process.env.NUNMAI_INSTALL_LITE !== "1") flags.push(IS_WIN ? "-Full" : "--full");
+  if (nonInteractive) flags.push(IS_WIN ? "-NonInteractive" : "--non-interactive", IS_WIN ? "-SkipSetup" : "--skip-setup");
+  const extra = (process.env.NUNMAI_INSTALL_ARGS || "").trim();
+  if (extra) flags.push(extra);
+  return flags.join(" ");
+}
+
+function install(nonInteractive) {
+  const flags = installerFlags(nonInteractive);
+  let cmd, args, shown;
+  if (IS_WIN) {
+    const ps = `& ([scriptblock]::Create((irm ${INSTALL_PS1}))) ${flags}`.trim();
+    cmd = "powershell";
+    args = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", ps];
+    shown = `powershell -NoProfile -ExecutionPolicy Bypass -Command "${ps}"`;
+  } else {
+    const sh = `curl -fsSL ${INSTALL_SH} | bash -s -- ${flags}`.trim();
+    cmd = "bash";
+    args = ["-c", sh];
+    shown = sh;
+  }
+  console.log(nonInteractive
+    ? "Installing Nunmai Engine and all of its dependencies (this can take a few minutes)…"
+    : "Nunmai Engine is not installed on this machine yet — installing it now.");
+  console.log(`  ${shown}\n`);
+  if (DRY) return 0;
+  return run(cmd, args);
+}
+
+function manualHint() {
+  return IS_WIN ? `  irm ${INSTALL_PS1} | iex` : `  curl -fsSL ${INSTALL_SH} | bash`;
+}
+
+function postinstall() {
+  // Runs from `npm install -g nunmai`. Must never fail the npm install: on any
+  // problem we exit 0 and the first `nunmai` run retries interactively.
+  if (process.env.NUNMAI_NPM_NO_POSTINSTALL === "1" || process.env.CI) {
+    console.log("nunmai: engine install deferred to first run.");
+    return 0;
+  }
+  if (findLauncher()) {
+    console.log("nunmai: engine already installed — run `nunmai` to start.");
+    return 0;
+  }
+  const code = install(true);
+  if (code !== 0) {
+    console.error(`\nnunmai: installer exited with code ${code}. Run \`nunmai\` to retry, or install manually:\n${manualHint()}`);
+    return 0;
+  }
+  console.log("\n✓ Nunmai Engine installed. Open a new terminal and run:  nunmai");
+  return 0;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv[0] === "--bootstrap-postinstall") process.exit(postinstall());
+
+  let launcher = findLauncher();
+  if (!launcher) {
+    const code = install(false);
+    if (code !== 0) {
+      console.error(`\nnunmai: installer exited with code ${code}. You can retry it manually:\n${manualHint()}`);
+      process.exit(code);
+    }
+    if (DRY) process.exit(0);
+    launcher = findLauncher();
+    if (!launcher) {
+      console.error("nunmai: install finished but the launcher was not found. Open a new terminal and run `nunmai`.");
+      process.exit(1);
+    }
+    if (argv.length === 0) console.log("\nInstalled. Starting Nunmai Engine…\n");
+  }
+  process.exit(run(launcher, argv, IS_WIN && launcher.endsWith(".cmd") ? { shell: true } : {}));
+}
+
+main();

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "nunmai",
+  "version": "0.1.0",
+  "description": "Nunmai Engine — `npm i -g nunmai` installs the engine with all features and dependencies; run `nunmai` to start.",
+  "license": "MIT",
+  "homepage": "https://nunmai.in",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nunmai-Private-Limited/nunmai-engine.git",
+    "directory": "deploy/npm-bootstrap"
+  },
+  "bugs": "https://github.com/Nunmai-Private-Limited/nunmai-engine/issues",
+  "keywords": [
+    "nunmai",
+    "ai",
+    "agent",
+    "assistant",
+    "cli",
+    "claude",
+    "chatgpt",
+    "gemini",
+    "whatsapp",
+    "telegram"
+  ],
+  "bin": {
+    "nunmai": "bin/nunmai.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32",
+    "android"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "postinstall": "node bin/nunmai.js --bootstrap-postinstall"
+  }
+}