@agentteams/runner 0.0.117 → 0.0.118

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

@@ -1,17 +1,39 @@
 const PERMISSION_DENIED_MESSAGE = 'Global npm install requires elevated permissions. Configure a user-level npm prefix or rerun the update with appropriate permissions.';
+const BIN_CONFLICT_MESSAGE = 'Global npm install failed because a command name is already taken by a file from another source. ' +
+    'npm prints the conflicting path after "File exists:" — remove or rename that file, then retry the update.';
+const toMessage = (error) => (error instanceof Error ? error.message : String(error));
+const isPermissionFailure = (message) => message.includes('EACCES') || message.includes('EPERM') || message.toLowerCase().includes('permission denied');
+/**
+ * 전역 bin 이름 충돌. 패키지가 링크하려는 bin 이름을 다른 출처의 파일이 이미 점유하고 있으면
+ * npm은 `EEXIST` / `File exists:`로 설치 전체를 실패시킨다. 사용자가 그 파일을 치우기 전에는 풀리지 않는다.
+ */
+const isBinConflictFailure = (message) => message.includes('EEXIST') || message.includes('File exists:');
 export const classifyInstallError = (error) => {
-    const message = error instanceof Error ? error.message : String(error);
-    if (message.includes('EACCES') || message.includes('EPERM') || message.toLowerCase().includes('permission denied')) {
+    if (isPermissionFailure(toMessage(error))) {
         return 'PERMISSION_DENIED';
     }
     return 'UNKNOWN';
 };
-/** 사용자에게 보여줄 설치 실패 메시지. 권한 실패는 조치 방법을 담은 고정 문구를 쓴다. */
+/**
+ * 재시도만으로는 절대 풀리지 않고 사용자가 직접 손대야 하는 실패인지 판정한다.
+ *
+ * 서버로 보내는 `reason` 코드 계약(`PERMISSION_DENIED` | `UNKNOWN`)은 그대로 두고, 자동 업데이트의
+ * 재시도 백오프만 이 판정으로 넓힌다. bin 이름 충돌은 `UNKNOWN`으로 보고되지만 1시간마다 재시도할
+ * 이유가 없는 실패라 여기에 포함된다.
+ */
+export const requiresManualFix = (error) => {
+    const message = toMessage(error);
+    return isPermissionFailure(message) || isBinConflictFailure(message);
+};
+/** 사용자에게 보여줄 설치 실패 메시지. 조치 방법이 정해진 실패는 고정 문구를 쓴다. */
 export const describeInstallError = (error) => {
-    const message = error instanceof Error ? error.message : String(error);
-    if (classifyInstallError(error) === 'PERMISSION_DENIED') {
+    const message = toMessage(error);
+    if (isPermissionFailure(message)) {
         return PERMISSION_DENIED_MESSAGE;
     }
+    if (isBinConflictFailure(message)) {
+        return BIN_CONFLICT_MESSAGE;
+    }
     return `Failed to install the latest AgentRunner package: ${message}`;
 };
 /** 설치 실패를 사용자용 문구로 정규화한 Error로 바꾼다. */

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

@@ -1 +1 @@
-{"version":3,"file":"npm-install-error.js","sourceRoot":"","sources":["../../src/utils/npm-install-error.ts"],"names":[],"mappings":"AAQA,MAAM,yBAAyB,GAC7B,uIAAuI,CAAC;AAE1I,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAwB,EAAE;IAC3E,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACnH,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAU,EAAE;IAC7D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,IAAI,oBAAoB,CAAC,KAAK,CAAC,KAAK,mBAAmB,EAAE,CAAC;QACxD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,OAAO,qDAAqD,OAAO,EAAE,CAAC;AACxE,CAAC,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAS,EAAE,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC"}
+{"version":3,"file":"npm-install-error.js","sourceRoot":"","sources":["../../src/utils/npm-install-error.ts"],"names":[],"mappings":"AAQA,MAAM,yBAAyB,GAC7B,uIAAuI,CAAC;AAE1I,MAAM,oBAAoB,GACxB,mGAAmG;IACnG,2GAA2G,CAAC;AAE9G,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAEvG,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAW,EAAE,CACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAEjH;;;GAGG;AACH,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAW,EAAE,CACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAwB,EAAE;IAC3E,IAAI,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAW,EAAE;IAC3D,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAU,EAAE;IAC7D,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,OAAO,qDAAqD,OAAO,EAAE,CAAC;AACxE,CAAC,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAS,EAAE,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC"}

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.117",
+  "version": "0.0.118",
   "platform": "win32",
   "arch": "x64",
   "fileName": "agentrunner-launcher.exe",
-  "sha256": "43d2b6bb1a1aa370c04f7482a8acf8ba10c3f10c5074f54db55363763c35d998"
+  "sha256": "7401e89ce20c10a249e042e894a022f2c4e5fb5bea0230477026f00803c55a12"
 }

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@agentteams/runner",
-  "version": "0.0.117",
+  "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.`