@agentteams/runner 0.0.116 → 0.0.118

package/dist/utils/npm-install-error.test.js

@@ -1,6 +1,6 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
-import { classifyInstallError, describeInstallError, normalizeInstallError } from './npm-install-error.js';
+import { classifyInstallError, describeInstallError, normalizeInstallError, requiresManualFix, } from './npm-install-error.js';
 test('classifyInstallError detects permission failures from real npm output', () => {
     const eacces = new Error([
         'Command failed: /usr/bin/npm install -g @agentteams/runner@0.0.114',
@@ -25,4 +25,26 @@ test('normalizeInstallError returns an Error carrying the described message', ()
     assert.ok(normalized instanceof Error);
     assert.equal(normalized.message, describeInstallError(new Error('npm ERR! code EACCES')));
 });
+const EEXIST_INSTALL_ERROR_MESSAGE = [
+    'Command failed: /usr/bin/npm install -g @agentteams/cli@0.0.114',
+    'npm ERR! code EEXIST',
+    'npm ERR! path /usr/local/bin/agt',
+    'npm ERR! EEXIST: file already exists',
+    'npm ERR! File exists: /usr/local/bin/agt',
+].join('\n');
+test('describeInstallError guides the user to clear a conflicting global bin file', () => {
+    // `agt`/`agr` bin이 늘어난 뒤 새로 열린 실패 경로다. 원시 npm 출력만 보여주면 조치를 알 수 없다.
+    const described = describeInstallError(new Error(EEXIST_INSTALL_ERROR_MESSAGE));
+    assert.match(described, /already taken by a file from another source/u);
+    assert.match(described, /remove or rename that file/u);
+});
+test('requiresManualFix covers both permission blocks and global bin conflicts', () => {
+    assert.equal(requiresManualFix(new Error('npm ERR! code EACCES')), true);
+    assert.equal(requiresManualFix(new Error(EEXIST_INSTALL_ERROR_MESSAGE)), true);
+    assert.equal(requiresManualFix(new Error('npm ERR! File exists: /usr/local/bin/agr')), true);
+    assert.equal(requiresManualFix(new Error('network unavailable')), false);
+});
+test('a bin conflict keeps reporting UNKNOWN so the server reason contract stays unchanged', () => {
+    assert.equal(classifyInstallError(new Error(EEXIST_INSTALL_ERROR_MESSAGE)), 'UNKNOWN');
+});
 //# sourceMappingURL=npm-install-error.test.js.map

package/dist/utils/npm-install-error.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-install-error.test.js","sourceRoot":"","sources":["../../src/utils/npm-install-error.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE3G,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB;QACE,oEAAoE;QACpE,sBAAsB;QACtB,yBAAyB;QACzB,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC1F,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC9F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,6BAA6B,CAAC,EAAE,SAAS,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4EAA4E,EAAE,GAAG,EAAE;IACtF,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC9F,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,0CAA0C,CAAC,CAAC;AACnH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC5E,MAAM,CAAC,EAAE,CAAC,UAAU,YAAY,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,oBAAoB,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC,CAAC"}
+{"version":3,"file":"npm-install-error.test.js","sourceRoot":"","sources":["../../src/utils/npm-install-error.test.ts"],"names":[],"mappings":"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"}

package/native/bin/win32-x64/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "version": "0.0.116",
+  "version": "0.0.118",
   "platform": "win32",
   "arch": "x64",
   "fileName": "agentrunner-launcher.exe",
-  "sha256": "c809675b68b9dc8ff8a871d89f69a1b01a0bee0d4b2f9de2ee5691079dafd6c6"
+  "sha256": "7401e89ce20c10a249e042e894a022f2c4e5fb5bea0230477026f00803c55a12"
 }

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@agentteams/runner",
-  "version": "0.0.116",
+  "version": "0.0.118",
   "description": "AgentRunner - Background runner that polls and executes AI agent tasks",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "agentrunner": "dist/index.js"
+    "agentrunner": "dist/index.js",
+    "agr": "dist/index.js"
   },
   "files": [
     "dist/**/*",

package/readme.md

@@ -23,6 +23,18 @@ Verify the installation:
 agentrunner --help
 ```
 
+### Short alias (`agr`)
+
+`agentrunner` is also installed as `agr`. The canonical name keeps working — the alias is an addition, not a replacement.
+
+```bash
+agr --help    # same as: agentrunner --help
+```
+
+- The alias symlink is created at install time. If you installed an earlier version, rerun `npm install -g @agentteams/runner` to get it.
+- Use the alias only when you type commands yourself. Autostart entries, scripts, and agent guides should keep using `agentrunner`, which exists in every environment.
+- Usage text echoes the alias only where npm installs bins as symlinks (POSIX). Windows `.cmd`/`.ps1` shims and pnpm global installs are shell wrappers, so `agr --help` still prints `Usage: agentrunner ...` there. Running the alias itself works everywhere.
+
 ## Quick Start
 
 ### 1. Initialize
@@ -213,9 +225,9 @@ For a release smoke test on a disposable Windows test machine:
 
 ## Troubleshooting
 
-### `Missing token. Usage: agentrunner init --token <token> ...`
+### `Missing token. Usage: ... init --token <token> ...`
 
-The `--token` flag was not provided to `init`.
+The `--token` flag was not provided to `init`. The usage line names whichever executable you ran, so it reads `agentrunner init ...` or `agr init ...`.
 
 ### `Daemon token is missing. Run 'agentrunner init --token <token>' first.`