@devboy-tools/agent-usage 0.1.0

package/bin/agent-usage.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { spawn } = require("child_process");
+const { getBinaryPath } = require("../index");
+
+let binaryPath;
+try {
+  binaryPath = getBinaryPath();
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  if (err.code === "ENOENT") {
+    console.error(
+      `devboy-agent-usage binary not found at: ${binaryPath}\n` +
+        "Run 'npm rebuild @devboy-tools/agent-usage' or set DEVBOY_AGENT_USAGE_BINARY_PATH.",
+    );
+  } else {
+    console.error(`Failed to start devboy-agent-usage: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});
+
+// Forward signals to child process
+for (const sig of ["SIGINT", "SIGTERM"]) {
+  process.on(sig, () => {
+    if (!child.killed) {
+      child.kill(sig);
+    }
+  });
+}

package/index.d.ts

@@ -0,0 +1,3 @@
+export declare function getBinaryPath(): string;
+export declare const name: string;
+export declare const version: string;

package/index.js

@@ -0,0 +1,54 @@
+"use strict";
+
+const path = require("path");
+const fs = require("fs");
+
+const pkg = require("./package.json");
+
+exports.name = pkg.name;
+exports.version = pkg.version;
+
+/**
+ * Resolves the path to the devboy-agent-usage binary.
+ *
+ * Resolution order:
+ * 1. DEVBOY_AGENT_USAGE_BINARY_PATH environment variable
+ * 2. Platform-specific npm package
+ *
+ * @returns {string} Absolute path to the binary
+ * @throws {Error} If binary cannot be found
+ */
+exports.getBinaryPath = function getBinaryPath() {
+  // 1. Check environment variable override
+  const envPath = process.env.DEVBOY_AGENT_USAGE_BINARY_PATH;
+  if (envPath) {
+    if (!fs.existsSync(envPath)) {
+      throw new Error(
+        `DEVBOY_AGENT_USAGE_BINARY_PATH is set to "${envPath}" but file does not exist.`,
+      );
+    }
+    return path.resolve(envPath);
+  }
+
+  // 2. Resolve from platform-specific package
+  const platformPkg = `@devboy-tools/agent-usage-${process.platform}-${process.arch}`;
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const binaryName = `devboy-agent-usage${ext}`;
+
+  try {
+    const pkgJsonPath = require.resolve(`${platformPkg}/package.json`);
+    const binaryPath = path.join(path.dirname(pkgJsonPath), "bin", binaryName);
+    if (fs.existsSync(binaryPath)) {
+      return binaryPath;
+    }
+  } catch {
+    // Package not installed
+  }
+
+  throw new Error(
+    `devboy-agent-usage binary not found. No package ${platformPkg} installed.\n` +
+      "Your platform might not be supported. " +
+      "Set DEVBOY_AGENT_USAGE_BINARY_PATH to point to a binary, or install from source:\n" +
+      "  cargo install --git https://github.com/meteora-pro/devboy-agent-usage.git",
+  );
+};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@devboy-tools/agent-usage",
+  "version": "0.1.0",
+  "description": "CLI tool for analyzing AI agent usage (Claude Code) — npm wrapper for Rust binary",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/meteora-pro/devboy-agent-usage.git"
+  },
+  "bin": {
+    "devboy-agent-usage": "bin/agent-usage.js"
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "bin/agent-usage.js",
+    "index.js",
+    "index.d.ts"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@devboy-tools/agent-usage-darwin-arm64": "0.1.0",
+    "@devboy-tools/agent-usage-darwin-x64": "0.1.0",
+    "@devboy-tools/agent-usage-linux-arm64": "0.1.0",
+    "@devboy-tools/agent-usage-linux-x64": "0.1.0",
+    "@devboy-tools/agent-usage-win32-x64": "0.1.0"
+  }
+}