@uipath/packager-tool-workflowcompiler 0.0.15 → 1.195.0

package/dist/i18n/locales/en.d.ts

@@ -16,6 +16,7 @@ export declare const en: {
             readonly processError: "[WorkflowCompiler] Process error: {message}";
             readonly startFailed: "Failed to start workflow compiler: {message}";
             readonly operationCancelled: "Operation cancelled";
+            readonly dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command.";
         };
         readonly pathResolver: {
             readonly info: {

package/dist/index.js

@@ -14,7 +14,8 @@ var de_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -56,7 +57,8 @@ var en = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -97,7 +99,8 @@ var es_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -138,7 +141,8 @@ var es_MX_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -179,7 +183,8 @@ var fr_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -220,7 +225,8 @@ var ja_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -261,7 +267,8 @@ var ko_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -302,7 +309,8 @@ var pt_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -343,7 +351,8 @@ var pt_BR_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -384,7 +393,8 @@ var ro_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -425,7 +435,8 @@ var ru_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -466,7 +477,8 @@ var tr_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -507,7 +519,8 @@ var zh_CN_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -548,7 +561,8 @@ var zh_TW_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -589,7 +603,8 @@ var zu_default = {
       failed: "[WorkflowCompiler] {operation} failed: {errorMessage}",
       processError: "[WorkflowCompiler] Process error: {message}",
       startFailed: "Failed to start workflow compiler: {message}",
-      operationCancelled: "Operation cancelled"
+      operationCancelled: "Operation cancelled",
+      dotnetNotAvailable: "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
     },
     pathResolver: {
       info: {
@@ -638,8 +653,10 @@ I18nManager.registerTranslations("zu", zu_default);
 import { toolsFactoryRepository } from "@uipath/solutionpackager-tool-core";
 
 // src/workflow-compiler-tool-factory.ts
+import { execSync } from "node:child_process";
 import {
-  ProjectTypes
+  ProjectTypes,
+  translate as translate3
 } from "@uipath/solutionpackager-tool-core";
 
 // src/workflow-compiler-tool.ts
@@ -666,7 +683,7 @@ import {
 } from "@uipath/solutionpackager-tool-core";
 
 // src/workflow-compiler-config.ts
-var DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.0-alpha.22366";
+var DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.195-alpha.23402";
 var workflowCompilerConfig = {
   workflowCompilerPath: undefined,
   workflowCompilerVersion: DEFAULT_WORKFLOW_COMPILER_VERSION
@@ -682,19 +699,11 @@ function setupWorkflowCompiler(options) {
 
 // src/workflow-compiler-path-resolver.ts
 var NUGET_FEED_URL = "https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Internal/nuget/v3/index.json";
-var PLATFORM_PACKAGES = {
-  win32: {
-    packageId: "UiPath.WorkflowCompiler.Windows",
-    compilerFileName: "UiPath.WorkflowCompiler.exe"
-  },
-  darwin: {
-    packageId: "UiPath.WorkflowCompiler.macOS",
-    compilerFileName: "UiPath.WorkflowCompiler.dll"
-  },
-  linux: {
-    packageId: "UiPath.WorkflowCompiler.Linux",
-    compilerFileName: "UiPath.WorkflowCompiler.dll"
-  }
+var WORKFLOW_COMPILER_DLL_NAME = "UiPath.WorkflowCompiler.dll";
+var PLATFORM_PACKAGE_IDS = {
+  win32: "UiPath.WorkflowCompiler.Windows",
+  darwin: "UiPath.WorkflowCompiler.macOS",
+  linux: "UiPath.WorkflowCompiler.Linux"
 };
 var RESTORE_CSPROJ_TEMPLATE = `<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
@@ -766,14 +775,14 @@ class WorkflowCompilerPathResolver {
     if (!location)
       return null;
     this.logger.info(translate.t("toolWorkflowcompiler.pathResolver.info.checkingEnvVar", { path: location }));
-    if ((location.endsWith(".dll") || location.endsWith(".exe")) && await this.fileSystem.exists(location)) {
+    if (location.endsWith(".dll") && await this.fileSystem.exists(location)) {
       this.logger.info(translate.t("toolWorkflowcompiler.pathResolver.info.foundViaEnv"));
       return location;
     }
     return null;
   }
   async restoreAndResolve(compilerPath, version) {
-    const { packageId } = this.getPlatformInfo();
+    const packageId = this.getPackageId();
     const tempDir = await this.tempStorage.getTempFolderPath();
     try {
       this.logger.info(translate.t("toolWorkflowcompiler.pathResolver.info.restoringPackage", { packageName: packageId, version, platform: platform() }));
@@ -810,17 +819,16 @@ class WorkflowCompilerPathResolver {
       await this.tempStorage.cleanup();
     }
   }
-  getPlatformInfo() {
-    const info = PLATFORM_PACKAGES[platform()];
-    if (!info) {
+  getPackageId() {
+    const packageId = PLATFORM_PACKAGE_IDS[platform()];
+    if (!packageId) {
       throw new Error(translate.t("toolWorkflowcompiler.pathResolver.errors.unsupportedPlatform", { platform: platform() }));
     }
-    return info;
+    return packageId;
   }
   getNuGetCompilerPath(version) {
     const cacheRoot = process.env.NUGET_PACKAGES ?? Path.join(homedir(), ".nuget", "packages");
-    const { packageId, compilerFileName } = this.getPlatformInfo();
-    return Path.join(cacheRoot, packageId.toLowerCase(), version.toLowerCase(), "WorkflowCompiler", compilerFileName);
+    return Path.join(cacheRoot, this.getPackageId().toLowerCase(), version.toLowerCase(), "WorkflowCompiler", WORKFLOW_COMPILER_DLL_NAME);
   }
 }
 
@@ -850,9 +858,8 @@ class WorkflowCompilerExecutor {
   async executeAsync(operation, args, cancellationToken) {
     const startTime = Date.now();
     const compilerPath = await this.pathResolver.getCompilerPathAsync();
-    const isDll = compilerPath.endsWith(".dll");
-    const executable = isDll ? WorkflowCompilerExecutor.DOTNET_EXECUTABLE : compilerPath;
-    const commandArgs = isDll ? [compilerPath, operation, ...args] : [operation, ...args];
+    const executable = WorkflowCompilerExecutor.DOTNET_EXECUTABLE;
+    const commandArgs = [compilerPath, operation, ...args];
     this.logCommandStart(operation, executable, commandArgs);
     return new Promise((resolve) => {
       let result = null;
@@ -871,7 +878,9 @@ class WorkflowCompilerExecutor {
               elapsed: elapsed.toString(),
               errorCode: result.errorCode
             }));
-            resolve(new ToolResult(result.errorCode, result.message, result.outputPackages));
+            const toolResult = new ToolResult(result.errorCode, result.message, result.outputPackages);
+            toolResult.details = getAdditionalResultDetails(result);
+            resolve(toolResult);
           } else {
             const exitCode = childProcess.exitCode ?? -1;
             const errorMessage = fallbackErrors.join(`
@@ -1049,6 +1058,24 @@ class WorkflowCompilerExecutor {
     }
   }
 }
+var KNOWN_ENVELOPE_KEYS = new Set([
+  "elapsed",
+  "errorCode",
+  "inputId",
+  "message",
+  "outputPackages",
+  "toolId",
+  "type"
+]);
+function getAdditionalResultDetails(result) {
+  const details = {};
+  for (const key of Object.keys(result)) {
+    if (!KNOWN_ENVELOPE_KEYS.has(key)) {
+      details[key] = result[key];
+    }
+  }
+  return Object.keys(details).length > 0 ? details : undefined;
+}
 
 // src/workflow-compiler-tool.ts
 class WorkflowCompilerTool extends ProjectTool {
@@ -1197,6 +1224,7 @@ class WorkflowCompilerTool extends ProjectTool {
 
 // src/workflow-compiler-tool-factory.ts
 class WorkflowCompilerToolFactory {
+  static cachedDotnetAvailable;
   supportedTypes = [
     ProjectTypes.Process,
     ProjectTypes.Library,
@@ -1204,8 +1232,25 @@ class WorkflowCompilerToolFactory {
     ProjectTypes.WebApp
   ];
   async createAsync(logger, fileSystem) {
+    if (!this.isDotnetAvailable()) {
+      throw new Error(translate3.t("toolWorkflowcompiler.errors.dotnetNotAvailable"));
+    }
     return new WorkflowCompilerTool(fileSystem, logger);
   }
+  isDotnetAvailable() {
+    if (WorkflowCompilerToolFactory.cachedDotnetAvailable !== undefined) {
+      return WorkflowCompilerToolFactory.cachedDotnetAvailable;
+    }
+    try {
+      execSync("dotnet --version", {
+        stdio: ["ignore", "pipe", "ignore"]
+      });
+      WorkflowCompilerToolFactory.cachedDotnetAvailable = true;
+      return true;
+    } catch {
+      return false;
+    }
+  }
 }
 
 // src/index.ts

package/dist/output-entry.d.ts

@@ -39,4 +39,5 @@ export interface IOutputResult extends IOutputMessage {
     message?: string;
     outputPackages: string[];
     elapsed?: number;
+    [key: string]: unknown;
 }

package/dist/workflow-compiler-config.d.ts

@@ -1,4 +1,4 @@
-export declare const DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.0-alpha.22366";
+export declare const DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.195-alpha.23402";
 export declare const workflowCompilerConfig: {
     workflowCompilerPath: string | undefined;
     workflowCompilerVersion: string;
@@ -6,15 +6,15 @@ export declare const workflowCompilerConfig: {
 /**
  * Configure the workflow compiler tool.
  *
- * @param options.compilerPath - Explicit path to the compiler executable (skips all resolution logic).
+ * @param options.compilerPath - Explicit path to UiPath.WorkflowCompiler.dll (skips all resolution logic).
  * @param options.version - NuGet package version to download. Defaults to {@link DEFAULT_WORKFLOW_COMPILER_VERSION}.
  *
  * @example
  * ```ts
  * import { setupWorkflowCompiler } from "@uipath/packager-tool-workflowcompiler";
  *
- * setupWorkflowCompiler({ compilerPath: "/path/to/UiPath.WorkflowCompiler.exe" });
- * setupWorkflowCompiler({ version: "26.0.0-alpha.22366" });
+ * setupWorkflowCompiler({ compilerPath: "/path/to/UiPath.WorkflowCompiler.dll" });
+ * setupWorkflowCompiler({ version: "26.0.195-alpha.23402" });
  * ```
  */
 export declare function setupWorkflowCompiler(options: {

package/dist/workflow-compiler-path-resolver.d.ts

@@ -3,12 +3,14 @@ export interface IWorkflowCompilerPathResolver {
     getCompilerPathAsync(): Promise<string>;
 }
 /**
- * Resolves and caches the workflow compiler executable path.
+ * Resolves and caches the workflow compiler DLL path. The executor always
+ * launches `dotnet <dll>`, so the resolved path must point at a managed
+ * assembly (UiPath.WorkflowCompiler.dll) on every platform.
  *
  * Resolution chain:
  * 1. In-memory cache (subsequent calls)
  * 2. Explicit config path (`workflowCompilerConfig.workflowCompilerPath`)
- * 3. `UIPATH_WORKFLOWCOMPILER_LOCATION` env var — full file path (pipelines / offline)
+ * 3. `UIPATH_WORKFLOWCOMPILER_LOCATION` env var — full path to .dll (pipelines / offline)
  * 4. NuGet global packages cache
  * 5. `dotnet restore` to populate NuGet cache, then (4) again
  */
@@ -25,6 +27,6 @@ export declare class WorkflowCompilerPathResolver implements IWorkflowCompilerPa
     private resolveCompilerPath;
     private findInEnvLocation;
     private restoreAndResolve;
-    private getPlatformInfo;
+    private getPackageId;
     private getNuGetCompilerPath;
 }

package/dist/workflow-compiler-tool-factory.d.ts

@@ -4,6 +4,13 @@ import { type IFileSystem, type IProjectToolFactory, type IToolLogger, type Proj
  * Handles Process, Library, WebApp, and Tests project types.
  */
 export declare class WorkflowCompilerToolFactory implements IProjectToolFactory {
+    /**
+     * Process-lifetime cache of a successful `dotnet --version` lookup.
+     * Negative results are not cached so a one-off failure does not pin
+     * the factory across the rest of the process.
+     */
+    private static cachedDotnetAvailable;
     readonly supportedTypes: readonly ProjectType[];
     createAsync(logger: IToolLogger, fileSystem: IFileSystem): Promise<ProjectTool>;
+    private isDotnetAvailable;
 }

package/package.json

@@ -1,55 +1,33 @@
 {
-    "name": "@uipath/packager-tool-workflowcompiler",
-    "version": "0.0.15",
-    "description": "UiPath Workflow Compiler tool implementation",
-    "type": "module",
-    "exports": {
-        ".": {
-            "source": "./src/index.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/UiPath/cli.git",
-        "directory": "packages/packager/packager-tool-workflowcompiler"
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
-    },
-    "types": "./dist/index.d.ts",
-    "scripts": {
-        "build": "bun build ./src/index.ts --outdir dist --format esm --target node --external @uipath/solutionpackager-tool-core && tsc --emitDeclarationOnly --outDir dist",
-        "dev": "bun build ./src/index.ts --outdir dist --format esm --target node --external @uipath/solutionpackager-tool-core --watch",
-        "test": "vitest run",
-        "test:coverage": "vitest run --coverage",
-        "test:all": "bun run test",
-        "test:all:coverage": "bun run test:coverage",
-        "prepack": "bun run build",
-        "publish:dry": "bun publish --dry-run",
-        "publish:gh": "bun publish",
-        "version:patch": "bun version patch --no-git-tag-version",
-        "version:minor": "bun version minor --no-git-tag-version",
-        "version:major": "bun version major --no-git-tag-version",
-        "lint": "biome check ."
-    },
-    "files": [
-        "dist",
-        "!dist/**/*.map",
-        "src"
-    ],
-    "author": "",
-    "license": "ISC",
-    "peerDependencies": {
-        "@uipath/solutionpackager-tool-core": "0.0.33"
-    },
-    "devDependencies": {
-        "@types/node": "^25.5.0",
-        "@uipath/solutionpackager-tool-core": "0.0.33",
-        "@vitest/coverage-v8": "^4.0.14",
-        "typescript": "^5.9.3",
-        "vitest": "^4.0.14"
-    },
-    "dependencies": {},
-    "gitHead": "3f1b4d8e9f910be81e4cab956537f21dbd5d63ac"
+  "name": "@uipath/packager-tool-workflowcompiler",
+  "version": "1.195.0",
+  "description": "UiPath Workflow Compiler tool implementation",
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UiPath/cli.git",
+    "directory": "packages/packager/packager-tool-workflowcompiler"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "src"
+  ],
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "@uipath/solutionpackager-tool-core": "1.195.0"
+  },
+  "dependencies": {},
+  "gitHead": "eecf5713cd579b15783c770d1923e44e730271ea"
 }

package/src/i18n/locales/de.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/en.ts

@@ -18,6 +18,8 @@ export const en = {
             processError: "[WorkflowCompiler] Process error: {message}",
             startFailed: "Failed to start workflow compiler: {message}",
             operationCancelled: "Operation cancelled",
+            dotnetNotAvailable:
+                "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command.",
         },
         pathResolver: {
             info: {

package/src/i18n/locales/es-MX.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/es.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/fr.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/ja.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/ko.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/pt-BR.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/pt.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/ro.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/ru.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/tr.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/zh-CN.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/zh-TW.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/i18n/locales/zu.json

@@ -11,7 +11,8 @@
             "failed": "[WorkflowCompiler] {operation} failed: {errorMessage}",
             "processError": "[WorkflowCompiler] Process error: {message}",
             "startFailed": "Failed to start workflow compiler: {message}",
-            "operationCancelled": "Operation cancelled"
+            "operationCancelled": "Operation cancelled",
+            "dotnetNotAvailable": "The .NET SDK 8.0 is required by the workflow compiler, but the 'dotnet' CLI was not found on PATH. Install SDK 8.0 from https://dotnet.microsoft.com/download/dotnet/8.0, then re-run this command."
         },
         "pathResolver": {
             "info": {

package/src/output-entry.ts

@@ -43,4 +43,5 @@ export interface IOutputResult extends IOutputMessage {
     message?: string;
     outputPackages: string[];
     elapsed?: number;
+    [key: string]: unknown;
 }

package/src/workflow-compiler-config.ts

@@ -1,4 +1,4 @@
-export const DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.0-alpha.22366";
+export const DEFAULT_WORKFLOW_COMPILER_VERSION = "26.0.195-alpha.23402";
 
 export const workflowCompilerConfig = {
     workflowCompilerPath: undefined as string | undefined,
@@ -8,15 +8,15 @@ export const workflowCompilerConfig = {
 /**
  * Configure the workflow compiler tool.
  *
- * @param options.compilerPath - Explicit path to the compiler executable (skips all resolution logic).
+ * @param options.compilerPath - Explicit path to UiPath.WorkflowCompiler.dll (skips all resolution logic).
  * @param options.version - NuGet package version to download. Defaults to {@link DEFAULT_WORKFLOW_COMPILER_VERSION}.
  *
  * @example
  * ```ts
  * import { setupWorkflowCompiler } from "@uipath/packager-tool-workflowcompiler";
  *
- * setupWorkflowCompiler({ compilerPath: "/path/to/UiPath.WorkflowCompiler.exe" });
- * setupWorkflowCompiler({ version: "26.0.0-alpha.22366" });
+ * setupWorkflowCompiler({ compilerPath: "/path/to/UiPath.WorkflowCompiler.dll" });
+ * setupWorkflowCompiler({ version: "26.0.195-alpha.23402" });
  * ```
  */
 export function setupWorkflowCompiler(options: {

package/src/workflow-compiler-executor.ts

@@ -64,13 +64,8 @@ export class WorkflowCompilerExecutor {
     ): Promise<ToolResult> {
         const startTime = Date.now();
         const compilerPath = await this.pathResolver.getCompilerPathAsync();
-        const isDll = compilerPath.endsWith(".dll");
-        const executable = isDll
-            ? WorkflowCompilerExecutor.DOTNET_EXECUTABLE
-            : compilerPath;
-        const commandArgs = isDll
-            ? [compilerPath, operation, ...args]
-            : [operation, ...args];
+        const executable = WorkflowCompilerExecutor.DOTNET_EXECUTABLE;
+        const commandArgs = [compilerPath, operation, ...args];
 
         this.logCommandStart(operation, executable, commandArgs);
 
@@ -101,13 +96,13 @@ export class WorkflowCompilerExecutor {
                                 },
                             ),
                         );
-                        resolve(
-                            new ToolResult(
-                                result.errorCode,
-                                result.message,
-                                result.outputPackages,
-                            ),
+                        const toolResult = new ToolResult(
+                            result.errorCode,
+                            result.message,
+                            result.outputPackages,
                         );
+                        toolResult.details = getAdditionalResultDetails(result);
+                        resolve(toolResult);
                     } else {
                         const exitCode = childProcess.exitCode ?? -1;
                         const errorMessage =
@@ -384,3 +379,37 @@ export class WorkflowCompilerExecutor {
         }
     }
 }
+
+/**
+ * Allow-list-driven copy of any *extra* fields the WorkflowCompiler emits on
+ * its result envelope (e.g. analyzer `findings`) into `ToolResult.details`,
+ * so downstream callers can read structured data without the executor having
+ * to know what each consumer needs.
+ *
+ * Known envelope fields (already exposed as first-class on `ToolResult` or
+ * intentionally internal) are excluded; anything else is copied through.
+ * Adding the new field to `KNOWN_ENVELOPE_KEYS` is what keeps it out of
+ * `details` — leaving it absent surfaces it, which is the safer default.
+ */
+const KNOWN_ENVELOPE_KEYS = new Set<keyof IOutputResult>([
+    "elapsed",
+    "errorCode",
+    "inputId",
+    "message",
+    "outputPackages",
+    "toolId",
+    "type",
+]);
+
+function getAdditionalResultDetails(
+    result: IOutputResult,
+): Record<string, unknown> | undefined {
+    const details: Record<string, unknown> = {};
+    for (const key of Object.keys(result)) {
+        if (!KNOWN_ENVELOPE_KEYS.has(key as keyof IOutputResult)) {
+            details[key] = (result as Record<string, unknown>)[key];
+        }
+    }
+
+    return Object.keys(details).length > 0 ? details : undefined;
+}

package/src/workflow-compiler-path-resolver.ts

@@ -14,22 +14,12 @@ import { workflowCompilerConfig } from "./workflow-compiler-config.js";
 const NUGET_FEED_URL =
     "https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Internal/nuget/v3/index.json";
 
-const PLATFORM_PACKAGES: Record<
-    string,
-    { packageId: string; compilerFileName: string }
-> = {
-    win32: {
-        packageId: "UiPath.WorkflowCompiler.Windows",
-        compilerFileName: "UiPath.WorkflowCompiler.exe",
-    },
-    darwin: {
-        packageId: "UiPath.WorkflowCompiler.macOS",
-        compilerFileName: "UiPath.WorkflowCompiler.dll",
-    },
-    linux: {
-        packageId: "UiPath.WorkflowCompiler.Linux",
-        compilerFileName: "UiPath.WorkflowCompiler.dll",
-    },
+const WORKFLOW_COMPILER_DLL_NAME = "UiPath.WorkflowCompiler.dll";
+
+const PLATFORM_PACKAGE_IDS: Record<string, string> = {
+    win32: "UiPath.WorkflowCompiler.Windows",
+    darwin: "UiPath.WorkflowCompiler.macOS",
+    linux: "UiPath.WorkflowCompiler.Linux",
 };
 
 const RESTORE_CSPROJ_TEMPLATE = `<Project Sdk="Microsoft.NET.Sdk">
@@ -50,12 +40,14 @@ export interface IWorkflowCompilerPathResolver {
 }
 
 /**
- * Resolves and caches the workflow compiler executable path.
+ * Resolves and caches the workflow compiler DLL path. The executor always
+ * launches `dotnet <dll>`, so the resolved path must point at a managed
+ * assembly (UiPath.WorkflowCompiler.dll) on every platform.
  *
  * Resolution chain:
  * 1. In-memory cache (subsequent calls)
  * 2. Explicit config path (`workflowCompilerConfig.workflowCompilerPath`)
- * 3. `UIPATH_WORKFLOWCOMPILER_LOCATION` env var — full file path (pipelines / offline)
+ * 3. `UIPATH_WORKFLOWCOMPILER_LOCATION` env var — full path to .dll (pipelines / offline)
  * 4. NuGet global packages cache
  * 5. `dotnet restore` to populate NuGet cache, then (4) again
  */
@@ -97,8 +89,10 @@ export class WorkflowCompilerPathResolver
             return this.cachedPath;
         }
 
-        // Coalesce concurrent callers into a single resolution to avoid
-        // parallel dotnet restore processes.
+        // In-process coalescing only: dedupes concurrent callers within this
+        // Node process. Parallel `uip` invocations each run their own restore;
+        // NuGet's own per-package lock handles cross-process coordination of
+        // the cache.
         if (this.pendingResolution) {
             return this.pendingResolution;
         }
@@ -170,9 +164,11 @@ export class WorkflowCompilerPathResolver
             ),
         );
 
-        // Env var must point to a full file path (.dll or .exe)
+        // Env var must point to UiPath.WorkflowCompiler.dll. The executor
+        // always launches via `dotnet <dll>`; .exe apphost paths are not
+        // accepted because they cannot be loaded as managed assemblies.
         if (
-            (location.endsWith(".dll") || location.endsWith(".exe")) &&
+            location.endsWith(".dll") &&
             (await this.fileSystem.exists(location))
         ) {
             this.logger.info(
@@ -190,7 +186,7 @@ export class WorkflowCompilerPathResolver
         compilerPath: string,
         version: string,
     ): Promise<string> {
-        const { packageId } = this.getPlatformInfo();
+        const packageId = this.getPackageId();
         const tempDir = await this.tempStorage.getTempFolderPath();
 
         try {
@@ -279,12 +275,9 @@ export class WorkflowCompilerPathResolver
         }
     }
 
-    private getPlatformInfo(): {
-        packageId: string;
-        compilerFileName: string;
-    } {
-        const info = PLATFORM_PACKAGES[platform()];
-        if (!info) {
+    private getPackageId(): string {
+        const packageId = PLATFORM_PACKAGE_IDS[platform()];
+        if (!packageId) {
             throw new Error(
                 translate.t(
                     "toolWorkflowcompiler.pathResolver.errors.unsupportedPlatform",
@@ -292,20 +285,19 @@ export class WorkflowCompilerPathResolver
                 ),
             );
         }
-        return info;
+        return packageId;
     }
 
     private getNuGetCompilerPath(version: string): string {
         const cacheRoot =
             process.env.NUGET_PACKAGES ??
             Path.join(homedir(), ".nuget", "packages");
-        const { packageId, compilerFileName } = this.getPlatformInfo();
         return Path.join(
             cacheRoot,
-            packageId.toLowerCase(),
+            this.getPackageId().toLowerCase(),
             version.toLowerCase(),
             "WorkflowCompiler",
-            compilerFileName,
+            WORKFLOW_COMPILER_DLL_NAME,
         );
     }
 }

package/src/workflow-compiler-tool-factory.ts

@@ -1,3 +1,4 @@
+import { execSync } from "node:child_process";
 import {
     type IFileSystem,
     type IProjectToolFactory,
@@ -5,6 +6,7 @@ import {
     type ProjectTool,
     type ProjectType,
     ProjectTypes,
+    translate,
 } from "@uipath/solutionpackager-tool-core";
 import { WorkflowCompilerTool } from "./workflow-compiler-tool.js";
 
@@ -13,6 +15,13 @@ import { WorkflowCompilerTool } from "./workflow-compiler-tool.js";
  * Handles Process, Library, WebApp, and Tests project types.
  */
 export class WorkflowCompilerToolFactory implements IProjectToolFactory {
+    /**
+     * Process-lifetime cache of a successful `dotnet --version` lookup.
+     * Negative results are not cached so a one-off failure does not pin
+     * the factory across the rest of the process.
+     */
+    private static cachedDotnetAvailable: boolean | undefined;
+
     readonly supportedTypes: readonly ProjectType[] = [
         ProjectTypes.Process,
         ProjectTypes.Library,
@@ -24,6 +33,26 @@ export class WorkflowCompilerToolFactory implements IProjectToolFactory {
         logger: IToolLogger,
         fileSystem: IFileSystem,
     ): Promise<ProjectTool> {
+        if (!this.isDotnetAvailable()) {
+            throw new Error(
+                translate.t("toolWorkflowcompiler.errors.dotnetNotAvailable"),
+            );
+        }
         return new WorkflowCompilerTool(fileSystem, logger);
     }
+
+    private isDotnetAvailable(): boolean {
+        if (WorkflowCompilerToolFactory.cachedDotnetAvailable !== undefined) {
+            return WorkflowCompilerToolFactory.cachedDotnetAvailable;
+        }
+        try {
+            execSync("dotnet --version", {
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+            WorkflowCompilerToolFactory.cachedDotnetAvailable = true;
+            return true;
+        } catch {
+            return false;
+        }
+    }
 }