agentworth 0.1.12 → 0.1.14

package/bin/agentworth.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 
+import path from 'node:path';
 import { run } from '../lib/resolver.js';
 
-const exitCode = run(process.argv.slice(2));
+// Both npm bin entries ('agentworth' and 'agwt', see package.json) point at this same
+// script -- process.argv[1] carries the name the shell actually resolved (the .bin
+// symlink), which is how we tell the two invocations apart without a second script.
+const invokedAs = path.basename(process.argv[1] || '').replace(/\.(js|cjs|mjs)$/, '');
+
+const exitCode = run(process.argv.slice(2), { invokedAs });
 process.exit(exitCode);

package/lib/resolver.js

@@ -77,11 +77,19 @@ export function getCacheDir(version, homeDir) {
 /**
  * Returns the expected native binary name for the target platform.
  *
+ * `invokedAs` selects between the two native binaries the release tarball ships
+ * (`agentworth` and its `agwt` alias, see apps/cli/Cargo.toml's two [[bin]] targets) --
+ * anything other than exactly 'agwt' resolves to the `agentworth` binary, so an
+ * unrecognized or missing invocation name still gets the primary binary rather than
+ * silently 404ing on a name nobody built.
+ *
  * @param {string} [platform=process.platform]
+ * @param {string} [invokedAs] - basename the launcher was invoked as ('agentworth' or 'agwt')
  * @returns {string}
  */
-export function getBinaryName(platform = process.platform) {
-  return platform === 'win32' ? 'agentworth.exe' : 'agentworth';
+export function getBinaryName(platform = process.platform, invokedAs) {
+  const base = invokedAs === 'agwt' ? 'agwt' : 'agentworth';
+  return platform === 'win32' ? `${base}.exe` : base;
 }
 
 /**
@@ -222,6 +230,7 @@ function pathBinaryMatchesVersion(binPath, expected) {
  * @param {string} [options.version]
  * @param {string} [options.homeDir]
  * @param {boolean} [options.silent=false]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; picks which extracted binary is returned
  * @returns {Promise<string>} Path to extracted binary
  */
 export async function downloadAndExtractBinary(options = {}) {
@@ -229,7 +238,7 @@ export async function downloadAndExtractBinary(options = {}) {
   const arch = options.arch || process.arch;
   const version = options.version || getPackageVersion();
   const targetTriple = getTargetTriple(platform, arch);
-  const binName = getBinaryName(platform);
+  const binName = getBinaryName(platform, options.invokedAs);
 
   if (!targetTriple) {
     throw new Error(`Unsupported platform/architecture: ${platform}-${arch}`);
@@ -369,6 +378,7 @@ export function findPathBinary(binName = getBinaryName(), pathEnv = process.env.
  * @param {NodeJS.ProcessEnv} [options.env=process.env]
  * @param {string} [options.baseDir=__dirname]
  * @param {string} [options.homeDir]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; selects which native binary to look for
  * @returns {{ found: boolean, path?: string, source?: string, error?: string }}
  */
 export function resolveBinary(options = {}) {
@@ -378,7 +388,7 @@ export function resolveBinary(options = {}) {
   const env = options.env || process.env;
   const baseDir = options.baseDir || __dirname;
   const homeDir = options.homeDir || (env.HOME ? env.HOME : os.homedir());
-  const binName = getBinaryName(platform);
+  const binName = getBinaryName(platform, options.invokedAs);
   const platformKey = getPlatformKey(platform, arch);
 
   // 1. Explicit environment variable override
@@ -510,11 +520,14 @@ export function formatMissingBinaryMessage(platformKey = getPlatformKey()) {
     '',
     'AgentWorth requires the native binary to run. You can install or build it via:',
     '',
-    '  \x1b[36m• Build from local source:\x1b[0m',
-    '      cargo build --release -p agentworth-cli',
+    '  \x1b[36m• Standalone install script:\x1b[0m',
+    '      curl -fsSL https://agentworth.dev/install.sh | sh',
+    '',
+    '  \x1b[36m• Cargo:\x1b[0m',
+    '      cargo install agentworth-cli',
     '',
-    '  \x1b[36m• Install via Cargo:\x1b[0m',
-    '      cargo install --path apps/cli',
+    '  \x1b[36m• Zero-install via npx:\x1b[0m',
+    '      npx -y agentworth',
     '',
     '  \x1b[36m• Download the release for your platform:\x1b[0m',
     `      https://github.com/unfoundbox-crew/agentworth/releases/latest`,
@@ -547,6 +560,7 @@ export function buildChildEnv(baseEnv, npmVersion) {
  *
  * @param {string[]} [argv=process.argv.slice(2)]
  * @param {Object} [options={}]
+ * @param {string} [options.invokedAs] - 'agentworth' or 'agwt'; which native binary to resolve
  * @returns {number} Exit code
  */
 export function run(argv = process.argv.slice(2), options = {}) {
@@ -562,7 +576,8 @@ export function run(argv = process.argv.slice(2), options = {}) {
         await downloadAndExtractBinary({
           platform: ${JSON.stringify(options.platform || process.platform)},
           arch: ${JSON.stringify(options.arch || process.arch)},
-          homeDir: ${JSON.stringify(options.homeDir || (options.env && options.env.HOME) || '')}
+          homeDir: ${JSON.stringify(options.homeDir || (options.env && options.env.HOME) || '')},
+          invokedAs: ${JSON.stringify(options.invokedAs || '')}
         });
       `;
       const dlResult = spawnSync(process.execPath, ['--input-type=module', '-e', syncDownloadScript], {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworth",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Discover, normalize, and understand AI-agent histories locally.",
   "type": "module",
   "main": "./lib/resolver.js",