laohuang 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 laoHuangCode contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# laohuang
+
+This npm package provides the `laohuang` command for
+[laoHuangCode](https://github.com/hxr223/laoHuangCode).
+
+It is a small Node.js launcher, not a second implementation of the agent. On
+first run it creates an isolated Python environment in the user cache and
+installs the bundled `laohuangcode` Python wheel. Python 3.11 or newer must
+already be available as `python3` or `python`. Third-party Python dependencies
+are downloaded by pip during this first launch.
+
+```bash
+npm install --global laohuang
+laohuang --version
+laohuang
+```
+
+The first interactive launch asks for DeepSeek or OpenAI, reads the API key
+with hidden terminal input, and then asks which model to use. No API key
+environment variable is needed.
+
+The launcher accepts two advanced environment variables:
+
+- `LAOHUANG_PYTHON`: run a specific Python executable and skip bootstrapping.
+- `LAOHUANG_CACHE_HOME`: override the launcher's cache root.
+
+See the main project README for model configuration and security details.

package/bin/laohuang.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+const { run } = require("../lib/launcher");
+
+try {
+  process.exitCode = run(process.argv.slice(2));
+} catch (error) {
+  console.error(`laohuang: ${error.message}`);
+  process.exitCode = 1;
+}

package/lib/launcher.js

@@ -0,0 +1,133 @@
+const childProcess = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const packageJson = require("../package.json");
+
+function cacheDirectory(env = process.env, version = packageJson.version) {
+  let root = env.LAOHUANG_CACHE_HOME;
+  if (!root) {
+    if (process.platform === "darwin") {
+      root = path.join(os.homedir(), "Library", "Caches", "laohuang");
+    } else {
+      root = path.join(env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache"), "laohuang");
+    }
+  }
+  return path.join(root, `python-${version}`);
+}
+
+function venvPython(venvDirectory) {
+  return path.join(venvDirectory, "bin", "python");
+}
+
+function bundledWheelPath(version = packageJson.version) {
+  return path.join(
+    __dirname,
+    "..",
+    "vendor",
+    `laohuangcode-${version}-py3-none-any.whl`,
+  );
+}
+
+function successful(result) {
+  return !result.error && result.status === 0;
+}
+
+function findHostPython(env, spawnSync) {
+  const candidates = env.LAOHUANG_BOOTSTRAP_PYTHON
+    ? [env.LAOHUANG_BOOTSTRAP_PYTHON]
+    : ["python3", "python"];
+  const versionCheck =
+    "import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)";
+
+  for (const candidate of candidates) {
+    const result = spawnSync(candidate, ["-c", versionCheck], {
+      env,
+      stdio: "ignore",
+    });
+    if (successful(result)) {
+      return candidate;
+    }
+  }
+  throw new Error("Python 3.11 or newer is required to run laohuang");
+}
+
+function runChecked(spawnSync, command, arguments_, options, description) {
+  const result = spawnSync(command, arguments_, options);
+  if (!successful(result)) {
+    if (result.error) {
+      throw new Error(`${description}: ${result.error.message}`);
+    }
+    throw new Error(`${description} (exit code ${result.status ?? "unknown"})`);
+  }
+}
+
+function ensurePythonPackage({ env, spawnSync }) {
+  const directory = cacheDirectory(env);
+  const python = venvPython(directory);
+  const readyFile = path.join(directory, ".laohuang-ready");
+  if (fs.existsSync(python) && fs.existsSync(readyFile)) {
+    return python;
+  }
+
+  fs.mkdirSync(path.dirname(directory), { recursive: true });
+  const hostPython = findHostPython(env, spawnSync);
+  if (!fs.existsSync(python)) {
+    runChecked(
+      spawnSync,
+      hostPython,
+      ["-m", "venv", directory],
+      { env, stdio: "inherit" },
+      "Could not create the laohuang Python environment",
+    );
+  }
+
+  const packageSource = env.LAOHUANG_PYTHON_PACKAGE || bundledWheelPath();
+  if (!env.LAOHUANG_PYTHON_PACKAGE && !fs.existsSync(packageSource)) {
+    throw new Error(`Bundled Python wheel is missing: ${packageSource}`);
+  }
+  runChecked(
+    spawnSync,
+    python,
+    [
+      "-m",
+      "pip",
+      "install",
+      "--disable-pip-version-check",
+      "--upgrade",
+      packageSource,
+    ],
+    { env, stdio: "inherit" },
+    `Could not install ${packageSource}`,
+  );
+  fs.writeFileSync(readyFile, `${packageJson.version}\n`, { mode: 0o600 });
+  return python;
+}
+
+function run(
+  arguments_,
+  {
+    env = process.env,
+    spawnSync = childProcess.spawnSync,
+  } = {},
+) {
+  const python = env.LAOHUANG_PYTHON || ensurePythonPackage({ env, spawnSync });
+  const result = spawnSync(
+    python,
+    ["-m", "laohuangcode", ...arguments_],
+    { env, stdio: "inherit" },
+  );
+  if (result.error) {
+    throw new Error(`Could not start laohuang: ${result.error.message}`);
+  }
+  return result.status ?? 1;
+}
+
+module.exports = {
+  bundledWheelPath,
+  cacheDirectory,
+  ensurePythonPackage,
+  findHostPython,
+  run,
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "laohuang",
+  "version": "0.3.0",
+  "description": "Node.js launcher for the laoHuangCode coding agent",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hxr223/laoHuangCode.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/hxr223/laoHuangCode#readme",
+  "bugs": "https://github.com/hxr223/laoHuangCode/issues",
+  "type": "commonjs",
+  "bin": {
+    "laohuang": "bin/laohuang.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "vendor",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}