@uipath/solution-tool 1.202.0-preview.137 → 1.202.0-preview.139

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-3hbsdwjm.js → packager-tool-9dx65z2d.js}

@@ -1,6 +1,6 @@
 import {
   toolsFactoryRepository
-} from "./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-nzghfa48.js";
 import {
   unzipSync,
   zipSync
@@ -1420,8 +1420,7 @@ class ToolsFactoryRepository {
   getProjectToolFactory(projectType) {
     const factory = this.projectFactoryMap.get(projectType);
     if (!factory) {
-      const known = [...this.projectFactoryMap.keys()].join(", ");
-      throw new Error(`Cannot pack project type '${projectType}': no packager is installed for it. ` + `Project types that can be packed: ${known || "none"}.`);
+      throw new Error(`Cannot pack project type '${projectType}': no packager is installed for it.`);
     }
     return factory;
   }
@@ -2270,4 +2269,4 @@ function registerPackagerFactories() {
 
 export { Path, TemporaryStorageService, ZipService, I18nManager, translate, BuildConfiguration, LogLevel, LogMessage, TargetFramework, ToolErrorCodes, ToolResult, toolsFactoryRepository2 as toolsFactoryRepository, registerPackagerFactories };
 
-//# debugId=FCA9CE604FDEAF2C64756E2164756E21
+//# debugId=1698A45CAE5F631764756E2164756E21

package/dist/{packager-tool-zz9cxrqw.js → packager-tool-9ez6mf86.js}

@@ -3,14 +3,14 @@ import {
   PipelinesApi,
   feedScopeInitOverride,
   resolveFeedScope
-} from "./packager-tool-m7vg7dwj.js";
+} from "./packager-tool-n3ch3v36.js";
 import {
   Configuration as Configuration2,
   PackagesApi
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-qpfkpph4.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-8cw7djz6.js → packager-tool-ar7ae24x.js}

@@ -7,7 +7,7 @@ import {
   listSelectablePublishLocations,
   resolveFeedScope,
   resolvePersonalWorkspace
-} from "./packager-tool-m7vg7dwj.js";
+} from "./packager-tool-n3ch3v36.js";
 import {
   Configuration as Configuration2,
   DeploymentOperationStatus,
@@ -16,11 +16,11 @@ import {
   SolutionDeploymentAction,
   deploymentsAutoInstall,
   searchPackageVersions
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-qpfkpph4.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-m7vg7dwj.js → packager-tool-n3ch3v36.js}

@@ -1,15 +1,15 @@
 import {
   getAvailablePublishLocationsV2
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-qpfkpph4.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-x3ehbhsn.js → packager-tool-nzghfa48.js}

@@ -29,8 +29,7 @@ class ToolsFactoryRepository {
   getProjectToolFactory(projectType) {
     const factory = this.projectFactoryMap.get(projectType);
     if (!factory) {
-      const known = [...this.projectFactoryMap.keys()].join(", ");
-      throw new Error(`Cannot pack project type '${projectType}': no packager is installed for it. ` + `Project types that can be packed: ${known || "none"}.`);
+      throw new Error(`Cannot pack project type '${projectType}': no packager is installed for it.`);
     }
     return factory;
   }
@@ -893,4 +892,4 @@ I18nManager.registerTranslations("zu", zu);
 I18nManager.setLocale("en");
 export { ToolResult, toolsFactoryRepository };
 
-//# debugId=EE7F0622AB4476C164756E2164756E21
+//# debugId=C6B394D3F76A061364756E2164756E21

package/dist/{packager-tool-n41f88jn.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
@@ -15670,6 +15723,26 @@ async function findProjectFile(projectDir) {
     null
   ];
 }
+
+class ProjectManifestError extends Error {
+  __projectManifestError = true;
+  reason;
+  constructor(message, reason) {
+    super(message);
+    this.name = "ProjectManifestError";
+    this.reason = reason;
+  }
+}
+function isProjectManifestError(error) {
+  return !!error && typeof error === "object" && error.__projectManifestError === true;
+}
+function isMissingProjectTypeError(error) {
+  return isProjectManifestError(error) && error.reason === "no-project-type";
+}
+function lastPathSegment(filePath) {
+  const parts = filePath.split(/[/\\]/);
+  return parts[parts.length - 1] ?? filePath;
+}
 async function readProjectFile(filePath, useProjectJson) {
   const fs = getFileSystem();
   const [readError, rawContent] = await catchError(fs.readFile(filePath, "utf-8"));
@@ -15679,7 +15752,7 @@ async function readProjectFile(filePath, useProjectJson) {
   const [parseError, content] = catchError(() => JSON.parse(rawContent));
   if (parseError) {
     return [
-      new Error(`Invalid JSON in project file: ${parseError.message}`),
+      new ProjectManifestError(`Invalid JSON in project file: ${parseError.message}`, "invalid-json"),
       null
     ];
   }
@@ -15694,7 +15767,16 @@ async function readProjectFile(filePath, useProjectJson) {
         }
       ];
     }
-    return [new Error(`ProjectType not found in ${filePath}`), null];
+    if (lastPathSegment(filePath) === "uipath.json") {
+      return [
+        new ProjectManifestError(`${filePath} has no 'ProjectType'. A uipath.json is only read as a code-first Functions project, which also needs a 'functions' entry. Other project types are registered from project.uiproj or project.json, not from uipath.json.`, "no-project-type"),
+        null
+      ];
+    }
+    return [
+      new ProjectManifestError(`ProjectType not found in ${filePath}`, "no-project-type"),
+      null
+    ];
   }
   return [null, { content, projectType: normalizeProjectType(projectType) }];
 }
@@ -16513,6 +16595,6 @@ async function resourceRefreshAsync(solutionPath = ".", options = {}) {
     warnings: result.warnings
   };
 }
-export { Tokens, models_BindingsResourceType, getResourceName, getFolderPathProperty, getResourceKindForBinding, applyEntryPointEnhancementAsync, createResourceBuilderServices, findProjectFile, readProjectFile, readSolutionFile, resolveSolutionFilePath, writeSolutionFile, restoreSolutionFile, createProjectInSolutionBuilder, normalizeFolderPath, findMatchingLocalResource, addProjectArtifactsToSolutionAsync, assertSolutionManifest, syncResourcesFromBindings, findResourceByKeyInRcs, searchRcsResources, findResourceInRcs, createResourceKindMetadataResolver, createLocalResource, readUipxProjects, syncAndLog, resourceRefreshAsync };
+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=BC3A09192B8885E064756E2164756E21
+//# debugId=1B68275F5B7B34D164756E2164756E21

package/dist/{packager-tool-56b5tnnr.js → packager-tool-qpfkpph4.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.137",
+  version: "1.202.0-preview.139",
   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=1DF7E23CF3FEEFE764756E2164756E21
+//# debugId=2E318348F3A8BF3E64756E2164756E21

package/dist/packager-tool.js

@@ -1,7 +1,7 @@
 import {
   registerPackagerFactories
-} from "./packager-tool-3hbsdwjm.js";
-import"./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-9dx65z2d.js";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/publish.js

@@ -1,10 +1,10 @@
 import {
   publishSolutionAsync
-} from "./packager-tool-zz9cxrqw.js";
-import"./packager-tool-m7vg7dwj.js";
-import"./packager-tool-56b5tnnr.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+} from "./packager-tool-9ez6mf86.js";
+import"./packager-tool-n3ch3v36.js";
+import"./packager-tool-qpfkpph4.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-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.js";
-import"./packager-tool-fjr8yn4g.js";
-import"./packager-tool-sba5cptt.js";
+} from "./packager-tool-pc4hb3pv.js";
+import"./packager-tool-nzghfa48.js";
+import"./packager-tool-29bj4s4t.js";
+import"./packager-tool-1x1cc4qh.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/services/governance-options.d.ts

@@ -18,7 +18,9 @@ export declare const GOVERNANCE_OPTION_INSTRUCTIONS: string;
  *
  * Returns the message rather than throwing because the two callers report
  * failures differently: the command builds an `OutputFormatter.error` envelope,
- * while `executeAsync` returns a `ToolResult` and never throws for an expected
- * failure. Owning the wording here keeps the two paths from drifting apart.
+ * while `executeAsync` returns a `ToolResult` for an expected failure — except
+ * `UnpackableProjectTypeError`, which it rethrows so the CLI can split
+ * `Message` from `Instructions`. Owning the wording here keeps the two paths
+ * from drifting apart.
  */
 export declare function validateGovernanceOptions(options: Pick<PackCommandOptions, "governanceFilePath" | "automationOpsProfile">): string | null;

package/dist/services/pack-command-service.d.ts

@@ -8,12 +8,27 @@ export declare class PackCommandService {
     private packager;
     private readonly fs;
     constructor();
+    /**
+     * Report an error thrown out of the pack pipeline, then leave the exit to
+     * the caller. Split out of `execute` so the classification and the
+     * stack-trace decision do not add to that method's cognitive complexity,
+     * which is already well over budget for reasons that predate this.
+     */
+    private reportPackThrow;
     /**
      * Execute the pack command with formatted CLI output and process exit handling.
      * When `options.dryRun` is true, the pipeline writes to a temporary directory
      * which is discarded on exit — useful as a pre-deploy validation gate.
      */
     execute(solutionPath: string, options: PackCommandOptions, context: CommandContext): Promise<void>;
+    /**
+     * The entry guards `executeAsync` runs before it touches a packager:
+     * a missing output path, bad governance options, and a solution path that
+     * is absent or unreadable. Split out so `executeAsync` stays inside the
+     * cognitive-complexity budget; each one still returns the `ToolResult`
+     * that caller expects rather than throwing.
+     */
+    private checkPackInputs;
     /**
      * Execute the pack command and return result (for programmatic usage and testing)
      */

package/dist/services/packager-tool-resolver.d.ts

@@ -1,4 +1,21 @@
 import type { IFileSystem } from "@uipath/filesystem";
+/**
+ * A `.uipx` names a project type nothing can pack, and no tool provides one.
+ *
+ * Thrown before the packager runs so the user gets the real problem — the
+ * manifest declares a type this CLI does not have — instead of the packager's
+ * "install the tool that packs it", which for a type that does not exist
+ * sends them looking for a tool that is not there. `instructions` follows the
+ * repo-wide convention `carriedInstructions` reads, and `__unpackableType`
+ * lets callers duck-type across bundle boundaries where `instanceof` fails.
+ */
+export declare class UnpackableProjectTypeError extends Error {
+    readonly __unpackableType = true;
+    readonly instructions: string;
+    constructor(projectType: string, projectPath: string);
+}
+/** True when `error` is an {@link UnpackableProjectTypeError}, duck-typed. */
+export declare function isUnpackableProjectTypeError(error: unknown): boolean;
 /**
  * Puts every factory this pack needs in `toolsFactoryRepository`: registers
  * the ones solution-tool owns, then reads project types from the .uipx and

package/dist/templates/AGENTS.md

@@ -77,7 +77,9 @@ Install the skills with `uip skills install`. The general-purpose `uipath-platfo
 
 **`Library` is not a project type here.** A library is a reusable `.nupkg` consumed as a NuGet dependency, so `projects add` / `import` reject it and auto-registration returns `SolutionRegistration.Status: "Skipped"`. Publish it on its own (`uip rpa pack <project-dir> <output-path>`, then `uip or libraries upload --file <nupkg-path>`) and either reference it from a project's dependencies or attach it to this solution as a resource: `uip solution resources add --source remote --kind Library --name <library-name>`.
 
-The type lives in either `project.uiproj` (top-level `ProjectType`) or `project.json` (`designOptions.outputType`, falling back to top-level `ProjectType` when `outputType` is absent — read or write either field). The `init` scaffolders above auto-register when run inside a solution directory (unless `--skip-solution-registration` is passed). For other scaffolders, register the project with the solution after scaffolding: use `uip solution projects add <project-path> [<solution-file>]` when the project already lives inside the solution directory (registers in place, no copy), or `uip solution projects import <path>` to copy a project from outside the solution dir into it and register it. If you pass an unknown type to those commands, they reject with the exhaustive accepted list — trust that error over this table.
+The type lives in either `project.uiproj` (top-level `ProjectType`) or `project.json` (`designOptions.outputType`, falling back to top-level `ProjectType` when `outputType` is absent — read or write either field). A third form exists but is narrow: `uipath.json` is read as a project manifest **only** for a code-first Functions project, which is recognised by a `functions` map inside it. Other project kinds keep a `uipath.json` for their own config — a coded app stores its SDK settings there — and that file is not what registers them: a coded app is registered from the `project.uiproj` that `uip codedapp init <path>` writes. Pointing a solution at a coded app's `uipath.json` (or at its `package.json`) fails, because neither carries a `ProjectType`.
+
+The `init` scaffolders above auto-register when run inside a solution directory (unless `--skip-solution-registration` is passed). For other scaffolders, register the project with the solution after scaffolding: use `uip solution projects add <project-path> [<solution-file>]` when the project already lives inside the solution directory (registers in place, no copy), or `uip solution projects import <path>` to copy a project from outside the solution dir into it and register it. If you pass an unknown type to those commands, they reject with the exhaustive accepted list — trust that error over this table. `uip solution pack` rejects the same way: a `Projects[]` entry whose `Type` no packager handles fails with `ErrorCode: invalid_argument`, naming the project, the accepted types, and how to drop the entry, rather than attempting the pack.
 
 ## End-to-End Lifecycle
 
@@ -261,6 +263,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:
@@ -445,6 +449,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 |