@uipath/cli 1.203.0-preview.205 → 1.204.0-preview.206

package/dist/{index-eb9q7r0k.js → index-45h1c7ad.js}

@@ -11,7 +11,7 @@ import {
   logger,
   processContext,
   wasInteractiveFlagPassed
-} from "./index-7pvwjzsq.js";
+} from "./index-kyn5nn3d.js";
 import {
   exports_external
 } from "./index-hrt7fpkk.js";
@@ -551,7 +551,7 @@ var package_default = {
   name: "@uipath/cli",
   author: "UiPath",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.203.0-preview.205",
+  version: "1.204.0-preview.206",
   description: "Cross platform CLI for UiPath",
   repository: {
     type: "git",
@@ -932,6 +932,10 @@ async function getGlobalNpmUipathDir() {
   cachedLookup = resolveGlobalNpmUipathDir();
   return cachedLookup;
 }
+async function refreshGlobalNpmUipathDir() {
+  cachedLookup = resolveGlobalNpmUipathDir();
+  return cachedLookup;
+}
 async function resolveGlobalNpmUipathDir() {
   const root = await runNpmRootGlobal();
   if (!root) {
@@ -984,6 +988,98 @@ async function runNpmRootGlobal() {
   });
 }
 
+// src/utils/toolsDirsEnv.ts
+var TOOLS_DIRS_ENV_VAR = "UIPATH_CLI_TOOLS_DIRS";
+var UNSAFE_PATH_CHARS = /["%\p{Cc}]/u;
+function hasUnsafePathChars(value) {
+  return UNSAFE_PATH_CHARS.test(value);
+}
+var cachedDeclaration = null;
+async function getEnvToolsDirsDeclaration() {
+  if (cachedDeclaration)
+    return cachedDeclaration;
+  cachedDeclaration = resolveDeclaration();
+  return cachedDeclaration;
+}
+async function resolveDeclaration() {
+  const fs = getFileSystem();
+  const raw = fs.env.getenv(TOOLS_DIRS_ENV_VAR);
+  if (raw === undefined || raw.trim() === "")
+    return null;
+  const delimiter = process.platform === "win32" ? ";" : ":";
+  const dirs = [];
+  const seen = new Set;
+  let installTarget = null;
+  let declared = false;
+  for (const entry of raw.split(delimiter)) {
+    const candidate = entry.trim();
+    if (candidate === "")
+      continue;
+    if (hasUnsafePathChars(candidate)) {
+      logger.warn(`${TOOLS_DIRS_ENV_VAR} entry rejected — unsupported characters in path: ${JSON.stringify(candidate)}`);
+      continue;
+    }
+    if (!fs.path.isAbsolute(candidate)) {
+      logger.warn(`${TOOLS_DIRS_ENV_VAR} entry rejected — path is not absolute: ${JSON.stringify(candidate)}`);
+      continue;
+    }
+    const resolved = fs.path.resolve(candidate);
+    const key = process.platform === "win32" ? resolved.toLowerCase() : resolved;
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    const isFirst = !declared;
+    declared = true;
+    const [error, stats] = await catchError(fs.stat(resolved));
+    if (error) {
+      logger.debug(`${TOOLS_DIRS_ENV_VAR} entry skipped — cannot stat ${resolved}: ${String(error)}`);
+      continue;
+    }
+    if (stats && !stats.isDirectory()) {
+      logger.warn(`${TOOLS_DIRS_ENV_VAR} entry skipped — not a directory: ${resolved}`);
+      continue;
+    }
+    if (stats) {
+      const [readError] = await catchError(fs.readdir(resolved));
+      if (readError) {
+        logger.warn(`${TOOLS_DIRS_ENV_VAR} entry skipped — directory is not readable: ${resolved}`);
+        continue;
+      }
+    }
+    if (isFirst) {
+      installTarget = resolved;
+      dirs.push(resolved);
+      continue;
+    }
+    if (!stats) {
+      logger.debug(`${TOOLS_DIRS_ENV_VAR} entry skipped — directory does not exist: ${resolved}`);
+      continue;
+    }
+    dirs.push(resolved);
+  }
+  if (!declared)
+    return null;
+  logger.debug(`${TOOLS_DIRS_ENV_VAR} declared tool directories: [${dirs.join(", ")}] (install target: ${installTarget ?? "none"})`);
+  return { installTarget, dirs };
+}
+function resolveNpmPrefixForToolsDir(toolsDir, platform = process.platform) {
+  const fs = getFileSystem();
+  const { basename, dirname } = fs.path;
+  const is = (path, name) => platform === "win32" ? basename(path).toLowerCase() === name : basename(path) === name;
+  if (!is(toolsDir, "@uipath"))
+    return null;
+  const nodeModules = dirname(toolsDir);
+  if (!is(nodeModules, "node_modules"))
+    return null;
+  const parent = dirname(nodeModules);
+  if (platform === "win32")
+    return parent;
+  return is(parent, "lib") ? dirname(parent) : null;
+}
+function npmGlobalRootParent(prefix, platform = process.platform) {
+  return platform === "win32" ? prefix : getFileSystem().path.join(prefix, "lib");
+}
+
 // src/services/bundleDistribution.ts
 var BUNDLE_PACKAGE_NAME = "uipath-cli-bundle";
 var DISABLE_AUTOINSTALL_ENV = "UIPATH_CLI_DISABLE_AUTOINSTALL";
@@ -1097,6 +1193,7 @@ var TOOLS_WHITELIST = new Map([
   ["@uipath/test-manager-tool", "tm"],
   ["@uipath/api-workflow-tool", "api-workflow"],
   ["@uipath/maestro-tool", "maestro"],
+  ["@uipath/rules-tool", "rules"],
   ["@uipath/docsai-tool", "docsai"],
   ["@uipath/vertical-solutions-tool", "vss"],
   ["@uipath/rpa-legacy-tool", "rpa-legacy"],
@@ -1481,7 +1578,7 @@ async function spawnPackageManager(executable, args, cwd, label, extraEnv) {
   }
   const { spawn } = await loadChildProcess();
   const isWindows = process.platform === "win32";
-  const envOpt = extraEnv ? { env: { ...process.env, ...extraEnv } } : {};
+  const envOpt = extraEnv ? { env: mergeEnvCaseInsensitive(process.env, extraEnv) } : {};
   return new Promise((resolve, reject) => {
     let proc;
     if (isWindows) {
@@ -1526,6 +1623,35 @@ async function spawnPackageManager(executable, args, cwd, label, extraEnv) {
     });
   });
 }
+function mergeEnvCaseInsensitive(base, overrides) {
+  const overridden = new Set(Object.keys(overrides).map((k) => k.toLowerCase()));
+  const merged = {};
+  for (const [key, value] of Object.entries(base)) {
+    if (!overridden.has(key.toLowerCase()))
+      merged[key] = value;
+  }
+  return { ...merged, ...overrides };
+}
+function prefixEnv(prefix) {
+  if (prefix === undefined || prefix.trim() === "")
+    return {};
+  if (!/^(?:\/|[A-Za-z]:[\\/]|\\\\)/.test(prefix)) {
+    throw new Error(`npm prefix must be an absolute path: ${prefix}`);
+  }
+  if (hasUnsafePathChars(prefix)) {
+    throw new Error(`npm prefix contains unsupported characters: ${JSON.stringify(prefix)}`);
+  }
+  return { npm_config_prefix: prefix };
+}
+async function bunCwdFor(args, cwd, extraEnv) {
+  const prefix = extraEnv?.npm_config_prefix;
+  if (!prefix || !args.includes("-g"))
+    return cwd;
+  const root = npmGlobalRootParent(prefix);
+  if (root !== cwd)
+    await getFileSystem().mkdir(root);
+  return root;
+}
 async function runPackageManager(args, cwd, extraEnv) {
   for (const arg of args) {
     if (arg !== "-g" && !arg.startsWith("--")) {
@@ -1534,9 +1660,10 @@ async function runPackageManager(args, cwd, extraEnv) {
   }
   const useBun = await isDevMode();
   const pm = useBun ? "bun" : "npm";
-  logger.debug(`Running package manager: ${pm} ${args.join(" ")}${cwd ? ` (cwd: ${cwd})` : ""}`);
+  const runCwd = useBun ? await bunCwdFor(args, cwd, extraEnv) : cwd;
+  logger.debug(`Running package manager: ${pm} ${args.join(" ")}${runCwd ? ` (cwd: ${runCwd})` : ""}`);
   const pmArgs = useBun ? args.filter((a) => a !== "-g").map((a) => a === "uninstall" ? "remove" : a) : args;
-  await spawnPackageManager(pm, pmArgs, cwd, `${pm} ${pmArgs[0]}`, extraEnv);
+  await spawnPackageManager(pm, pmArgs, runCwd, `${pm} ${pmArgs[0]}`, extraEnv);
 }
 async function runPackageManagerWithBun(args, cwd, extraEnv) {
   for (const arg of args) {
@@ -1545,8 +1672,16 @@ async function runPackageManagerWithBun(args, cwd, extraEnv) {
     }
   }
   const pmArgs = args.filter((a) => a !== "-g").map((a) => a === "uninstall" ? "remove" : a);
-  logger.debug(`Running package manager: bun ${pmArgs.join(" ")}${cwd ? ` (cwd: ${cwd})` : ""}`);
-  await spawnPackageManager("bun", pmArgs, cwd, `bun ${pmArgs[0]}`, extraEnv);
+  const bunCwd = await bunCwdFor(args, cwd, extraEnv);
+  logger.debug(`Running package manager: bun ${pmArgs.join(" ")}${bunCwd ? ` (cwd: ${bunCwd})` : ""}`);
+  await spawnPackageManager("bun", pmArgs, bunCwd, `bun ${pmArgs[0]}`, extraEnv);
+}
+
+class HostOwnedToolError extends InstallRefusedError {
+  constructor(packageName, dir) {
+    super(`Refusing to uninstall '${packageName}': it ships with the host application at ${dir}, which the CLI does not manage.`, "Only tools installed with 'uip tools install' can be uninstalled here.");
+    this.name = "HostOwnedToolError";
+  }
 }
 
 class NodeToolService {
@@ -1714,7 +1849,10 @@ ${errors.map((e) => `  - ${e}`).join(`
     validatePackageSpec(packageName);
     await refuseIfBundledDistribution(destination, "install", packageName);
     const baseArgs = options?.global ? ["install", "-g", packageName] : ["install", packageName];
-    const extraEnv = { ...archPinEnv() };
+    const extraEnv = {
+      ...archPinEnv(),
+      ...options?.global ? prefixEnv(options.prefix) : {}
+    };
     await warnIfTranslatedNodeAsync();
     for (let attempt = 0;attempt <= NPM_MAX_RETRIES; attempt++) {
       const [err] = await catchError(runPackageManager(baseArgs, destination, extraEnv));
@@ -1748,7 +1886,8 @@ ${errors.map((e) => `  - ${e}`).join(`
     let containerDir;
     let relativeName;
     if (options?.global) {
-      const globalUipathDir = await getGlobalNpmUipathDir();
+      const declaration = options.prefix ? await getEnvToolsDirsDeclaration() : null;
+      const globalUipathDir = declaration ? declaration.installTarget : await getGlobalNpmUipathDir();
       if (!globalUipathDir) {
         throw new Error(`Cannot locate '${packageName}': npm root -g unavailable`);
       }
@@ -1763,6 +1902,12 @@ ${errors.map((e) => `  - ${e}`).join(`
       throw new Error(`Refusing to uninstall '${packageName}': resolved path escapes ${containerDir}`);
     }
     if (!await fs.exists(packageDir)) {
+      const declaration = options?.prefix ? await getEnvToolsDirsDeclaration() : null;
+      for (const dir of declaration?.dirs.slice(1) ?? []) {
+        if (await fs.exists(fs.path.join(dir, relativeName))) {
+          throw new HostOwnedToolError(packageName, dir);
+        }
+      }
       throw new Error(`Package '${packageName}' is not installed at ${packageDir}`);
     }
     const [statError, stat] = await catchError(fs.stat(packageDir));
@@ -1772,7 +1917,7 @@ ${errors.map((e) => `  - ${e}`).join(`
       return;
     }
     if (options?.global) {
-      await runPackageManager(["uninstall", "-g", packageName], destination);
+      await runPackageManager(["uninstall", "-g", packageName], destination, options.prefix ? prefixEnv(options.prefix) : undefined);
     } else {
       await runPackageManager(["uninstall", packageName], destination);
     }
@@ -9474,7 +9619,8 @@ async function runToolsUpdate(opts, state) {
       });
       const packageName = `${fullName}@${targetVersion}`;
       await toolService.install(packageName, location.path, {
-        global: location.global
+        global: location.global,
+        prefix: location.prefix
       });
     })());
     if (updateError) {
@@ -9719,6 +9865,6 @@ function getManualCommandForInstallError(error, fallback) {
   return error instanceof CliSelfUpdateError ? error.manualCommand : fallback;
 }
 
-export { package_default, VALID_CHANNELS, HIDDEN_CHANNELS, PUBLIC_CHANNELS, withConfigLock, SECRET_FIELD_PATHS, migrateVersionConfig, versionMigrationNotice, resolveConfigFilePathAsync, loadConfigAsync, resolveUpdateChannel, resolveRuntimeChannel, isPreviewVersion, isValidVersionPin, majorOf, resolvePinnedVersion, isExactPin, versionLinePrefix, formatVersionPin, dist_default5 as dist_default, dist_default6 as dist_default1, dist_default7 as dist_default2, getGlobalNpmUipathDir, DISABLE_AUTOINSTALL_ENV, DISABLE_TOOL_LINE_CHECK_ENV, InstallRefusedError, isBundledDistribution, isAutoInstallDisabled, isToolLineCheckDisabled, TOOLS_WHITELIST, COMMAND_ALIASES, ALIASES_BY_COMMAND, WHITELIST_BY_COMMAND, WHITELIST_BY_SHORT_NAME, isValidSemver, compareSemver, resolveToolPackageName, parsePackageSpec, describeCandidateFailure, getEffectiveRegistry, isDevMode, truncateVersionsForDisplay, toolService, SkillSourceError, SkillsRegistryAuthError, resolveSkillSource, getContentStoreForRead, getAvailableSkills, readManifest, removeFromManifest, readExtraFiles, AGENT_DEFS, getSkillsDir, getSkillsDestinationHint, hasDistinctGlobalPath, skillOwnerOf, uninstallExtraFolders, uninstallSkill, rejectIfGlobalOnly, getSkillsSourceFailureDetails, buildSkillCatalog, removeSkillCatalog, searchSkillCatalog, ALL_AGENTS, AGENT_DISPLAY_NAMES, promptAgentSelection, SkillsError, resolveSkillsTargetVersion, resolveRootDir, resolveSkillsContext, runAgentInstalls, runSkillsUpdate, getInstalledTools, toolFailureRemediation, collapsePinnedLineErrors, todayLocal, readState, recordToolUpdateDate, mergeState, TOOLS_UPDATE_PHASES, runToolsUpdate, runUpdate };
+export { package_default, VALID_CHANNELS, HIDDEN_CHANNELS, PUBLIC_CHANNELS, withConfigLock, SECRET_FIELD_PATHS, migrateVersionConfig, versionMigrationNotice, resolveConfigFilePathAsync, loadConfigAsync, resolveUpdateChannel, resolveRuntimeChannel, isPreviewVersion, isValidVersionPin, majorOf, resolvePinnedVersion, isExactPin, versionLinePrefix, formatVersionPin, dist_default5 as dist_default, dist_default6 as dist_default1, dist_default7 as dist_default2, getGlobalNpmUipathDir, refreshGlobalNpmUipathDir, TOOLS_DIRS_ENV_VAR, getEnvToolsDirsDeclaration, resolveNpmPrefixForToolsDir, DISABLE_AUTOINSTALL_ENV, DISABLE_TOOL_LINE_CHECK_ENV, InstallRefusedError, isBundledDistribution, isAutoInstallDisabled, isToolLineCheckDisabled, TOOLS_WHITELIST, COMMAND_ALIASES, ALIASES_BY_COMMAND, WHITELIST_BY_COMMAND, WHITELIST_BY_SHORT_NAME, isValidSemver, compareSemver, resolveToolPackageName, parsePackageSpec, describeCandidateFailure, getEffectiveRegistry, isDevMode, HostOwnedToolError, truncateVersionsForDisplay, toolService, SkillSourceError, SkillsRegistryAuthError, resolveSkillSource, getContentStoreForRead, getAvailableSkills, readManifest, removeFromManifest, readExtraFiles, AGENT_DEFS, getSkillsDir, getSkillsDestinationHint, hasDistinctGlobalPath, skillOwnerOf, uninstallExtraFolders, uninstallSkill, rejectIfGlobalOnly, getSkillsSourceFailureDetails, buildSkillCatalog, removeSkillCatalog, searchSkillCatalog, ALL_AGENTS, AGENT_DISPLAY_NAMES, promptAgentSelection, SkillsError, resolveSkillsTargetVersion, resolveRootDir, resolveSkillsContext, runAgentInstalls, runSkillsUpdate, getInstalledTools, toolFailureRemediation, collapsePinnedLineErrors, todayLocal, readState, recordToolUpdateDate, mergeState, TOOLS_UPDATE_PHASES, runToolsUpdate, runUpdate };
 
-//# debugId=452E6333FCBBBE5F64756E2164756E21
+//# debugId=28073FAA99B3D1C564756E2164756E21