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

package/dist/deploy.js

@@ -5,9 +5,9 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-8cw7djz6.js";
-import"./packager-tool-m7vg7dwj.js";
-import"./packager-tool-56b5tnnr.js";
+} 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";
 import"./packager-tool-dfrk01gn.js";

package/dist/index.js

@@ -2,17 +2,17 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-kjjkk63a.js";
+} from "./packager-tool-htp0xd7c.js";
 import"./packager-tool-vxthsps3.js";
-import"./packager-tool-8cw7djz6.js";
+import"./packager-tool-k2tj5mv2.js";
 import"./packager-tool-xfg2cveb.js";
-import"./packager-tool-6d4e44g7.js";
-import"./packager-tool-3hbsdwjm.js";
-import"./packager-tool-zz9cxrqw.js";
-import"./packager-tool-m7vg7dwj.js";
-import"./packager-tool-56b5tnnr.js";
-import"./packager-tool-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.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";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-fjr8yn4g.js";
 import {
   Command

package/dist/init.js

@@ -4,8 +4,8 @@ import {
 } from "./packager-tool-xfg2cveb.js";
 import {
   addProjectArtifactsToSolutionAsync
-} from "./packager-tool-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-72345dw7.js";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-fjr8yn4g.js";
 import"./packager-tool-sba5cptt.js";
 import"./packager-tool-dfrk01gn.js";

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

@@ -5,7 +5,7 @@ import {
 import {
   getStudioWebSolutionProjects,
   listStudioWebSolutions
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-zwvkjsmc.js";
 import {
   DEFAULT_PAGE_SIZE,
   OutputFormatter,

package/dist/pack.js

@@ -1,9 +1,9 @@
 import {
   packSolutionAsync
-} from "./packager-tool-6d4e44g7.js";
-import"./packager-tool-3hbsdwjm.js";
-import"./packager-tool-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-p4kjbrrp.js";
+import"./packager-tool-9dx65z2d.js";
+import"./packager-tool-72345dw7.js";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-fjr8yn4g.js";
 import"./packager-tool-sba5cptt.js";
 import"./packager-tool-dfrk01gn.js";

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

@@ -15670,6 +15670,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 +15699,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 +15714,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 +16542,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=C2523648CDA094EE64756E2164756E21

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-af5hm3yv.js}

@@ -3,11 +3,11 @@ import {
   PipelinesApi,
   feedScopeInitOverride,
   resolveFeedScope
-} from "./packager-tool-m7vg7dwj.js";
+} from "./packager-tool-vmskhsbr.js";
 import {
   Configuration as Configuration2,
   PackagesApi
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-zwvkjsmc.js";
 import {
   getSolutionAuthContext
 } from "./packager-tool-fjr8yn4g.js";

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

@@ -11,7 +11,7 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-8cw7djz6.js";
+} from "./packager-tool-k2tj5mv2.js";
 import {
   SolutionInitError,
   solutionInitAsync
@@ -25,14 +25,15 @@ import {
   checkSolutionPathAsync,
   createSolutionPackager,
   ensurePackagerTools,
+  isUnpackableProjectTypeError,
   packSolutionAsync,
   readSolutionFileAsUint8Array,
   resolveSdkLogLevel,
   validateGovernanceOptions
-} from "./packager-tool-6d4e44g7.js";
+} from "./packager-tool-p4kjbrrp.js";
 import {
   publishSolutionAsync
-} from "./packager-tool-zz9cxrqw.js";
+} from "./packager-tool-af5hm3yv.js";
 import {
   Configuration,
   PipelinesApi,
@@ -40,7 +41,7 @@ import {
   feedScopeInitOverride,
   listSelectablePublishLocations,
   resolveFeedScope
-} from "./packager-tool-m7vg7dwj.js";
+} from "./packager-tool-vmskhsbr.js";
 import {
   Configuration as Configuration2,
   DeploymentActivationStatus,
@@ -56,7 +57,7 @@ import {
   overwriteSolution,
   searchPackageVersions,
   solutionExistsOnStudioWeb
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-zwvkjsmc.js";
 import {
   Tokens,
   applyEntryPointEnhancementAsync,
@@ -68,6 +69,8 @@ import {
   findMatchingLocalResource,
   findProjectFile,
   findResourceByKeyInRcs,
+  isMissingProjectTypeError,
+  isProjectManifestError,
   normalizeFolderPath,
   readProjectFile,
   readSolutionFile,
@@ -78,10 +81,10 @@ import {
   syncAndLog,
   syncResourcesFromBindings,
   writeSolutionFile
-} from "./packager-tool-n41f88jn.js";
+} from "./packager-tool-72345dw7.js";
 import {
   ToolResult
-} from "./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-nzghfa48.js";
 import {
   getSolutionAuthContext
 } from "./packager-tool-fjr8yn4g.js";
@@ -130,7 +133,7 @@ import {
 var package_default = {
   name: "@uipath/solution-tool",
   license: "MIT",
-  version: "1.202.0-preview.137",
+  version: "1.202.0-preview.138",
   description: "Create, pack, publish, and deploy UiPath Automation Solutions.",
   repository: {
     type: "git",
@@ -2479,6 +2482,12 @@ function rejectUnsupportedProjectType(projectType, failureMessage) {
   processContext.exit(1);
   return true;
 }
+function projectManifestInstructions(fileName, readProjectError, verb) {
+  if (fileName !== "uipath.json" || !isMissingProjectTypeError(readProjectError)) {
+    return readProjectError.message;
+  }
+  return `${readProjectError.message} If this is a coded app, scaffold it with 'uip codedapp init <project-path>' — that writes the project.uiproj this command registers — then run 'uip solution projects ${verb} <project-path>' again.`;
+}
 
 // src/commands/project-add.ts
 var PROJECT_ADD_EXAMPLES = [
@@ -2563,7 +2572,8 @@ var registerProjectAddCommand = (project) => {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: "Failed to add project to solution",
-        Instructions: readProjectError.message
+        ...isProjectManifestError(readProjectError) ? { ErrorCode: "invalid_argument" } : {},
+        Instructions: projectManifestInstructions(projectFileInfo.fileName, readProjectError, "add")
       });
       processContext.exit(1);
       return;
@@ -2709,7 +2719,8 @@ var registerProjectImportCommand = (project) => {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: "Failed to import project into solution",
-        Instructions: readProjectError.message
+        ...isProjectManifestError(readProjectError) ? { ErrorCode: "invalid_argument" } : {},
+        Instructions: projectManifestInstructions(projectFileInfo.fileName, readProjectError, "import")
       });
       processContext.exit(1);
       return;
@@ -5053,10 +5064,11 @@ Restoring solution dependencies...
       const msg = error instanceof Error ? error.message : String(error);
       OutputFormatter.error({
         Result: RESULTS.Failure,
+        ...isUnpackableProjectTypeError(error) ? { ErrorCode: "invalid_argument" } : {},
         Message: msg,
         Instructions: carriedInstructions(error) ?? "Check that you are logged in (`uip auth login`) and that the solution path is accessible, then rerun: uip solution restore <solutionPath>"
       });
-      if (error instanceof Error && error.stack) {
+      if (error instanceof Error && error.stack && !isUnpackableProjectTypeError(error)) {
         logger.error("Stack trace:");
         logger.error(error.stack);
       }
@@ -6055,7 +6067,7 @@ var registerCommands = async (program) => {
   registerResourceCommand(program);
   registerDeleteCommand(program);
   if (isPreviewBuild()) {
-    const { registerListCommand } = await import("./list-484rd8hx.js");
+    const { registerListCommand } = await import("./list-4dbar53b.js");
     registerListCommand(program);
   }
   registerFeedsCommand(program);
@@ -6063,4 +6075,4 @@ var registerCommands = async (program) => {
 
 export { metadata, registerCommands };
 
-//# debugId=53AC8396C5EA789164756E2164756E21
+//# debugId=1EE3E1E687A49ED364756E2164756E21

package/dist/{packager-tool-8cw7djz6.js → packager-tool-k2tj5mv2.js}

@@ -7,7 +7,7 @@ import {
   listSelectablePublishLocations,
   resolveFeedScope,
   resolvePersonalWorkspace
-} from "./packager-tool-m7vg7dwj.js";
+} from "./packager-tool-vmskhsbr.js";
 import {
   Configuration as Configuration2,
   DeploymentOperationStatus,
@@ -16,7 +16,7 @@ import {
   SolutionDeploymentAction,
   deploymentsAutoInstall,
   searchPackageVersions
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-zwvkjsmc.js";
 import {
   getSolutionAuthContext,
   resolveFolder

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-6d4e44g7.js → packager-tool-p4kjbrrp.js}

@@ -12,7 +12,7 @@ import {
   registerPackagerFactories,
   toolsFactoryRepository,
   translate
-} from "./packager-tool-3hbsdwjm.js";
+} from "./packager-tool-9dx65z2d.js";
 import {
   Tokens,
   createResourceBuilderServices,
@@ -23,11 +23,11 @@ import {
   models_BindingsResourceType,
   readUipxProjects,
   syncAndLog
-} from "./packager-tool-n41f88jn.js";
+} from "./packager-tool-72345dw7.js";
 import {
   ToolResult as ToolResult2,
   toolsFactoryRepository as toolsFactoryRepository2
-} from "./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-nzghfa48.js";
 import {
   OutputFormatter,
   RESULTS,
@@ -24191,7 +24191,7 @@ var sdkUserAgentHostToken2 = singleton2("SdkUserAgentHostToken");
 var package_default = {
   name: "@uipath/project-packager",
   license: "MIT",
-  version: "1.202.0-preview.137",
+  version: "1.202.0-preview.138",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -37334,7 +37334,7 @@ var sdkUserAgentHostToken22 = singleton22("SdkUserAgentHostToken");
 var package_default2 = {
   name: "@uipath/project-packager",
   license: "MIT",
-  version: "1.202.0-preview.137",
+  version: "1.202.0-preview.138",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -38883,6 +38883,25 @@ var PROJECT_TYPE_TO_TOOL = new Map([
   ["BusinessRules", "maestro"],
   ["Entity", "df"]
 ]);
+var PACKAGER_OWNED_TYPES = ["Connector"];
+
+class UnpackableProjectTypeError extends Error {
+  __unpackableType = true;
+  instructions;
+  constructor(projectType, projectPath) {
+    super(`Project '${projectPath}' declares type '${projectType}', which this CLI cannot pack.`);
+    this.name = "UnpackableProjectTypeError";
+    this.instructions = buildUnpackableInstructions(projectType);
+  }
+}
+function isUnpackableProjectTypeError(error) {
+  return !!error && typeof error === "object" && error.__unpackableType === true;
+}
+function buildUnpackableInstructions(projectType) {
+  const allowed = `Types a solution can contain: ${packableProjectTypes().join(", ")}.`;
+  const codedAppHint = projectType.toLowerCase() === "app" ? " A coded app packs as 'AppV2': scaffold it with 'uip codedapp init <project-path>', which writes project.uiproj and webAppManifest.json and puts the app files under <project-path>/source." : "";
+  return `${allowed}${codedAppHint} Correct the project's Type in the .uipx, or drop the entry with 'uip solution projects remove <project-path>'.`;
+}
 var TOOL_TO_PACKAGE = new Map([
   ["rpa", "@uipath/rpa-tool"],
   ["codedapp", "@uipath/codedapp-tool"],
@@ -38892,7 +38911,7 @@ var TOOL_TO_PACKAGE = new Map([
   ["function", "@uipath/function-tool"],
   ["df", "@uipath/data-fabric-tool"]
 ]);
-async function readProjectTypes(solutionDir, fs8) {
+async function readSolutionProjects(solutionDir, fs8) {
   const entries = await fs8.readdir(solutionDir);
   const uipxFile = entries.find((f) => f.endsWith(".uipx"));
   if (!uipxFile)
@@ -38905,27 +38924,42 @@ async function readProjectTypes(solutionDir, fs8) {
   if (parseError) {
     throw new Error(`Failed to parse ${uipxFile}: ${parseError.message}`);
   }
-  return (solution.Projects || []).map((p) => p.Type);
+  return (solution.Projects || []).map((p) => ({
+    type: typeof p.Type === "string" ? p.Type : "",
+    path: typeof p.ProjectRelativePath === "string" ? p.ProjectRelativePath : "(no ProjectRelativePath)"
+  }));
+}
+function packableProjectTypes() {
+  const types3 = new Set(PROJECT_TYPE_TO_TOOL.keys());
+  for (const type2 of PACKAGER_OWNED_TYPES) {
+    types3.add(type2);
+  }
+  types3.delete("processOrchestration");
+  return [...types3].sort((a, b) => a.localeCompare(b));
 }
 async function ensurePackagerTools(solutionDir, fs8) {
   registerPackagerFactories();
-  const projectTypes = await readProjectTypes(solutionDir, fs8);
-  if (projectTypes.length === 0)
+  const projects = await readSolutionProjects(solutionDir, fs8);
+  if (projects.length === 0)
     return;
   const neededTools = new Set;
-  for (const type2 of projectTypes) {
+  for (const { type: type2, path: path4 } of projects) {
     const unsupported = unsupportedSolutionProjectType(type2);
     if (unsupported) {
       throw new Error(`Project type '${type2}' cannot be packed as part of a solution. ${unsupported} Or drop it with 'uip solution projects remove <project-path>'.`);
     }
+    if (!type2) {
+      logger.warn(`Solution project '${path4}' has no Type. Pack may fail.`);
+      continue;
+    }
     if (toolsFactoryRepository2.canHandleProject(type2))
       continue;
     const toolVerb = PROJECT_TYPE_TO_TOOL.get(type2);
     if (toolVerb) {
       neededTools.add(toolVerb);
-    } else {
-      logger.warn(`No installable tool packs project type '${type2}'. Pack may fail.`);
+      continue;
     }
+    throw new UnpackableProjectTypeError(type2, path4);
   }
   for (const toolVerb of neededTools) {
     logger.info(`Loading packager factory for '${toolVerb}' to handle project types...`);
@@ -39083,6 +39117,22 @@ class PackCommandService {
   constructor() {
     this.fs = getFileSystem();
   }
+  reportPackThrow(error, dryRun) {
+    const msg = error instanceof Error ? error.message : String(error);
+    const unpackableType = isUnpackableProjectTypeError(error);
+    const dryRunHint = "Inspect the reported error, fix the underlying issue in the solution, then rerun: uip solution pack <solution-path> --dry-run";
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      ...unpackableType ? { ErrorCode: "invalid_argument" } : {},
+      Message: msg,
+      Instructions: carriedInstructions(error) ?? (dryRun ? dryRunHint : msg)
+    });
+    if (unpackableType || !(error instanceof Error) || !error.stack) {
+      return;
+    }
+    logger.error("Stack trace:");
+    logger.error(error.stack);
+  }
   async execute(solutionPath, options, context) {
     const check = await checkSolutionPathAsync(this.fs, solutionPath);
     if (!check.ok) {
@@ -39162,16 +39212,7 @@ Packing solution...
         output: resolvedOutput
       }));
       if (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: msg,
-          Instructions: options.dryRun ? "Inspect the reported error, fix the underlying issue in the solution, then rerun: uip solution pack <solution-path> --dry-run" : msg
-        });
-        if (error instanceof Error && error.stack) {
-          logger.error("Stack trace:");
-          logger.error(error.stack);
-        }
+        this.reportPackThrow(error, options.dryRun === true);
         context.exit(1);
         return;
       }
@@ -39214,19 +39255,35 @@ Packing solution...
       }
     }
   }
-  async executeAsync(solutionPath, options) {
+  async checkPackInputs(solutionPath, options) {
     if (options.output === undefined) {
-      return new ToolResult2("INTERNAL_ERROR" /* InternalError */, "Output path is required when invoking executeAsync directly.", []);
+      return {
+        failure: new ToolResult2("INTERNAL_ERROR" /* InternalError */, "Output path is required when invoking executeAsync directly.", [])
+      };
     }
     const governanceError = validateGovernanceOptions(options);
     if (governanceError) {
-      return new ToolResult2("INTERNAL_ERROR" /* InternalError */, governanceError, []);
+      return {
+        failure: new ToolResult2("INTERNAL_ERROR" /* InternalError */, governanceError, [])
+      };
     }
-    const absoluteOutputPath = this.fs.path.resolve(options.output);
     const check = await checkSolutionPathAsync(this.fs, solutionPath);
     if (!check.ok) {
-      return new ToolResult2("INTERNAL_ERROR" /* InternalError */, check.message, []);
+      return {
+        failure: new ToolResult2("INTERNAL_ERROR" /* InternalError */, check.message, [])
+      };
     }
+    return {
+      absoluteOutputPath: this.fs.path.resolve(options.output),
+      check
+    };
+  }
+  async executeAsync(solutionPath, options) {
+    const inputs = await this.checkPackInputs(solutionPath, options);
+    if (inputs.failure) {
+      return inputs.failure;
+    }
+    const { absoluteOutputPath, check } = inputs;
     const { absoluteSolutionPath, isUisFile, stats } = check;
     const isDirectory = stats.isDirectory();
     const packageName = options.name || (isUisFile ? this.fs.path.basename(solutionPath, ".uis") : this.fs.path.basename(solutionPath));
@@ -39261,6 +39318,9 @@ Packing solution...
         return packager.packSolutionAsync(packOptions);
       });
       if (error) {
+        if (isUnpackableProjectTypeError(error)) {
+          throw error;
+        }
         const message = error instanceof Error ? error.message : String(error);
         const instructions = carriedInstructions(error);
         return new ToolResult2("INTERNAL_ERROR" /* InternalError */, instructions ? `${message} ${instructions}` : message, []);
@@ -39406,7 +39466,20 @@ function formatPackFailureInstructions(message, dryRun) {
 // src/services/pack-service.ts
 async function packSolutionAsync(solutionPath, options) {
   const service = new PackCommandService;
-  const result = await service.executeAsync(solutionPath, options);
+  const [error, result] = await catchError(service.executeAsync(solutionPath, options));
+  if (error) {
+    if (!isUnpackableProjectTypeError(error)) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const instructions = carriedInstructions(error);
+    return {
+      ok: false,
+      errorCode: "INTERNAL_ERROR" /* InternalError */,
+      message: instructions ? `${message} ${instructions}` : message,
+      packages: []
+    };
+  }
   return {
     ok: result.errorCode === "SUCCESS" /* Success */,
     errorCode: result.errorCode,
@@ -39415,6 +39488,6 @@ async function packSolutionAsync(solutionPath, options) {
   };
 }
 
-export { SolutionPackOptions, ensurePackagerTools, createSolutionPackager, readSolutionFileAsUint8Array, resolveSdkLogLevel, applyAuthConnection, SOLUTION_PATH_INSTRUCTIONS, checkSolutionPathAsync, GOVERNANCE_OPTION_INSTRUCTIONS, validateGovernanceOptions, PackCommandService, packSolutionAsync };
+export { SolutionPackOptions, isUnpackableProjectTypeError, ensurePackagerTools, createSolutionPackager, readSolutionFileAsUint8Array, resolveSdkLogLevel, applyAuthConnection, SOLUTION_PATH_INSTRUCTIONS, checkSolutionPathAsync, GOVERNANCE_OPTION_INSTRUCTIONS, validateGovernanceOptions, PackCommandService, packSolutionAsync };
 
-//# debugId=57C636C235AB2E9564756E2164756E21
+//# debugId=2C5DDB7BE97361C764756E2164756E21

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

@@ -1,6 +1,6 @@
 import {
   getAvailablePublishLocationsV2
-} from "./packager-tool-56b5tnnr.js";
+} from "./packager-tool-zwvkjsmc.js";
 import {
   PersonalWorkspacesApi,
   createOrchestratorConfig

package/dist/{packager-tool-56b5tnnr.js → packager-tool-zwvkjsmc.js}

@@ -3103,7 +3103,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.138",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -3394,4 +3394,4 @@ async function searchPackageVersions(config, packageKey, filter, feedFolderKey)
 }
 export { Configuration, getAvailablePublishLocationsV2, DeploymentActivationStatus, DeploymentOperationStatus, SolutionDeploymentAction, DeploymentsApi, PackagesApi, SearchApi, StudioWebIncompatibleProjectError, bundleSolution, deploymentsAutoInstall, isDebugProvisioningTerminal, isDebugProvisioningSucceeded, getProjectDebugStatus, searchPackageVersions, getStudioWebSolutionProjects, listStudioWebSolutions, solutionExistsOnStudioWeb, importSolution, overwriteSolution };
 
-//# debugId=1DF7E23CF3FEEFE764756E2164756E21
+//# debugId=E7F2A66862D9247664756E2164756E21

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,8 +1,8 @@
 import {
   publishSolutionAsync
-} from "./packager-tool-zz9cxrqw.js";
-import"./packager-tool-m7vg7dwj.js";
-import"./packager-tool-56b5tnnr.js";
+} 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";
 import"./packager-tool-dfrk01gn.js";

package/dist/resource.js

@@ -1,7 +1,7 @@
 import {
   resourceRefreshAsync
-} from "./packager-tool-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.js";
+} from "./packager-tool-72345dw7.js";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-fjr8yn4g.js";
 import"./packager-tool-sba5cptt.js";
 import"./packager-tool-dfrk01gn.js";

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
 

package/dist/tool.js

@@ -1,17 +1,17 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-kjjkk63a.js";
+} from "./packager-tool-htp0xd7c.js";
 import"./packager-tool-vxthsps3.js";
-import"./packager-tool-8cw7djz6.js";
+import"./packager-tool-k2tj5mv2.js";
 import"./packager-tool-xfg2cveb.js";
-import"./packager-tool-6d4e44g7.js";
-import"./packager-tool-3hbsdwjm.js";
-import"./packager-tool-zz9cxrqw.js";
-import"./packager-tool-m7vg7dwj.js";
-import"./packager-tool-56b5tnnr.js";
-import"./packager-tool-n41f88jn.js";
-import"./packager-tool-x3ehbhsn.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";
+import"./packager-tool-nzghfa48.js";
 import"./packager-tool-fjr8yn4g.js";
 import"./packager-tool-sba5cptt.js";
 import"./packager-tool-dfrk01gn.js";

package/package.json

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