@vishal2612200/agentpack 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentPack 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,58 @@
+# AgentPack npm wrapper
+
+Task-aware context packing for AI coding agents.
+
+This npm package is a thin wrapper around the Python package
+[`agentpack-cli`](https://pypi.org/project/agentpack-cli/). On first run it:
+
+1. Finds Python 3.10+.
+2. Creates a per-version virtual environment under your user cache directory.
+3. Installs the matching PyPI package version.
+4. Proxies all arguments to the real `agentpack` CLI.
+
+```bash
+npm install -g @vishal2612200/agentpack
+agentpack quickstart --task "fix auth token expiry"
+```
+
+## Requirements
+
+- Node.js 18+
+- Python 3.10+
+- macOS or Linux
+
+Windows is not supported by AgentPack yet. Use WSL or install the Python package
+directly inside a Linux environment.
+
+## Python selection
+
+By default, the wrapper tries `python3` and then `python`. To force a specific
+interpreter:
+
+```bash
+AGENTPACK_PYTHON=/opt/homebrew/bin/python3 agentpack --version
+```
+
+## Cache location
+
+The wrapper installs the Python CLI under:
+
+```text
+$XDG_CACHE_HOME/agentpack-npm/<version>/
+```
+
+or, if `XDG_CACHE_HOME` is unset:
+
+```text
+~/.cache/agentpack-npm/<version>/
+```
+
+Override with:
+
+```bash
+AGENTPACK_NPM_CACHE_DIR=/tmp/agentpack-cache agentpack --version
+```
+
+## Upstream
+
+Full docs: <https://github.com/vishal2612200/agentpack>

package/bin/agentpack.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const PACKAGE_VERSION = "0.2.2";
+const PYPI_PACKAGE = `agentpack-cli==${PACKAGE_VERSION}`;
+
+function compareVersions(left, right) {
+  const a = String(left).split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const b = String(right).split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const length = Math.max(a.length, b.length);
+  for (let i = 0; i < length; i += 1) {
+    const delta = (a[i] || 0) - (b[i] || 0);
+    if (delta !== 0) {
+      return delta;
+    }
+  }
+  return 0;
+}
+
+function run(command, args, options = {}) {
+  return spawnSync(command, args, {
+    encoding: "utf8",
+    ...options,
+  });
+}
+
+function fail(message, code = 1) {
+  console.error(`agentpack npm wrapper: ${message}`);
+  process.exit(code);
+}
+
+function pythonVersion(python) {
+  const result = run(python, [
+    "-c",
+    "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')",
+  ]);
+  if (result.status !== 0) {
+    return null;
+  }
+  return result.stdout.trim();
+}
+
+function findPython() {
+  const candidates = [
+    process.env.AGENTPACK_PYTHON,
+    "python3",
+    "python",
+  ].filter(Boolean);
+
+  for (const candidate of candidates) {
+    const version = pythonVersion(candidate);
+    if (version && compareVersions(version, "3.10") >= 0) {
+      return { command: candidate, version };
+    }
+  }
+  return null;
+}
+
+function cacheRoot() {
+  if (process.env.AGENTPACK_NPM_CACHE_DIR) {
+    return process.env.AGENTPACK_NPM_CACHE_DIR;
+  }
+  const base = process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
+  return path.join(base, "agentpack-npm", PACKAGE_VERSION);
+}
+
+function venvPaths(root) {
+  const venv = path.join(root, "venv");
+  const bin = process.platform === "win32" ? path.join(venv, "Scripts") : path.join(venv, "bin");
+  return {
+    venv,
+    python: process.platform === "win32" ? path.join(bin, "python.exe") : path.join(bin, "python"),
+    agentpack: process.platform === "win32" ? path.join(bin, "agentpack.exe") : path.join(bin, "agentpack"),
+    marker: path.join(root, "agentpack-cli-version.txt"),
+  };
+}
+
+function ensureSupportedPlatform() {
+  if (process.platform === "win32") {
+    fail("Windows is not supported yet. Please use macOS/Linux or install agentpack-cli directly in WSL.");
+  }
+}
+
+function installOrUpdateVenv(systemPython, paths) {
+  const marker = fs.existsSync(paths.marker) ? fs.readFileSync(paths.marker, "utf8").trim() : "";
+  if (marker === PACKAGE_VERSION && fs.existsSync(paths.agentpack)) {
+    return;
+  }
+
+  fs.mkdirSync(path.dirname(paths.marker), { recursive: true });
+
+  let result = run(systemPython, ["-m", "venv", paths.venv], { stdio: "inherit" });
+  if (result.status !== 0) {
+    fail(`failed to create Python virtual environment at ${paths.venv}`);
+  }
+
+  result = run(paths.python, ["-m", "pip", "install", "--upgrade", "pip"], { stdio: "inherit" });
+  if (result.status !== 0) {
+    fail("failed to upgrade pip in the AgentPack npm wrapper environment");
+  }
+
+  result = run(paths.python, ["-m", "pip", "install", "--upgrade", PYPI_PACKAGE], { stdio: "inherit" });
+  if (result.status !== 0) {
+    fail(`failed to install ${PYPI_PACKAGE}`);
+  }
+
+  fs.writeFileSync(paths.marker, `${PACKAGE_VERSION}\n`);
+}
+
+function main(argv = process.argv.slice(2)) {
+  const root = cacheRoot();
+  const paths = venvPaths(root);
+
+  if (process.env.AGENTPACK_NPM_DRY_RUN === "1") {
+    console.log(JSON.stringify({
+      packageVersion: PACKAGE_VERSION,
+      pypiPackage: PYPI_PACKAGE,
+      cacheRoot: root,
+      venv: paths.venv,
+    }));
+    return;
+  }
+
+  ensureSupportedPlatform();
+
+  const python = findPython();
+  if (!python) {
+    fail("Python >=3.10 is required. Install Python, or set AGENTPACK_PYTHON=/path/to/python.");
+  }
+
+  installOrUpdateVenv(python.command, paths);
+
+  const result = spawnSync(paths.agentpack, argv, {
+    stdio: "inherit",
+    env: process.env,
+  });
+  if (result.error) {
+    fail(`failed to run ${paths.agentpack}: ${result.error.message}`);
+  }
+  process.exit(typeof result.status === "number" ? result.status : 1);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  PACKAGE_VERSION,
+  PYPI_PACKAGE,
+  cacheRoot,
+  compareVersions,
+  findPython,
+  pythonVersion,
+  venvPaths,
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@vishal2612200/agentpack",
+  "version": "0.2.2",
+  "description": "Task-aware context packing for AI coding agents. npm wrapper for the Python AgentPack CLI.",
+  "license": "MIT",
+  "homepage": "https://github.com/vishal2612200/agentpack#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vishal2612200/agentpack.git",
+    "directory": "npm"
+  },
+  "bugs": {
+    "url": "https://github.com/vishal2612200/agentpack/issues"
+  },
+  "bin": {
+    "agentpack": "bin/agentpack.js"
+  },
+  "files": [
+    "bin/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "prepack": "node test/version-sync.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "claude",
+    "codex",
+    "context",
+    "cursor",
+    "antigravity",
+    "llm",
+    "packing",
+    "windsurf"
+  ]
+}