@uipath/solution-sdk 1.201.0-preview.115 → 1.201.0-preview.121

package/dist/index.js

@@ -8534,7 +8534,7 @@ class TextApiResponse {
 var package_default = {
   name: "@uipath/solution-sdk",
   license: "MIT",
-  version: "1.201.0-preview.115",
+  version: "1.201.0-preview.121",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -9404,6 +9404,14 @@ function TestManagerMetadataDtoFromJSONTyped(json, ignoreDiscriminator) {
   };
 }
 
+// ../studioweb-sdk/generated/src/models/TargetPlatform.ts
+function TargetPlatformFromJSON(json) {
+  return TargetPlatformFromJSONTyped(json, false);
+}
+function TargetPlatformFromJSONTyped(json, ignoreDiscriminator) {
+  return json;
+}
+
 // ../studioweb-sdk/generated/src/models/ProjectErrorCode.ts
 function ProjectErrorCodeFromJSON(json) {
   return ProjectErrorCodeFromJSONTyped(json, false);
@@ -9444,6 +9452,91 @@ function SapContextDtoFromJSONTyped(json, ignoreDiscriminator) {
   };
 }
 
+// ../studioweb-sdk/generated/src/models/PreviewProjectDto.ts
+function PreviewProjectDtoFromJSON(json) {
+  return PreviewProjectDtoFromJSONTyped(json, false);
+}
+function PreviewProjectDtoFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    id: json["id"] == null ? undefined : json["id"],
+    designId: json["designId"] == null ? undefined : json["designId"],
+    expressionLanguage: json["expressionLanguage"] == null ? undefined : json["expressionLanguage"],
+    projectType: json["projectType"] == null ? undefined : json["projectType"],
+    name: json["name"] == null ? undefined : json["name"],
+    description: json["description"] == null ? undefined : json["description"],
+    tenantId: json["tenantId"] == null ? undefined : json["tenantId"],
+    status: json["status"] == null ? undefined : ProjectStatusFromJSON(json["status"]),
+    message: json["message"] == null ? undefined : json["message"],
+    lastModifiedTime: json["lastModifiedTime"] == null ? undefined : new Date(json["lastModifiedTime"]),
+    pinDate: json["pinDate"] == null ? undefined : new Date(json["pinDate"]),
+    triggerType: json["triggerType"] == null ? undefined : json["triggerType"],
+    trigger: json["trigger"] == null ? undefined : MetadataTriggerDtoFromJSON(json["trigger"]),
+    connections: json["connections"] == null ? undefined : json["connections"].map(MetadataConnectionDtoFromJSON),
+    lockedBy: json["lockedBy"] == null ? undefined : json["lockedBy"],
+    isSharedByMe: json["isSharedByMe"] == null ? undefined : json["isSharedByMe"],
+    isSharedWithMe: json["isSharedWithMe"] == null ? undefined : json["isSharedWithMe"],
+    projectAppId: json["projectAppId"] == null ? undefined : json["projectAppId"],
+    isSwFileSystemEnabledForApps: json["isSwFileSystemEnabledForApps"] == null ? undefined : json["isSwFileSystemEnabledForApps"],
+    ownerId: json["ownerId"] == null ? undefined : json["ownerId"],
+    sapContext: json["sapContext"] == null ? undefined : SapContextDtoFromJSON(json["sapContext"]),
+    hasDefaultName: json["hasDefaultName"] == null ? undefined : json["hasDefaultName"],
+    errorList: json["errorList"] == null ? undefined : json["errorList"].map(ProjectErrorInformationFromJSON),
+    solutionId: json["solutionId"] == null ? undefined : json["solutionId"],
+    testManagerMetadata: json["testManagerMetadata"] == null ? undefined : TestManagerMetadataDtoFromJSON(json["testManagerMetadata"]),
+    isPreview: json["isPreview"] == null ? undefined : json["isPreview"],
+    lastPublishedVersion: json["lastPublishedVersion"] == null ? undefined : PublishResultModelFromJSON(json["lastPublishedVersion"]),
+    publishedToFeeds: json["publishedToFeeds"] == null ? undefined : json["publishedToFeeds"],
+    sortIndex: json["sortIndex"] == null ? undefined : json["sortIndex"],
+    hasTestCases: json["hasTestCases"] == null ? undefined : json["hasTestCases"],
+    isApp: json["isApp"] == null ? undefined : json["isApp"],
+    targetPlatform: json["targetPlatform"] == null ? undefined : TargetPlatformFromJSON(json["targetPlatform"])
+  };
+}
+// ../studioweb-sdk/generated/src/models/SolutionStatus.ts
+function SolutionStatusFromJSON(json) {
+  return SolutionStatusFromJSONTyped(json, false);
+}
+function SolutionStatusFromJSONTyped(json, ignoreDiscriminator) {
+  return json;
+}
+
+// ../studioweb-sdk/generated/src/models/SolutionPublishStatus.ts
+function SolutionPublishStatusFromJSON(json) {
+  return SolutionPublishStatusFromJSONTyped(json, false);
+}
+function SolutionPublishStatusFromJSONTyped(json, ignoreDiscriminator) {
+  return json;
+}
+
+// ../studioweb-sdk/generated/src/models/PreviewSolutionDto.ts
+function PreviewSolutionDtoFromJSON(json) {
+  return PreviewSolutionDtoFromJSONTyped(json, false);
+}
+function PreviewSolutionDtoFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    id: json["id"] == null ? undefined : json["id"],
+    name: json["name"] == null ? undefined : json["name"],
+    ownerId: json["ownerId"] == null ? undefined : json["ownerId"],
+    creationTime: json["creationTime"] == null ? undefined : new Date(json["creationTime"]),
+    lastModifiedTime: json["lastModifiedTime"] == null ? undefined : new Date(json["lastModifiedTime"]),
+    pinDate: json["pinDate"] == null ? undefined : new Date(json["pinDate"]),
+    projects: json["projects"] == null ? undefined : json["projects"].map(PreviewProjectDtoFromJSON),
+    sortIndex: json["sortIndex"] == null ? undefined : json["sortIndex"],
+    hasTestCases: json["hasTestCases"] == null ? undefined : json["hasTestCases"],
+    status: json["status"] == null ? undefined : SolutionStatusFromJSON(json["status"]),
+    lockedBy: json["lockedBy"] == null ? undefined : json["lockedBy"],
+    isSharedByMe: json["isSharedByMe"] == null ? undefined : json["isSharedByMe"],
+    isSharedWithMe: json["isSharedWithMe"] == null ? undefined : json["isSharedWithMe"],
+    permissions: json["permissions"] == null ? undefined : SharingPermissionsFromJSON(json["permissions"]),
+    publishStatus: json["publishStatus"] == null ? undefined : SolutionPublishStatusFromJSON(json["publishStatus"])
+  };
+}
 // ../studioweb-sdk/generated/src/models/WorkflowUiState.ts
 function WorkflowUiStateFromJSON(json) {
   return WorkflowUiStateFromJSONTyped(json, false);
@@ -9460,14 +9553,6 @@ function WorkflowUiStateFromJSONTyped(json, ignoreDiscriminator) {
   };
 }
 
-// ../studioweb-sdk/generated/src/models/TargetPlatform.ts
-function TargetPlatformFromJSON(json) {
-  return TargetPlatformFromJSONTyped(json, false);
-}
-function TargetPlatformFromJSONTyped(json, ignoreDiscriminator) {
-  return json;
-}
-
 // ../studioweb-sdk/generated/src/models/ProjectDto.ts
 function ProjectDtoFromJSON(json) {
   return ProjectDtoFromJSONTyped(json, false);
@@ -9531,22 +9616,20 @@ function ProjectDtoFromJSONTyped(json, ignoreDiscriminator) {
     jitVersion: json["jitVersion"] == null ? undefined : json["jitVersion"]
   };
 }
-// ../studioweb-sdk/generated/src/models/SolutionStatus.ts
-function SolutionStatusFromJSON(json) {
-  return SolutionStatusFromJSONTyped(json, false);
-}
-function SolutionStatusFromJSONTyped(json, ignoreDiscriminator) {
-  return json;
-}
-
-// ../studioweb-sdk/generated/src/models/SolutionPublishStatus.ts
-function SolutionPublishStatusFromJSON(json) {
-  return SolutionPublishStatusFromJSONTyped(json, false);
+// ../studioweb-sdk/generated/src/models/SolutionAndProjectSearchModelDto.ts
+function SolutionAndProjectSearchModelDtoFromJSON(json) {
+  return SolutionAndProjectSearchModelDtoFromJSONTyped(json, false);
 }
-function SolutionPublishStatusFromJSONTyped(json, ignoreDiscriminator) {
-  return json;
+function SolutionAndProjectSearchModelDtoFromJSONTyped(json, ignoreDiscriminator) {
+  if (json == null) {
+    return json;
+  }
+  return {
+    solutions: json["solutions"] == null ? undefined : json["solutions"].map(PreviewSolutionDtoFromJSON),
+    standaloneProjects: json["standaloneProjects"] == null ? undefined : json["standaloneProjects"].map(PreviewProjectDtoFromJSON),
+    totalCount: json["totalCount"] == null ? undefined : json["totalCount"]
+  };
 }
-
 // ../studioweb-sdk/generated/src/models/SolutionDto.ts
 function SolutionDtoFromJSON(json) {
   return SolutionDtoFromJSONTyped(json, false);
@@ -9718,6 +9801,68 @@ class SolutionApi extends BaseAPI2 {
     const response = await this.solutionOverwriteSolutionRaw(requestParameters, initOverrides);
     return await response.value();
   }
+  async solutionSearchSolutionsAndProjectsRaw(requestParameters, initOverrides) {
+    const queryParameters = {};
+    if (requestParameters["triggerTypes"] != null) {
+      queryParameters["triggerTypes"] = requestParameters["triggerTypes"];
+    }
+    if (requestParameters["owners"] != null) {
+      queryParameters["owners"] = requestParameters["owners"];
+    }
+    if (requestParameters["isPublished"] != null) {
+      queryParameters["isPublished"] = requestParameters["isPublished"];
+    }
+    if (requestParameters["hasTestCases"] != null) {
+      queryParameters["hasTestCases"] = requestParameters["hasTestCases"];
+    }
+    if (requestParameters["publishStatus"] != null) {
+      queryParameters["publishStatus"] = requestParameters["publishStatus"];
+    }
+    if (requestParameters["validIds"] != null) {
+      queryParameters["validIds"] = requestParameters["validIds"];
+    }
+    if (requestParameters["keywords"] != null) {
+      queryParameters["keywords"] = requestParameters["keywords"];
+    }
+    if (requestParameters["connectors"] != null) {
+      queryParameters["connectors"] = requestParameters["connectors"];
+    }
+    if (requestParameters["pagingOptionsLimit"] != null) {
+      queryParameters["pagingOptions.limit"] = requestParameters["pagingOptionsLimit"];
+    }
+    if (requestParameters["pagingOptionsSkip"] != null) {
+      queryParameters["pagingOptions.skip"] = requestParameters["pagingOptionsSkip"];
+    }
+    if (requestParameters["sortBy"] != null) {
+      queryParameters["sortBy"] = requestParameters["sortBy"];
+    }
+    if (requestParameters["sortOrder"] != null) {
+      queryParameters["sortOrder"] = requestParameters["sortOrder"];
+    }
+    if (requestParameters["apiVersion"] != null) {
+      queryParameters["api-version"] = requestParameters["apiVersion"];
+    }
+    const headerParameters = {};
+    if (this.configuration && this.configuration.accessToken) {
+      const token = this.configuration.accessToken;
+      const tokenString = await token("Bearer", []);
+      if (tokenString) {
+        headerParameters["Authorization"] = `Bearer ${tokenString}`;
+      }
+    }
+    let urlPath = `/api/Solution/SearchSolutionsAndProjects`;
+    const response = await this.request({
+      path: urlPath,
+      method: "GET",
+      headers: headerParameters,
+      query: queryParameters
+    }, initOverrides);
+    return new JSONApiResponse2(response, (jsonValue) => SolutionAndProjectSearchModelDtoFromJSON(jsonValue));
+  }
+  async solutionSearchSolutionsAndProjects(requestParameters = {}, initOverrides) {
+    const response = await this.solutionSearchSolutionsAndProjectsRaw(requestParameters, initOverrides);
+    return await response.value();
+  }
 }
 // ../studioweb-sdk/src/client.ts
 function studioWebBasePath(config, organizationName) {
@@ -11904,17 +12049,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, 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 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)) {
@@ -11933,6 +12079,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))
@@ -11993,6 +12182,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 {
@@ -12095,6 +12290,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) {
@@ -12134,6 +12339,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;
@@ -13338,6 +13546,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -13773,12 +13982,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);
 }
@@ -14262,9 +14475,6 @@ var ScreenLogger;
   }
   ScreenLogger.progress = progress;
 })(ScreenLogger ||= {});
-// ../common/src/tool-provider.ts
-var factorySlot = singleton("PackagerFactoryProvider");
-var moduleSlot = singleton("ToolModuleProvider");
 // ../common/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) {
@@ -14275,6 +14485,8 @@ function unsupportedSolutionProjectType(projectType) {
 }
 // ../common/src/telemetry/ship-succeeded.ts
 var shippedKeysSlot = singleton("ShipSucceededDedupeKeys");
+// ../common/src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
 // src/solution-file.ts
 var STUDIO_WEB_PROJECT_TYPE_OVERRIDES = {
   ProcessOrchestration: "processOrchestration"
@@ -15774,6 +15986,21 @@ async function deploymentsAutoInstall(config, request, feedFolderKey) {
     return {};
   }
 }
+// src/project-debug-status.ts
+var SUCCEEDED = "creationsucceeded";
+var TERMINAL = new Set([SUCCEEDED, "creationfailed", "validationfailed"]);
+var isDebugProvisioningTerminal = (status) => TERMINAL.has((status ?? "").toLowerCase());
+var isDebugProvisioningSucceeded = (status) => (status ?? "").toLowerCase() === SUCCEEDED;
+async function getProjectDebugStatus(config, solutionKey, debugSessionId) {
+  const url = `${config.basePath}/api/v1/solutions/${encodeURIComponent(solutionKey)}` + `/projects/debug/status?debugSessionId=${encodeURIComponent(debugSessionId)}`;
+  const response = await fetch(url, {
+    headers: { Authorization: `Bearer ${config.accessToken}` }
+  });
+  if (!response.ok) {
+    throw new ResponseError(response, "Response returned an error code");
+  }
+  return await response.json();
+}
 // src/search-package-versions.ts
 async function searchPackageVersions(config, packageKey, filter, feedFolderKey) {
   const url = `${config.basePath}/api/search/packages/${encodeURIComponent(packageKey)}/versions`;
@@ -15819,6 +16046,30 @@ async function getStudioWebSolutionProjects(config, organizationName, solutionId
     throw error;
   }
 }
+async function listStudioWebSolutions(config, organizationName, options = {}) {
+  const api = createSolutionApi(config, organizationName);
+  try {
+    const result = await api.solutionSearchSolutionsAndProjects({
+      keywords: options.name === undefined ? undefined : [options.name],
+      pagingOptionsLimit: options.limit,
+      pagingOptionsSkip: options.skip,
+      sortBy: options.sortBy,
+      sortOrder: options.sortOrder
+    });
+    const solutions = result.solutions ?? [];
+    return {
+      solutions,
+      combinedCount: solutions.length + (result.standaloneProjects?.length ?? 0),
+      totalCount: result.totalCount
+    };
+  } catch (error) {
+    if (error instanceof ResponseError2) {
+      const text = await error.response.text().catch(() => "");
+      throw new Error(`Studio Web solution listing failed (${error.response.status}): ${text}`);
+    }
+    throw error;
+  }
+}
 // src/upload-service.ts
 class HttpError extends Error {
   status;
@@ -15827,12 +16078,47 @@ class HttpError extends Error {
     this.status = status;
   }
 }
+var DEFAULT_UPLOAD_TIMEOUT_MS = 120000;
+function resolveUploadTimeoutMs() {
+  const raw = Number(process.env?.UIPATH_SOLUTION_UPLOAD_TIMEOUT_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_UPLOAD_TIMEOUT_MS;
+}
+function formatTimeout(timeoutMs) {
+  return timeoutMs < 1000 ? `${Math.round(timeoutMs)}ms` : `${Math.round(timeoutMs / 1000)}s`;
+}
+function timeoutMessage(what, timeoutMs) {
+  return `${what} timed out after ${formatTimeout(timeoutMs)} — the connection ` + `stalled with no response from Studio Web. Retry the command; if it keeps ` + `timing out, check connectivity (VPN/proxy) to the tenant, or raise the ` + `ceiling with UIPATH_SOLUTION_UPLOAD_TIMEOUT_MS.`;
+}
+function isTimeoutError(error) {
+  let current = error;
+  for (let depth = 0;depth < 5 && current instanceof Error; depth += 1) {
+    if (current.name === "TimeoutError")
+      return true;
+    current = current.cause;
+  }
+  return false;
+}
+async function fetchWithUploadTimeout(url, init, what) {
+  const timeoutMs = resolveUploadTimeoutMs();
+  const [error, response] = await catchError(fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) }));
+  if (error) {
+    if (isTimeoutError(error)) {
+      throw new Error(timeoutMessage(what, timeoutMs));
+    }
+    throw error;
+  }
+  return response;
+}
 async function solutionExistsOnStudioWeb(config, organizationName, solutionId) {
   const api = createSolutionApi(config, organizationName);
+  const timeoutMs = resolveUploadTimeoutMs();
   try {
-    await api.solutionGetSolutionRaw({ solutionId });
+    await api.solutionGetSolutionRaw({ solutionId }, { signal: AbortSignal.timeout(timeoutMs) });
     return true;
   } catch (error) {
+    if (isTimeoutError(error)) {
+      throw new Error(timeoutMessage("Studio Web solution existence probe", timeoutMs));
+    }
     if (error instanceof ResponseError2) {
       if (error.response.status === 404) {
         return false;
@@ -15857,11 +16143,7 @@ async function importSolution(config, organizationName, fileBuffer, fileName) {
   if (config.tenantId) {
     headers["x-uipath-tenantid"] = config.tenantId;
   }
-  const response = await fetch(importUrl, {
-    method: "POST",
-    headers,
-    body: formData
-  });
+  const response = await fetchWithUploadTimeout(importUrl, { method: "POST", headers, body: formData }, "Studio Web solution import");
   if (!response.ok) {
     const text = await response.text();
     throw new HttpError(response.status, `Import failed (${response.status}): ${text}`);
@@ -15881,11 +16163,7 @@ async function overwriteSolution(config, organizationName, fileBuffer, fileName,
   if (config.tenantId) {
     headers["x-uipath-tenantid"] = config.tenantId;
   }
-  const response = await fetch(overwriteUrl, {
-    method: "POST",
-    headers,
-    body: formData
-  });
+  const response = await fetchWithUploadTimeout(overwriteUrl, { method: "POST", headers, body: formData }, "Studio Web solution overwrite");
   if (!response.ok) {
     const text = await response.text();
     throw new HttpError(response.status, `Overwrite failed (${response.status}): ${text}`);
@@ -15941,7 +16219,10 @@ export {
   overwriteSolution,
   normalizeProjectType,
   mapValues,
+  listStudioWebSolutions,
   isProjectRegisteredInSolution,
+  isDebugProvisioningTerminal,
+  isDebugProvisioningSucceeded,
   instanceOfWorkflowAction,
   instanceOfSearchFilter,
   instanceOfRuntimeSetup,
@@ -15982,6 +16263,7 @@ export {
   instanceOfBlobFileAccessDto,
   importSolution,
   getStudioWebSolutionProjects,
+  getProjectDebugStatus,
   getAvailablePublishLocationsV2,
   findSolutionFileUpward,
   findSolutionFile,
@@ -16180,4 +16462,4 @@ export {
   BASE_PATH
 };
 
-//# debugId=B3CA1AACA0FB6AE064756E2164756E21
+//# debugId=CD797C0B703ED07764756E2164756E21

package/dist/resources/index.js

@@ -11813,6 +11813,8 @@ init_constants();
 
 // ../auth/src/interactive.ts
 init_src();
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
 
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
@@ -11903,17 +11905,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, 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 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)) {
@@ -11932,6 +11935,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))
@@ -11992,6 +12038,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 {
@@ -12094,6 +12146,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) {
@@ -12133,6 +12195,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;
@@ -13373,6 +13438,7 @@ var CLI_ERROR_CODES = [
   "invalid_argument",
   "authentication_required",
   "permission_denied",
+  "local_permission_denied",
   "not_found",
   "rate_limited",
   "network_error",
@@ -13808,12 +13874,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 errorCode2 = defaultErrorCodeForHttpStatus(status);
     if (errorCode2)
       return errorCode2;
+    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);
 }
@@ -14371,9 +14441,6 @@ 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/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) {
@@ -14384,6 +14451,8 @@ function unsupportedSolutionProjectType(projectType) {
 }
 // ../common/src/telemetry/ship-succeeded.ts
 var shippedKeysSlot = singleton("ShipSucceededDedupeKeys");
+// ../common/src/tool-provider.ts
+var factorySlot = singleton("PackagerFactoryProvider");
 // src/resources/commands/project-utils.ts
 init_src();
 // ../../node_modules/fflate/esm/index.mjs
@@ -32320,4 +32389,4 @@ export {
   EntryPointSpecEnhancer
 };
 
-//# debugId=651D5B44912A89AA64756E2164756E21
+//# debugId=C241E145A8681E7A64756E2164756E21

package/dist/solution-auth.js

@@ -2256,6 +2256,8 @@ init_constants();
 
 // ../auth/src/interactive.ts
 init_src();
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
 
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
@@ -2289,4 +2291,4 @@ export {
   getSolutionAuthContext
 };
 
-//# debugId=A8D037BD2594097C64756E2164756E21
+//# debugId=C583A49A0405670664756E2164756E21

package/dist/src/index.d.ts

@@ -3,10 +3,11 @@ export { getAvailablePublishLocationsV2, type PublishLocationType, type PublishL
 export * from "../generated/src/index.js";
 export { buildSolutionPackageFromDir, bundleSolution, resolveSolutionDir, } from "./bundle-service";
 export { type AutoInstallClientConfig, type DeploymentAutoInstallRequest, deploymentsAutoInstall, } from "./deployments-auto-install";
+export { getProjectDebugStatus, isDebugProvisioningSucceeded, isDebugProvisioningTerminal, type ProjectDebugStatusClientConfig, type ProjectDebugStatusError, type ProjectDebugStatusResponse, } from "./project-debug-status";
 export { type PackageVersionSearchFilter, type PackageVersionSearchRow, type PackageVersionsClientConfig, searchPackageVersions, } from "./search-package-versions";
 export type { AutoCreatedSolution, ParentSolutionDiscovery, PrepareProjectLocationOptions, PrepareProjectLocationResult, ProjectSolutionRegistration, RegisterProjectOptions, SolutionManifestCreation, } from "./solution-file";
 export { autoScaffoldSolution, createSolutionManifest, findNearestParentUipxFile, findSolutionFile, findSolutionFileUpward, isProjectRegisteredInSolution, normalizeProjectType, prepareProjectLocation, readSolutionManifest, readUipxFile, toPortableRelativePath, tryRegisterProjectInParentSolution, updateSolutionFile, updateUipxSolutionId, } from "./solution-file";
-export { getStudioWebSolutionProjects } from "./solution-info";
+export { getStudioWebSolutionProjects, type ListStudioWebSolutionsOptions, listStudioWebSolutions, type StudioWebSolutionsPage, } from "./solution-info";
 export type { BundleResult, SolutionImportResponse, StudioWebConfig, StudioWebSolutionProject, UipxFile, UipxProject, } from "./types";
 export { importSolution, overwriteSolution, solutionExistsOnStudioWeb, uploadOrOverwriteSolution, } from "./upload-service";
 export { SDK_USER_AGENT } from "./user-agent.js";

package/dist/src/project-debug-status.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Solution debug-provisioning status (Automation Solutions).
+ *
+ * Hand-written wrapper for
+ * `GET /api/v1/solutions/{solutionKey}/projects/debug/status`. It is the same
+ * endpoint Studio Web's provisioning flow polls when its SignalR
+ * `ProjectDebugStatus` event does not arrive in time
+ * (`ProvisionSolutionDebugService._pollDebugStatusFallback$`), which makes it
+ * the CLI's way to wait for a `debugProjectAsync` that answered
+ * `complete: false`.
+ *
+ * Generating it instead would take three things, none of them available here:
+ *
+ * 1. `src/scripts/generate-sdk.ts` excludes the whole `/api/v1/solutions/`
+ *    prefix as "problematic headers", so every path in this namespace is out
+ *    of scope by configuration — not merely missing. The two solutions/debug
+ *    paths that *are* in the committed swagger get filtered out for the same
+ *    reason; the generated client holds no `/api/v1/solutions/*` at all.
+ * 2. This path is absent from the committed swagger, which was last refreshed
+ *    2026-03-20, and the generator's source URL is auth-gated.
+ * 3. Lifting the prefix exclusion means finding out which headers broke the
+ *    generator in the first place, which nobody wrote down.
+ *
+ * So this file is a deviation from how the SDKs are meant to work — see
+ * `@uipath/orchestrator-sdk`, where every endpoint is generated and the
+ * hand-written layer is helpers only. To undo it: refresh the swagger with a
+ * valid session, add this path to `explicitlyIncludedPaths`, regenerate, and
+ * delete this file.
+ */
+/** Auth/endpoint inputs for {@link getProjectDebugStatus}. */
+export interface ProjectDebugStatusClientConfig {
+    /** Tenant-scoped Automation Solutions base path (`.../automationsolutions_`). */
+    basePath: string;
+    accessToken: string;
+}
+/** One provisioning error, as the status endpoint reports it. */
+export interface ProjectDebugStatusError {
+    message: string;
+    serviceName?: string;
+    resource?: {
+        key?: string;
+        name?: string;
+        kind?: string;
+        type?: string;
+    };
+}
+/**
+ * Response of the debug status endpoint (mirrors Studio Web's
+ * `ProjectDebugInfo`). `status` is open-ended on purpose: the service emits
+ * non-terminal statuses while provisioning is in flight, and the poll only
+ * acts on the terminal ones ({@link DEBUG_PROVISIONING_TERMINAL_STATUSES}).
+ */
+export interface ProjectDebugStatusResponse {
+    sessionId?: string;
+    status?: string;
+    errors?: ProjectDebugStatusError[];
+    internalFolderId?: number | null;
+}
+/** Whether the provisioning session reached any terminal status. */
+export declare const isDebugProvisioningTerminal: (status?: string) => boolean;
+/** Whether the provisioning session finished successfully. */
+export declare const isDebugProvisioningSucceeded: (status?: string) => boolean;
+/**
+ * Fetch the provisioning status of a solution debug session.
+ *
+ * Non-2xx responses throw the generated runtime's {@link ResponseError} so
+ * callers' `extractErrorDetails` handling (status + body parsing) works
+ * unchanged.
+ */
+export declare function getProjectDebugStatus(config: ProjectDebugStatusClientConfig, solutionKey: string, debugSessionId: string): Promise<ProjectDebugStatusResponse>;

package/dist/src/solution-info.d.ts

@@ -1,6 +1,7 @@
 /**
  * Read solution metadata from UiPath Studio Web.
  */
+import { type PreviewSolutionDto } from "@uipath/studioweb-sdk";
 import type { StudioWebConfig, StudioWebSolutionProject } from "./types";
 /**
  * Fetch the projects of a Studio Web solution
@@ -14,3 +15,45 @@ import type { StudioWebConfig, StudioWebSolutionProject } from "./types";
  * produce a targeted error. Throws on any other non-2xx status.
  */
 export declare function getStudioWebSolutionProjects(config: StudioWebConfig, organizationName: string, solutionId: string): Promise<StudioWebSolutionProject[] | undefined>;
+/** Options for {@link listStudioWebSolutions}. */
+export interface ListStudioWebSolutionsOptions {
+    /** Server-side keyword match against solution and project names. */
+    name?: string;
+    /** Page size. Studio Web caps a page at 100 rows. */
+    limit?: number;
+    /**
+     * Rows to skip before the first returned one. Paging spans Studio Web's
+     * combined solutions + standalone-projects result set (the endpoint pages
+     * over both; only the solutions are returned here).
+     */
+    skip?: number;
+    /** Server column to sort by (e.g. `lastModifiedTime`). */
+    sortBy?: string;
+    /** Sort direction. */
+    sortOrder?: "asc" | "desc";
+}
+/** One page of Studio Web solutions. */
+export interface StudioWebSolutionsPage {
+    /** Solutions in this page, verbatim from the Studio Web response. */
+    solutions: PreviewSolutionDto[];
+    /**
+     * Rows the server returned in this page — solutions plus the standalone
+     * projects that were dropped. Callers paging with `skip` must advance by
+     * this count, not by `solutions.length`.
+     */
+    combinedCount: number;
+    /**
+     * Total matching rows as reported by the server. Counts the combined
+     * solutions + standalone-projects result set, not just solutions.
+     */
+    totalCount?: number;
+}
+/**
+ * List the current user's Studio Web solutions
+ * (`Solution_SearchSolutionsAndProjects` →
+ * `GET /api/Solution/SearchSolutionsAndProjects`).
+ *
+ * The endpoint also returns standalone projects; those are dropped — callers
+ * get solutions only. Throws on any non-2xx status.
+ */
+export declare function listStudioWebSolutions(config: StudioWebConfig, organizationName: string, options?: ListStudioWebSolutionsOptions): Promise<StudioWebSolutionsPage>;

package/dist/src/upload-service.d.ts

@@ -4,6 +4,15 @@
  */
 import type { IFileSystem } from "@uipath/filesystem";
 import type { SolutionImportResponse, StudioWebConfig } from "./types";
+/**
+ * Escape hatch for very large solutions or unusually slow links:
+ * `UIPATH_SOLUTION_UPLOAD_TIMEOUT_MS=300000`. Anything non-numeric or
+ * non-positive falls back to the default — the ceiling can be raised, not
+ * removed, so the silent hang cannot come back through a typo.
+ *
+ * Exported for tests only — not re-exported from the package barrel.
+ */
+export declare function resolveUploadTimeoutMs(): number;
 /**
  * Probe Studio Web for the existence of a solution by id.
  * Returns true on 2xx, false on 404. Throws on any other status so callers

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/solution-sdk",
   "license": "MIT",
-  "version": "1.201.0-preview.115",
+  "version": "1.201.0-preview.121",
   "repository": {
     "type": "git",
     "url": "https://github.com/UiPath/cli.git",
@@ -39,5 +39,5 @@
     "dist"
   ],
   "private": false,
-  "gitHead": "f1086b73654d7728cb71f280588b3e0c77d535fc"
+  "gitHead": "c70ccfc0b12e637441d67df1d212b71d7784b5f8"
 }