agent-toolkit-cli 1.10.0

package/README.md

@@ -0,0 +1,14 @@
+# agent-toolkit-cli (npm)
+
+Thin Node launcher for the **native V** `agent-toolkit` binary. Same product name as PyPI: **`agent-toolkit-cli`**.
+
+```bash
+npm install -g agent-toolkit-cli
+agent-toolkit --help
+```
+
+The installer pulls a platform package via `optionalDependencies` (`agent-toolkit-cli-<os>-<cpu>`). Those packages contain GitHub Release V binaries (ADR-018 / ADR-025), not a second CLI.
+
+Dev override: `AGENT_TOOLKIT_BIN=/path/to/agent-toolkit`.
+
+Publish: GitHub Actions OIDC trusted publishing (`.github/workflows/publish-npm.yml`). No long-lived `NPM_TOKEN`.

package/bin/agent-toolkit.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * Thin npm launcher — spawn the bundled V binary (ADR-025 / #536).
+ * No JS business logic. Product commands agent-toolkit and agent-toolkit-cli
+ * hand off to the native binary (same product as PyPI).
+ */
+
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const PLATFORMS = require("../platforms.json");
+const EXIT_MISSING = 127;
+
+function platformSpec() {
+  const osName = process.platform;
+  const cpu = process.arch === "ia32" ? "ia32" : process.arch;
+  return PLATFORMS.find((p) => p.os === osName && p.cpu === cpu) || null;
+}
+
+function resolveNativeBin() {
+  const env = (process.env.AGENT_TOOLKIT_BIN || "").trim();
+  if (env) {
+    return fs.existsSync(env) ? env : null;
+  }
+  const spec = platformSpec();
+  if (spec) {
+    try {
+      const pkgDir = path.dirname(require.resolve(`${spec.npm}/package.json`));
+      const cand = path.join(pkgDir, "bin", spec.bin);
+      if (fs.existsSync(cand)) {
+        return cand;
+      }
+    } catch {
+      // optionalDependency not installed for this platform
+    }
+  }
+  const root = (process.env.AGENT_TOOLKIT_ROOT || "").trim();
+  if (root) {
+    const names =
+      process.platform === "win32"
+        ? ["build/agent-toolkit.exe", "build/agent-toolkit"]
+        : ["build/agent-toolkit", "build/agent-toolkit-v"];
+    for (const rel of names) {
+      const cand = path.join(root, rel);
+      if (fs.existsSync(cand)) {
+        return cand;
+      }
+    }
+  }
+  return null;
+}
+
+function missingBinaryMessage() {
+  return [
+    "agent-toolkit: native V binary not found (ADR-025).",
+    "  npm optionalDependencies should install agent-toolkit-cli-<os>-<cpu>.",
+    "  Dev: make build-cli, or set AGENT_TOOLKIT_BIN to that executable.",
+    "",
+  ].join("\n");
+}
+
+function runNative(binPath, argv) {
+  const child = spawn(binPath, argv, {
+    stdio: "inherit",
+    windowsHide: true,
+  });
+  const forward = (signal) => {
+    if (child.killed) {
+      return;
+    }
+    try {
+      child.kill(signal);
+    } catch {
+      /* child already gone */
+    }
+  };
+  process.on("SIGINT", () => forward("SIGINT"));
+  process.on("SIGTERM", () => forward("SIGTERM"));
+  child.on("error", (err) => {
+    process.stderr.write(`agent-toolkit: failed to spawn native binary: ${err.message}\n`);
+    process.exit(EXIT_MISSING);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.exit(1);
+    }
+    process.exit(code == null ? 1 : code);
+  });
+}
+
+function main(argv) {
+  const rest = argv.slice(2);
+  const binPath = resolveNativeBin();
+  if (!binPath) {
+    process.stderr.write(missingBinaryMessage());
+    process.exit(EXIT_MISSING);
+  }
+  runNative(binPath, rest);
+}
+
+module.exports = { platformSpec, resolveNativeBin, missingBinaryMessage, EXIT_MISSING };
+
+if (require.main === module) {
+  main(process.argv);
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "agent-toolkit-cli",
+  "version": "1.10.0",
+  "description": "Thin Node launcher for the agent-toolkit native V CLI (same product as PyPI)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ulises-jeremias/agent-toolkit.git",
+    "directory": "packages/npm/agent-toolkit-cli"
+  },
+  "homepage": "https://github.com/ulises-jeremias/agent-toolkit",
+  "bugs": {
+    "url": "https://github.com/ulises-jeremias/agent-toolkit/issues"
+  },
+  "bin": {
+    "agent-toolkit": "bin/agent-toolkit.js",
+    "agent-toolkit-cli": "bin/agent-toolkit.js"
+  },
+  "files": [
+    "bin/",
+    "platforms.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/launcher.test.js"
+  },
+  "optionalDependencies": {
+    "agent-toolkit-cli-linux-x64": "1.10.0",
+    "agent-toolkit-cli-linux-arm64": "1.10.0",
+    "agent-toolkit-cli-darwin-arm64": "1.10.0",
+    "agent-toolkit-cli-darwin-x64": "1.10.0",
+    "agent-toolkit-cli-win32-x64": "1.10.0"
+  },
+  "keywords": [
+    "agent-toolkit",
+    "cli",
+    "ai-agents"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/platforms.json

@@ -0,0 +1,39 @@
+[
+  {
+    "npm": "agent-toolkit-cli-linux-x64",
+    "os": "linux",
+    "cpu": "x64",
+    "libc": "glibc",
+    "floating": "agent-toolkit-linux-x86_64",
+    "bin": "agent-toolkit"
+  },
+  {
+    "npm": "agent-toolkit-cli-linux-arm64",
+    "os": "linux",
+    "cpu": "arm64",
+    "libc": "glibc",
+    "floating": "agent-toolkit-linux-arm64",
+    "bin": "agent-toolkit"
+  },
+  {
+    "npm": "agent-toolkit-cli-darwin-arm64",
+    "os": "darwin",
+    "cpu": "arm64",
+    "floating": "agent-toolkit-macos-arm64",
+    "bin": "agent-toolkit"
+  },
+  {
+    "npm": "agent-toolkit-cli-darwin-x64",
+    "os": "darwin",
+    "cpu": "x64",
+    "floating": "agent-toolkit-macos-x86_64",
+    "bin": "agent-toolkit"
+  },
+  {
+    "npm": "agent-toolkit-cli-win32-x64",
+    "os": "win32",
+    "cpu": "x64",
+    "floating": "agent-toolkit-windows-x86_64.exe",
+    "bin": "agent-toolkit.exe"
+  }
+]