@agentistics/agentop 1.22.2

package/README.md

@@ -0,0 +1,41 @@
+# @agentistics/agentop
+
+npm install for the `agentop` CLI — the same native binary published on
+[GitHub Releases](https://github.com/blpsoares/agentistics/releases) and
+installed by the project's `curl | bash` script. This package is only an
+**additional** install channel; it downloads and runs the identical binary,
+never a JS reimplementation.
+
+## Install
+
+```bash
+npm i -g @agentistics/agentop
+```
+
+`postinstall` downloads the `agentop` binary matching this package's own
+version from the corresponding GitHub Release and makes it executable.
+
+## Supported platforms
+
+Linux x86_64 only, same as the current GitHub Release. Installing on any
+other platform fails during `postinstall` with a clear error instead of
+leaving a broken binary in place.
+
+## Usage
+
+```bash
+agentop server       # web dashboard + daemon
+agentop tui           # terminal TUI
+agentop watch         # daemon only
+```
+
+See the [main README](https://github.com/blpsoares/agentistics#readme) for
+full CLI documentation.
+
+## Alternative install
+
+```bash
+curl -fsSL https://agentop.openvibes.tech/cli | bash
+```
+
+Both methods install the exact same binary.

package/bin/agentop.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Thin exec shim — the real CLI is the native binary postinstall.js downloaded
+// alongside this file. This wrapper exists only because npm's `bin` field
+// needs a file it can chmod +x and put on PATH; it does not reimplement or
+// rebundle any agentop behavior.
+'use strict';
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const BIN_PATH = path.join(__dirname, 'agentop-bin');
+
+if (!fs.existsSync(BIN_PATH)) {
+  console.error(
+    'agentop binary not found — the npm postinstall step did not complete. Try reinstalling: npm i -g @agentistics/agentop'
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(BIN_PATH, process.argv.slice(2), { stdio: 'inherit' });
+
+if (result.error) {
+  console.error(`Failed to launch agentop: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@agentistics/agentop",
+  "version": "1.22.2",
+  "description": "agentop CLI — npm install for the same native binary distributed via install.sh (Linux x86_64 only)",
+  "type": "commonjs",
+  "bin": {
+    "agentop": "bin/agentop.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "!scripts/*.test.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "bun test scripts/platform.test.js"
+  },
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "cli",
+    "claude",
+    "claude-code",
+    "analytics",
+    "agentistics",
+    "agentop"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blpsoares/agentistics.git",
+    "directory": "packages/agentop"
+  },
+  "homepage": "https://github.com/blpsoares/agentistics"
+}

package/scripts/platform.js

@@ -0,0 +1,62 @@
+// Pure platform resolution for the @agentistics/agentop npm postinstall.
+//
+// Mirrors the gate in /install.sh (Linux x86_64 only, same error message shape).
+// install.sh cannot be sourced from here — it is fetched standalone via
+// `curl | bash` with no local checkout at run time — so this check is kept in
+// sync by hand. See CLAUDE.md's PKG_FILES comment in release.yml for the same
+// documented trade-off (two things that must agree, checked nowhere but here).
+
+const REPO = 'blpsoares/agentistics';
+const BINARY = 'agentop';
+
+// node's process.platform/process.arch -> the `uname -s` / `uname -m` strings
+// install.sh's error messages are phrased in terms of, so a Node-side failure
+// reads the same way as a curl|bash one.
+const OS_NAMES = {
+  linux: 'Linux',
+  darwin: 'Darwin',
+  win32: 'Windows',
+};
+
+const ARCH_NAMES = {
+  x64: 'x86_64',
+  arm64: 'arm64',
+  ia32: 'x86',
+};
+
+function displayOs(platform) {
+  return OS_NAMES[platform] || platform;
+}
+
+function displayArch(arch) {
+  return ARCH_NAMES[arch] || arch;
+}
+
+/**
+ * @param {string} platform - process.platform value
+ * @param {string} arch - process.arch value
+ * @param {string} version - the npm package's own version (no leading "v")
+ * @returns {{ok: true, url: string} | {ok: false, message: string}}
+ */
+function resolveAsset(platform, arch, version) {
+  if (platform !== 'linux') {
+    return {
+      ok: false,
+      message: `Error: only Linux binaries are published at the moment (detected: ${displayOs(platform)}).`,
+    };
+  }
+
+  if (arch !== 'x64') {
+    return {
+      ok: false,
+      message: `Error: only x86_64 binaries are published at the moment (detected: ${displayArch(arch)}).`,
+    };
+  }
+
+  return {
+    ok: true,
+    url: `https://github.com/${REPO}/releases/download/v${version}/${BINARY}`,
+  };
+}
+
+module.exports = { resolveAsset, REPO, BINARY };

package/scripts/postinstall.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+// Downloads the native `agentop` binary this npm package's own version was
+// released with, from the same GitHub Release install.sh downloads from —
+// npm is an ADDITIONAL install channel for the identical binary, never a
+// separate build. Unlike install.sh (which always grabs the rolling
+// `latest` release), this fetches the VERSION-TAGGED asset — an `npm i
+// @agentistics/agentop@1.20.0` must download the 1.20.0 binary, not
+// whatever happens to be newest on GitHub.
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { resolveAsset } = require('./platform.js');
+
+const pkg = require('../package.json');
+
+const BIN_DIR = path.join(__dirname, '..', 'bin');
+const BIN_PATH = path.join(BIN_DIR, 'agentop-bin');
+const MAX_REDIRECTS = 5;
+
+function download(url, destPath, redirectsLeft) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { 'User-Agent': '@agentistics/agentop-postinstall' } }, (res) => {
+        const { statusCode, headers } = res;
+
+        if (statusCode >= 300 && statusCode < 400 && headers.location) {
+          res.resume();
+          if (redirectsLeft <= 0) {
+            reject(new Error('Too many redirects while downloading the agentop binary.'));
+            return;
+          }
+          download(headers.location, destPath, redirectsLeft - 1).then(resolve, reject);
+          return;
+        }
+
+        if (statusCode !== 200) {
+          res.resume();
+          reject(new Error(`Download failed: HTTP ${statusCode} for ${url}`));
+          return;
+        }
+
+        const file = fs.createWriteStream(destPath, { mode: 0o755 });
+        res.pipe(file);
+        file.on('finish', () => file.close(resolve));
+        file.on('error', reject);
+      })
+      .on('error', reject);
+  });
+}
+
+async function main() {
+  const asset = resolveAsset(process.platform, process.arch, pkg.version);
+
+  if (!asset.ok) {
+    console.error(asset.message);
+    console.error(
+      'The agentop CLI is not available for this platform via npm. See https://github.com/blpsoares/agentistics for other install options.'
+    );
+    process.exit(1);
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+  console.log(`Downloading agentop from ${asset.url} ...`);
+  await download(asset.url, BIN_PATH, MAX_REDIRECTS);
+  fs.chmodSync(BIN_PATH, 0o755);
+  console.log(`Installed: ${BIN_PATH}`);
+}
+
+main().catch((err) => {
+  console.error(`Failed to install the agentop binary: ${err.message}`);
+  process.exit(1);
+});