@uipath/solution-tool 1.202.0-preview.138 → 1.202.0-preview.140

package/dist/deploy.js

@@ -5,11 +5,11 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-k2tj5mv2.js";
-import"./packager-tool-vmskhsbr.js";
-import"./packager-tool-zwvkjsmc.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+} from "./packager-tool-3n5e7fkr.js";
+import"./packager-tool-x907fvkz.js";
+import"./packager-tool-40vamz9y.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/index.js

@@ -2,21 +2,21 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-htp0xd7c.js";
-import"./packager-tool-vxthsps3.js";
-import"./packager-tool-k2tj5mv2.js";
-import"./packager-tool-xfg2cveb.js";
-import"./packager-tool-p4kjbrrp.js";
-import"./packager-tool-9dx65z2d.js";
-import"./packager-tool-af5hm3yv.js";
-import"./packager-tool-vmskhsbr.js";
-import"./packager-tool-zwvkjsmc.js";
-import"./packager-tool-72345dw7.js";
+} from "./packager-tool-kpybyt0p.js";
+import"./packager-tool-6bhx9vfz.js";
+import"./packager-tool-3n5e7fkr.js";
+import"./packager-tool-8t3sjyk9.js";
+import"./packager-tool-2t1tzvbv.js";
+import"./packager-tool-3bewrpq4.js";
+import"./packager-tool-ah6zzb55.js";
+import"./packager-tool-x907fvkz.js";
+import"./packager-tool-40vamz9y.js";
+import"./packager-tool-pc4hb3pv.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-fjr8yn4g.js";
+import"./packager-tool-29bj4s4t.js";
 import {
   Command
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 

package/dist/init.js

@@ -1,13 +1,13 @@
 import {
   SolutionInitError,
   solutionInitAsync
-} from "./packager-tool-xfg2cveb.js";
+} from "./packager-tool-8t3sjyk9.js";
 import {
   addProjectArtifactsToSolutionAsync
-} from "./packager-tool-72345dw7.js";
+} from "./packager-tool-pc4hb3pv.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/{list-4dbar53b.js → list-jqq1w9h5.js}

@@ -1,11 +1,11 @@
 import {
   getStudioWebAuth,
   useStudioWebAuth
-} from "./packager-tool-vxthsps3.js";
+} from "./packager-tool-6bhx9vfz.js";
 import {
   getStudioWebSolutionProjects,
   listStudioWebSolutions
-} from "./packager-tool-zwvkjsmc.js";
+} from "./packager-tool-40vamz9y.js";
 import {
   DEFAULT_PAGE_SIZE,
   OutputFormatter,
@@ -16,7 +16,7 @@ import {
   parseBoundedInt,
   parseOffset,
   processContext
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 

package/dist/pack.js

@@ -1,11 +1,11 @@
 import {
   packSolutionAsync
-} from "./packager-tool-p4kjbrrp.js";
-import"./packager-tool-9dx65z2d.js";
-import"./packager-tool-72345dw7.js";
+} from "./packager-tool-2t1tzvbv.js";
+import"./packager-tool-3bewrpq4.js";
+import"./packager-tool-pc4hb3pv.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/{packager-tool-sba5cptt.js → packager-tool-1x1cc4qh.js}

@@ -5436,6 +5436,12 @@ async function extractErrorMessage(error, options) {
   const { message } = await extractErrorDetails(error, options);
   return message;
 }
+// ../common/src/classified-failure.ts
+var MAX_QUOTED_BODY_CHARS = 200;
+function summarizePlatformBody(body) {
+  const trimmed = body.trim().replace(/\s+/g, " ");
+  return trimmed.length > MAX_QUOTED_BODY_CHARS ? `${trimmed.slice(0, MAX_QUOTED_BODY_CHARS)}…` : trimmed;
+}
 // ../common/src/command-examples.ts
 var examplesByCommand = new WeakMap;
 Command.prototype.examples = function(examples) {
@@ -7817,6 +7823,6 @@ async function findSolutionFileUpward(fs2, startDir) {
   }
 }
 
-export { getFileSystem, catchError, carriedInstructions, extractErrorDetails, extractErrorMessage, logger, telemetry, RESULTS, Pagination, OutputFormatter, Command, Option, isPreviewBuild, processContext, withCompleter, requireConfirmation, DEFAULT_PAGE_SIZE, resolveEnvReference, isGuid, createHiddenDeprecatedTenantOption, parseLimit, parseOffset, parseBoundedInt, registerPackageMetadataOptions, mapPackageMetadataOptions, PollOutcome, mapPollFailure, pollUntil, getSdkUserAgentToken, addSdkUserAgentHeader, installSdkUserAgentHeader, unsupportedSolutionProjectType, trackShipSucceeded, ensurePackagerFactory, getLoginStatusAsync, getAuthContext, normalizeProjectType, toPortableRelativePath, readUipxFile, resolveSolutionDir, updateUipxSolutionId, findSolutionFileUpward };
+export { getFileSystem, catchError, carriedInstructions, extractErrorDetails, extractErrorMessage, logger, telemetry, RESULTS, Pagination, OutputFormatter, summarizePlatformBody, Command, Option, isPreviewBuild, processContext, withCompleter, requireConfirmation, DEFAULT_PAGE_SIZE, resolveEnvReference, isGuid, createHiddenDeprecatedTenantOption, parseLimit, parseOffset, parseBoundedInt, registerPackageMetadataOptions, mapPackageMetadataOptions, PollOutcome, mapPollFailure, pollUntil, getSdkUserAgentToken, addSdkUserAgentHeader, installSdkUserAgentHeader, unsupportedSolutionProjectType, trackShipSucceeded, ensurePackagerFactory, getLoginStatusAsync, getAuthContext, normalizeProjectType, toPortableRelativePath, readUipxFile, resolveSolutionDir, updateUipxSolutionId, findSolutionFileUpward };
 
-//# debugId=62C28FF18B08C6A164756E2164756E21
+//# debugId=A770E41AF763C8F264756E2164756E21

package/dist/{packager-tool-fjr8yn4g.js → packager-tool-29bj4s4t.js}

@@ -3,7 +3,7 @@ import {
   getAuthContext,
   getSdkUserAgentToken,
   installSdkUserAgentHeader
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 
 // ../solution-sdk/src/solution-auth.ts
 async function getSolutionAuthContext(options) {

package/dist/{packager-tool-p4kjbrrp.js → packager-tool-2t1tzvbv.js}

@@ -4,6 +4,8 @@ import {
   LogLevel,
   LogMessage,
   Path,
+  ProjectTool,
+  ProjectTypes,
   TargetFramework,
   TemporaryStorageService,
   ToolErrorCodes,
@@ -12,7 +14,7 @@ import {
   registerPackagerFactories,
   toolsFactoryRepository,
   translate
-} from "./packager-tool-9dx65z2d.js";
+} from "./packager-tool-3bewrpq4.js";
 import {
   Tokens,
   createResourceBuilderServices,
@@ -23,7 +25,7 @@ import {
   models_BindingsResourceType,
   readUipxProjects,
   syncAndLog
-} from "./packager-tool-72345dw7.js";
+} from "./packager-tool-pc4hb3pv.js";
 import {
   ToolResult as ToolResult2,
   toolsFactoryRepository as toolsFactoryRepository2
@@ -39,7 +41,7 @@ import {
   logger,
   telemetry,
   unsupportedSolutionProjectType
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 
 // ../filesystem/dist/index.js
 import fs from "node:fs";
@@ -24191,7 +24193,7 @@ var sdkUserAgentHostToken2 = singleton2("SdkUserAgentHostToken");
 var package_default = {
   name: "@uipath/project-packager",
   license: "MIT",
-  version: "1.202.0-preview.138",
+  version: "1.202.0-preview.140",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -24556,6 +24558,77 @@ class PackagerParametersValidator {
     return ToolResult.success();
   }
 }
+class ProjectLoader {
+  fileSystem;
+  static WebAppManifestFileName = "webAppManifest.json";
+  static ProjectJsonFileName = "project.json";
+  constructor(fileSystem) {
+    this.fileSystem = fileSystem;
+  }
+  async loadProject(projectPath) {
+    if (!projectPath) {
+      throw new Error(translate.t("solutionpackager.projectLoader.errors.pathRequired"));
+    }
+    const projectFilePath = Path.join(projectPath, ProjectTool.ProjectFileName);
+    const projectFileExists = await this.fileSystem.exists(projectFilePath);
+    if (projectFileExists) {
+      return await this.loadFromProjectFile(projectPath, projectFilePath);
+    }
+    const projectJsonPath = Path.join(projectPath, ProjectLoader.ProjectJsonFileName);
+    if (await this.fileSystem.exists(projectJsonPath)) {
+      return await this.loadFromProjectFile(projectPath, projectJsonPath, true);
+    }
+    const webAppManifestPath = Path.join(projectPath, ProjectLoader.WebAppManifestFileName);
+    const webAppManifestExists = await this.fileSystem.exists(webAppManifestPath);
+    if (webAppManifestExists) {
+      return this.loadFromWebAppManifest(projectPath, webAppManifestPath);
+    }
+    throw new Error(translate.t("solutionpackager.projectLoader.errors.noProjectFile", {
+      projectFile: ProjectTool.ProjectFileName,
+      projectJsonFile: ProjectLoader.ProjectJsonFileName,
+      manifestFile: ProjectLoader.WebAppManifestFileName,
+      path: projectPath
+    }));
+  }
+  async loadFromProjectFile(projectPath, projectFilePath, useProjectJson = false) {
+    const fileContent = await this.fileSystem.readFile(projectFilePath);
+    if (!fileContent) {
+      throw new Error(translate.t("solutionpackager.projectLoader.errors.readFailed", {
+        path: projectFilePath
+      }));
+    }
+    const json = typeof fileContent === "string" ? fileContent : new TextDecoder("utf-8").decode(fileContent);
+    const projectData = JSON.parse(json);
+    const projectJson = useProjectJson ? projectData : undefined;
+    const outputType = projectJson?.designOptions?.outputType;
+    const projectType = outputType ?? (projectData?.ProjectType || projectData?.type);
+    if (!projectData || !projectType) {
+      throw new Error(translate.t("solutionpackager.projectLoader.errors.invalidProject", {
+        path: projectFilePath
+      }));
+    }
+    const declaredName = projectJson?.name?.trim() || projectData.Name;
+    const declaredDescription = projectJson?.description?.trim() || projectData.Description?.trim() || undefined;
+    const declaredAuthor = projectJson?.author?.trim() || projectData.Author?.trim() || undefined;
+    return {
+      type: projectType,
+      name: declaredName || Path.basename(projectPath),
+      projectPath,
+      projectFilePath,
+      description: declaredDescription,
+      author: declaredAuthor
+    };
+  }
+  loadFromWebAppManifest(projectPath, webAppManifestPath) {
+    const folderName = Path.basename(projectPath);
+    return {
+      type: ProjectTypes.AppV2,
+      name: folderName,
+      projectPath,
+      projectFilePath: webAppManifestPath
+    };
+  }
+}
 var TelemetryNames;
 ((TelemetryNames2) => {
   TelemetryNames2["ProjectToolPack"] = "ProjectPackager.Tool.Pack";
@@ -37334,7 +37407,7 @@ var sdkUserAgentHostToken22 = singleton22("SdkUserAgentHostToken");
 var package_default2 = {
   name: "@uipath/project-packager",
   license: "MIT",
-  version: "1.202.0-preview.138",
+  version: "1.202.0-preview.140",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -37799,6 +37872,8 @@ class OptionsBuilder {
     this.fileSystem = fileSystem;
   }
   static FILES_DIRECTORY_NAME = "files";
+  static DEFAULT_AUTHOR = "UiPath";
+  static DEFAULT_DESCRIPTION = "Created by UiPath";
   async buildSolutionPackOptions(parameters, solution) {
     if (!parameters.outputPath) {
       throw new Error(translate.t("solutionpackager.optionsBuilder.errors.outputPathRequired"));
@@ -37817,16 +37892,34 @@ class OptionsBuilder {
       projectsToBuild: solution.Projects.map((p) => p.Id)
     };
   }
+  async resolveMemberMetadataAsync(solutionOptions, projectPath) {
+    const declared = await this.loadDeclaredMetadataAsync(projectPath);
+    return {
+      author: solutionOptions.package.author?.trim() || declared?.author || OptionsBuilder.DEFAULT_AUTHOR,
+      description: solutionOptions.package.description?.trim() || declared?.description || OptionsBuilder.DEFAULT_DESCRIPTION
+    };
+  }
+  async loadDeclaredMetadataAsync(projectPath) {
+    try {
+      const loaded = await new ProjectLoader(this.fileSystem).loadProject(projectPath);
+      return {
+        author: loaded.author,
+        description: loaded.description
+      };
+    } catch {
+      return;
+    }
+  }
   async createOutputFilesDirectoryAsync(outputPath) {
     const filesDir = Path.join(outputPath, OptionsBuilder.FILES_DIRECTORY_NAME);
     await this.fileSystem.mkdir(filesDir);
   }
-  async buildProjectPackOptions(solutionOptions, project) {
+  async buildProjectPackOptions(solutionOptions, project, solutionName) {
     const projectPath = this.resolveProjectPath(solutionOptions, project);
-    const solutionName = solutionOptions.package.id || undefined;
     const packageInfo = {
       ...solutionOptions.package,
-      id: await this.packageIdReader.read(project, solutionOptions.inputPath, solutionName) || ""
+      id: await this.packageIdReader.read(project, solutionOptions.inputPath, solutionName) || "",
+      ...await this.resolveMemberMetadataAsync(solutionOptions, projectPath)
     };
     if (!solutionOptions.outputPath) {
       throw new Error(translate.t("solutionpackager.optionsBuilder.errors.outputPathRequired"));
@@ -38269,7 +38362,7 @@ class SolutionPackService {
       return await this.telemetry.trackDependencyOperation("SolutionPackager.Solution.Pack", "pack", async () => {
         const [restoreResult, ...projectResults] = await Promise.all([
           solutionTool.restoreAsync(solutionOptions, cancellationToken),
-          ...this.packAllProjectsAsync(parameters, solution.Projects, context, cancellationToken)
+          ...this.packAllProjectsAsync(parameters, solution.Projects, solution.Name, context, cancellationToken)
         ]);
         const restoreAndPackResults = [
           restoreResult,
@@ -38301,12 +38394,12 @@ class SolutionPackService {
       }
     }
   }
-  packAllProjectsAsync(parameters, projects, context, cancellationToken) {
-    return projects.map((project) => this.packSingleProjectAsync(parameters, project, context, cancellationToken));
+  packAllProjectsAsync(parameters, projects, solutionName, context, cancellationToken) {
+    return projects.map((project) => this.packSingleProjectAsync(parameters, project, solutionName, context, cancellationToken));
   }
-  async packSingleProjectAsync(parameters, project, context, cancellationToken) {
+  async packSingleProjectAsync(parameters, project, solutionName, context, cancellationToken) {
     try {
-      const projectOptions = await this.optionsBuilder.buildProjectPackOptions(parameters, project);
+      const projectOptions = await this.optionsBuilder.buildProjectPackOptions(parameters, project, solutionName);
       return await this.projectExecutor.packAsync(projectOptions, project, context, cancellationToken);
     } catch (error) {
       const errorMessage2 = error instanceof Error ? error.message : String(error);
@@ -39415,8 +39508,8 @@ Packing solution...
     packOptions.package = {
       id: packageName,
       version: options.version || "1.0.0",
-      author: options.author?.trim() || "UiPath",
-      description: options.description?.trim() || "Created by UiPath",
+      author: options.author?.trim() || undefined,
+      description: options.description?.trim() || undefined,
       releaseNotes: options.releaseNotes,
       projectUrl: options.projectUrl,
       repositoryType: options.repositoryType,
@@ -39490,4 +39583,4 @@ async function packSolutionAsync(solutionPath, options) {
 
 export { SolutionPackOptions, isUnpackableProjectTypeError, ensurePackagerTools, createSolutionPackager, readSolutionFileAsUint8Array, resolveSdkLogLevel, applyAuthConnection, SOLUTION_PATH_INSTRUCTIONS, checkSolutionPathAsync, GOVERNANCE_OPTION_INSTRUCTIONS, validateGovernanceOptions, PackCommandService, packSolutionAsync };
 
-//# debugId=2C5DDB7BE97361C764756E2164756E21
+//# debugId=53B4FC3C36728CC064756E2164756E21

package/dist/{packager-tool-9dx65z2d.js → packager-tool-3bewrpq4.js}

@@ -2267,6 +2267,6 @@ function registerPackagerFactories() {
   toolsFactoryRepository.registerProjectToolFactory(new ConnectorToolFactory);
 }
 
-export { Path, TemporaryStorageService, ZipService, I18nManager, translate, BuildConfiguration, LogLevel, LogMessage, TargetFramework, ToolErrorCodes, ToolResult, toolsFactoryRepository2 as toolsFactoryRepository, registerPackagerFactories };
+export { Path, TemporaryStorageService, ZipService, I18nManager, translate, BuildConfiguration, LogLevel, LogMessage, ProjectTypes, TargetFramework, ToolErrorCodes, ToolResult, ProjectTool, toolsFactoryRepository2 as toolsFactoryRepository, registerPackagerFactories };
 
-//# debugId=1698A45CAE5F631764756E2164756E21
+//# debugId=380EC26ADC903B4F64756E2164756E21

package/dist/{packager-tool-k2tj5mv2.js → packager-tool-3n5e7fkr.js}

@@ -7,7 +7,7 @@ import {
   listSelectablePublishLocations,
   resolveFeedScope,
   resolvePersonalWorkspace
-} from "./packager-tool-vmskhsbr.js";
+} from "./packager-tool-x907fvkz.js";
 import {
   Configuration as Configuration2,
   DeploymentOperationStatus,
@@ -16,11 +16,11 @@ import {
   SolutionDeploymentAction,
   deploymentsAutoInstall,
   searchPackageVersions
-} from "./packager-tool-zwvkjsmc.js";
+} from "./packager-tool-40vamz9y.js";
 import {
   getSolutionAuthContext,
   resolveFolder
-} from "./packager-tool-fjr8yn4g.js";
+} from "./packager-tool-29bj4s4t.js";
 import {
   DEFAULT_PAGE_SIZE,
   PollOutcome,
@@ -31,7 +31,7 @@ import {
   mapPollFailure,
   pollUntil,
   processContext
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import {
   __commonJS,
   __require

package/dist/{packager-tool-zwvkjsmc.js → packager-tool-40vamz9y.js}

@@ -1,11 +1,13 @@
 import {
+  RESULTS,
   addSdkUserAgentHeader,
   catchError,
   getSdkUserAgentToken,
   installSdkUserAgentHeader,
   logger,
-  readUipxFile
-} from "./packager-tool-sba5cptt.js";
+  readUipxFile,
+  summarizePlatformBody
+} from "./packager-tool-1x1cc4qh.js";
 import {
   zipSync
 } from "./packager-tool-dfrk01gn.js";
@@ -3103,7 +3105,7 @@ async function listStudioWebSolutions(config, organizationName, options = {}) {
 var package_default = {
   name: "@uipath/solution-sdk",
   license: "MIT",
-  version: "1.202.0-preview.138",
+  version: "1.202.0-preview.140",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -3170,9 +3172,11 @@ installSdkUserAgentHeader(BaseAPI, SDK_USER_AGENT);
 // ../solution-sdk/src/upload-service.ts
 class HttpError extends Error {
   status;
-  constructor(status, message) {
+  authChallenge;
+  constructor(status, message, authChallenge) {
     super(message);
     this.status = status;
+    this.authChallenge = authChallenge;
   }
 }
 
@@ -3186,6 +3190,7 @@ class SolutionUploadHttpError extends Error {
   solutionId;
   parsedErrorCode;
   parsedErrorMessage;
+  authChallenge;
   constructor(details) {
     super(details.message);
     this.name = "SolutionUploadHttpError";
@@ -3198,6 +3203,7 @@ class SolutionUploadHttpError extends Error {
     if (details.operation === "overwrite") {
       this.solutionId = details.solutionId;
     }
+    this.authChallenge = details.authChallenge;
     const parsed = parseUploadErrorBody(details.body);
     this.parsedErrorCode = parsed.code;
     this.parsedErrorMessage = parsed.message;
@@ -3214,10 +3220,101 @@ function parseUploadErrorBody(body) {
     message: typeof rawMessage === "string" && rawMessage.trim() ? rawMessage : undefined
   };
 }
+function isSolutionUploadHttpError(error) {
+  return error instanceof Error && error.name === "SolutionUploadHttpError" && "operation" in error && (error.operation === "import" || error.operation === "overwrite") && "status" in error && typeof error.status === "number" && "body" in error && typeof error.body === "string";
+}
 function requestPath(url) {
   const [, parsed] = catchError(() => new URL(url));
   return parsed ? `${parsed.pathname}${parsed.search}` : url;
 }
+var TOKEN_SHAPED = /\beyJ[A-Za-z0-9_-]{6,}\.[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]*)?|\bBearer\s+[A-Za-z0-9._~+/=-]{8,}/gi;
+function redactTokens(text) {
+  return text.replace(TOKEN_SHAPED, "[REDACTED]");
+}
+var MAX_CHALLENGE_DESCRIPTION = 200;
+function parseAuthChallenge(header) {
+  if (!header)
+    return {};
+  const code = /\berror="([^"]*)"/.exec(header)?.[1]?.trim();
+  const raw = /\berror_description="([^"]*)"/.exec(header)?.[1]?.trim();
+  const description = raw ? redactTokens(raw).slice(0, MAX_CHALLENGE_DESCRIPTION) : undefined;
+  return {
+    error: code || undefined,
+    description: description || undefined
+  };
+}
+function summarizeAuthRefusalBody(body) {
+  return summarizePlatformBody(redactTokens(body));
+}
+function isAuthRefusal(status) {
+  return status === 401 || status === 403;
+}
+function buildAuthRefusalInstructions({
+  err,
+  subject,
+  target,
+  bodySuffix,
+  identityType,
+  clientId
+}) {
+  const refusal = err.status === 401 ? "rejected the call as unauthorized (401)" : "forbade the call (403)";
+  const what = err.operation === "overwrite" ? `replacing the contents of solution ${target}` : "importing the solution package";
+  const actor = identityType === "Application" ? `This session acts as external application ${clientId ?? "(client id unknown)"}, so ` + `check what that application is allowed to do: it needs the Studio ` + `Web scopes that cover writing a solution (the StudioWebS2S grants ` + `on the external application), not just the Orchestrator or ` + `Solutions ones. ` : identityType === "User" ? `This session acts as a user, so check that your account has ` + `Studio Web access in this tenant. ` : `Check what this session is allowed to do in Studio Web — an ` + `external application needs the StudioWebS2S grants that cover ` + `writing a solution, a user needs Studio Web access in the tenant. `;
+  const tenant = err.operation === "overwrite" ? `Also confirm that ${target} is the solution this project should ` + `publish to, and that it lives in the organization and tenant ` + `this session logged into — the id comes from the SolutionId ` + `recorded in the enclosing solution file. An id this session ` + `cannot see at all is reported separately, as nothing to ` + `overwrite, so a refusal here points at the grants first. ` : `Also confirm you are logged into the organization and tenant the ` + `solution should land in. `;
+  const challenge = parseAuthChallenge(err.authChallenge);
+  const quoted = challenge.description ? ` ("${challenge.description}")` : "";
+  if (challenge.error === "invalid_token") {
+    return `Studio Web ${refusal} while ${what}, and rejected the credential ` + `itself with the reason \`invalid_token\`${quoted}. That is the ` + `platform refusing this token rather than the permissions behind ` + `it, so unlike a grants refusal this one is worth a fresh ` + `\`uip login\` — or, in a pipeline, a newly minted ` + `client-credentials token. Check too that the token was issued for ` + `the organization being called: one minted against a different ` + `environment or audience is refused this way. Nothing was uploaded ` + `and nothing ran, so the ${subject} is not the cause.${bodySuffix}`;
+  }
+  const authenticated = `The session is authenticated — the token was issued and had not ` + `expired when the call went out — so re-running \`uip login\` mints ` + `the same token and fails the same way. `;
+  const diagnosis = challenge.error === "insufficient_scope" ? `Studio Web reported \`insufficient_scope\`${quoted}, so the ` + `token is valid and simply not allowed to do this: logging in ` + `again will not change it. ` : challenge.error ? `${authenticated}Studio Web gave the reason ` + `\`${challenge.error}\`${quoted}. ` : authenticated;
+  const closing = bodySuffix ? `If the grants and the tenant are already right, report the platform ` + `response, including its traceId.${bodySuffix}` : challenge.error ? `If the grants and the tenant are already right, report that reason ` + `together with the request path and status above.` : `If the grants and the tenant are already right, report the request ` + `path and status above — Studio Web returned no response body and ` + `no authentication challenge, so there is nothing further to quote.`;
+  return `Studio Web ${refusal} while ${what}. ${diagnosis}${actor}${tenant}` + `Nothing was uploaded and nothing ran, so the ${subject} is not the ` + `cause. ${closing}`;
+}
+function buildSolutionUploadFailureOutput(err, options = {}) {
+  const stage = err.operation === "overwrite" ? "overwrite-solution" : "import-solution";
+  const authRefusal = isAuthRefusal(err.status);
+  const parsedMessage = authRefusal && err.parsedErrorMessage ? redactTokens(err.parsedErrorMessage) : err.parsedErrorMessage;
+  const detail = parsedMessage ? ` — ${parsedMessage}` : "";
+  const Message = `Failed during ${stage}: HTTP ${err.status} on ${err.method} ` + `${err.endpoint}${detail}`;
+  const quote = authRefusal ? summarizeAuthRefusalBody : summarizePlatformBody;
+  const body = err.parsedErrorMessage ? "" : quote(err.body);
+  const bodySuffix = body ? ` Platform response: "${body}".` : "";
+  const importHint = options.importCheckHint ? ` ${options.importCheckHint}` : "";
+  const subject = options.subject ?? "project";
+  const target = err.solutionId ?? `the solution at ${err.endpoint}`;
+  const authInstructions = isAuthRefusal(err.status) ? buildAuthRefusalInstructions({
+    err,
+    subject,
+    target,
+    bodySuffix,
+    identityType: options.identityType,
+    clientId: options.clientId
+  }) : undefined;
+  const Instructions = authInstructions ?? (err.operation === "overwrite" ? `Studio Web refused to replace the contents of solution ` + `${target}. Nothing was uploaded and nothing ran, so the ` + `${subject} is not the cause: do not re-author it, and do not ` + `copy the project into another solution. Confirm that ${target} ` + `is a solution you can still write to, and that it is the one ` + `this project should publish to — it comes from the SolutionId ` + `recorded in the enclosing solution file. If it is right, report ` + `the platform response.${bodySuffix}` : `Studio Web refused to import the solution package. Nothing was ` + `uploaded and nothing ran, so no part of the ${subject} executed ` + `— but the package itself may be what was rejected.${importHint} ` + `Report the platform response if the ${subject} is ` + `well-formed.${bodySuffix}`);
+  const Context = {
+    httpStatus: err.status,
+    stage,
+    endpoint: err.endpoint,
+    method: err.method
+  };
+  if (err.parsedErrorCode !== undefined) {
+    Context.errorCode = err.parsedErrorCode;
+  }
+  const output = {
+    Result: RESULTS.Failure,
+    Message,
+    Instructions,
+    Context
+  };
+  if (err.status === 401 && options.identityType === "Application") {
+    output.ErrorCode = "permission_denied";
+  }
+  if (err.operation === "overwrite" && err.status >= 500 && err.status < 600) {
+    output.Retry = "RetryAfter30Seconds";
+  }
+  return output;
+}
 var DEFAULT_UPLOAD_TIMEOUT_MS = 120000;
 function resolveUploadTimeoutMs() {
   const raw = Number(process.env?.UIPATH_SOLUTION_UPLOAD_TIMEOUT_MS);
@@ -3263,8 +3360,10 @@ async function solutionExistsOnStudioWeb(config, organizationName, solutionId) {
       if (error.response.status === 404) {
         return false;
       }
+      const status = error.response.status;
       const text = await error.response.text().catch(() => "");
-      throw new HttpError(error.response.status, `Studio Web solution existence probe failed (${error.response.status}): ${text}`);
+      const body = isAuthRefusal(status) ? summarizeAuthRefusalBody(text) : text;
+      throw new HttpError(status, `Studio Web solution existence probe failed (${status}): ${body}`, parseAuthChallenge(error.response.headers?.get("www-authenticate") ?? undefined));
     }
     throw error;
   }
@@ -3293,6 +3392,7 @@ async function importSolution(config, organizationName, fileBuffer, fileName) {
       endpoint: requestPath(importUrl),
       url: importUrl,
       body: text,
+      authChallenge: response.headers?.get("www-authenticate") ?? undefined,
       message: `Import failed (${response.status}): ${text}`
     });
   }
@@ -3324,6 +3424,7 @@ async function overwriteSolution(config, organizationName, fileBuffer, fileName,
       endpoint: requestPath(overwriteUrl),
       url: overwriteUrl,
       body: text,
+      authChallenge: response.headers?.get("www-authenticate") ?? undefined,
       message: `Overwrite failed (${response.status}): ${text}`,
       solutionId
     });
@@ -3392,6 +3493,6 @@ async function searchPackageVersions(config, packageKey, filter, feedFolderKey)
   const raw = await response.json();
   return { count: raw.count, values: raw.values ?? [] };
 }
-export { Configuration, getAvailablePublishLocationsV2, DeploymentActivationStatus, DeploymentOperationStatus, SolutionDeploymentAction, DeploymentsApi, PackagesApi, SearchApi, StudioWebIncompatibleProjectError, bundleSolution, deploymentsAutoInstall, isDebugProvisioningTerminal, isDebugProvisioningSucceeded, getProjectDebugStatus, searchPackageVersions, getStudioWebSolutionProjects, listStudioWebSolutions, solutionExistsOnStudioWeb, importSolution, overwriteSolution };
+export { Configuration, getAvailablePublishLocationsV2, DeploymentActivationStatus, DeploymentOperationStatus, SolutionDeploymentAction, DeploymentsApi, PackagesApi, SearchApi, StudioWebIncompatibleProjectError, bundleSolution, deploymentsAutoInstall, isDebugProvisioningTerminal, isDebugProvisioningSucceeded, getProjectDebugStatus, searchPackageVersions, getStudioWebSolutionProjects, listStudioWebSolutions, isSolutionUploadHttpError, buildSolutionUploadFailureOutput, solutionExistsOnStudioWeb, importSolution, overwriteSolution };
 
-//# debugId=E7F2A66862D9247664756E2164756E21
+//# debugId=C2B9C3D9E8E0D45A64756E2164756E21

package/dist/{packager-tool-vxthsps3.js → packager-tool-6bhx9vfz.js}

@@ -1,7 +1,7 @@
 import {
   catchError,
   getAuthContext
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 
 // src/services/studio-web-auth-middleware.ts
 var studioWebAuthByCommand = new WeakMap;

package/dist/{packager-tool-xfg2cveb.js → packager-tool-8t3sjyk9.js}

@@ -1,7 +1,7 @@
 import {
   catchError,
   getFileSystem
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 
 // src/services/solution-init-service.ts
 var AGENTS_FILENAME = "AGENTS.md";

package/dist/{packager-tool-af5hm3yv.js → packager-tool-ah6zzb55.js}

@@ -3,14 +3,14 @@ import {
   PipelinesApi,
   feedScopeInitOverride,
   resolveFeedScope
-} from "./packager-tool-vmskhsbr.js";
+} from "./packager-tool-x907fvkz.js";
 import {
   Configuration as Configuration2,
   PackagesApi
-} from "./packager-tool-zwvkjsmc.js";
+} from "./packager-tool-40vamz9y.js";
 import {
   getSolutionAuthContext
-} from "./packager-tool-fjr8yn4g.js";
+} from "./packager-tool-29bj4s4t.js";
 import {
   PollOutcome,
   catchError,
@@ -19,7 +19,7 @@ import {
   logger,
   mapPollFailure,
   pollUntil
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import {
   strFromU8,
   strToU8,

package/dist/{packager-tool-htp0xd7c.js → packager-tool-kpybyt0p.js}

@@ -1,7 +1,7 @@
 import {
   getStudioWebAuthWithOrganizationId,
   useStudioWebAuth
-} from "./packager-tool-vxthsps3.js";
+} from "./packager-tool-6bhx9vfz.js";
 import {
   activateDeploymentAsync,
   deployRunAsync,
@@ -11,11 +11,11 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-k2tj5mv2.js";
+} from "./packager-tool-3n5e7fkr.js";
 import {
   SolutionInitError,
   solutionInitAsync
-} from "./packager-tool-xfg2cveb.js";
+} from "./packager-tool-8t3sjyk9.js";
 import {
   GOVERNANCE_OPTION_INSTRUCTIONS,
   PackCommandService,
@@ -30,10 +30,10 @@ import {
   readSolutionFileAsUint8Array,
   resolveSdkLogLevel,
   validateGovernanceOptions
-} from "./packager-tool-p4kjbrrp.js";
+} from "./packager-tool-2t1tzvbv.js";
 import {
   publishSolutionAsync
-} from "./packager-tool-af5hm3yv.js";
+} from "./packager-tool-ah6zzb55.js";
 import {
   Configuration,
   PipelinesApi,
@@ -41,7 +41,7 @@ import {
   feedScopeInitOverride,
   listSelectablePublishLocations,
   resolveFeedScope
-} from "./packager-tool-vmskhsbr.js";
+} from "./packager-tool-x907fvkz.js";
 import {
   Configuration as Configuration2,
   DeploymentActivationStatus,
@@ -49,15 +49,17 @@ import {
   PackagesApi,
   SearchApi,
   StudioWebIncompatibleProjectError,
+  buildSolutionUploadFailureOutput,
   bundleSolution,
   getProjectDebugStatus,
   importSolution,
   isDebugProvisioningSucceeded,
   isDebugProvisioningTerminal,
+  isSolutionUploadHttpError,
   overwriteSolution,
   searchPackageVersions,
   solutionExistsOnStudioWeb
-} from "./packager-tool-zwvkjsmc.js";
+} from "./packager-tool-40vamz9y.js";
 import {
   Tokens,
   applyEntryPointEnhancementAsync,
@@ -81,13 +83,13 @@ import {
   syncAndLog,
   syncResourcesFromBindings,
   writeSolutionFile
-} from "./packager-tool-72345dw7.js";
+} from "./packager-tool-pc4hb3pv.js";
 import {
   ToolResult
 } from "./packager-tool-nzghfa48.js";
 import {
   getSolutionAuthContext
-} from "./packager-tool-fjr8yn4g.js";
+} from "./packager-tool-29bj4s4t.js";
 import {
   DEFAULT_PAGE_SIZE,
   Option,
@@ -120,7 +122,7 @@ import {
   unsupportedSolutionProjectType,
   updateUipxSolutionId,
   withCompleter
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import {
   strFromU8,
   unzip,
@@ -133,7 +135,7 @@ import {
 var package_default = {
   name: "@uipath/solution-tool",
   license: "MIT",
-  version: "1.202.0-preview.138",
+  version: "1.202.0-preview.140",
   description: "Create, pack, publish, and deploy UiPath Automation Solutions.",
   repository: {
     type: "git",
@@ -5947,12 +5949,7 @@ var registerUploadCommand = (program) => {
       } else if (solutionId) {
         const [probeError, exists] = await catchError(solutionExistsOnStudioWeb(studioWebConfig, organizationName, solutionId));
         if (probeError) {
-          const errorMessage = await extractErrorMessage(probeError);
-          OutputFormatter.error({
-            Result: RESULTS.Failure,
-            Message: `Failed to check whether solution ${solutionId} exists on Studio Web: ${errorMessage}`,
-            Instructions: "Verify your login (uip login) and tenant access, then retry. If the problem persists, contact your UiPath administrator."
-          });
+          OutputFormatter.error(await buildProbeFailureOutput(probeError, solutionId, loginStatus.identity));
           processContext.exit(1);
           return;
         }
@@ -5973,6 +5970,16 @@ var registerUploadCommand = (program) => {
           processContext.exit(1);
           return;
         }
+        if (isSolutionUploadHttpError(uploadError)) {
+          OutputFormatter.error(buildSolutionUploadFailureOutput(uploadError, {
+            subject: "solution",
+            importCheckHint: "Run 'uip solution pack' to confirm the solution packs cleanly.",
+            identityType: loginStatus.identity?.type,
+            clientId: loginStatus.identity?.clientId
+          }));
+          processContext.exit(1);
+          return;
+        }
         const errorMessage = await extractErrorMessage(uploadError);
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -6033,8 +6040,56 @@ async function updateLocalSolutionId(fs, result, solutionId, uipxPath) {
   }
   return { returnedSolutionId, rewroteLocalSolutionId };
 }
+function httpStatusOf(error) {
+  if (error instanceof Error && "status" in error) {
+    const status = error.status;
+    if (typeof status === "number")
+      return status;
+  }
+  return;
+}
+function probeAuthChallengeOf(error) {
+  if (error instanceof Error && "authChallenge" in error) {
+    const challenge = error.authChallenge;
+    if (challenge && typeof challenge === "object") {
+      return challenge;
+    }
+  }
+  return {};
+}
 function isSolutionNotFoundError(error) {
-  return error instanceof Error && "status" in error && error.status === 404;
+  return httpStatusOf(error) === 404;
+}
+async function buildProbeFailureOutput(probeError, solutionId, identity) {
+  const status = httpStatusOf(probeError);
+  const isAuthRefusal = status === 401 || status === 403;
+  const challenge = probeAuthChallengeOf(probeError);
+  const message = isAuthRefusal ? probeError.message : await extractErrorMessage(probeError);
+  const output = {
+    Result: RESULTS.Failure,
+    Message: `Failed to check whether solution ${solutionId} exists on Studio Web: ${message}`,
+    Instructions: isAuthRefusal ? probeAuthInstructions(solutionId, identity, challenge) : "Verify your login (uip login) and tenant access, then retry. If the problem persists, contact your UiPath administrator."
+  };
+  if (status !== undefined) {
+    output.Context = {
+      httpStatus: status,
+      stage: "probe-solution",
+      method: "GET"
+    };
+  }
+  if (status === 401 && identity?.type === "Application" && challenge.error !== "invalid_token") {
+    output.ErrorCode = "permission_denied";
+  }
+  return output;
+}
+function probeAuthInstructions(solutionId, identity, challenge) {
+  const quoted = challenge.description ? ` ("${challenge.description}")` : "";
+  if (challenge.error === "invalid_token") {
+    return `Studio Web rejected the credential itself with the reason ` + `\`invalid_token\`${quoted} while checking whether solution ` + `${solutionId} exists. That is the platform refusing this token ` + `rather than the grants behind it, so unlike a grants refusal this ` + `one is worth a fresh 'uip login' — or, in a pipeline, a newly ` + `minted client-credentials token. Check too that the token was ` + `issued for the organization and tenant being called. Nothing was ` + `uploaded.`;
+  }
+  const actor = identity?.type === "Application" ? `This session acts as external application ${identity.clientId ?? "(client id unknown)"}: it needs a Studio Web grant that can read a solution.` : identity?.type === "User" ? "This session acts as a user: check that your account has Studio Web access in this tenant." : "Check that this session may read a solution in Studio Web — an external application needs a StudioWebS2S grant, a user needs Studio Web access in the tenant.";
+  const reported = challenge.error === "insufficient_scope" ? `Studio Web reported \`insufficient_scope\`${quoted}, so the token is good and its grants are not. ` : "";
+  return `Studio Web refused the read, and the session is authenticated, so ` + `re-running 'uip login' mints the same token and fails the same way. ` + `${reported}${actor} Also confirm solution ${solutionId} lives in the organization ` + `and tenant this session logged into. Nothing was uploaded.`;
 }
 function outputError(message) {
   OutputFormatter.error({
@@ -6067,7 +6122,7 @@ var registerCommands = async (program) => {
   registerResourceCommand(program);
   registerDeleteCommand(program);
   if (isPreviewBuild()) {
-    const { registerListCommand } = await import("./list-4dbar53b.js");
+    const { registerListCommand } = await import("./list-jqq1w9h5.js");
     registerListCommand(program);
   }
   registerFeedsCommand(program);
@@ -6075,4 +6130,4 @@ var registerCommands = async (program) => {
 
 export { metadata, registerCommands };
 
-//# debugId=1EE3E1E687A49ED364756E2164756E21
+//# debugId=D3FFC293E996FA3164756E2164756E21

package/dist/{packager-tool-72345dw7.js → packager-tool-pc4hb3pv.js}

@@ -2,7 +2,7 @@ import {
   UsersApi,
   createApiClient,
   getSolutionAuthContext
-} from "./packager-tool-fjr8yn4g.js";
+} from "./packager-tool-29bj4s4t.js";
 import {
   catchError,
   extractErrorMessage,
@@ -12,7 +12,7 @@ import {
   isGuid,
   logger,
   normalizeProjectType
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 import {
   __commonJS,
   __toESM
@@ -15558,6 +15558,59 @@ class FileSystemFileStorageProviderFactory {
   }
 }
 
+// ../solution-sdk/src/resources/providers/resource-builder-logger.ts
+var PLACEHOLDER = /\{(\w+)\}|%[sdifoOj]/g;
+function render(value) {
+  if (typeof value === "string")
+    return value;
+  if (value === null || value === undefined)
+    return String(value);
+  if (typeof value !== "object")
+    return String(value);
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function interpolate(message, args) {
+  const fields = args[0] !== null && typeof args[0] === "object" && !Array.isArray(args[0]) ? args[0] : undefined;
+  const consumed = new Set;
+  let positional = 0;
+  const filled = message.replace(PLACEHOLDER, (match, name) => {
+    if (name !== undefined) {
+      if (fields && name in fields) {
+        consumed.add(0);
+        return render(fields[name]);
+      }
+      return match;
+    }
+    const index = positional;
+    positional += 1;
+    if (index >= args.length)
+      return match;
+    consumed.add(index);
+    return render(args[index]);
+  });
+  const extra = args.filter((_, index) => !consumed.has(index)).map(render).filter((text) => text.length > 0);
+  return extra.length > 0 ? `${filled} ${extra.join(" ")}` : filled;
+}
+
+class CliResourceBuilderLoggerFactory {
+  create(target) {
+    const name = typeof target === "string" ? target : target.name;
+    const line = (message, args) => `[${name}] ${interpolate(message, args)}`;
+    return {
+      trace: (message, ...args) => logger.debug(line(message, args)),
+      debug: (message, ...args) => logger.debug(line(message, args)),
+      info: (message, ...args) => logger.info(line(message, args)),
+      warn: (message, ...args) => logger.warn(line(message, args)),
+      error: (message, error, ...args) => logger.error(error ? `${line(message, args)}: ${error.message}` : line(message, args)),
+      fatal: (message, ...args) => logger.error(line(message, args))
+    };
+  }
+}
+
 // ../solution-sdk/src/resources/providers/solution-access-provider.ts
 var ORG_SCOPED_SERVICES = new Set(["apps", "authz"]);
 
@@ -15626,7 +15679,7 @@ class SolutionAccessProvider {
 
 // ../solution-sdk/src/resources/providers/resource-builder-init.ts
 async function createResourceBuilderServices() {
-  return await createResourceBuilderConfiguration().addAccessProvider(new SolutionAccessProvider).addFileStorageProviderFactory(new FileSystemFileStorageProviderFactory).addArtifactResourceSpecEnhancer(new EntryPointSpecEnhancer).build();
+  return await createResourceBuilderConfiguration().addAccessProvider(new SolutionAccessProvider).addFileStorageProviderFactory(new FileSystemFileStorageProviderFactory).addArtifactResourceSpecEnhancer(new EntryPointSpecEnhancer).addLoggerFactory(new CliResourceBuilderLoggerFactory).build();
 }
 
 // ../solution-sdk/src/resources/commands/project-utils.ts
@@ -16544,4 +16597,4 @@ async function resourceRefreshAsync(solutionPath = ".", options = {}) {
 }
 export { Tokens, models_BindingsResourceType, getResourceName, getFolderPathProperty, getResourceKindForBinding, applyEntryPointEnhancementAsync, createResourceBuilderServices, findProjectFile, isProjectManifestError, isMissingProjectTypeError, readProjectFile, readSolutionFile, resolveSolutionFilePath, writeSolutionFile, restoreSolutionFile, createProjectInSolutionBuilder, normalizeFolderPath, findMatchingLocalResource, addProjectArtifactsToSolutionAsync, assertSolutionManifest, syncResourcesFromBindings, findResourceByKeyInRcs, searchRcsResources, findResourceInRcs, createResourceKindMetadataResolver, createLocalResource, readUipxProjects, syncAndLog, resourceRefreshAsync };
 
-//# debugId=C2523648CDA094EE64756E2164756E21
+//# debugId=1B68275F5B7B34D164756E2164756E21

package/dist/{packager-tool-vmskhsbr.js → packager-tool-x907fvkz.js}

@@ -1,15 +1,15 @@
 import {
   getAvailablePublishLocationsV2
-} from "./packager-tool-zwvkjsmc.js";
+} from "./packager-tool-40vamz9y.js";
 import {
   PersonalWorkspacesApi,
   createOrchestratorConfig
-} from "./packager-tool-fjr8yn4g.js";
+} from "./packager-tool-29bj4s4t.js";
 import {
   getLoginStatusAsync,
   getSdkUserAgentToken,
   installSdkUserAgentHeader
-} from "./packager-tool-sba5cptt.js";
+} from "./packager-tool-1x1cc4qh.js";
 
 // ../pipelines-sdk/generated/src/runtime.ts
 var BASE_PATH = "https://alpha.uipath.com/uipattycyrhx/abizon_1/automationsolutions_".replace(/\/+$/, "");

package/dist/packager-tool.js

@@ -1,6 +1,6 @@
 import {
   registerPackagerFactories
-} from "./packager-tool-9dx65z2d.js";
+} from "./packager-tool-3bewrpq4.js";
 import"./packager-tool-nzghfa48.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";

package/dist/publish.js

@@ -1,10 +1,10 @@
 import {
   publishSolutionAsync
-} from "./packager-tool-af5hm3yv.js";
-import"./packager-tool-vmskhsbr.js";
-import"./packager-tool-zwvkjsmc.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+} from "./packager-tool-ah6zzb55.js";
+import"./packager-tool-x907fvkz.js";
+import"./packager-tool-40vamz9y.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/resource.js

@@ -1,9 +1,9 @@
 import {
   resourceRefreshAsync
-} from "./packager-tool-72345dw7.js";
+} from "./packager-tool-pc4hb3pv.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/templates/AGENTS.md

@@ -212,6 +212,10 @@ By default dependencies resolve against every tenant feed the session can see.
 
 `pack` also takes `-n, --name <name>` to override the package name (it defaults to the solution folder or `.uis` file name) and `-v, --version <version>` (defaults to `1.0.0`).
 
+`--name` names the **solution archive only**. Each member project keeps its own NuGet id, anchored on the solution's `.uipx` name, so packing one solution twice under two names produces two archives holding members with the same ids — which is what lets an upgrade land on the same feed entries. Renaming the solution *directory* does not move member ids either; the `.uipx` travels with a checkout.
+
+`--author` and `--description` apply to every member that declares neither. A project that declares its own `Description` / `Author` in its project file keeps them, so per-project provenance survives a solution pack; only when nothing declares either do the `UiPath` / `Created by UiPath` defaults apply.
+
 `publish` goes to the tenant feed by default:
 
 ```bash
@@ -263,6 +267,8 @@ uip solution delete <solution-id> --yes    # remove a solution from Studio Web (
 
 `Data.Action` is `Imported` or `Overwritten`, so you can tell which ran. `--force` skips the existence check and overwrites directly; it is not normally needed, it fails rather than importing if that solution is gone, and it has no effect when no `SolutionId` is bundled (the upload imports as new). To upload a copy as an unrelated cloud solution instead of updating, scaffold a fresh solution with `uip solution init`, or replace the `SolutionId` in the local `.uipx` with a fresh GUID and re-run upload (removing the field entirely fails `.uipx` validation).
 
+If Studio Web refuses the upload with 401 or 403, read `Instructions` before you do anything — the answer is one of two, and they are opposites. In almost every case do **not** re-run `uip login`: the CLI checks the session and its token expiry before it calls, so the token was valid and re-authenticating produces the same one. The failure is then about what the acting identity may do in Studio Web (for a CI pipeline: the external application's `StudioWebS2S` grants) or about the tenant the bundled `SolutionId` belongs to, and an application 401 is reported as `ErrorCode: permission_denied` rather than `authentication_required`. The exception is when `Instructions` quote `invalid_token`: that is Studio Web rejecting the credential itself rather than the permissions behind it, so a fresh `uip login` — or a newly minted client-credentials token — is worth trying, and the error code stays `authentication_required`.
+
 `download` writes the `.uis` archive and nothing else — extraction is opt-in. Pass `--extract` to also unzip it into a sibling directory named after the archive; that directory is a working solution tree, with the `.uipx` manifest at its root. `--extract` also drops `AGENTS.md` and `CLAUDE.md` there so an agent picking the solution up has the same briefing `uip solution init` writes. It only fills gaps: a file the archive already carried is left alone, and the paths actually written come back in `Data.BriefingFiles`. Without `--extract` you get the zip only, and no briefing files — there is no solution directory to put them in.
 
 Two more verbs act on a **cloud** solution project rather than the local tree — do not confuse them with the local `projects add` / `import` / `remove` / `list` membership commands above:
@@ -447,6 +453,8 @@ Adjacent groups commonly used alongside solutions:
 | Symptom | First thing to check |
 |---|---|
 | `Not authenticated` / 401 | `uip login`, then re-run |
+| `upload` fails with 401/403 and `ErrorCode: permission_denied` | Not a login problem — the token was valid when the call went out, so `uip login` mints the same one. Read `Instructions`: for a session on an external application, check that the app has the Studio Web (`StudioWebS2S`) grants, not only the Orchestrator and Solutions ones; for a user, check Studio Web access in the tenant. Then confirm the `SolutionId` in the `.uipx` belongs to the tenant you are logged into — an id this session cannot see at all is reported separately, as nothing to overwrite, so a refusal here points at the grants first |
+| `upload` fails with 401 and `Instructions` quote `invalid_token` | The opposite case: Studio Web rejected the credential itself, not the grants behind it. Re-run `uip login`, or mint a fresh client-credentials token in a pipeline. Check too that the token was issued for the organization and tenant being called — one minted against another environment or audience is refused this way. The error code stays `authentication_required` |
 | Command targets the wrong tenant | `uip login tenant set <tenant>`; verify with `uip login status` |
 | Pack succeeds but publish 409s | Version conflict — bump the version (`uip solution pack . ./out -v <new-version>`) or delete the colliding version with `uip solution packages delete <package-name> <version> --yes` (only if intentional; `--yes` required) |
 | `deploy run` stops because the package is already deployed | Upgrade it in place with `uip solution deploy upgrade <deployment-key>` (running `deploy run` again does not upgrade it), or `uip solution deploy uninstall <name> --yes` first, or pass `--yes` to create a second, separate deployment |

package/dist/tool.js

@@ -1,19 +1,19 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-htp0xd7c.js";
-import"./packager-tool-vxthsps3.js";
-import"./packager-tool-k2tj5mv2.js";
-import"./packager-tool-xfg2cveb.js";
-import"./packager-tool-p4kjbrrp.js";
-import"./packager-tool-9dx65z2d.js";
-import"./packager-tool-af5hm3yv.js";
-import"./packager-tool-vmskhsbr.js";
-import"./packager-tool-zwvkjsmc.js";
-import"./packager-tool-72345dw7.js";
+} from "./packager-tool-kpybyt0p.js";
+import"./packager-tool-6bhx9vfz.js";
+import"./packager-tool-3n5e7fkr.js";
+import"./packager-tool-8t3sjyk9.js";
+import"./packager-tool-2t1tzvbv.js";
+import"./packager-tool-3bewrpq4.js";
+import"./packager-tool-ah6zzb55.js";
+import"./packager-tool-x907fvkz.js";
+import"./packager-tool-40vamz9y.js";
+import"./packager-tool-pc4hb3pv.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@uipath/solution-tool",
     "license": "MIT",
-    "version": "1.202.0-preview.138",
+    "version": "1.202.0-preview.140",
     "description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
     "repository": {
         "type": "git",
@@ -47,5 +47,5 @@
         "dist"
     ],
     "private": false,
-    "gitHead": "46372d5c4c4ae9352e9457a99e9d5efc1890cb48"
+    "gitHead": "1861498d8a158a710a718c04614523ba59c93781"
 }