npm - @uipath/common - Versions diffs - 1.201.0-preview.115 → 1.201.0-preview.122 - Mend

@uipath/common 1.201.0-preview.115 → 1.201.0-preview.122

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/error-handler.d.ts +36 -0
package/dist/formatter.d.ts +18 -4
package/dist/index.browser.js +90 -41
package/dist/index.d.ts +0 -1
package/dist/index.js +135 -79
package/dist/option-validators.d.ts +14 -0
package/dist/tool-provider.d.ts +1 -21
package/package.json +2 -2
package/dist/solution-project-artifacts.d.ts +0 -43
package/dist/tool-module-import.d.ts +0 -9

package/dist/error-handler.d.ts CHANGED Viewed

@@ -45,6 +45,23 @@ export interface ConnectivityError {
     /** Actionable, user-facing remediation steps. */
     instructions: string;
 }
+/**
+ * A local OS/sandbox permission failure (EACCES, EPERM, EROFS), already
+ * classified with actionable guidance. Returned by
+ * {@link describePermissionError}. Deliberately distinct from an HTTP 403:
+ * this failure means the local OS refused a syscall, so the fix is a local
+ * permission grant or elevation, never a credential or role change.
+ */
+export interface LocalPermissionError {
+    /** The OS error code, e.g. `EACCES`. */
+    code: string;
+    /** The most specific message found while walking the cause chain. */
+    message: string;
+    /** The file or directory the OS refused access to, when known. */
+    path?: string;
+    /** Actionable, user-facing remediation steps. */
+    instructions: string;
+}
 export declare function formatErrorChain(error: unknown): string;
 /**
  * Classify an outbound connectivity failure by walking the error graph.
@@ -60,6 +77,25 @@ export declare function formatErrorChain(error: unknown): string;
  * failure so callers can fall back to their normal handling.
  */
 export declare function describeConnectivityError(error: unknown): ConnectivityError | undefined;
+/**
+ * Classify a local OS/sandbox permission failure by walking the error graph.
+ *
+ * Recognises `EACCES`/`EPERM`/`EROFS` on the `code` property of any node in
+ * the `.cause` / `AggregateError.errors` graph, and falls back to the errno
+ * token inside the message for errors that were re-wrapped and lost their
+ * `code` (e.g. `catchError`'s `new Error(String(err))`). Returns `undefined`
+ * for anything else — including HTTP-shaped errors, which are the service's
+ * failures, not the local OS's.
+ */
+export declare function describePermissionError(error: unknown): LocalPermissionError | undefined;
+/**
+ * Parse an `HTTP <status>` prefix out of an error message. SDK wrappers often
+ * throw plain `Error`s shaped `HTTP 403: <body>` with no structured status
+ * field; every classifier that treats "has a status" as "the service
+ * answered" must see these too, or the local-vs-service split drifts between
+ * layers. Shared by {@link extractErrorDetails} and `instructionsFor`.
+ */
+export declare function parseHttpStatusFromMessage(message: string): number | undefined;
 export declare function isHtmlDocument(body: string): boolean;
 /**
  * Extract a structured error message and details from an unknown thrown value.

package/dist/formatter.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import { type CommandErrorClass, type TerminalOutcome } from "./telemetry/comman
 export type OutputFormat = "table" | "json" | "yaml" | "plain";
 export type ResultType = "Success" | "Failure" | "ConfigError" | "AuthenticationError" | "ValidationError" | "TimeoutError";
 export type FailureResultType = Exclude<ResultType, "Success">;
-export declare const CLI_ERROR_CODES: readonly ["invalid_argument", "authentication_required", "permission_denied", "not_found", "rate_limited", "network_error", "timeout", "server_error", "method_not_allowed", "configuration_error", "unknown_error"];
+export declare const CLI_ERROR_CODES: readonly ["invalid_argument", "authentication_required", "permission_denied", "local_permission_denied", "not_found", "rate_limited", "network_error", "timeout", "server_error", "method_not_allowed", "configuration_error", "unknown_error"];
 export type CliErrorCode = (typeof CLI_ERROR_CODES)[number];
 export declare const RETRY_HINTS: readonly ["RetryWillNotFix", "RetryLater", "RetryAfter1Second", "RetryAfter10Seconds", "RetryAfter30Seconds", "RetryAfter60Seconds"];
 export type RetryHint = (typeof RETRY_HINTS)[number];
@@ -41,14 +41,24 @@ export type DataRecord = Record<string, unknown> | (object & Record<never, never
 export declare class Pagination {
     Returned: number;
     Limit: number;
-    Offset: number;
+    /** Absent for APIs that page by cursor instead of by offset. */
+    Offset?: number;
     Total?: number;
     HasMore: boolean;
-    constructor({ returned, limit, offset, total, }: {
+    /**
+     * Opaque cursor the caller passes back to fetch the next page. Only set by
+     * APIs that page by cursor (e.g. PIMS instance listing); absent on the last
+     * page and on offset-paged commands.
+     */
+    NextPage?: string;
+    constructor({ returned, limit, offset, total, hasMore, nextPage, }: {
         returned: number;
         limit: number;
-        offset: number;
+        offset?: number;
         total?: number;
+        /** Server-reported "more pages exist"; overrides the derived guess. */
+        hasMore?: boolean;
+        nextPage?: string;
     });
 }
 export declare class SuccessOutput {
@@ -77,6 +87,10 @@ export interface ErrorContext {
     method?: string;
     /** Distributed-tracing id parsed from the backend error body when present. */
     traceId?: string;
+    /** Local filesystem path the OS refused access to. Set only for
+     *  `local_permission_denied` failures — it is the one datum a caller
+     *  needs to decide which permission to grant. */
+    path?: string;
 }
 export declare class FailureOutput {
     Result: FailureResultType;

package/dist/index.browser.js CHANGED Viewed

@@ -21052,6 +21052,16 @@ var TLS_ERROR_CODES = new Set([
 ]);
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
+var LOCAL_PERMISSION_ERROR_CODES = new Set(["EACCES", "EPERM", "EROFS"]);
+var LOCAL_PERMISSION_MESSAGE_PATTERN = /\b(EACCES|EPERM|EROFS)\b/;
+function localPermissionInstructions(code2, path) {
+  const target = path !== undefined ? `'${path}'` : "a local file or resource";
+  if (code2 === "EROFS") {
+    return `The filesystem containing ${target} is read-only (EROFS), so the ` + "CLI could not write to it. This is a local environment problem, " + "not a UiPath service error — retrying will not help. Use a " + "writable location, or give this environment write access to the " + "path.";
+  }
+  const remedy = process.platform === "win32" ? "Re-run from an elevated terminal, close any program holding " + "the file open, or grant your user access to the path." : "Grant this user (or the sandbox the command runs in) access " + "to the path, or run the command outside the sandbox.";
+  return `The operating system denied access to ${target} (${code2}). This is ` + "a local permission problem, not a UiPath service error — retrying " + `without a permission change will not help. ${remedy}`;
+}
 function formatErrorChain(error) {
   const lines = [];
   const seen = new Set;
@@ -21084,16 +21094,7 @@ function formatErrorChain(error) {
 `);
 }
 function describeConnectivityError(error) {
-  const queue2 = [error];
-  const seen = new Set;
-  for (let steps = 0;queue2.length > 0 && steps < 32; steps++) {
-    const current = queue2.shift();
-    if (current === null || typeof current !== "object")
-      continue;
-    if (seen.has(current))
-      continue;
-    seen.add(current);
-    const cur = current;
+  for (const cur of walkErrorGraph(error)) {
     const code2 = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
     if (code2 && TLS_ERROR_CODES.has(code2)) {
@@ -21112,6 +21113,49 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
+  }
+  return;
+}
+function describePermissionError(error) {
+  for (const cur of walkErrorGraph(error)) {
+    const message = typeof cur.message === "string" ? cur.message : undefined;
+    const code2 = matchLocalPermissionCode(cur.code, message);
+    if (!code2)
+      continue;
+    const path = localPermissionPath(cur.path, message);
+    return {
+      code: code2,
+      message: message ?? code2,
+      ...path !== undefined ? { path } : {},
+      instructions: localPermissionInstructions(code2, path)
+    };
+  }
+  return;
+}
+function matchLocalPermissionCode(code2, message) {
+  if (typeof code2 === "string" && LOCAL_PERMISSION_ERROR_CODES.has(code2)) {
+    return code2;
+  }
+  const match = message ? LOCAL_PERMISSION_MESSAGE_PATTERN.exec(message) : null;
+  return match ? match[1] : undefined;
+}
+function localPermissionPath(path, message) {
+  if (typeof path === "string")
+    return path;
+  return message ? /'([^']+)'/.exec(message)?.[1] : undefined;
+}
+function* walkErrorGraph(error) {
+  const queue2 = [error];
+  const seen = new Set;
+  for (let steps = 0;queue2.length > 0 && steps < 32; steps++) {
+    const current = queue2.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
+    const cur = current;
+    yield cur;
     if (cur.cause !== undefined)
       queue2.push(cur.cause);
     if (Array.isArray(cur.errors))
@@ -21172,6 +21216,12 @@ function classifyError(status, error) {
   if (status !== undefined && status >= 500 && status < 600) {
     return { errorCode: "server_error", retry: "RetryLater" };
   }
+  if (status === undefined && describePermissionError(error)) {
+    return {
+      errorCode: "local_permission_denied",
+      retry: "RetryWillNotFix"
+    };
+  }
   const connectivity = describeConnectivityError(error);
   if (connectivity) {
     return {
@@ -21274,6 +21324,16 @@ async function extractErrorDetails(error, options) {
       message = `${message}: ${connectivity.message}`;
     }
   }
+  const permission = status === undefined ? describePermissionError(error) : undefined;
+  if (permission) {
+    if (permission.message !== message && !message.includes(permission.message)) {
+      message = `${message}: ${permission.message}`;
+    }
+    if (!message.includes(permission.instructions)) {
+      const punctuated = message.endsWith(".") ? message : `${message}.`;
+      message = `${punctuated} ${permission.instructions}`;
+    }
+  }
   let details = rawMessage;
   if (rawBody) {
     if (parsedBody) {
@@ -21313,6 +21373,9 @@ async function extractErrorDetails(error, options) {
   if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
     context.traceId = parsedBody.traceId;
   }
+  if (permission?.path !== undefined) {
+    context.path = permission.path;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -21388,7 +21451,10 @@ function extractHttpStatus(err) {
   if (!err || typeof err !== "object")
     return;
   const e = err;
-  return e.response?.status ?? e.status ?? e.statusCode;
+  const structured = e.response?.status ?? e.status ?? e.statusCode;
+  if (structured !== undefined)
+    return structured;
+  return typeof e.message === "string" ? parseHttpStatusFromMessage(e.message) : undefined;
 }
 var GENERIC = "Check authentication and parameters";
 function instructionsFor(ctx, err) {
@@ -21422,6 +21488,10 @@ function instructionsFor(ctx, err) {
       if (status !== undefined && status >= 500 && status < 600) {
         return "Orchestrator returned a server error — retry; if it persists, check service status";
       }
+      const permission = describePermissionError(err);
+      if (permission) {
+        return permission.instructions;
+      }
       const connectivity = describeConnectivityError(err);
       if (connectivity) {
         return connectivity.instructions;
@@ -21688,6 +21758,11 @@ function parseSafeInteger(raw, min) {
   }
   return parsed;
 }
+function splitScopeList(raw) {
+  if (!raw)
+    return [];
+  return raw.split(/[\s,]+/).filter((scope) => scope.length > 0);
+}
 // src/orchestrator-urls.ts
 function requireNonEmpty(label, value) {
   if (typeof value !== "string" || value.trim().length === 0) {
@@ -23358,38 +23433,11 @@ async function importPackagerTool(specifier) {
   return registerError;
 }
-// src/tool-module-import.ts
-async function importToolModule(specifier) {
-  return await import(specifier);
-}
 // src/tool-provider.ts
 var factorySlot = singleton("PackagerFactoryProvider");
 function setPackagerFactoryProvider(provider) {
   factorySlot.set(provider);
 }
-var moduleSlot = singleton("ToolModuleProvider");
-function setToolModuleProvider(provider) {
-  moduleSlot.set(provider);
-}
-async function ensureToolModule(verb, packageName, moduleName) {
-  if (!/^[a-z0-9-]+$/.test(moduleName)) {
-    throw new Error(`Invalid tool module name '${moduleName}'.`);
-  }
-  const provider = moduleSlot.get();
-  if (provider) {
-    return provider(verb, moduleName);
-  }
-  const specifier = `${packageName}/${moduleName}`;
-  const [importError, mod] = await catchError(importToolModule(specifier));
-  if (importError) {
-    logger.debug(`No tool-module provider registered; import of '${specifier}' failed: ${importError.message}`);
-    throw new Error(`This command needs '${packageName}'. Install it.`, {
-      cause: importError
-    });
-  }
-  return mod;
-}
 async function ensurePackagerFactory(verb, packageName) {
   const provider = factorySlot.get();
   if (provider) {
@@ -23413,8 +23461,8 @@ async function loadPackagerTool(specifier) {
 export {
   withCompleter,
   takeRecordedCommandFailureTelemetry,
+  splitScopeList,
   singleton,
-  setToolModuleProvider,
   setSdkUserAgentHostToken,
   setPackagerFactoryProvider,
   setOutputFormatExplicit,
@@ -23434,6 +23482,7 @@ export {
   parseOffset,
   parseNonNegativeInteger,
   parseLimit,
+  parseHttpStatusFromMessage,
   parseBoundedInt,
   normalizeSkillName,
   msToDuration,
@@ -23470,8 +23519,8 @@ export {
   extractErrorMessage,
   extractErrorDetails,
   extractCommandHelp,
-  ensureToolModule,
   ensurePackagerFactory,
+  describePermissionError,
   describeConnectivityError,
   createPollAbortController,
   configureLogger,
@@ -23510,4 +23559,4 @@ export {
   AUTH_FILENAME
 };
-//# debugId=C2BB3B73AD55AF7D64756E2164756E21
+//# debugId=8E9A65CE1EE8015D64756E2164756E21

package/dist/index.d.ts CHANGED Viewed

@@ -33,7 +33,6 @@ export * from "./registry";
 export * from "./screen-logger";
 export * from "./sdk-user-agent";
 export * from "./singleton";
-export * from "./solution-project-artifacts";
 export * from "./solution-project-types";
 export * from "./stdin";
 export { BrowserContextStorage } from "./telemetry/browser-context-storage.js";

package/dist/index.js CHANGED Viewed

@@ -8182,6 +8182,16 @@ var TLS_ERROR_CODES = new Set([
 ]);
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
+var LOCAL_PERMISSION_ERROR_CODES = new Set(["EACCES", "EPERM", "EROFS"]);
+var LOCAL_PERMISSION_MESSAGE_PATTERN = /\b(EACCES|EPERM|EROFS)\b/;
+function localPermissionInstructions(code, path3) {
+  const target = path3 !== undefined ? `'${path3}'` : "a local file or resource";
+  if (code === "EROFS") {
+    return `The filesystem containing ${target} is read-only (EROFS), so the ` + "CLI could not write to it. This is a local environment problem, " + "not a UiPath service error — retrying will not help. Use a " + "writable location, or give this environment write access to the " + "path.";
+  }
+  const remedy = process.platform === "win32" ? "Re-run from an elevated terminal, close any program holding " + "the file open, or grant your user access to the path." : "Grant this user (or the sandbox the command runs in) access " + "to the path, or run the command outside the sandbox.";
+  return `The operating system denied access to ${target} (${code}). This is ` + "a local permission problem, not a UiPath service error — retrying " + `without a permission change will not help. ${remedy}`;
+}
 function formatErrorChain(error) {
   const lines = [];
   const seen = new Set;
@@ -8214,16 +8224,7 @@ function formatErrorChain(error) {
 `);
 }
 function describeConnectivityError(error) {
-  const queue = [error];
-  const seen = new Set;
-  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
-    const current = queue.shift();
-    if (current === null || typeof current !== "object")
-      continue;
-    if (seen.has(current))
-      continue;
-    seen.add(current);
-    const cur = current;
+  for (const cur of walkErrorGraph(error)) {
     const code = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
     if (code && TLS_ERROR_CODES.has(code)) {
@@ -8242,6 +8243,49 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
+  }
+  return;
+}
+function describePermissionError(error) {
+  for (const cur of walkErrorGraph(error)) {
+    const message = typeof cur.message === "string" ? cur.message : undefined;
+    const code = matchLocalPermissionCode(cur.code, message);
+    if (!code)
+      continue;
+    const path3 = localPermissionPath(cur.path, message);
+    return {
+      code,
+      message: message ?? code,
+      ...path3 !== undefined ? { path: path3 } : {},
+      instructions: localPermissionInstructions(code, path3)
+    };
+  }
+  return;
+}
+function matchLocalPermissionCode(code, message) {
+  if (typeof code === "string" && LOCAL_PERMISSION_ERROR_CODES.has(code)) {
+    return code;
+  }
+  const match = message ? LOCAL_PERMISSION_MESSAGE_PATTERN.exec(message) : null;
+  return match ? match[1] : undefined;
+}
+function localPermissionPath(path3, message) {
+  if (typeof path3 === "string")
+    return path3;
+  return message ? /'([^']+)'/.exec(message)?.[1] : undefined;
+}
+function* walkErrorGraph(error) {
+  const queue = [error];
+  const seen = new Set;
+  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
+    const current = queue.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
+    const cur = current;
+    yield cur;
     if (cur.cause !== undefined)
       queue.push(cur.cause);
     if (Array.isArray(cur.errors))
@@ -8302,6 +8346,12 @@ function classifyError(status, error) {
   if (status !== undefined && status >= 500 && status < 600) {
     return { errorCode: "server_error", retry: "RetryLater" };
   }
+  if (status === undefined && describePermissionError(error)) {
+    return {
+      errorCode: "local_permission_denied",
+      retry: "RetryWillNotFix"
+    };
+  }
   const connectivity = describeConnectivityError(error);
   if (connectivity) {
     return {
@@ -8404,6 +8454,16 @@ async function extractErrorDetails(error, options) {
       message = `${message}: ${connectivity.message}`;
     }
   }
+  const permission = status === undefined ? describePermissionError(error) : undefined;
+  if (permission) {
+    if (permission.message !== message && !message.includes(permission.message)) {
+      message = `${message}: ${permission.message}`;
+    }
+    if (!message.includes(permission.instructions)) {
+      const punctuated = message.endsWith(".") ? message : `${message}.`;
+      message = `${punctuated} ${permission.instructions}`;
+    }
+  }
   let details = rawMessage;
   if (rawBody) {
     if (parsedBody) {
@@ -8443,6 +8503,9 @@ async function extractErrorDetails(error, options) {
   if (parsedBody?.traceId && typeof parsedBody.traceId === "string") {
     context.traceId = parsedBody.traceId;
   }
+  if (permission?.path !== undefined) {
+    context.path = permission.path;
+  }
   if (status === 429) {
     const resp = response;
     const headersObj = resp?.headers;
@@ -10612,6 +10675,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -10652,19 +10716,32 @@ class Pagination {
   Offset;
   Total;
   HasMore;
+  NextPage;
   constructor({
     returned,
     limit,
     offset,
-    total
+    total,
+    hasMore,
+    nextPage
   }) {
     this.Returned = returned;
     this.Limit = limit;
     this.Offset = offset;
     this.Total = total;
-    this.HasMore = total === undefined ? returned === limit : offset + returned < total;
+    this.HasMore = hasMore ?? derivePaginationHasMore(returned, limit, offset, total, nextPage);
+    this.NextPage = nextPage;
   }
 }
+function derivePaginationHasMore(returned, limit, offset, total, nextPage) {
+  if (nextPage) {
+    return true;
+  }
+  if (total === undefined) {
+    return returned >= limit;
+  }
+  return (offset ?? 0) + returned < total;
+}
 class SuccessOutput {
   Result = RESULTS.Success;
@@ -11111,12 +11188,16 @@ function defaultErrorCodeForHttpStatus(status) {
     return "server_error";
   return;
 }
+var LOCAL_PERMISSION_TEXT_PATTERN = /(?:\b|\()(?:EACCES|EPERM|EROFS)(?::\s|\))/;
 function defaultErrorCodeForFailure(data) {
   if (data.Result === RESULTS.Failure) {
     const status = data.Context?.httpStatus ?? parseHttpStatusFromMessage2(data.Message);
     const errorCode = defaultErrorCodeForHttpStatus(status);
     if (errorCode)
       return errorCode;
+    if (status === undefined && (LOCAL_PERMISSION_TEXT_PATTERN.test(data.Message) || LOCAL_PERMISSION_TEXT_PATTERN.test(data.Instructions))) {
+      return "local_permission_denied";
+    }
   }
   return defaultErrorCodeForResult(data.Result);
 }
@@ -11796,7 +11877,10 @@ function extractHttpStatus(err) {
   if (!err || typeof err !== "object")
     return;
   const e = err;
-  return e.response?.status ?? e.status ?? e.statusCode;
+  const structured = e.response?.status ?? e.status ?? e.statusCode;
+  if (structured !== undefined)
+    return structured;
+  return typeof e.message === "string" ? parseHttpStatusFromMessage(e.message) : undefined;
 }
 var GENERIC = "Check authentication and parameters";
 function instructionsFor(ctx, err) {
@@ -11830,6 +11914,10 @@ function instructionsFor(ctx, err) {
       if (status !== undefined && status >= 500 && status < 600) {
         return "Orchestrator returned a server error — retry; if it persists, check service status";
       }
+      const permission = describePermissionError(err);
+      if (permission) {
+        return permission.instructions;
+      }
       const connectivity = describeConnectivityError(err);
       if (connectivity) {
         return connectivity.instructions;
@@ -11984,6 +12072,11 @@ function parseSafeInteger(raw, min) {
   }
   return parsed;
 }
+function splitScopeList(raw) {
+  if (!raw)
+    return [];
+  return raw.split(/[\s,]+/).filter((scope) => scope.length > 0);
+}
 // src/orchestrator-urls.ts
 function requireNonEmpty(label, value) {
   if (typeof value !== "string" || value.trim().length === 0) {
@@ -12673,68 +12766,6 @@ function installSdkUserAgentHeader(BaseApiClass, userAgent) {
 function installSdkCodingAgentHeader(BaseApiClass) {
   installRequestHeaderForwarding(BaseApiClass, codingAgentPatchKey(), (headers) => addSdkCodingAgentHeader(headers));
 }
-// src/tool-module-import.ts
-async function importToolModule(specifier) {
-  return await import(specifier);
-}
-// src/tool-provider.ts
-var factorySlot = singleton("PackagerFactoryProvider");
-function setPackagerFactoryProvider(provider) {
-  factorySlot.set(provider);
-}
-var moduleSlot = singleton("ToolModuleProvider");
-function setToolModuleProvider(provider) {
-  moduleSlot.set(provider);
-}
-async function ensureToolModule(verb, packageName, moduleName) {
-  if (!/^[a-z0-9-]+$/.test(moduleName)) {
-    throw new Error(`Invalid tool module name '${moduleName}'.`);
-  }
-  const provider = moduleSlot.get();
-  if (provider) {
-    return provider(verb, moduleName);
-  }
-  const specifier = `${packageName}/${moduleName}`;
-  const [importError, mod2] = await catchError(importToolModule(specifier));
-  if (importError) {
-    logger.debug(`No tool-module provider registered; import of '${specifier}' failed: ${importError.message}`);
-    throw new Error(`This command needs '${packageName}'. Install it.`, {
-      cause: importError
-    });
-  }
-  return mod2;
-}
-async function ensurePackagerFactory(verb, packageName) {
-  const provider = factorySlot.get();
-  if (provider) {
-    await provider(verb);
-    return;
-  }
-  const importError = packageName ? await loadPackagerTool(`${packageName}/packager-tool`) : undefined;
-  if (packageName && !importError)
-    return;
-  throw new Error(packageName ? `Packing this project type needs '${packageName}'. Install it.` : `Packing this project type needs the packager factory for '${verb}', and no package provides it.`, { cause: importError });
-}
-async function loadPackagerTool(specifier) {
-  const error = await importPackagerTool(specifier);
-  if (error) {
-    logger.debug(`No packager factory provider registered; import of '${specifier}' failed: ${error.message}`);
-    return error;
-  }
-  logger.debug(`No packager factory provider registered; loaded '${specifier}' directly.`);
-  return;
-}
-// src/solution-project-artifacts.ts
-async function ensureProjectArtifacts(args) {
-  const [error, mod2] = await catchError(ensureToolModule("solution", "@uipath/solution-tool", "init"));
-  if (error) {
-    logger.warn(`Solution artifact-resource generation skipped for project "${args.projectName}": ${error.message}. ` + "Run 'uip solution projects add' to finish setup.");
-    return { Created: false, Error: error.message };
-  }
-  return mod2.addProjectArtifactsToSolutionAsync(args);
-}
 // src/solution-project-types.ts
 var LIBRARY_NOT_A_PROJECT = "A library cannot be a project inside a solution — it is a reusable .nupkg that other projects consume as a NuGet dependency, not a deployable unit. Build and publish it on its own ('uip rpa pack <project-dir> <output-path>', then 'uip or libraries upload --file <nupkg-path>'), and reference it from a project's dependencies. To make the published library part of this solution, add it as a resource instead: 'uip solution resources add --source remote --kind Library --name <library-name>'.";
 function unsupportedSolutionProjectType(projectType) {
@@ -12842,6 +12873,31 @@ function trackShipSucceeded(payload) {
   telemetry.trackEvent(CommonTelemetryEvents.ShipSucceeded, redactProperties({ ...payload }));
   return true;
 }
+// src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
+function setPackagerFactoryProvider(provider) {
+  factorySlot.set(provider);
+}
+async function ensurePackagerFactory(verb, packageName) {
+  const provider = factorySlot.get();
+  if (provider) {
+    await provider(verb);
+    return;
+  }
+  const importError = packageName ? await loadPackagerTool(`${packageName}/packager-tool`) : undefined;
+  if (packageName && !importError)
+    return;
+  throw new Error(packageName ? `Packing this project type needs '${packageName}'. Install it.` : `Packing this project type needs the packager factory for '${verb}', and no package provides it.`, { cause: importError });
+}
+async function loadPackagerTool(specifier) {
+  const error = await importPackagerTool(specifier);
+  if (error) {
+    logger.debug(`No packager factory provider registered; import of '${specifier}' failed: ${error.message}`);
+    return error;
+  }
+  logger.debug(`No packager factory provider registered; loaded '${specifier}' directly.`);
+  return;
+}
 export {
   writeTelemetrySpoolFile,
   withCompleter,
@@ -12858,8 +12914,8 @@ export {
   takeRecordedCommandFailureTelemetry,
   sweepTelemetrySpool,
   stripHostGlobalOptions,
+  splitScopeList,
   singleton,
-  setToolModuleProvider,
   setTelemetrySidecarEntry,
   setSdkUserAgentHostToken,
   setProxyAuthHttpsAgent,
@@ -12904,6 +12960,7 @@ export {
   parseNonNegativeInteger,
   parseLimit,
   parseInboundTraceparent,
+  parseHttpStatusFromMessage,
   parseBoundedInt,
   parseAttachmentSpec,
   normalizeSkillName,
@@ -12957,13 +13014,12 @@ export {
   extractErrorDetails,
   extractCommandHelp,
   escapeNonAscii,
-  ensureToolModule,
-  ensureProjectArtifacts,
   ensurePackagerFactory,
   discardClaimedSpoolFile,
   detectExecutionContext,
   detectAgentVersion,
   detectAgent,
+  describePermissionError,
   describeConnectivityError,
   deriveCommandPath,
   createTelemetryProvider,
@@ -13037,4 +13093,4 @@ export {
   ATTACHMENT_INSTRUCTIONS
 };
-//# debugId=A4E6BBF59E547A0B64756E2164756E21
+//# debugId=8077A5752FBAFF2864756E2164756E21

package/dist/option-validators.d.ts CHANGED Viewed

@@ -33,3 +33,17 @@ export declare function parseBoundedInt(raw: string, optionName: string, bounds:
 }): number;
 export declare function parsePositiveInteger(raw: string): number | undefined;
 export declare function parseNonNegativeInteger(raw: string): number | undefined;
+/**
+ * Split an OAuth scope list into individual scope names.
+ *
+ * Accepts both separators the CLI has historically used: the OAuth2
+ * space-separated form (`uip login --scope`) and the comma-separated form
+ * (`uip admin external-apps --user-scope`). Space is safe to split on
+ * because RFC 6749 uses it as the scope delimiter. Comma is not reserved by
+ * the RFC — a `scope-token` may legally contain one — but no UiPath scope
+ * name does, and the server validates every name it is sent, so a
+ * wrongly-split name fails as unknown rather than granting anything extra.
+ *
+ * Returns an empty array for undefined, empty, or separator-only input.
+ */
+export declare function splitScopeList(raw: string | undefined): string[];

package/dist/tool-provider.d.ts CHANGED Viewed

@@ -1,28 +1,8 @@
 /**
- * Cross-module bridge for packager factory and tool-module resolution.
+ * Cross-module bridge for packager factory resolution.
  */
 export type PackagerFactoryProvider = (verb: string) => Promise<void>;
 export declare function setPackagerFactoryProvider(provider: PackagerFactoryProvider): void;
-export type ToolModuleProvider = (verb: string, moduleName: string) => Promise<unknown>;
-export declare function setToolModuleProvider(provider: ToolModuleProvider): void;
-/**
- * Resolve another tool's library entry point (its `dist/<module>.js` subpath
- * export) at runtime and return the module namespace.
- *
- * Prefers the registered provider (installed by the CLI — it can install the
- * tool on demand and imports the entry by absolute path). With no provider —
- * a library caller — falls back to importing `<packageName>/<moduleName>`,
- * which resolves when the tool package is installed next to the caller.
- *
- * This is how one tool uses another tool's code without bundling it: the
- * multi-megabyte implementation ships once, in the tool that owns it.
- *
- * @param verb - CLI tool verb that owns the module (e.g. `"solution"`).
- * @param packageName - npm package behind that verb, used for the fallback
- * import (e.g. `"@uipath/solution-tool"`).
- * @param moduleName - subpath entry to load (e.g. `"init"`, `"resource"`).
- */
-export declare function ensureToolModule(verb: string, packageName: string, moduleName: string): Promise<unknown>;
 /**
  * Resolve the packager factory for a tool verb.
  *

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/common",
   "license": "MIT",
-  "version": "1.201.0-preview.115",
+  "version": "1.201.0-preview.122",
   "description": "Common infrastructure needed by uip tools.",
   "repository": {
     "type": "git",
@@ -71,5 +71,5 @@
     "mihaigirleanu",
     "vlad-uipath"
   ],
-  "gitHead": "f1086b73654d7728cb71f280588b3e0c77d535fc"
+  "gitHead": "6c56f56100be96231fccbaa59e99d64d94808d58"
 }

package/dist/solution-project-artifacts.d.ts DELETED Viewed

@@ -1,43 +0,0 @@
-/**
- * Shared `ensureProjectArtifacts` used by every `*-tool init` path (agent,
- * case, codedapp, flow, maestro). Lives here so the five tools don't each
- * carry a copy; each tool re-exports it from its own
- * `src/services/project-artifacts.ts` shim (the browser-build
- * `excludedImports` stub mechanism resolves only relative paths under each
- * tool's own src tree).
- */
-/** Options forwarded to solution-tool's `addProjectArtifactsToSolutionAsync`. */
-export interface EnsureProjectArtifactsArgs {
-    /** Absolute path to the solution directory (containing the `.uipx`). */
-    solutionDir: string;
-    /** Stable project key — must match the `Id` in `.uipx` `Projects[]`. */
-    projectId: string;
-    /** Display name for the project; typically the project folder name. */
-    projectName: string;
-    /** Project type as written to `project.uiproj` (e.g. `Flow`, `Agent`). */
-    projectType: string;
-    /** Optional SDK subType (AppV2: `"Coded"` / `"CodedAction"`). */
-    projectSubType?: string;
-}
-/**
- * Result envelope. Structurally identical to `ProjectArtifactsResult` in
- * `@uipath/solution-sdk/resources` — declared here too because this
- * package sits below `solution-sdk` in the dependency graph and cannot import
- * from it.
- */
-export interface ProjectArtifactsResult {
-    /** True when artifact resources were generated. */
-    Created: boolean;
-    /** Error message when `Created` is `false`. */
-    Error?: string;
-}
-/**
- * Generate the `resources/solution_folder/...` artifact-resource entries for
- * a project that has just been registered in its parent solution's `.uipx`.
- *
- * The implementation is resolved at runtime from the installed
- * `@uipath/solution-tool` (through the CLI host's tool-module provider, which
- * installs it on demand), so the multi-megabyte resource-builder chain is
- * never bundled into the calling tool.
- */
-export declare function ensureProjectArtifacts(args: EnsureProjectArtifactsArgs): Promise<ProjectArtifactsResult>;

package/dist/tool-module-import.d.ts DELETED Viewed

@@ -1,9 +0,0 @@
-/**
- * Dynamic import of another tool's library entry point (e.g.
- * `@uipath/solution-tool/init`).
- *
- * Its own module so tests can stand in for it, and so the specifier stays a
- * plain variable — bundlers then leave the `import()` to run at runtime
- * instead of inlining the multi-megabyte target bundle into the caller.
- */
-export declare function importToolModule(specifier: string): Promise<unknown>;