@uipath/resourcecatalog-tool 0.1.0 → 1.2.0

package/dist/tool.js

@@ -383,11 +383,11 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import childProcess3 from "node:child_process";
 import fs5, { constants as fsConstants2 } from "node:fs/promises";
-function detectArchBinary(binary2) {
-  if (typeof binary2 === "string" || Array.isArray(binary2)) {
-    return binary2;
+function detectArchBinary(binary) {
+  if (typeof binary === "string" || Array.isArray(binary)) {
+    return binary;
   }
-  const { [arch]: archBinary } = binary2;
+  const { [arch]: archBinary } = binary;
   if (!archBinary) {
     throw new Error(`${arch} is not supported`);
   }
@@ -667,6 +667,7 @@ var init_open = __esm(() => {
 });
 
 // ../../filesystem/src/node.ts
+import { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import * as fs6 from "node:fs/promises";
 import * as os2 from "node:os";
@@ -748,6 +749,90 @@ class NodeFileSystem {
   async mkdir(dirPath) {
     await fs6.mkdir(dirPath, { recursive: true });
   }
+  async acquireLock(lockPath) {
+    const canonicalPath = await this.canonicalizeLockTarget(lockPath);
+    const lockFile = `${canonicalPath}.lock`;
+    const ownerId = randomUUID();
+    const start = Date.now();
+    while (true) {
+      try {
+        await fs6.writeFile(lockFile, ownerId, { flag: "wx" });
+        return this.createLockRelease(lockFile, ownerId);
+      } catch (error) {
+        if (!this.hasErrnoCode(error, "EEXIST")) {
+          throw error;
+        }
+        const stats = await fs6.stat(lockFile).catch(() => null);
+        if (stats && Date.now() - stats.mtimeMs > LOCK_STALE_MS) {
+          const reclaimed = await fs6.rm(lockFile, { force: true }).then(() => true).catch(() => false);
+          if (reclaimed)
+            continue;
+        }
+        if (Date.now() - start > LOCK_MAX_WAIT_MS) {
+          throw new Error(`ELOCKED: timed out waiting for lock on ${canonicalPath}`);
+        }
+        await new Promise((resolve2) => setTimeout(resolve2, LOCK_RETRY_MIN_MS + Math.random() * LOCK_RETRY_JITTER_MS));
+      }
+    }
+  }
+  async canonicalizeLockTarget(lockPath) {
+    const absolute = path2.resolve(lockPath);
+    const fullReal = await fs6.realpath(absolute).catch(() => null);
+    if (fullReal)
+      return fullReal;
+    const parent = path2.dirname(absolute);
+    const base = path2.basename(absolute);
+    const canonicalParent = await fs6.realpath(parent).catch(() => parent);
+    return path2.join(canonicalParent, base);
+  }
+  createLockRelease(lockFile, ownerId) {
+    const heartbeatStart = Date.now();
+    let heartbeatTimer;
+    let stopped = false;
+    const stopHeartbeat = () => {
+      stopped = true;
+      if (heartbeatTimer)
+        clearTimeout(heartbeatTimer);
+    };
+    const scheduleNextHeartbeat = () => {
+      if (stopped)
+        return;
+      if (Date.now() - heartbeatStart >= LOCK_MAX_HOLD_MS) {
+        stopped = true;
+        return;
+      }
+      heartbeatTimer = setTimeout(() => {
+        runHeartbeat();
+      }, LOCK_HEARTBEAT_MS);
+      heartbeatTimer.unref?.();
+    };
+    const runHeartbeat = async () => {
+      if (stopped)
+        return;
+      const current = await fs6.readFile(lockFile, "utf-8").catch(() => null);
+      if (stopped)
+        return;
+      if (current !== ownerId) {
+        stopped = true;
+        return;
+      }
+      const now = Date.now() / 1000;
+      await fs6.utimes(lockFile, now, now).catch(() => {});
+      scheduleNextHeartbeat();
+    };
+    scheduleNextHeartbeat();
+    let released = false;
+    return async () => {
+      if (released)
+        return;
+      released = true;
+      stopHeartbeat();
+      const current = await fs6.readFile(lockFile, "utf-8").catch(() => null);
+      if (current === ownerId) {
+        await fs6.rm(lockFile, { force: true });
+      }
+    };
+  }
   async rm(filePath) {
     await fs6.rm(filePath, { recursive: true, force: true });
   }
@@ -793,16 +878,18 @@ class NodeFileSystem {
     }
   }
   isEnoent(error) {
-    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+    return this.hasErrnoCode(error, "ENOENT");
+  }
+  hasErrnoCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
   }
 }
+var LOCK_HEARTBEAT_MS = 5000, LOCK_STALE_MS = 15000, LOCK_MAX_WAIT_MS = 20000, LOCK_MAX_HOLD_MS = 60000, LOCK_RETRY_MIN_MS = 100, LOCK_RETRY_JITTER_MS = 200;
 var init_node = __esm(() => {
   init_open();
 });
 // ../../filesystem/src/index.ts
-var fsInstance, getFileSystem = () => {
-  return fsInstance;
-};
+var fsInstance, getFileSystem = () => fsInstance;
 var init_src = __esm(() => {
   init_node();
   init_node();
@@ -19042,10 +19129,15 @@ var require_dist = __commonJS((exports) => {
   exports.RobotProxyConstructor = RobotProxyConstructor;
   __exportStar(require_agent(), exports);
 });
+// ../../auth/src/server.ts
+var init_server = __esm(() => {
+  init_constants();
+});
 // package.json
 var package_default = {
   name: "@uipath/resourcecatalog-tool",
-  version: "0.1.0",
+  license: "MIT",
+  version: "1.2.0",
   description: "CLI plugin for the UiPath Resource Catalog Service.",
   private: false,
   repository: {
@@ -19087,6 +19179,9 @@ var package_default = {
   }
 };
 
+// ../../common/src/attachment-binding.ts
+init_src();
+
 // ../../common/src/catch-error.ts
 function isPromiseLike(value) {
   return value !== null && typeof value === "object" && typeof value.then === "function";
@@ -19114,79 +19209,7 @@ function settlePromiseLike(thenable) {
     undefined
   ]);
 }
-// ../../common/src/command-examples.ts
-import { Command } from "commander";
-var examplesByCommand = new WeakMap;
-Command.prototype.examples = function(examples) {
-  examplesByCommand.set(this, examples);
-  return this;
-};
-// ../../common/src/singleton.ts
-var PREFIX = "@uipath/common/";
-var _g = globalThis;
-function singleton(ctorOrName) {
-  const name = typeof ctorOrName === "string" ? ctorOrName : ctorOrName.name;
-  const key = Symbol.for(PREFIX + name);
-  return {
-    get(fallback) {
-      return _g[key] ?? fallback;
-    },
-    set(value) {
-      _g[key] = value;
-    },
-    clear() {
-      delete _g[key];
-    },
-    getOrInit(factory, guard) {
-      const existing = _g[key];
-      if (existing != null && typeof existing === "object") {
-        if (!guard || guard(existing)) {
-          return existing;
-        }
-      }
-      const instance = factory();
-      _g[key] = instance;
-      return instance;
-    }
-  };
-}
 
-// ../../common/src/output-context.ts
-function createStorage() {
-  const [error, mod] = catchError(() => __require("node:async_hooks"));
-  if (error || typeof mod?.AsyncLocalStorage !== "function") {
-    return {
-      getStore: () => {
-        return;
-      },
-      run: (_store, fn) => fn()
-    };
-  }
-  return new mod.AsyncLocalStorage;
-}
-var storageSingleton = singleton("OutputStorage");
-var sinkSlot = singleton("OutputSink");
-var outputStorage = storageSingleton.getOrInit(createStorage, (v) => ("getStore" in v));
-var CONSOLE_FALLBACK = {
-  writeOut: (str) => process.stdout.write(str),
-  writeErr: (str) => process.stderr.write(str),
-  writeLog: (str) => process.stdout.write(str),
-  capabilities: {
-    isInteractive: false,
-    supportsColor: false,
-    outputWidth: 80
-  }
-};
-function getOutputSink() {
-  return outputStorage.getStore() ?? sinkSlot.get() ?? CONSOLE_FALLBACK;
-}
-// ../../common/src/completer.ts
-var COMPLETER_SYMBOL = Symbol.for("@uipath/common/completer");
-// ../../common/src/console-guard.ts
-var guardInstalledSlot = singleton("ConsoleGuardInstalled");
-var savedOriginalsSlot = singleton("ConsoleGuardOriginals");
-// ../../common/src/constants.ts
-var DEFAULT_AUTH_TIMEOUT_MS = 5 * 60 * 1000;
 // ../../common/src/error-handler.ts
 var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.";
 var DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.";
@@ -19293,10 +19316,15 @@ async function extractErrorDetails(error, options) {
   }
   if (parsedBody?.errorCode && typeof parsedBody.errorCode === "string") {
     context.errorCode = parsedBody.errorCode;
+  } else if (parsedBody?.code && typeof parsedBody.code === "string") {
+    context.errorCode = parsedBody.code;
   }
   if (parsedBody?.requestId && typeof parsedBody.requestId === "string") {
     context.requestId = parsedBody.requestId;
   }
+  if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
+    context.traceId = parsedBody.traceId;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -19316,12 +19344,114 @@ async function extractErrorDetails(error, options) {
     }
   }
   const hasContext = Object.keys(context).length > 0;
-  return { result, message, details, ...hasContext ? { context } : {} };
+  let parsedErrors;
+  if (parsedBody?.errors && typeof parsedBody.errors === "object") {
+    const errors = {};
+    for (const [field, raw] of Object.entries(parsedBody.errors)) {
+      if (Array.isArray(raw)) {
+        const messages = raw.map((entry) => {
+          if (typeof entry === "string")
+            return entry;
+          if (entry && typeof entry === "object" && typeof entry.message === "string") {
+            return entry.message;
+          }
+          return String(entry);
+        }).filter(Boolean);
+        if (messages.length > 0)
+          errors[field] = messages;
+      } else if (typeof raw === "string") {
+        errors[field] = [raw];
+      }
+    }
+    if (Object.keys(errors).length > 0)
+      parsedErrors = errors;
+  }
+  return {
+    result,
+    message,
+    details,
+    ...hasContext ? { context } : {},
+    ...parsedErrors ? { parsedErrors } : {}
+  };
 }
 async function extractErrorMessage(error, options) {
   const { message } = await extractErrorDetails(error, options);
   return message;
 }
+// ../../common/src/command-examples.ts
+import { Command } from "commander";
+var examplesByCommand = new WeakMap;
+Command.prototype.examples = function(examples) {
+  examplesByCommand.set(this, examples);
+  return this;
+};
+// ../../common/src/singleton.ts
+var PREFIX = "@uipath/common/";
+var _g = globalThis;
+function singleton(ctorOrName) {
+  const name = typeof ctorOrName === "string" ? ctorOrName : ctorOrName.name;
+  const key = Symbol.for(PREFIX + name);
+  return {
+    get(fallback) {
+      return _g[key] ?? fallback;
+    },
+    set(value) {
+      _g[key] = value;
+    },
+    clear() {
+      delete _g[key];
+    },
+    getOrInit(factory, guard) {
+      const existing = _g[key];
+      if (existing != null && typeof existing === "object") {
+        if (!guard || guard(existing)) {
+          return existing;
+        }
+      }
+      const instance = factory();
+      _g[key] = instance;
+      return instance;
+    }
+  };
+}
+
+// ../../common/src/output-context.ts
+function createStorage() {
+  const [error, mod] = catchError(() => __require("node:async_hooks"));
+  if (error || typeof mod?.AsyncLocalStorage !== "function") {
+    return {
+      getStore: () => {
+        return;
+      },
+      run: (_store, fn) => fn()
+    };
+  }
+  return new mod.AsyncLocalStorage;
+}
+var storageSingleton = singleton("OutputStorage");
+var sinkSlot = singleton("OutputSink");
+var outputStorage = storageSingleton.getOrInit(createStorage, (v) => ("getStore" in v));
+var CONSOLE_FALLBACK = {
+  writeOut: (str) => process.stdout.write(str),
+  writeErr: (str) => process.stderr.write(str),
+  writeLog: (str) => process.stdout.write(str),
+  capabilities: {
+    isInteractive: false,
+    supportsColor: false,
+    outputWidth: 80
+  }
+};
+function getOutputSink() {
+  return outputStorage.getStore() ?? sinkSlot.get() ?? CONSOLE_FALLBACK;
+}
+// ../../common/src/completer.ts
+var COMPLETER_SYMBOL = Symbol.for("@uipath/common/completer");
+// ../../common/src/console-guard.ts
+var guardInstalledSlot = singleton("ConsoleGuardInstalled");
+var savedOriginalsSlot = singleton("ConsoleGuardOriginals");
+// ../../common/src/constants.ts
+var DEFAULT_PAGE_SIZE = 50;
+var DEFAULT_AUTH_TIMEOUT_MS = 5 * 60 * 1000;
 // ../../../node_modules/@jmespath-community/jmespath/dist/index.mjs
 var isObject = (obj) => {
   return obj !== null && Object.prototype.toString.call(obj) === "[object Object]";
@@ -24366,15 +24496,80 @@ class SuccessOutput {
     }
   }
 }
-function printOutput(data, format = "json", logFn) {
+function escapeNonAscii(jsonText) {
+  return jsonText.replace(/[\u0080-\uffff]/g, (c) => {
+    const hex = c.charCodeAt(0).toString(16).padStart(4, "0");
+    return `\\u${hex}`;
+  });
+}
+function needsAsciiSafeJson(sink) {
+  return process.platform === "win32" && !sink.capabilities.isInteractive;
+}
+function isPlainRecord(value) {
+  if (value === null || typeof value !== "object")
+    return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function toLowerCamelCaseKey(key) {
+  if (!key)
+    return key;
+  if (/[_\-\s]/.test(key)) {
+    const [firstPart, ...restParts] = key.split(/[_\-\s]+/).filter(Boolean);
+    if (!firstPart)
+      return key;
+    return [
+      toLowerCamelCaseSimpleKey(firstPart),
+      ...restParts.map((part) => {
+        const normalized = toLowerCamelCaseSimpleKey(part);
+        return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+      })
+    ].join("");
+  }
+  return toLowerCamelCaseSimpleKey(key);
+}
+function toLowerCamelCaseSimpleKey(key) {
+  if (/^[A-Z0-9]+$/.test(key))
+    return key.toLowerCase();
+  return key.replace(/^[A-Z]+(?=[A-Z][a-z]|\d|$)|^[A-Z]/, (match) => match.toLowerCase());
+}
+function toPascalCaseKey(key) {
+  const lowerCamelKey = toLowerCamelCaseKey(key);
+  return lowerCamelKey ? lowerCamelKey.charAt(0).toUpperCase() + lowerCamelKey.slice(1) : lowerCamelKey;
+}
+function toPascalCaseData(value) {
+  if (Array.isArray(value))
+    return value.map(toPascalCaseData);
+  if (!isPlainRecord(value))
+    return value;
+  const result = {};
+  for (const [key, nestedValue] of Object.entries(value)) {
+    result[toPascalCaseKey(key)] = toPascalCaseData(nestedValue);
+  }
+  return result;
+}
+function normalizeDataKeys(data) {
+  return toPascalCaseData(data);
+}
+function normalizeOutputKeys(data) {
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    const pascalKey = toPascalCaseKey(key);
+    result[pascalKey] = pascalKey === "Data" ? value : toPascalCaseData(value);
+  }
+  return result;
+}
+function printOutput(data, format = "json", logFn, asciiSafe = false) {
   if (!data) {
     logFn("Empty response object. No data to display.");
     return;
   }
   switch (format) {
-    case "json":
-      logFn(JSON.stringify(data, null, 2));
+    case "json": {
+      const json2 = JSON.stringify(data, null, 2);
+      logFn(asciiSafe ? escapeNonAscii(json2) : json2);
       break;
+    }
     case "yaml":
       logFn(toYaml(data));
       break;
@@ -24409,7 +24604,7 @@ function printOutput(data, format = "json", logFn) {
 function logOutput(data, format = "json") {
   const sink = getOutputSink();
   printOutput(data, format, (msg) => sink.writeOut(`${msg}
-`));
+`), needsAsciiSafeJson(sink));
 }
 function cellToString(val) {
   return val != null && typeof val === "object" ? JSON.stringify(val) : String(val ?? "");
@@ -24426,7 +24621,7 @@ function wrapText(text, width) {
 function printTable(data, logFn, externalLogValue) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   const maxWidths = keys.map((key) => Math.max(key.length, ...data.map((item) => cellToString(item[key]).length)));
   const header = keys.map((key, i2) => key.padEnd(maxWidths[i2])).join(" | ");
   logFn(header);
@@ -24441,7 +24636,7 @@ function printTable(data, logFn, externalLogValue) {
   }
 }
 function printVerticalTable(data, logFn = console.log, externalLogValue) {
-  const keys = Object.keys(data).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   if (keys.length === 0)
     return;
   const maxKeyWidth = Math.max(...keys.map((key) => key.length));
@@ -24457,7 +24652,7 @@ function printVerticalTable(data, logFn = console.log, externalLogValue) {
 function printResizableTable(data, logFn = console.log, externalLogValue) {
   if (data.length === 0)
     return;
-  const keys = Object.keys(data[0]).filter((key) => key !== "Code" && key !== "Log");
+  const keys = Object.keys(data[0]).filter((key) => !["code", "log"].includes(key.toLowerCase()));
   if (keys.length === 0)
     return;
   if (!process.stdout.isTTY) {
@@ -24533,8 +24728,26 @@ function printResizableTable(data, logFn = console.log, externalLogValue) {
 function toYaml(data) {
   return dump(data);
 }
+class FilterEvaluationError extends Error {
+  __brand = "FilterEvaluationError";
+  filter;
+  instructions;
+  result = RESULTS.ValidationError;
+  constructor(filter, cause) {
+    const underlying = cause instanceof Error ? cause.message : String(cause);
+    super(`Filter '${filter}' failed to evaluate: ${underlying}`);
+    this.name = "FilterEvaluationError";
+    this.filter = filter;
+    this.instructions = `The --output-filter expression '${filter}' failed at evaluation time. ` + "Note that --output-filter operates on the 'Data' field of the envelope, not the full object. " + "For example, on a list result use 'length(@)' instead of 'Data | length(@)'.";
+  }
+}
 function applyFilter(data, filter) {
-  const result = search(data, filter);
+  let result;
+  try {
+    result = search(data, filter);
+  } catch (err) {
+    throw new FilterEvaluationError(filter, err);
+  }
   if (result == null)
     return [];
   if (Array.isArray(result)) {
@@ -24551,13 +24764,18 @@ function applyFilter(data, filter) {
 }
 var OutputFormatter;
 ((OutputFormatter) => {
-  function success(data) {
+  function success(data, options) {
     data.Log ??= getLogFilePath() || undefined;
+    const normalize = !options?.preserveDataKeys;
+    if (normalize) {
+      data.Data = normalizeDataKeys(data.Data);
+    }
     const filter = getOutputFilter();
     if (filter) {
-      data.Data = applyFilter(data.Data, filter);
+      const filtered = applyFilter(data.Data, filter);
+      data.Data = normalize ? normalizeDataKeys(filtered) : filtered;
     }
-    logOutput(data, getOutputFormat());
+    logOutput(normalizeOutputKeys(data), getOutputFormat());
   }
   OutputFormatter.success = success;
   function error(data) {
@@ -24567,7 +24785,7 @@ var OutputFormatter;
       result: data.Result,
       message: data.Message
     });
-    logOutput(data, getOutputFormat());
+    logOutput(normalizeOutputKeys(data), getOutputFormat());
   }
   OutputFormatter.error = error;
   function emitList(code, items, opts) {
@@ -24588,11 +24806,14 @@ var OutputFormatter;
   function log(data) {
     const format = getOutputFormat();
     const sink = getOutputSink();
+    const normalized = toPascalCaseData(data);
     if (format === "json") {
-      sink.writeErr(`${JSON.stringify(data)}
+      const json2 = JSON.stringify(normalized);
+      const safe = needsAsciiSafeJson(sink) ? escapeNonAscii(json2) : json2;
+      sink.writeErr(`${safe}
 `);
     } else {
-      for (const [key, value] of Object.entries(data)) {
+      for (const [key, value] of Object.entries(normalized)) {
         sink.writeErr(`${key}: ${value}
 `);
       }
@@ -24601,13 +24822,18 @@ var OutputFormatter;
   OutputFormatter.log = log;
   function formatToString(data) {
     const filter = getOutputFilter();
-    if (filter && "Data" in data && data.Data != null) {
-      data.Data = applyFilter(data.Data, filter);
+    if ("Data" in data && data.Data != null) {
+      data.Data = normalizeDataKeys(data.Data);
+      if (filter) {
+        data.Data = normalizeDataKeys(applyFilter(data.Data, filter));
+      }
     }
+    const output = normalizeOutputKeys(data);
     const lines = [];
-    printOutput(data, getOutputFormat(), (msg) => {
+    const sink = getOutputSink();
+    printOutput(output, getOutputFormat(), (msg) => {
       lines.push(msg);
-    });
+    }, needsAsciiSafeJson(sink));
     return lines.join(`
 `);
   }
@@ -26016,8 +26242,65 @@ JSONPath.prototype.safeVm = {
   Script: SafeScript
 };
 JSONPath.prototype.vm = vm;
+// ../../common/src/option-aliases.ts
+import { Option } from "commander";
+function resolveDeprecatedOptionAlias({
+  preferredValue,
+  deprecatedValue,
+  preferredFlag,
+  deprecatedFlag
+}) {
+  const hasPreferred = preferredValue !== undefined;
+  const hasDeprecated = deprecatedValue !== undefined;
+  if (hasPreferred && hasDeprecated) {
+    return {
+      value: undefined,
+      usedDeprecated: true,
+      error: {
+        message: `${deprecatedFlag} and ${preferredFlag} are aliases. Use only ${preferredFlag}.`,
+        instructions: `Replace ${deprecatedFlag} with ${preferredFlag}.`
+      }
+    };
+  }
+  return {
+    value: hasPreferred ? preferredValue : deprecatedValue,
+    usedDeprecated: hasDeprecated
+  };
+}
+function warnDeprecatedOptionAlias(deprecatedFlag, preferredFlag) {
+  getOutputSink().writeErr(`[WARN] ${deprecatedFlag} is deprecated. Use ${preferredFlag} instead.
+`);
+}
+var TENANT_SWITCH_COMMAND = "uip login tenant set <tenant>";
+function createHiddenDeprecatedTenantOption(flags = "-t, --tenant <tenant-name>") {
+  return new Option(flags, `Tenant name. Deprecated; use ${TENANT_SWITCH_COMMAND} to switch active tenants.`).hideHelp().argParser((tenant) => {
+    warnDeprecatedTenantOption(tenant);
+    return tenant;
+  });
+}
+function warnDeprecatedTenantOption(tenant) {
+  if (tenant === undefined)
+    return;
+  warnDeprecatedOptionAlias("--tenant", TENANT_SWITCH_COMMAND);
+}
 // ../../common/src/option-validators.ts
 import { InvalidArgumentError } from "commander";
+// ../../common/src/polling/types.ts
+var PollOutcome = {
+  Completed: "completed",
+  Timeout: "timeout",
+  Interrupted: "interrupted",
+  Aborted: "aborted",
+  Failed: "failed"
+};
+
+// ../../common/src/polling/poll-failure-mapping.ts
+var REASON_BY_OUTCOME = {
+  [PollOutcome.Timeout]: "poll_timeout",
+  [PollOutcome.Failed]: "poll_failed",
+  [PollOutcome.Interrupted]: "poll_failed",
+  [PollOutcome.Aborted]: "poll_aborted"
+};
 // ../../common/src/polling/terminal-statuses.ts
 var TERMINAL_STATUSES = new Set([
   "completed",
@@ -26045,6 +26328,105 @@ var ScreenLogger;
   }
   ScreenLogger.progress = progress;
 })(ScreenLogger ||= {});
+// ../../common/src/sdk-user-agent.ts
+var USER_AGENT_HEADER = "User-Agent";
+var sdkUserAgentHostToken = singleton("SdkUserAgentHostToken");
+function userAgentPatchKey(userAgent) {
+  return Symbol.for(`@uipath/common/sdk-user-agent/${userAgent}`);
+}
+function splitUserAgentTokens(value) {
+  return value?.trim().split(/\s+/).filter(Boolean) ?? [];
+}
+function appendUserAgentToken(value, userAgent) {
+  const tokens = splitUserAgentTokens(value);
+  const seen = new Set(tokens);
+  for (const token of splitUserAgentTokens(userAgent)) {
+    if (!seen.has(token)) {
+      tokens.push(token);
+      seen.add(token);
+    }
+  }
+  return tokens.join(" ");
+}
+function getEffectiveUserAgent(userAgent) {
+  return appendUserAgentToken(sdkUserAgentHostToken.get(), userAgent);
+}
+function isHeadersLike(headers) {
+  return typeof headers === "object" && headers !== null && "get" in headers && typeof headers.get === "function" && "set" in headers && typeof headers.set === "function";
+}
+function getSdkUserAgentToken(pkg) {
+  const packageName = pkg.name.replace(/^@uipath\//, "");
+  return getEffectiveUserAgent(`${packageName}/${pkg.version}`);
+}
+function addSdkUserAgentHeader(headers, userAgent) {
+  const result = { ...headers ?? {} };
+  const effectiveUserAgent = getEffectiveUserAgent(userAgent);
+  const headerName = Object.keys(result).find((key) => key.toLowerCase() === USER_AGENT_HEADER.toLowerCase());
+  if (headerName) {
+    result[headerName] = appendUserAgentToken(result[headerName], effectiveUserAgent);
+  } else {
+    result[USER_AGENT_HEADER] = effectiveUserAgent;
+  }
+  return result;
+}
+function withSdkUserAgentHeader(headers, userAgent) {
+  const effectiveUserAgent = getEffectiveUserAgent(userAgent);
+  if (isHeadersLike(headers)) {
+    headers.set(USER_AGENT_HEADER, appendUserAgentToken(headers.get(USER_AGENT_HEADER), effectiveUserAgent));
+    return headers;
+  }
+  if (Array.isArray(headers)) {
+    const result = headers.map((entry) => {
+      const [key, value] = entry;
+      return [key, value];
+    });
+    const headerIndex = result.findIndex(([key]) => key.toLowerCase() === USER_AGENT_HEADER.toLowerCase());
+    if (headerIndex >= 0) {
+      const [key, value] = result[headerIndex];
+      result[headerIndex] = [
+        key,
+        appendUserAgentToken(value, effectiveUserAgent)
+      ];
+    } else {
+      result.push([USER_AGENT_HEADER, effectiveUserAgent]);
+    }
+    return result;
+  }
+  return addSdkUserAgentHeader(typeof headers === "object" && headers !== null ? { ...headers } : {}, effectiveUserAgent);
+}
+function withUserAgentInitOverride(initOverrides, userAgent) {
+  return async (requestContext) => {
+    const initWithUserAgent = {
+      ...requestContext.init,
+      headers: withSdkUserAgentHeader(requestContext.init.headers, userAgent)
+    };
+    const override = typeof initOverrides === "function" ? await initOverrides({
+      ...requestContext,
+      init: initWithUserAgent
+    }) : initOverrides;
+    return {
+      ...override ?? {},
+      headers: withSdkUserAgentHeader(override?.headers ?? initWithUserAgent.headers, userAgent)
+    };
+  };
+}
+function installSdkUserAgentHeader(BaseApiClass, userAgent) {
+  const prototype = BaseApiClass.prototype;
+  const patchKey = userAgentPatchKey(userAgent);
+  if (prototype[patchKey]) {
+    return;
+  }
+  if (typeof prototype.request !== "function") {
+    throw new Error("Generated BaseAPI request function not found.");
+  }
+  const originalRequest = prototype.request;
+  prototype.request = function requestWithUserAgent(context, initOverrides) {
+    return originalRequest.call(this, context, withUserAgentInitOverride(initOverrides, userAgent));
+  };
+  Object.defineProperty(prototype, patchKey, {
+    value: true
+  });
+}
 // ../../common/src/tool-provider.ts
 var factorySlot = singleton("PackagerFactoryProvider");
 // ../../common/src/trackedAction.ts
@@ -26230,13 +26612,17 @@ Command2.prototype.trackedAction = function(context, fn, properties) {
     const [error] = await catchError(fn(...args));
     if (error) {
       errorMessage = error instanceof Error ? error.message : String(error);
-      logger.error(`[trackedAction] ${telemetryName} failed: ${errorMessage}`);
+      logger.debug(`[trackedAction] ${telemetryName} failed: ${errorMessage}`);
+      const typed = error;
+      const customInstructions = typeof typed.instructions === "string" ? typed.instructions : undefined;
+      const customResult = typeof typed.result === "string" && typed.result !== RESULTS.Success && Object.values(RESULTS).includes(typed.result) ? typed.result : undefined;
+      const finalResult = customResult ?? RESULTS.Failure;
       OutputFormatter.error({
-        Result: RESULTS.Failure,
+        Result: finalResult,
         Message: errorMessage,
-        Instructions: "An unexpected error occurred. Run with --log-level debug for details."
+        Instructions: customInstructions ?? "An unexpected error occurred. Run with --log-level debug for details."
       });
-      context.exit(1);
+      context.exit(EXIT_CODES[finalResult]);
     }
     const durationMs = performance.now() - startTime;
     const success = !error && (process.exitCode === undefined || process.exitCode === 0);
@@ -26498,8 +26884,66 @@ class VoidApiResponse {
     return;
   }
 }
-
-// ../resourcecatalog-sdk/generated/src/models/TagType.ts
+// ../resourcecatalog-sdk/package.json
+var package_default2 = {
+  name: "@uipath/resourcecatalog-sdk",
+  license: "MIT",
+  version: "1.2.0",
+  description: "SDK for the UiPath Resource Catalog Service API.",
+  repository: {
+    type: "git",
+    url: "https://github.com/UiPath/cli.git",
+    directory: "packages/admin/resourcecatalog-sdk"
+  },
+  publishConfig: {
+    registry: "https://npm.pkg.github.com/@uipath"
+  },
+  keywords: [
+    "uipath",
+    "resource-catalog",
+    "sdk"
+  ],
+  type: "module",
+  main: "./dist/index.js",
+  types: "./dist/src/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/src/index.d.ts",
+      default: "./dist/index.js"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  private: true,
+  scripts: {
+    build: "bun build ./src/index.ts --outdir dist --format esm --target node && tsc -p tsconfig.build.json --noCheck",
+    generate: "bun run src/scripts/generate-sdk.ts",
+    lint: "biome check ."
+  },
+  devDependencies: {
+    "@openapitools/openapi-generator-cli": "^2.31.1",
+    "@types/node": "^25.5.2",
+    "@uipath/auth": "workspace:*",
+    "@uipath/common": "workspace:*",
+    "@uipath/filesystem": "workspace:*",
+    typescript: "^6.0.2"
+  }
+};
+
+// ../resourcecatalog-sdk/src/user-agent.ts
+var SDK_USER_AGENT = getSdkUserAgentToken(package_default2);
+installSdkUserAgentHeader(BaseAPI, SDK_USER_AGENT);
+
+// ../resourcecatalog-sdk/generated/src/models/EntitySearchState.ts
+function EntitySearchStateFromJSON(json2) {
+  return EntitySearchStateFromJSONTyped(json2, false);
+}
+function EntitySearchStateFromJSONTyped(json2, ignoreDiscriminator) {
+  return json2;
+}
+
+// ../resourcecatalog-sdk/generated/src/models/TagType.ts
 var TagType = {
   Label: "Label",
   KeyValue: "KeyValue"
@@ -26514,6 +26958,168 @@ function TagTypeToJSON(value) {
   return value;
 }
 
+// ../resourcecatalog-sdk/generated/src/models/TagModel.ts
+function TagModelFromJSON(json2) {
+  return TagModelFromJSONTyped(json2, false);
+}
+function TagModelFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    key: json2["key"] == null ? undefined : json2["key"],
+    displayName: json2["displayName"] == null ? undefined : json2["displayName"],
+    name: json2["name"] == null ? undefined : json2["name"],
+    displayValue: json2["displayValue"] == null ? undefined : json2["displayValue"],
+    value: json2["value"] == null ? undefined : json2["value"],
+    type: json2["type"] == null ? undefined : TagTypeFromJSON(json2["type"]),
+    accountKey: json2["accountKey"] == null ? undefined : json2["accountKey"],
+    tenantKey: json2["tenantKey"] == null ? undefined : json2["tenantKey"],
+    userKey: json2["userKey"] == null ? undefined : json2["userKey"]
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/EntityScope.ts
+function EntityScopeFromJSON(json2) {
+  return EntityScopeFromJSONTyped(json2, false);
+}
+function EntityScopeFromJSONTyped(json2, ignoreDiscriminator) {
+  return json2;
+}
+
+// ../resourcecatalog-sdk/generated/src/models/FolderType.ts
+function FolderTypeFromJSON(json2) {
+  return FolderTypeFromJSONTyped(json2, false);
+}
+function FolderTypeFromJSONTyped(json2, ignoreDiscriminator) {
+  return json2;
+}
+
+// ../resourcecatalog-sdk/generated/src/models/FolderModel.ts
+function FolderModelFromJSON(json2) {
+  return FolderModelFromJSONTyped(json2, false);
+}
+function FolderModelFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    id: json2["id"] == null ? undefined : json2["id"],
+    key: json2["key"] == null ? undefined : json2["key"],
+    displayName: json2["displayName"] == null ? undefined : json2["displayName"],
+    code: json2["code"] == null ? undefined : json2["code"],
+    fullyQualifiedName: json2["fullyQualifiedName"] == null ? undefined : json2["fullyQualifiedName"],
+    timestamp: json2["timestamp"] == null ? undefined : new Date(json2["timestamp"]),
+    tenantKey: json2["tenantKey"] == null ? undefined : json2["tenantKey"],
+    accountKey: json2["accountKey"] == null ? undefined : json2["accountKey"],
+    userKey: json2["userKey"] == null ? undefined : json2["userKey"],
+    type: json2["type"] == null ? undefined : FolderTypeFromJSON(json2["type"]),
+    path: json2["path"] == null ? undefined : json2["path"],
+    permissions: json2["permissions"] == null ? undefined : json2["permissions"]
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/EntityModel.ts
+function EntityModelFromJSON(json2) {
+  return EntityModelFromJSONTyped(json2, false);
+}
+function EntityModelFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    entityKey: json2["entityKey"] == null ? undefined : json2["entityKey"],
+    name: json2["name"] == null ? undefined : json2["name"],
+    description: json2["description"] == null ? undefined : json2["description"],
+    entityType: json2["entityType"] == null ? undefined : json2["entityType"],
+    tags: json2["tags"] == null ? undefined : json2["tags"].map(TagModelFromJSON),
+    folders: json2["folders"] == null ? undefined : json2["folders"].map(FolderModelFromJSON),
+    linkedFoldersCount: json2["linkedFoldersCount"] == null ? undefined : json2["linkedFoldersCount"],
+    source: json2["source"] == null ? undefined : json2["source"],
+    scope: json2["scope"] == null ? undefined : EntityScopeFromJSON(json2["scope"]),
+    searchState: json2["searchState"] == null ? undefined : EntitySearchStateFromJSON(json2["searchState"]),
+    timestamp: json2["timestamp"] == null ? undefined : new Date(json2["timestamp"]),
+    folderKey: json2["folderKey"] == null ? undefined : json2["folderKey"],
+    folderKeys: json2["folderKeys"] == null ? undefined : json2["folderKeys"],
+    tenantKey: json2["tenantKey"] == null ? undefined : json2["tenantKey"],
+    accountKey: json2["accountKey"] == null ? undefined : json2["accountKey"],
+    userKey: json2["userKey"] == null ? undefined : json2["userKey"],
+    dependencies: json2["dependencies"] == null ? undefined : json2["dependencies"],
+    customData: json2["customData"] == null ? undefined : json2["customData"],
+    entitySubType: json2["entitySubType"] == null ? undefined : json2["entitySubType"]
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/EntityModelPaginationResult.ts
+function EntityModelPaginationResultFromJSON(json2) {
+  return EntityModelPaginationResultFromJSONTyped(json2, false);
+}
+function EntityModelPaginationResultFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    count: json2["count"] == null ? undefined : json2["count"],
+    value: json2["value"] == null ? undefined : json2["value"].map(EntityModelFromJSON)
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/FolderDto.ts
+function FolderDtoFromJSON(json2) {
+  return FolderDtoFromJSONTyped(json2, false);
+}
+function FolderDtoFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    key: json2["key"] == null ? undefined : json2["key"],
+    fullyQualifiedName: json2["fullyQualifiedName"] == null ? undefined : json2["fullyQualifiedName"],
+    isPersonal: json2["isPersonal"] == null ? undefined : json2["isPersonal"],
+    folderType: json2["folderType"] == null ? undefined : FolderTypeFromJSON(json2["folderType"])
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/FolderEntityModel.ts
+function FolderEntityModelFromJSON(json2) {
+  return FolderEntityModelFromJSONTyped(json2, false);
+}
+function FolderEntityModelFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    folderKey: json2["folderKey"] == null ? undefined : json2["folderKey"],
+    folderName: json2["folderName"] == null ? undefined : json2["folderName"],
+    folderCode: json2["folderCode"] == null ? undefined : json2["folderCode"],
+    fullyQualifiedName: json2["fullyQualifiedName"] == null ? undefined : json2["fullyQualifiedName"],
+    folderType: json2["folderType"] == null ? undefined : FolderTypeFromJSON(json2["folderType"]),
+    folderPath: json2["folderPath"] == null ? undefined : json2["folderPath"],
+    entityKey: json2["entityKey"] == null ? undefined : json2["entityKey"],
+    entityName: json2["entityName"] == null ? undefined : json2["entityName"],
+    entityDescription: json2["entityDescription"] == null ? undefined : json2["entityDescription"],
+    entityType: json2["entityType"] == null ? undefined : json2["entityType"],
+    entitySubType: json2["entitySubType"] == null ? undefined : json2["entitySubType"],
+    entitySource: json2["entitySource"] == null ? undefined : json2["entitySource"]
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/FolderEntityModelCursorPaginationResult.ts
+function FolderEntityModelCursorPaginationResultFromJSON(json2) {
+  return FolderEntityModelCursorPaginationResultFromJSONTyped(json2, false);
+}
+function FolderEntityModelCursorPaginationResultFromJSONTyped(json2, ignoreDiscriminator) {
+  if (json2 == null) {
+    return json2;
+  }
+  return {
+    items: json2["items"] == null ? undefined : json2["items"].map(FolderEntityModelFromJSON),
+    totalCount: json2["totalCount"] == null ? undefined : json2["totalCount"],
+    nextPage: json2["nextPage"] == null ? undefined : json2["nextPage"],
+    previousPage: json2["previousPage"] == null ? undefined : json2["previousPage"]
+  };
+}
+
 // ../resourcecatalog-sdk/generated/src/models/TagReferencesModel.ts
 function TagReferencesModelFromJSON(json2) {
   return TagReferencesModelFromJSONTyped(json2, false);
@@ -26635,27 +27241,464 @@ function TagValueModelPaginationResultFromJSONTyped(json2, ignoreDiscriminator)
   if (json2 == null) {
     return json2;
   }
-  return {
-    count: json2["count"] == null ? undefined : json2["count"],
-    value: json2["value"] == null ? undefined : json2["value"].map(TagValueModelFromJSON)
-  };
-}
-
-// ../resourcecatalog-sdk/generated/src/models/ValueModel.ts
-function ValueModelToJSON(json2) {
-  return ValueModelToJSONTyped(json2, false);
-}
-function ValueModelToJSONTyped(value, ignoreDiscriminator = false) {
-  if (value == null) {
-    return value;
+  return {
+    count: json2["count"] == null ? undefined : json2["count"],
+    value: json2["value"] == null ? undefined : json2["value"].map(TagValueModelFromJSON)
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/models/ValueModel.ts
+function ValueModelToJSON(json2) {
+  return ValueModelToJSONTyped(json2, false);
+}
+function ValueModelToJSONTyped(value, ignoreDiscriminator = false) {
+  if (value == null) {
+    return value;
+  }
+  return {
+    labelKey: value["labelKey"],
+    values: value["values"],
+    accountKey: value["accountKey"],
+    tenantKey: value["tenantKey"],
+    userKey: value["userKey"]
+  };
+}
+
+// ../resourcecatalog-sdk/generated/src/apis/EntitiesApi.ts
+class EntitiesApi extends BaseAPI {
+  async entitiesGetRaw(requestParameters, initOverrides) {
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGet().');
+    }
+    const queryParameters = {};
+    if (requestParameters["skip"] != null) {
+      queryParameters["skip"] = requestParameters["skip"];
+    }
+    if (requestParameters["take"] != null) {
+      queryParameters["take"] = requestParameters["take"];
+    }
+    if (requestParameters["entityTypes"] != null) {
+      queryParameters["entityTypes"] = requestParameters["entityTypes"];
+    }
+    if (requestParameters["entitySubType"] != null) {
+      queryParameters["entitySubType"] = requestParameters["entitySubType"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (requestParameters["xUIPATHOrganizationUnitId"] != null) {
+      headerParameters["X-UIPATH-OrganizationUnitId"] = String(requestParameters["xUIPATHOrganizationUnitId"]);
+    }
+    if (requestParameters["xUIPATHFolderPath"] != null) {
+      headerParameters["X-UIPATH-FolderPath"] = String(requestParameters["xUIPATHFolderPath"]);
+    }
+    if (requestParameters["xUIPATHFolderPathEncoded"] != null) {
+      headerParameters["X-UIPATH-FolderPath-Encoded"] = String(requestParameters["xUIPATHFolderPathEncoded"]);
+    }
+    if (requestParameters["xUIPATHFolderKey"] != null) {
+      headerParameters["X-UIPATH-FolderKey"] = String(requestParameters["xUIPATHFolderKey"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities`;
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => EntityModelPaginationResultFromJSON(jsonValue));
+  }
+  async entitiesGet(requestParameters, initOverrides) {
+    const response = await this.entitiesGetRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesGetByEntityTypeRaw(requestParameters, initOverrides) {
+    if (requestParameters["entityType"] == null) {
+      throw new RequiredError("entityType", 'Required parameter "entityType" was null or undefined when calling entitiesGetByEntityType().');
+    }
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGetByEntityType().');
+    }
+    const queryParameters = {};
+    if (requestParameters["name"] != null) {
+      queryParameters["name"] = requestParameters["name"];
+    }
+    if (requestParameters["skip"] != null) {
+      queryParameters["skip"] = requestParameters["skip"];
+    }
+    if (requestParameters["take"] != null) {
+      queryParameters["take"] = requestParameters["take"];
+    }
+    if (requestParameters["entitySubType"] != null) {
+      queryParameters["entitySubType"] = requestParameters["entitySubType"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (requestParameters["xUIPATHOrganizationUnitId"] != null) {
+      headerParameters["X-UIPATH-OrganizationUnitId"] = String(requestParameters["xUIPATHOrganizationUnitId"]);
+    }
+    if (requestParameters["xUIPATHFolderPath"] != null) {
+      headerParameters["X-UIPATH-FolderPath"] = String(requestParameters["xUIPATHFolderPath"]);
+    }
+    if (requestParameters["xUIPATHFolderPathEncoded"] != null) {
+      headerParameters["X-UIPATH-FolderPath-Encoded"] = String(requestParameters["xUIPATHFolderPathEncoded"]);
+    }
+    if (requestParameters["xUIPATHFolderKey"] != null) {
+      headerParameters["X-UIPATH-FolderKey"] = String(requestParameters["xUIPATHFolderKey"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/{entityType}`;
+    urlPath = urlPath.replace(`{${"entityType"}}`, encodeURIComponent(String(requestParameters["entityType"])));
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => EntityModelPaginationResultFromJSON(jsonValue));
+  }
+  async entitiesGetByEntityType(requestParameters, initOverrides) {
+    const response = await this.entitiesGetByEntityTypeRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesGetDependenciesRaw(requestParameters, initOverrides) {
+    if (requestParameters["entityKey"] == null) {
+      throw new RequiredError("entityKey", 'Required parameter "entityKey" was null or undefined when calling entitiesGetDependencies().');
+    }
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGetDependencies().');
+    }
+    const queryParameters = {};
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/{entityKey}/Dependencies`;
+    urlPath = urlPath.replace(`{${"entityKey"}}`, encodeURIComponent(String(requestParameters["entityKey"])));
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => jsonValue.map(EntityModelFromJSON));
+  }
+  async entitiesGetDependencies(requestParameters, initOverrides) {
+    const response = await this.entitiesGetDependenciesRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesGetEntitiesByKeysRaw(requestParameters, initOverrides) {
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGetEntitiesByKeys().');
+    }
+    const queryParameters = {};
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    headerParameters["Content-Type"] = "application/json";
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/GetEntitiesByKeys`;
+    const response = await this.request({
+      path: urlPath,
+      method: "POST",
+      headers: headerParameters,
+      query: queryParameters,
+      body: requestParameters["requestBody"]
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => jsonValue.map(EntityModelFromJSON));
+  }
+  async entitiesGetEntitiesByKeys(requestParameters, initOverrides) {
+    const response = await this.entitiesGetEntitiesByKeysRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesGetFoldersRaw(requestParameters, initOverrides) {
+    if (requestParameters["entityType"] == null) {
+      throw new RequiredError("entityType", 'Required parameter "entityType" was null or undefined when calling entitiesGetFolders().');
+    }
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGetFolders().');
+    }
+    const queryParameters = {};
+    if (requestParameters["permissions"] != null) {
+      queryParameters["permissions"] = requestParameters["permissions"];
+    }
+    if (requestParameters["folderTypes"] != null) {
+      queryParameters["folderTypes"] = requestParameters["folderTypes"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/{entityType}/Folders`;
+    urlPath = urlPath.replace(`{${"entityType"}}`, encodeURIComponent(String(requestParameters["entityType"])));
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => jsonValue.map(FolderDtoFromJSON));
+  }
+  async entitiesGetFolders(requestParameters, initOverrides) {
+    const response = await this.entitiesGetFoldersRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesGetPermissionsRaw(requestParameters, initOverrides) {
+    if (requestParameters["entityType"] == null) {
+      throw new RequiredError("entityType", 'Required parameter "entityType" was null or undefined when calling entitiesGetPermissions().');
+    }
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesGetPermissions().');
+    }
+    const queryParameters = {};
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (requestParameters["xUIPATHOrganizationUnitId"] != null) {
+      headerParameters["X-UIPATH-OrganizationUnitId"] = String(requestParameters["xUIPATHOrganizationUnitId"]);
+    }
+    if (requestParameters["xUIPATHFolderPath"] != null) {
+      headerParameters["X-UIPATH-FolderPath"] = String(requestParameters["xUIPATHFolderPath"]);
+    }
+    if (requestParameters["xUIPATHFolderPathEncoded"] != null) {
+      headerParameters["X-UIPATH-FolderPath-Encoded"] = String(requestParameters["xUIPATHFolderPathEncoded"]);
+    }
+    if (requestParameters["xUIPATHFolderKey"] != null) {
+      headerParameters["X-UIPATH-FolderKey"] = String(requestParameters["xUIPATHFolderKey"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/{entityType}/Permissions`;
+    urlPath = urlPath.replace(`{${"entityType"}}`, encodeURIComponent(String(requestParameters["entityType"])));
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response);
+  }
+  async entitiesGetPermissions(requestParameters, initOverrides) {
+    const response = await this.entitiesGetPermissionsRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesSearchRaw(requestParameters, initOverrides) {
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesSearch().');
+    }
+    const queryParameters = {};
+    if (requestParameters["name"] != null) {
+      queryParameters["name"] = requestParameters["name"];
+    }
+    if (requestParameters["skip"] != null) {
+      queryParameters["skip"] = requestParameters["skip"];
+    }
+    if (requestParameters["take"] != null) {
+      queryParameters["take"] = requestParameters["take"];
+    }
+    if (requestParameters["entityTypes"] != null) {
+      queryParameters["entityTypes"] = requestParameters["entityTypes"];
+    }
+    if (requestParameters["entitySubType"] != null) {
+      queryParameters["entitySubType"] = requestParameters["entitySubType"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (requestParameters["xUIPATHOrganizationUnitId"] != null) {
+      headerParameters["X-UIPATH-OrganizationUnitId"] = String(requestParameters["xUIPATHOrganizationUnitId"]);
+    }
+    if (requestParameters["xUIPATHFolderPath"] != null) {
+      headerParameters["X-UIPATH-FolderPath"] = String(requestParameters["xUIPATHFolderPath"]);
+    }
+    if (requestParameters["xUIPATHFolderPathEncoded"] != null) {
+      headerParameters["X-UIPATH-FolderPath-Encoded"] = String(requestParameters["xUIPATHFolderPathEncoded"]);
+    }
+    if (requestParameters["xUIPATHFolderKey"] != null) {
+      headerParameters["X-UIPATH-FolderKey"] = String(requestParameters["xUIPATHFolderKey"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/Search`;
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => EntityModelPaginationResultFromJSON(jsonValue));
+  }
+  async entitiesSearch(requestParameters, initOverrides) {
+    const response = await this.entitiesSearchRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
+  async entitiesSearchFolderEntitiesRaw(requestParameters, initOverrides) {
+    if (requestParameters["xUiPathInternalAccountId"] == null) {
+      throw new RequiredError("xUiPathInternalAccountId", 'Required parameter "xUiPathInternalAccountId" was null or undefined when calling entitiesSearchFolderEntities().');
+    }
+    const queryParameters = {};
+    if (requestParameters["name"] != null) {
+      queryParameters["name"] = requestParameters["name"];
+    }
+    if (requestParameters["pageCursor"] != null) {
+      queryParameters["pageCursor"] = requestParameters["pageCursor"];
+    }
+    if (requestParameters["pageSize"] != null) {
+      queryParameters["pageSize"] = requestParameters["pageSize"];
+    }
+    if (requestParameters["entityTypes"] != null) {
+      queryParameters["entityTypes"] = requestParameters["entityTypes"];
+    }
+    if (requestParameters["entitySubTypes"] != null) {
+      queryParameters["entitySubTypes"] = requestParameters["entitySubTypes"];
+    }
+    if (requestParameters["folderTypes"] != null) {
+      queryParameters["folderTypes"] = requestParameters["folderTypes"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (requestParameters["xVersion"] != null) {
+      headerParameters["X-Version"] = String(requestParameters["xVersion"]);
+    }
+    if (requestParameters["xUiPathInternalAccountId"] != null) {
+      headerParameters["X-UiPath-Internal-AccountId"] = String(requestParameters["xUiPathInternalAccountId"]);
+    }
+    if (requestParameters["xUiPathInternalTenantId"] != null) {
+      headerParameters["X-UiPath-Internal-TenantId"] = String(requestParameters["xUiPathInternalTenantId"]);
+    }
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/Entities/SearchFolderEntities`;
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse(response, (jsonValue) => FolderEntityModelCursorPaginationResultFromJSON(jsonValue));
+  }
+  async entitiesSearchFolderEntities(requestParameters, initOverrides) {
+    const response = await this.entitiesSearchFolderEntitiesRaw(requestParameters, initOverrides);
+    return await response.value();
   }
-  return {
-    labelKey: value["labelKey"],
-    values: value["values"],
-    accountKey: value["accountKey"],
-    tenantKey: value["tenantKey"],
-    userKey: value["userKey"]
-  };
 }
 
 // ../resourcecatalog-sdk/generated/src/apis/TagsApi.ts
@@ -27256,30 +28299,7 @@ class InvalidBaseUrlError extends Error {
     this.name = "InvalidBaseUrlError";
   }
 }
-var DEFAULT_SCOPES = [
-  "offline_access",
-  "ProcessMining",
-  "OrchestratorApiUserAccess",
-  "StudioWebBackend",
-  "IdentityServerApi",
-  "ConnectionService",
-  "DataService",
-  "DataServiceApiUserAccess",
-  "DocumentUnderstanding",
-  "EnterpriseContextService",
-  "Directory",
-  "JamJamApi",
-  "LLMGateway",
-  "LLMOps",
-  "OMS",
-  "RCS.FolderAuthorization",
-  "RCS.TagsManagement",
-  "TestmanagerApiUserAccess",
-  "AutomationSolutions",
-  "StudioWebTypeCacheService",
-  "Docs.GPT.Search",
-  "Insights"
-];
+var DEFAULT_SCOPES = ["openid", "profile", "offline_access"];
 var normalizeAndValidateBaseUrl = (rawUrl) => {
   let baseUrl = rawUrl;
   if (baseUrl.endsWith("/identity_/")) {
@@ -27329,7 +28349,8 @@ var resolveConfigAsync = async ({
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const scopes = customScopes && customScopes.length > 0 ? customScopes : fileAuth.scopes && fileAuth.scopes.length > 0 ? fileAuth.scopes : DEFAULT_SCOPES;
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && Boolean(clientSecret);
+  const scopes = customScopes && customScopes.length > 0 ? customScopes : fileAuth.scopes && fileAuth.scopes.length > 0 ? fileAuth.scopes : isExternalAppAuth ? [] : DEFAULT_SCOPES;
   return {
     clientId,
     clientSecret,
@@ -27417,6 +28438,7 @@ var getTokenExpiration = (accessToken) => {
 
 // ../../auth/src/envAuth.ts
 var ENV_AUTH_ENABLE_VAR = "UIPATH_CLI_ENABLE_ENV_AUTH";
+var ENFORCE_ROBOT_AUTH_VAR = "UIPATH_CLI_ENFORCE_ROBOT_AUTH";
 var ENV_AUTH_VARS = {
   token: "UIPATH_CLI_AUTH_TOKEN",
   organizationName: "UIPATH_CLI_ORGANIZATION_NAME",
@@ -27432,6 +28454,7 @@ class EnvAuthConfigError extends Error {
   }
 }
 var isEnvAuthEnabled = () => process.env[ENV_AUTH_ENABLE_VAR] === "true";
+var isRobotAuthEnforced = () => process.env[ENFORCE_ROBOT_AUTH_VAR] === "true";
 var requireEnv = (name) => {
   const value = process.env[name];
   if (!value) {
@@ -27473,7 +28496,9 @@ var readAuthFromEnv = () => {
     expiration
   };
 };
+
 // ../../auth/src/robotClientFallback.ts
+init_src();
 var DEFAULT_TIMEOUT_MS = 1000;
 var CLOSE_TIMEOUT_MS = 500;
 var NOTICE_SENTINEL = Symbol.for("@uipath/auth/robotFallbackNoticePrinted");
@@ -27485,6 +28510,35 @@ var printNoticeOnce = () => {
   catchError2(() => process.stderr.write(`Using UiPath Robot credentials. Run 'uip login' for a dedicated session.
 `));
 };
+var ROBOT_USER_SERVICES_PIPE = "UiPathUserServices";
+var ROBOT_USER_SERVICES_ALTERNATE_PIPE = `${ROBOT_USER_SERVICES_PIPE}Alternate`;
+var PIPE_NAME_MAX_LENGTH = 103;
+var getRobotIpcPipeNames = async () => {
+  const fs7 = getFileSystem();
+  const username = fs7.env.getenv("USER") ?? fs7.env.getenv("USERNAME");
+  if (!username) {
+    throw new Error("Unable to determine current username");
+  }
+  const tempPath = fs7.env.getenv("TMPDIR") ?? "/tmp/";
+  return [ROBOT_USER_SERVICES_PIPE, ROBOT_USER_SERVICES_ALTERNATE_PIPE].map((baseName) => fs7.path.join(tempPath, `${baseName}_${username}`).substring(0, PIPE_NAME_MAX_LENGTH));
+};
+var defaultIsRobotIpcAvailable = async () => {
+  if (process.platform === "win32") {
+    return true;
+  }
+  const [pipeNamesError, pipeNames] = await catchError2(getRobotIpcPipeNames());
+  if (pipeNamesError || !pipeNames) {
+    return false;
+  }
+  const fs7 = getFileSystem();
+  for (const pipeName of pipeNames) {
+    const [existsError, exists] = await catchError2(fs7.exists(pipeName));
+    if (!existsError && exists === true) {
+      return true;
+    }
+  }
+  return false;
+};
 var withTimeout = (promise, timeoutMs) => new Promise((resolve2, reject) => {
   const timer = setTimeout(() => reject(new Error(`Robot IPC call timed out after ${timeoutMs}ms`)), timeoutMs);
   promise.then((value) => {
@@ -27516,14 +28570,20 @@ var defaultLoadModule = async () => {
 var tryRobotClientFallback = async (options = {}) => {
   if (isBrowser())
     return;
-  if (process.env.CI || process.env.GITHUB_ACTIONS) {
-    return;
-  }
-  if (process.env.UIPATH_URL) {
-    return;
+  if (!options.force) {
+    if (process.env.CI || process.env.GITHUB_ACTIONS) {
+      return;
+    }
+    if (process.env.UIPATH_URL) {
+      return;
+    }
   }
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const isRobotIpcAvailable = options.isRobotIpcAvailable ?? defaultIsRobotIpcAvailable;
   const loadModule = options.loadModule ?? defaultLoadModule;
+  if (!await isRobotIpcAvailable()) {
+    return;
+  }
   const mod2 = await loadModule();
   if (!mod2)
     return;
@@ -27790,11 +28850,130 @@ function normalizeTokenRefreshFailure() {
 function normalizeTokenRefreshUnavailableFailure() {
   return "token refresh failed before authentication completed";
 }
-var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
-  if (isEnvAuthEnabled()) {
-    return readAuthFromEnv();
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function computeExpirationThreshold(ensureTokenValidityMinutes) {
+  return new Date(Date.now() + (ensureTokenValidityMinutes ?? 0) * 60 * 1000);
+}
+async function runRefreshLocked(inputs) {
+  const {
+    absolutePath,
+    refreshToken: callerRefreshToken,
+    customAuthority,
+    ensureTokenValidityMinutes,
+    loadEnvFile,
+    saveEnvFile,
+    refreshFn,
+    resolveConfig
+  } = inputs;
+  const expirationThreshold = computeExpirationThreshold(ensureTokenValidityMinutes);
+  let fresh;
+  try {
+    fresh = await loadEnvFile({ envPath: absolutePath });
+  } catch (error) {
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint: "Could not read the auth file while refreshing. Retry, or run 'uip login' to re-authenticate.",
+        tokenRefresh: {
+          attempted: false,
+          success: false,
+          errorMessage: `auth file read failed: ${errorMessage(error)}`
+        }
+      }
+    };
   }
-  const { envFilePath = DEFAULT_ENV_FILENAME, ensureTokenValidityMinutes } = options;
+  const freshAccess = fresh.UIPATH_ACCESS_TOKEN;
+  const freshExp = freshAccess ? getTokenExpiration(freshAccess) : undefined;
+  if (freshAccess && freshExp && freshExp > expirationThreshold) {
+    return {
+      kind: "ok",
+      accessToken: freshAccess,
+      refreshToken: fresh.UIPATH_REFRESH_TOKEN ?? callerRefreshToken,
+      expiration: freshExp,
+      tokenRefresh: { attempted: false, success: true }
+    };
+  }
+  const tokenForIdP = fresh.UIPATH_REFRESH_TOKEN ?? callerRefreshToken;
+  let refreshedAccess;
+  let refreshedRefresh;
+  try {
+    const config = await resolveConfig({ customAuthority });
+    const refreshed = await refreshFn({
+      refreshToken: tokenForIdP,
+      tokenEndpoint: config.tokenEndpoint,
+      clientId: config.clientId,
+      expectedAuthority: customAuthority
+    });
+    refreshedAccess = refreshed.accessToken;
+    refreshedRefresh = refreshed.refreshToken;
+  } catch (error) {
+    const isOAuthFailure = isTokenRefreshOAuthFailure(error);
+    const hint = isOAuthFailure ? "Run 'uip login' to re-authenticate — the stored refresh token is invalid or expired." : "Token refresh failed. Check your network connection, then retry or run 'uip login' to re-authenticate.";
+    const message = isOAuthFailure ? normalizeTokenRefreshFailure() : normalizeTokenRefreshUnavailableFailure();
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint,
+        tokenRefresh: {
+          attempted: true,
+          success: false,
+          errorMessage: message
+        }
+      }
+    };
+  }
+  const refreshedExp = getTokenExpiration(refreshedAccess);
+  if (!refreshedExp || refreshedExp <= new Date) {
+    return {
+      kind: "fail",
+      status: {
+        loginStatus: "Refresh Failed",
+        hint: "The identity server returned an unusable token. Run 'uip login' to re-authenticate.",
+        tokenRefresh: {
+          attempted: true,
+          success: false,
+          errorMessage: "refreshed token has no valid expiration claim"
+        }
+      }
+    };
+  }
+  try {
+    await saveEnvFile({
+      envPath: absolutePath,
+      data: {
+        UIPATH_ACCESS_TOKEN: refreshedAccess,
+        UIPATH_REFRESH_TOKEN: refreshedRefresh
+      },
+      merge: true
+    });
+    return {
+      kind: "ok",
+      accessToken: refreshedAccess,
+      refreshToken: refreshedRefresh,
+      expiration: refreshedExp,
+      tokenRefresh: { attempted: true, success: true }
+    };
+  } catch (error) {
+    const msg = errorMessage(error);
+    return {
+      kind: "ok",
+      accessToken: refreshedAccess,
+      refreshToken: refreshedRefresh,
+      expiration: refreshedExp,
+      persistenceWarning: `Access token refreshed in memory but could not be written to ${absolutePath}: ${msg}. The next CLI invocation will fail until the file can be updated — run 'uip login' to re-authenticate.`,
+      tokenRefresh: {
+        attempted: true,
+        success: true,
+        errorMessage: `persistence failed: ${msg}`
+      }
+    };
+  }
+}
+var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
   const {
     resolveEnvFilePath = resolveEnvFilePathAsync,
     loadEnvFile = loadEnvFileAsync,
@@ -27804,6 +28983,34 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
     resolveConfig = resolveConfigAsync,
     robotFallback = tryRobotClientFallback
   } = deps;
+  if (isRobotAuthEnforced()) {
+    if (isEnvAuthEnabled()) {
+      throw new EnvAuthConfigError(`${ENV_AUTH_ENABLE_VAR}=true and ${ENFORCE_ROBOT_AUTH_VAR}=true ` + `are mutually exclusive. Unset one of them and re-run.`);
+    }
+    const robotCreds = await robotFallback({ force: true });
+    if (!robotCreds) {
+      return {
+        loginStatus: "Not logged in",
+        hint: `${ENFORCE_ROBOT_AUTH_VAR}=true but the UiPath Robot ` + `session is unavailable. Start and sign in to the Assistant, ` + `or unset ${ENFORCE_ROBOT_AUTH_VAR} to fall back to file or ` + `env-var authentication.`
+      };
+    }
+    const expiration2 = getTokenExpiration(robotCreds.accessToken);
+    return {
+      loginStatus: "Logged in",
+      accessToken: robotCreds.accessToken,
+      baseUrl: robotCreds.baseUrl,
+      organizationName: robotCreds.organizationName,
+      organizationId: robotCreds.organizationId,
+      tenantName: robotCreds.tenantName,
+      tenantId: robotCreds.tenantId,
+      expiration: expiration2,
+      source: "robot" /* Robot */
+    };
+  }
+  if (isEnvAuthEnabled()) {
+    return readAuthFromEnv();
+  }
+  const { envFilePath = DEFAULT_ENV_FILENAME, ensureTokenValidityMinutes } = options;
   const { absolutePath } = await resolveEnvFilePath(envFilePath);
   if (absolutePath === undefined) {
     const robotCreds = await robotFallback();
@@ -27840,73 +29047,103 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
   let refreshToken = credentials.UIPATH_REFRESH_TOKEN;
   let expiration = getTokenExpiration(accessToken);
   let persistenceWarning;
+  let lockReleaseFailed = false;
   let tokenRefresh;
-  const expirationThreshold = new Date(Date.now() + (ensureTokenValidityMinutes ?? 0) * 60 * 1000);
-  if (expiration && expiration <= expirationThreshold && refreshToken) {
-    let refreshedAccess;
-    let refreshedRefresh;
+  const outerThreshold = computeExpirationThreshold(ensureTokenValidityMinutes);
+  const tryGlobalCredsHint = async () => {
+    const fs7 = getFs();
+    const globalPath = fs7.path.join(fs7.env.homedir(), envFilePath);
+    if (absolutePath === globalPath)
+      return;
+    if (!await fs7.exists(globalPath))
+      return;
     try {
-      const config = await resolveConfig({
-        customAuthority: credentials.UIPATH_URL
-      });
-      const refreshed = await refreshTokenFn({
-        refreshToken,
-        tokenEndpoint: config.tokenEndpoint,
-        clientId: config.clientId,
-        expectedAuthority: credentials.UIPATH_URL
-      });
-      refreshedAccess = refreshed.accessToken;
-      refreshedRefresh = refreshed.refreshToken;
-    } catch (error) {
-      const isOAuthFailure = isTokenRefreshOAuthFailure(error);
-      const hint = isOAuthFailure ? "Run 'uip login' to re-authenticate — the stored refresh token is invalid or expired." : "Token refresh failed. Check your network connection, then retry or run 'uip login' to re-authenticate.";
-      const errorMessage = isOAuthFailure ? normalizeTokenRefreshFailure() : normalizeTokenRefreshUnavailableFailure();
-      return {
-        loginStatus: "Refresh Failed",
-        hint,
-        tokenRefresh: {
-          attempted: true,
-          success: false,
-          errorMessage
-        }
-      };
+      const globalCreds = await loadEnvFile({ envPath: globalPath });
+      if (!globalCreds.UIPATH_ACCESS_TOKEN)
+        return;
+      const globalExp = getTokenExpiration(globalCreds.UIPATH_ACCESS_TOKEN);
+      if (globalExp && globalExp <= new Date)
+        return;
+      return `Local credentials file at ${absolutePath} has expired credentials. Valid credentials exist in ${globalPath}. Remove the local file or run 'uip login' to re-authenticate.`;
+    } catch {
+      return;
     }
-    const refreshedExp = getTokenExpiration(refreshedAccess);
-    if (!refreshedExp || refreshedExp <= new Date) {
+  };
+  if (expiration && expiration <= outerThreshold && refreshToken) {
+    let release;
+    try {
+      release = await getFs().acquireLock(absolutePath);
+    } catch (error) {
+      const msg = errorMessage(error);
+      const globalHint = await tryGlobalCredsHint();
+      if (globalHint) {
+        return {
+          loginStatus: "Expired",
+          accessToken,
+          refreshToken,
+          baseUrl: credentials.UIPATH_URL,
+          organizationName: credentials.UIPATH_ORGANIZATION_NAME,
+          organizationId: credentials.UIPATH_ORGANIZATION_ID,
+          tenantName: credentials.UIPATH_TENANT_NAME,
+          tenantId: credentials.UIPATH_TENANT_ID,
+          expiration,
+          source: "file" /* File */,
+          hint: globalHint,
+          tokenRefresh: {
+            attempted: false,
+            success: false,
+            errorMessage: `lock acquisition failed: ${msg}`
+          }
+        };
+      }
       return {
         loginStatus: "Refresh Failed",
-        hint: "The identity server returned an unusable token. Run 'uip login' to re-authenticate.",
+        hint: "Could not acquire the auth-file lock — too many concurrent `uip` processes, or a permission issue on the auth directory. Retry, or run 'uip login' to re-authenticate.",
         tokenRefresh: {
-          attempted: true,
+          attempted: false,
           success: false,
-          errorMessage: "refreshed token has no valid expiration claim"
+          errorMessage: `lock acquisition failed: ${msg}`
         }
       };
     }
-    accessToken = refreshedAccess;
-    refreshToken = refreshedRefresh;
-    expiration = refreshedExp;
+    let lockedFailure;
     try {
-      await saveEnvFile({
-        envPath: absolutePath,
-        data: {
-          UIPATH_ACCESS_TOKEN: accessToken,
-          UIPATH_REFRESH_TOKEN: refreshToken
-        },
-        merge: true
+      const outcome = await runRefreshLocked({
+        absolutePath,
+        refreshToken,
+        customAuthority: credentials.UIPATH_URL,
+        ensureTokenValidityMinutes,
+        loadEnvFile,
+        saveEnvFile,
+        refreshFn: refreshTokenFn,
+        resolveConfig
       });
-      tokenRefresh = {
-        attempted: true,
-        success: true
-      };
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error);
-      persistenceWarning = `Access token refreshed in memory but could not be written to ${absolutePath}: ${msg}. The next CLI invocation will fail until the file can be updated — run 'uip login' to re-authenticate.`;
-      tokenRefresh = {
-        attempted: true,
-        success: true,
-        errorMessage: `persistence failed: ${msg}`
-      };
+      if (outcome.kind === "fail") {
+        lockedFailure = outcome.status;
+      } else {
+        accessToken = outcome.accessToken;
+        refreshToken = outcome.refreshToken;
+        expiration = outcome.expiration;
+        tokenRefresh = outcome.tokenRefresh;
+        if (outcome.persistenceWarning) {
+          persistenceWarning = outcome.persistenceWarning;
+        }
+      }
+    } finally {
+      try {
+        await release();
+      } catch {
+        lockReleaseFailed = true;
+      }
+    }
+    if (lockedFailure) {
+      const globalHint = await tryGlobalCredsHint();
+      const base = globalHint ? {
+        ...lockedFailure,
+        loginStatus: "Expired",
+        hint: globalHint
+      } : lockedFailure;
+      return lockReleaseFailed ? { ...base, lockReleaseFailed: true } : base;
     }
   }
   const result = {
@@ -27921,23 +29158,13 @@ var getLoginStatusWithDeps = async (options = {}, deps = {}) => {
     expiration,
     source: "file" /* File */,
     ...persistenceWarning ? { hint: persistenceWarning, persistenceFailed: true } : {},
+    ...lockReleaseFailed ? { lockReleaseFailed: true } : {},
     ...tokenRefresh ? { tokenRefresh } : {}
   };
   if (result.loginStatus === "Expired") {
-    const fs7 = getFs();
-    const globalPath = fs7.path.join(fs7.env.homedir(), envFilePath);
-    if (absolutePath !== globalPath && await fs7.exists(globalPath)) {
-      try {
-        const globalCreds = await loadEnvFile({
-          envPath: globalPath
-        });
-        if (globalCreds.UIPATH_ACCESS_TOKEN) {
-          const globalExp = getTokenExpiration(globalCreds.UIPATH_ACCESS_TOKEN);
-          if (!globalExp || globalExp > new Date) {
-            result.hint = `Local credentials file at ${absolutePath} has expired credentials. Valid credentials exist in ${globalPath}. Remove the local file or run 'uip login' to re-authenticate.`;
-          }
-        }
-      } catch {}
+    const globalHint = await tryGlobalCredsHint();
+    if (globalHint) {
+      result.hint = globalHint;
     }
   }
   return result;
@@ -27954,6 +29181,10 @@ var getLoginStatusAsync = async (options = {}) => {
 init_src();
 // ../../auth/src/logout.ts
 init_src();
+
+// ../../auth/src/index.ts
+init_server();
+
 // ../resourcecatalog-sdk/src/client-factory.ts
 async function resolveConfig(options) {
   const status = await getLoginStatusAsync({
@@ -27967,14 +29198,15 @@ async function resolveConfig(options) {
   }
   const tenant = options?.tenantName ?? status.tenantName;
   if (!tenant) {
-    throw new Error("Tenant not available. Pass --tenant <name> or log in with a tenant context.");
+    throw new Error("Tenant not available. Run 'uip login' to select a tenant, or use 'uip login tenant set <tenant>' to switch tenants.");
   }
   const basePath = `${status.baseUrl}/${status.organizationId}/${tenant}/resourcecatalog_`;
   const bearerToken = options?.s2sToken ?? status.accessToken;
   return {
     config: new Configuration({
       basePath,
-      accessToken: async () => bearerToken
+      accessToken: async () => bearerToken,
+      headers: addSdkUserAgentHeader(undefined, SDK_USER_AGENT)
     }),
     organizationId: status.organizationId,
     tenantName: tenant
@@ -27988,8 +29220,114 @@ async function createApiClient(ApiClass, options) {
     tenantName
   };
 }
+// src/commands/search.ts
+import { Option as Option2 } from "commander";
+var LOGIN_INSTRUCTIONS = "Ensure you are logged in with 'uip login' and have access to the Resource Catalog service.";
+var SEARCH_EXAMPLES = [
+  {
+    Description: "Search RCS Process entities by entitySubType (matches the Orchestrator UI Add-Tool picker)",
+    Command: "uip admin rcs search --entity-type Process --entity-sub-type ProcessOrchestration --limit 8",
+    Output: {
+      Code: "RcsSearch",
+      Data: {
+        items: [
+          {
+            entityKey: "entity-guid",
+            name: "Sample Orchestrator",
+            entityType: "Process",
+            entitySubType: "ProcessOrchestration"
+          }
+        ],
+        count: 1
+      }
+    }
+  },
+  {
+    Description: "Search across one folder by key",
+    Command: "uip admin rcs search --entity-type Process --folder-key 11111111-1111-1111-1111-111111111111",
+    Output: {
+      Code: "RcsSearch",
+      Data: { items: [], count: 0 }
+    }
+  }
+];
+var registerSearchCommands = (rcs) => {
+  rcs.command("search").description([
+    "Search Resource Catalog entities (RCS GET /Entities/Search).",
+    "",
+    "Filters: --entity-type, --entity-sub-type (each repeatable),",
+    "--name (substring on entity name), --folder-key/--folder-path",
+    "(sent as X-UIPATH-FolderKey/X-UIPATH-FolderPath headers).",
+    "",
+    "Returns the standard paging envelope {items, total, count, next}."
+  ].join(`
+`)).addOption(createHiddenDeprecatedTenantOption("--tenant <name>")).option("--entity-type <value>", "RCS entityTypes filter entry. Repeat to pass multiple values (e.g. --entity-type Process).", (value, previous = []) => [...previous, value]).option("--entity-sub-type <value>", "RCS entitySubType filter entry. Repeat to pass multiple values (e.g. --entity-sub-type ProcessOrchestration).", (value, previous = []) => [...previous, value]).option("--name <text>", "Substring filter on entity name (RCS `name` query param).").option("--folder-key <guid>", "Folder GUID to scope the call (sets X-UIPATH-FolderKey).").option("--folder-path <path>", "Folder path to scope the call (sets X-UIPATH-FolderPath).").option("--limit <n>", `Page size. Maps to RCS take. Defaults to ${DEFAULT_PAGE_SIZE}.`, (v) => Number.parseInt(v, 10)).option("--offset <n>", "Row offset. Maps to RCS skip. Defaults to 0.", (v) => Number.parseInt(v, 10)).addOption(new Option2("--skip <n>").hideHelp().argParser((v) => Number.parseInt(v, 10))).option("--login-validity <minutes>", "Override the interactive-login token lifetime for this call. Rarely needed.", (v) => Number.parseInt(v, 10)).examples(SEARCH_EXAMPLES).trackedAction(processContext, async (options) => {
+    const offset = resolveDeprecatedOptionAlias({
+      preferredValue: options.offset,
+      deprecatedValue: options.skip,
+      preferredFlag: "--offset",
+      deprecatedFlag: "--skip"
+    });
+    if (offset.error) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: offset.error.message,
+        Instructions: offset.error.instructions
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (offset.usedDeprecated) {
+      warnDeprecatedOptionAlias("--skip", "--offset");
+    }
+    const resolvedOffset = offset.value ?? 0;
+    const resolvedLimit = options.limit ?? DEFAULT_PAGE_SIZE;
+    const [error, result] = await catchError((async () => {
+      const { api, organizationId } = await createApiClient(EntitiesApi, {
+        loginValidity: options.loginValidity,
+        tenantName: options.tenant
+      });
+      return await api.entitiesSearch({
+        xUiPathInternalAccountId: organizationId,
+        name: options.name,
+        skip: resolvedOffset,
+        take: resolvedLimit,
+        entityTypes: options.entityType,
+        entitySubType: options.entitySubType,
+        xUIPATHFolderKey: options.folderKey,
+        xUIPATHFolderPath: options.folderPath
+      });
+    })());
+    if (error) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: await extractErrorMessage(error),
+        Instructions: LOGIN_INSTRUCTIONS
+      });
+      processContext.exit(1);
+      return;
+    }
+    const items = result?.value ?? [];
+    const total = result?.count;
+    const count = items.length;
+    const nextSkip = resolvedOffset + count;
+    const next = typeof total === "number" && nextSkip < total ? { skip: nextSkip, take: resolvedLimit } : undefined;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "RcsSearch",
+      Data: {
+        items,
+        total,
+        count,
+        ...next ? { next } : {}
+      }
+    });
+  });
+};
+
 // src/commands/tag.ts
-var LOGIN_INSTRUCTIONS = "Ensure you are logged in with 'uip login' and have access to the Resource Catalog service. If you see 'Invalid scope(s)', re-run 'uip login' to pick up the RCS.Tags scope.";
+import { Option as Option3 } from "commander";
+var LOGIN_INSTRUCTIONS2 = "Ensure you are logged in with 'uip login' and have access to the Resource Catalog service. If you see 'Invalid scope(s)', re-run 'uip login' to pick up the RCS.Tags scope.";
 var LIST_EXAMPLES = [
   {
     Description: "List all Label tags for the current tenant",
@@ -28031,11 +29369,29 @@ var registerTagCommands = (rcs) => {
     "List tags for a tenant in the current organization.",
     "",
     "By default returns TagType.Label tags for the tenant in your login context.",
-    "Pass --tenant <name> to target a different tenant in the same organization",
+    "Use 'uip login tenant set <tenant>' to target a different tenant in the same organization",
     "(your account must have RCS access to that tenant). Use --type KeyValue",
     "for key/value tags, or --starts-with to filter by name prefix."
   ].join(`
-`)).option("--tenant <name>", "Target tenant name. Defaults to the tenant in your login context.").option("--type <type>", "Tag type to list: 'Label' (default) or 'KeyValue'. Case-sensitive.", "Label").option("--starts-with <prefix>", "Return only tags whose normalized name starts with this prefix (case-insensitive).").option("--limit <n>", "Page size — how many tags to return in one call. Defaults to 100.", (v) => Number.parseInt(v, 10), 100).option("--skip <n>", "Row offset into the result set. Defaults to 0.", (v) => Number.parseInt(v, 10), 0).option("--login-validity <minutes>", "Override the interactive-login token lifetime for this call. Rarely needed.", (v) => Number.parseInt(v, 10)).examples(LIST_EXAMPLES).trackedAction(processContext, async (options) => {
+`)).addOption(createHiddenDeprecatedTenantOption("--tenant <name>")).option("--type <type>", "Tag type to list: 'Label' (default) or 'KeyValue'. Case-sensitive.", "Label").option("--starts-with <prefix>", "Return only tags whose normalized name starts with this prefix (case-insensitive).").option("--limit <n>", "Page size — how many tags to return in one call. Defaults to 100.", (v) => Number.parseInt(v, 10), 100).option("--offset <n>", "Row offset into the result set. Defaults to 0.", (v) => Number.parseInt(v, 10)).addOption(new Option3("--skip <n>").hideHelp().argParser((v) => Number.parseInt(v, 10))).option("--login-validity <minutes>", "Override the interactive-login token lifetime for this call. Rarely needed.", (v) => Number.parseInt(v, 10)).examples(LIST_EXAMPLES).trackedAction(processContext, async (options) => {
+    const offset = resolveDeprecatedOptionAlias({
+      preferredValue: options.offset,
+      deprecatedValue: options.skip,
+      preferredFlag: "--offset",
+      deprecatedFlag: "--skip"
+    });
+    if (offset.error) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: offset.error.message,
+        Instructions: offset.error.instructions
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (offset.usedDeprecated) {
+      warnDeprecatedOptionAlias("--skip", "--offset");
+    }
     const [error, result] = await catchError((async () => {
       if (options.type !== TagType.Label && options.type !== TagType.KeyValue) {
         throw new Error(`Invalid --type '${options.type}'. Use 'Label' or 'KeyValue'.`);
@@ -28049,14 +29405,14 @@ var registerTagCommands = (rcs) => {
         type: options.type,
         startsWith: options.startsWith,
         take: options.limit,
-        skip: options.skip
+        skip: offset.value ?? 0
       });
     })());
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: await extractErrorMessage(error),
-        Instructions: LOGIN_INSTRUCTIONS
+        Instructions: LOGIN_INSTRUCTIONS2
       });
       processContext.exit(1);
       return;
@@ -28075,9 +29431,11 @@ var registerRcsCommand = (program) => {
     "Manage UiPath Resource Catalog Service resources.",
     "",
     "Subcommand groups:",
+    "  search — search tenant- or folder-scoped RCS entities.",
     "  tag — list tenant-scoped tags."
   ].join(`
 `));
+  registerSearchCommands(rcs);
   registerTagCommands(rcs);
 };