@open-agent-toolkit/cli 0.2.9 → 0.2.10

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.2.9",
-  "docs-config": "0.2.9",
-  "docs-theme": "0.2.9",
-  "docs-transforms": "0.2.9"
+  "cli": "0.2.10",
+  "docs-config": "0.2.10",
+  "docs-theme": "0.2.10",
+  "docs-transforms": "0.2.10"
 }

package/dist/app/global-cli-installer.d.ts

@@ -0,0 +1,16 @@
+export type GlobalCliPackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+export interface GlobalCliInstallerOptions {
+    argv: string[];
+    env: NodeJS.ProcessEnv;
+    platform: NodeJS.Platform;
+    nodeExecutable: string;
+    fileExists: (path: string) => boolean;
+}
+export interface GlobalCliInstallerInvocation {
+    file: string;
+    args: string[];
+}
+export declare function detectGlobalCliPackageManager(argv: string[], env: NodeJS.ProcessEnv): GlobalCliPackageManager;
+export declare function formatGlobalCliInstallCommand(packageSpec: string, argv: string[], env: NodeJS.ProcessEnv): string;
+export declare function resolveGlobalCliInstallerInvocation(packageSpec: string, options: GlobalCliInstallerOptions): GlobalCliInstallerInvocation | null;
+//# sourceMappingURL=global-cli-installer.d.ts.map

package/dist/app/global-cli-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-cli-installer.d.ts","sourceRoot":"","sources":["../../src/app/global-cli-installer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAqCD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,uBAAuB,CAyBzB;AA0ED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,MAAM,CAYR;AAED,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,4BAA4B,GAAG,IAAI,CAUrC"}

package/dist/app/global-cli-installer.js

@@ -0,0 +1,111 @@
+import { win32 } from 'node:path';
+function normalizePathForDetection(path) {
+    return path.replaceAll('\\', '/').toLowerCase().replace(/\/+$/, '');
+}
+function isUnderNormalizedPath(normalizedCandidate, normalizedHome) {
+    return (normalizedCandidate === normalizedHome ||
+        normalizedCandidate.startsWith(`${normalizedHome}/`));
+}
+function detectFromPath(normalizedPath) {
+    if (normalizedPath.includes('/pnpm/') || normalizedPath.includes('/.pnpm/')) {
+        return 'pnpm';
+    }
+    if (normalizedPath.includes('/.bun/') ||
+        normalizedPath.includes('/bun/install/')) {
+        return 'bun';
+    }
+    if (normalizedPath.includes('/.yarn/') ||
+        normalizedPath.includes('/yarn/global/')) {
+        return 'yarn';
+    }
+    return null;
+}
+export function detectGlobalCliPackageManager(argv, env) {
+    const candidates = argv.slice(0, 2).filter(Boolean);
+    for (const candidate of candidates) {
+        const detected = detectFromPath(normalizePathForDetection(candidate));
+        if (detected) {
+            return detected;
+        }
+    }
+    const pnpmHome = env.PNPM_HOME?.trim();
+    if (pnpmHome) {
+        const normalizedHome = normalizePathForDetection(pnpmHome);
+        for (const candidate of candidates) {
+            if (isUnderNormalizedPath(normalizePathForDetection(candidate), normalizedHome)) {
+                return 'pnpm';
+            }
+        }
+    }
+    return 'npm';
+}
+function installArgsForManager(manager, packageSpec) {
+    switch (manager) {
+        case 'npm':
+            return ['install', '--global', packageSpec];
+        case 'pnpm':
+            return ['add', '-g', packageSpec];
+        case 'yarn':
+            return ['global', 'add', packageSpec];
+        case 'bun':
+            return ['install', '-g', packageSpec];
+    }
+}
+function executableForManager(manager) {
+    return manager;
+}
+function resolveWindowsManagerInvocation(manager, packageSpec, options) {
+    if (manager === 'npm') {
+        return resolveNpmWindowsInvocation(packageSpec, options);
+    }
+    const comspec = options.env.ComSpec?.trim() || 'cmd.exe';
+    return {
+        file: comspec,
+        args: [
+            '/d',
+            '/s',
+            '/c',
+            manager,
+            ...installArgsForManager(manager, packageSpec),
+        ],
+    };
+}
+function resolveNpmWindowsInvocation(packageSpec, options) {
+    const npmArgs = installArgsForManager('npm', packageSpec);
+    const environmentPath = options.env.npm_execpath?.trim();
+    const standardPath = win32.join(win32.dirname(options.nodeExecutable), 'node_modules', 'npm', 'bin', 'npm-cli.js');
+    const npmCliPath = [environmentPath, standardPath].find((candidate) => candidate !== undefined &&
+        win32.isAbsolute(candidate) &&
+        win32.basename(candidate).toLowerCase() === 'npm-cli.js' &&
+        options.fileExists(candidate));
+    if (!npmCliPath) {
+        return null;
+    }
+    return {
+        file: options.nodeExecutable,
+        args: [npmCliPath, ...npmArgs],
+    };
+}
+export function formatGlobalCliInstallCommand(packageSpec, argv, env) {
+    const manager = detectGlobalCliPackageManager(argv, env);
+    switch (manager) {
+        case 'npm':
+            return `npm install --global ${packageSpec}`;
+        case 'pnpm':
+            return `pnpm add -g ${packageSpec}`;
+        case 'yarn':
+            return `yarn global add ${packageSpec}`;
+        case 'bun':
+            return `bun install -g ${packageSpec}`;
+    }
+}
+export function resolveGlobalCliInstallerInvocation(packageSpec, options) {
+    const manager = detectGlobalCliPackageManager(options.argv, options.env);
+    if (options.platform === 'win32') {
+        return resolveWindowsManagerInvocation(manager, packageSpec, options);
+    }
+    return {
+        file: executableForManager(manager),
+        args: installArgsForManager(manager, packageSpec),
+    };
+}

package/dist/app/tool-bundle-update-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-bundle-update-guard.d.ts","sourceRoot":"","sources":["../../src/app/tool-bundle-update-guard.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,yBAAyB,EAAE,CACzB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,UAAU,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AA6CD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE1D;AAgBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,mBAAmB,CAOrB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMtE;AA0CD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,4BAA4B,EACrC,SAAS,GAAE,OAAO,CAAC,iCAAiC,CAAM,GACzD,OAAO,CAAC,OAAO,CAAC,CAsElB"}
+{"version":3,"file":"tool-bundle-update-guard.d.ts","sourceRoot":"","sources":["../../src/app/tool-bundle-update-guard.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,yBAAyB,EAAE,CACzB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,UAAU,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AA6CD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE1D;AAgBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,mBAAmB,CAOrB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMtE;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,4BAA4B,EACrC,SAAS,GAAE,OAAO,CAAC,iCAAiC,CAAM,GACzD,OAAO,CAAC,OAAO,CAAC,CA6ElB"}

package/dist/app/tool-bundle-update-guard.js

@@ -1,6 +1,6 @@
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
-import { win32 } from 'node:path';
+import { formatGlobalCliInstallCommand, resolveGlobalCliInstallerInvocation, } from './global-cli-installer.js';
 import { resolveUpdateAvailability } from './update-notifier.js';
 import { confirmAction } from '../commands/shared/shared.prompts.js';
 import { CliError } from '../errors/index.js';
@@ -67,25 +67,6 @@ export function isBundledToolMutationCommand(command) {
     }
     return path[0] === 'tools' && (path[1] === 'install' || path[1] === 'update');
 }
-function resolveInstallerInvocation(options, dependencies, packageVersion) {
-    const npmArgs = ['install', '--global', packageVersion];
-    if (dependencies.platform !== 'win32') {
-        return { file: 'npm', args: npmArgs };
-    }
-    const environmentPath = options.env.npm_execpath?.trim();
-    const standardPath = win32.join(win32.dirname(dependencies.nodeExecutable), 'node_modules', 'npm', 'bin', 'npm-cli.js');
-    const npmCliPath = [environmentPath, standardPath].find((candidate) => candidate !== undefined &&
-        win32.isAbsolute(candidate) &&
-        win32.basename(candidate).toLowerCase() === 'npm-cli.js' &&
-        dependencies.fileExists(candidate));
-    if (!npmCliPath) {
-        return null;
-    }
-    return {
-        file: dependencies.nodeExecutable,
-        args: [npmCliPath, ...npmArgs],
-    };
-}
 export async function guardBundledToolMutation(options, overrides = {}) {
     if (options.dryRun) {
         return false;
@@ -99,7 +80,8 @@ export async function guardBundledToolMutation(options, overrides = {}) {
         `bundled with the currently running CLI ${options.currentVersion}, which ` +
         'can only install its own bundled tool versions. The available CLI may ' +
         'bundle newer tool versions.');
-    const installCommand = `npm install --global ${CLI_PACKAGE}@${availableVersion}`;
+    const packageSpec = `${CLI_PACKAGE}@${availableVersion}`;
+    const installCommand = formatGlobalCliInstallCommand(packageSpec, options.argv, options.env);
     let accepted = false;
     try {
         accepted = await dependencies.confirmAction(`Update the OAT CLI to ${availableVersion} before running ${options.commandPath}?`, { interactive: options.interactive });
@@ -113,7 +95,13 @@ export async function guardBundledToolMutation(options, overrides = {}) {
             'versions may be older than those bundled with the available CLI.');
         return false;
     }
-    const invocation = resolveInstallerInvocation(options, dependencies, `${CLI_PACKAGE}@${availableVersion}`);
+    const invocation = resolveGlobalCliInstallerInvocation(packageSpec, {
+        argv: options.argv,
+        env: options.env,
+        platform: dependencies.platform,
+        nodeExecutable: dependencies.nodeExecutable,
+        fileExists: dependencies.fileExists,
+    });
     if (!invocation) {
         throw new CliError('Could not locate npm-cli.js for a shell-free Windows update. ' +
             `No tools were changed. Run this command manually: ${installCommand}`, 2);

package/dist/app/update-notifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-notifier.d.ts","sourceRoot":"","sources":["../../src/app/update-notifier.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAa5C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,KAAK,EAAE,CACL,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC;CACzD;AAkRD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAAC,IAAI,CAAC,CA8Bf"}
+{"version":3,"file":"update-notifier.d.ts","sourceRoot":"","sources":["../../src/app/update-notifier.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAa5C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,KAAK,EAAE,CACL,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC;CACzD;AAuRD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/app/update-notifier.js

@@ -1,5 +1,6 @@
 import { readFile as readFileDefault } from 'node:fs/promises';
 import { join } from 'node:path';
+import { formatGlobalCliInstallCommand } from './global-cli-installer.js';
 import { readUserConfig } from '../config/oat-config.js';
 import { atomicWriteJson } from '../fs/io.js';
 const CHECK_TTL_MS = 24 * 60 * 60 * 1000;
@@ -145,9 +146,9 @@ function shouldNotify(cache, latestVersion, nowMs) {
     return (cache.lastNotifiedVersion !== latestVersion ||
         !isTtlFresh(cache.lastNotifiedAt, nowMs, NOTICE_TTL_MS));
 }
-function formatNotice(currentVersion, latestVersion) {
+function formatNotice(currentVersion, latestVersion, argv, env) {
     return (`Update available: ${currentVersion} → ${latestVersion}\n` +
-        'Run: npm install -g @open-agent-toolkit/cli@latest');
+        `Run: ${formatGlobalCliInstallCommand('@open-agent-toolkit/cli@latest', argv, env)}`);
 }
 async function resolveUpdateAvailabilityState(options, overrides) {
     if (!isStaticallyEligible(options)) {
@@ -230,7 +231,7 @@ export async function maybeNotifyAboutUpdate(options, overrides = {}) {
         if (state.latestVersion &&
             shouldNotify(state.cache, state.latestVersion, state.nowMs)) {
             try {
-                options.logger.warn(formatNotice(options.currentVersion, state.latestVersion));
+                options.logger.warn(formatNotice(options.currentVersion, state.latestVersion, options.argv, options.env));
                 state.cache = {
                     ...state.cache,
                     lastNotifiedAt: state.nowTimestamp,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.2.9"
+    "@open-agent-toolkit/control-plane": "0.2.10"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",