@uipath/aops-tool 1.201.0-preview.115 → 1.201.0-preview.121

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   Command,
   metadata,
   registerCommands
-} from "./tool-kb7r4gxr.js";
+} from "./tool-kefvn9c5.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/dist/{tool-kb7r4gxr.js → tool-kefvn9c5.js}

@@ -2112,7 +2112,7 @@ var require_commander = __commonJS((exports) => {
 var package_default = {
   name: "@uipath/aops-tool",
   license: "MIT",
-  version: "1.201.0-preview.115",
+  version: "1.201.0-preview.121",
   description: "Manage UiPath StudioAdmin AOps — connections, repos, projects, solutions, pipelines, executions.",
   private: false,
   repository: {
@@ -2213,17 +2213,18 @@ 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, path) {
+  const target = path !== undefined ? `'${path}'` : "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 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)) {
@@ -2242,6 +2243,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 path = localPermissionPath(cur.path, message);
+    return {
+      code,
+      message: message ?? code,
+      ...path !== undefined ? { path } : {},
+      instructions: localPermissionInstructions(code, path)
+    };
+  }
+  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(path, message) {
+  if (typeof path === "string")
+    return path;
+  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))
@@ -2302,6 +2346,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 {
@@ -2404,6 +2454,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) {
@@ -2443,6 +2503,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;
@@ -3676,6 +3739,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -4111,12 +4175,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);
 }
@@ -5141,11 +5209,10 @@ function installRequestHeaderForwarding(BaseApiClass, patchKey, forward) {
 function installSdkUserAgentHeader(BaseApiClass, userAgent) {
   installRequestHeaderForwarding(BaseApiClass, userAgentPatchKey(userAgent), (headers) => addSdkUserAgentHeader(headers, userAgent));
 }
-// ../common/src/tool-provider.ts
-var factorySlot = singleton("PackagerFactoryProvider");
-var moduleSlot = singleton("ToolModuleProvider");
 // ../common/src/telemetry/ship-succeeded.ts
 var shippedKeysSlot = singleton("ShipSucceededDedupeKeys");
+// ../common/src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
 // ../sc-sdk/generated/src/runtime.ts
 var BASE_PATH = "http://localhost".replace(/\/+$/, "");
 
@@ -7868,6 +7935,9 @@ var getAuthContext = async (options = {}) => {
     tenantName
   };
 };
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
+
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
 var INVALID_TENANT_CODE = "INVALID_TENANT";
@@ -9710,11 +9780,13 @@ var registerConnectionCommand = (program2) => {
       return;
     }
     const data = pollResult.data;
+    const rows = connectionId ? data?.target : data?.states;
     if (!data?.succeeded) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: "Sync settled in a non-success state.",
-        Instructions: "Inspect the failureReason on the returned row(s) and retry, or recreate the connection in StudioAdmin."
+        Instructions: "Inspect the sync state on the row(s) in Data — in the all-connections form they name which one failed — then retry, or recreate the connection in StudioAdmin.",
+        ...rows ? { Data: rows } : {}
       });
       processContext.exit(1);
       return;
@@ -9723,7 +9795,7 @@ var registerConnectionCommand = (program2) => {
     OutputFormatter.success({
       Result: RESULTS.Success,
       Code: "ConnectionSynced",
-      Data: connectionId ? data.target : data.states
+      Data: rows
     });
   });
   withLoginValidity(connection.command("delete").description([
@@ -10273,8 +10345,8 @@ var registerExecutionCommand = (program2) => {
   withLoginValidity(execution.command("details").description([
     "Fetch the underlying job-execution detail document for an execution.",
     "",
-    "Returns the JobDetailsDto — robot, machine, folder, queue context. Useful",
-    "when triaging a failure to see which runner / where it ran."
+    "Returns the JobDetailsDto — robot, machine, release and host context.",
+    "Useful when triaging a failure to see which runner / where it ran."
   ].join(`
 `)).argument("[execution-id]", "Pipeline execution identifier (from `pipeline executions <pipeline-id>`). Required unless `--job-key` is set.").option("--job-key <key>", "JobKey to use directly. Skips the executionId lookup.").examples(DETAILS_EXAMPLES)).trackedAction(processContext, async (executionId, options) => {
     const api = await getCicdApi(PipelineExecutionsApi, options);
@@ -10286,10 +10358,11 @@ var registerExecutionCommand = (program2) => {
     const [error, result] = await catchError2(api.pipelineExecutionsGetPipelineJobDetails({
       jobKey: resolved.jobKey
     }));
-    if (error) {
+    if (error || !result?.key) {
+      const unresolvable = !error || error instanceof SyntaxError || /unexpected end of json/i.test(error.message ?? "");
       OutputFormatter.error({
         Result: RESULTS.Failure,
-        Message: await extractErrorMessage(error),
+        Message: unresolvable ? `Job details for '${resolved.jobKey}' not found.` : await extractErrorMessage(error),
         Instructions: "Verify the executionId / --job-key with 'uip aops execution get <execution-id>'."
       });
       processContext.exit(1);
@@ -10827,8 +10900,8 @@ var registerPipelineCommand = (program2) => {
     "single process with 'pipeline process <process-id>' for the",
     "full DTO including arguments and inputArguments.",
     "",
-    "Use the returned ProcessId inside the `automationProcessIdentifier`",
-    "field of the PipelineDto JSON when authoring a pipeline."
+    "Use the returned ProcessId as the PipelineDto's `processIdentifier` when",
+    "authoring a pipeline."
   ].join(`
 `)).examples(PROCESSES_EXAMPLES)).trackedAction(processContext, async (options) => {
     const api = await getCicdApi(PipelineApi, options);
@@ -11314,7 +11387,7 @@ var CONTENT_EXAMPLES = [
     Command: "uip aops project content --project-id 9999dddd-0000-0000-0000-000000000001 --path Main.xaml",
     Output: {
       Code: "ProjectFileContent",
-      Data: { content: "<xaml…>", encoding: "utf-8" }
+      Data: { FileContent: "<xaml…>" }
     }
   },
   {
@@ -11322,7 +11395,7 @@ var CONTENT_EXAMPLES = [
     Command: "uip aops project content --project-id 9999dddd-0000-0000-0000-000000000001 --path Main.xaml --reference 0123456789abcdef0123456789abcdef01234567",
     Output: {
       Code: "ProjectFileContent",
-      Data: { content: "<xaml…>", encoding: "utf-8" }
+      Data: { FileContent: "<xaml…>" }
     }
   }
 ];
@@ -11344,7 +11417,7 @@ var COMMIT_EXAMPLES = [
     Command: "uip aops project commit --project-id 9999dddd-0000-0000-0000-000000000001 --reference 0123456789abcdef0123456789abcdef01234567",
     Output: {
       Code: "ProjectCommit",
-      Data: { sha: SAMPLE_SHA, message: "Initial commit" }
+      Data: { Reference: SAMPLE_SHA, Message: "Initial commit" }
     }
   }
 ];
@@ -11579,7 +11652,8 @@ var registerProjectCommand = (program2) => {
     "List the file tree of a project at a given reference.",
     "",
     "`--path` scopes to a subdirectory; `--reference` targets a non-default",
-    "branch / tag / commit. Returns one row per file with type, size, and path."
+    "branch / tag / commit. Returns one row per entry with its name, path, type",
+    "and buildable-unit type."
   ].join(`
 `)).requiredOption("--project-id <id>", "SC service UUID for the automation project, from `connection projects`.").option("--path <path>", "Subdirectory inside the project to list. Defaults to the project root.").option("--reference <ref>", "Branch name, tag, or commit SHA. Defaults to the default branch HEAD.").examples(FILES_EXAMPLES)).trackedAction(processContext, async (options) => {
     const api = await getScApi(ProjectsApi, options);
@@ -11611,7 +11685,7 @@ var registerProjectCommand = (program2) => {
     "`--path` is the file path relative to the project root. `--reference` picks",
     "a non-default branch / tag / SHA — leave it off for the default branch HEAD."
   ].join(`
-`)).requiredOption("--project-id <id>", "SC service UUID for the automation project, from `connection projects`.").option("--path <path>", "Path to the file inside the project (relative to the project root).").option("--reference <ref>", "Branch name, tag, or commit SHA. Defaults to the default branch HEAD.").examples(CONTENT_EXAMPLES)).trackedAction(processContext, async (options) => {
+`)).requiredOption("--project-id <id>", "SC service UUID for the automation project, from `connection projects`.").requiredOption("--path <path>", "Path to the file inside the project (relative to the project root).").option("--reference <ref>", "Branch name, tag, or commit SHA. Defaults to the default branch HEAD.").examples(CONTENT_EXAMPLES)).trackedAction(processContext, async (options) => {
     const api = await getScApi(ProjectsApi, options);
     if (!api)
       return;
@@ -11630,7 +11704,7 @@ var registerProjectCommand = (program2) => {
       processContext.exit(1);
       return;
     }
-    if (!result) {
+    if (result?.fileContent == null) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: `Project file '${options.path}' not found.`,
@@ -11752,8 +11826,8 @@ var BRANCHES_EXAMPLES = [
     Output: {
       Code: "RepoBranches",
       Data: [
-        { name: "main", isDefault: true },
-        { name: "release", isDefault: false }
+        { Name: "main", Main: true },
+        { Name: "release", Main: false }
       ]
     }
   }
@@ -11788,7 +11862,7 @@ var registerRepoCommand = (program2) => {
   withLoginValidity(repo.command("branches").description([
     "List branches for a repository.",
     "",
-    "Returns one row per branch with its name and a `isDefault` flag. Use the",
+    "Returns one row per branch with its `Name` and a `Main` flag. Use the",
     "branch name as `--reference` for `repo project-files`, `project content`,",
     "etc., when you need to inspect non-default branches."
   ].join(`
@@ -11995,4 +12069,4 @@ var registerCommands = async (program2) => {
 
 export { Command, metadata, registerCommands };
 
-//# debugId=545EA0E4F5DEF0D464756E2164756E21
+//# debugId=85D641E61AC239C364756E2164756E21

package/dist/tool.js

@@ -1,7 +1,7 @@
 import {
   metadata,
   registerCommands
-} from "./tool-kb7r4gxr.js";
+} from "./tool-kefvn9c5.js";
 import"./tool-9qecd4wb.js";
 import"./tool-7eva0peq.js";
 import"./tool-5arsyj36.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/aops-tool",
   "license": "MIT",
-  "version": "1.201.0-preview.115",
+  "version": "1.201.0-preview.121",
   "description": "Manage UiPath StudioAdmin AOps — connections, repos, projects, solutions, pipelines, executions.",
   "private": false,
   "repository": {
@@ -26,5 +26,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "f1086b73654d7728cb71f280588b3e0c77d535fc"
+  "gitHead": "c70ccfc0b12e637441d67df1d212b71d7784b5f8"
 }