@uipath/solution-tool 1.198.0 → 1.199.0-preview.105

package/README.md

@@ -28,7 +28,7 @@ uip solution init --name MySolution
 uip solution upload <packagePath>
 uip solution deploy run --solution-name MySolution
 uip solution deploy status --solution-name MySolution
-uip solution project add --name MyProject
+uip solution projects add ./my-solution/my-project ./my-solution/my-solution.uipx
 ```
 
 ### Deploying to Personal Workspace

package/dist/commands/package-command-utils.d.ts

@@ -0,0 +1,4 @@
+import type { ExtendedPackageVersionState } from "@uipath/pipelines-sdk";
+export declare const LOGIN_INSTRUCTIONS = "Run `uip login` to authenticate.";
+export declare const PACKAGE_READY_STATES: ReadonlySet<ExtendedPackageVersionState>;
+export declare function getPackageStateInstructions(state: ExtendedPackageVersionState): "Wait until package processing completes, then run the command again." | "Check the solution package contents and publish it again.";

package/dist/commands/project-add.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare const registerProjectAddCommand: (project: Command) => void;

package/dist/commands/project-import.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare const registerProjectImportCommand: (project: Command) => void;

package/dist/commands/project-list.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare const registerProjectListCommand: (project: Command) => void;

package/dist/commands/project-publish.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare const registerProjectPublishCommand: (project: Command) => void;

package/dist/commands/project-remove.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare const registerProjectRemoveCommand: (project: Command) => void;

package/dist/commands/project-resync.d.ts

@@ -0,0 +1,2 @@
+import { type Command } from "commander";
+export declare const registerProjectResyncCommand: (project: Command) => void;

package/dist/commands/project-utils.d.ts

@@ -0,0 +1,60 @@
+export interface ProjectFileContent {
+    Name?: string;
+    ProjectType?: string;
+    designOptions?: {
+        outputType?: string;
+    };
+    functions?: Record<string, string>;
+}
+export interface SolutionProject {
+    Type: string;
+    ProjectRelativePath: string;
+    Id: string;
+}
+export interface SolutionFileContent {
+    Projects?: SolutionProject[];
+}
+export interface ProjectFileInfo {
+    filePath: string;
+    fileName: string;
+    useProjectJson: boolean;
+}
+export interface ParsedProjectFile {
+    content: ProjectFileContent;
+    projectType: string;
+}
+export interface ParsedSolutionFile {
+    solution: SolutionFileContent;
+    rawContent: string;
+}
+/**
+ * Finds the project manifest inside a directory, in priority order:
+ * project.uiproj, project.json, then uipath.json (code-first JS/TS Functions).
+ */
+export declare function findProjectFile(projectDir: string): Promise<[Error, null] | [null, ProjectFileInfo]>;
+/**
+ * Reads and parses a project manifest, extracting the project type.
+ */
+export declare function readProjectFile(filePath: string, useProjectJson: boolean): Promise<[Error, null] | [null, ParsedProjectFile]>;
+/**
+ * Reads and parses a solution .uipx file.
+ * Returns both the parsed object and the raw content (for rollback).
+ */
+export declare function readSolutionFile(filePath: string): Promise<[Error, null] | [null, ParsedSolutionFile]>;
+/**
+ * Resolves the solution file path — either from an explicit option or by searching upward.
+ */
+export declare function resolveSolutionFilePath(solutionFileOption: string | undefined, searchStartDir: string): Promise<[Error, null] | [null, string]>;
+/**
+ * Writes the solution object back to disk as formatted JSON.
+ */
+export declare function writeSolutionFile(filePath: string, solution: SolutionFileContent): Promise<Error | null>;
+/**
+ * Restores the exact solution file content captured before a write.
+ */
+export declare function restoreSolutionFile(filePath: string, rawContent: string): Promise<Error | null>;
+/**
+ * Creates a project in the solution builder (resource builder services).
+ * Handles service init, builder creation, createProjectAsync, and dispose.
+ */
+export declare function createProjectInSolutionBuilder(solutionDir: string, projectId: string, projectName: string, projectType: string): Promise<Error | null>;

package/dist/commands/project.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function findSolutionFile(startDir: string): Promise<string>;
+export declare const registerProjectCommand: (program: Command) => void;

package/dist/deploy.js

@@ -28203,6 +28203,7 @@ function settlePromiseLike(thenable) {
 var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.";
 var DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.";
 var DEFAULT_405 = "Method Not Allowed (405). The endpoint may not exist or the base URL may be incorrect.";
+var DEFAULT_413 = "Payload too large (413). The upload exceeded the server or CDN size limit. Reduce the package size — for example, exclude unused dependencies or remove large files from the project — and try again.";
 var HTML_RESPONSE_MESSAGE = "Received HTML instead of the expected JSON response.";
 var NETWORK_ERROR_CODES = new Set([
   "ECONNREFUSED",
@@ -28304,6 +28305,9 @@ function classifyError(status, error) {
   if (status === 405) {
     return { errorCode: "method_not_allowed", retry: "RetryWillNotFix" };
   }
+  if (status === 413) {
+    return { errorCode: "invalid_argument", retry: "RetryWillNotFix" };
+  }
   if (status === 408) {
     return { errorCode: "timeout", retry: "RetryLater" };
   }
@@ -28381,6 +28385,8 @@ async function extractErrorDetails(error, options) {
     result = "AuthenticationError";
   } else if (status === 405) {
     message = DEFAULT_405;
+  } else if (status === 413) {
+    message = DEFAULT_413;
   } else if (status === 400 || status === 422) {
     message = formatHttpStatusMessage(status, rawMessage, extractedMessage, inferredStatus);
     result = "ValidationError";
@@ -35259,6 +35265,7 @@ var SKILL_ATTRIBUTION = attributionRecord([
 var KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
 var COMMAND_ATTRIBUTION = commandAttribution([
   ["cli", "troubleshoot", ["uip.feedback"]],
+  ["llm-gateway", "operate", ["uip.llm-gateway"]],
   ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
   ["context-grounding", "build", ["uip.context-grounding"]],
   ["api-workflow", "build", ["uip.api-workflow"]],
@@ -36319,7 +36326,7 @@ class TextApiResponse {
 var package_default = {
   name: "@uipath/pipelines-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0",
   description: "Generated TypeScript client for UiPath Pipelines API (CI/CD deployment lifecycle)",
   repository: {
     type: "git",
@@ -37734,7 +37741,7 @@ class JSONApiResponse2 {
 var package_default2 = {
   name: "@uipath/solution-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0-preview.105",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -38565,6 +38572,39 @@ async function findDeploymentByName(auth, deploymentName) {
     skip += values.length;
   }
 }
+async function findDeploymentByPackageName(auth, packageName, folderPath, scope) {
+  const [lookupError, deployment] = await catchError((async () => {
+    const api = new SearchApi(new Configuration2({
+      basePath: auth.basePath,
+      accessToken: auth.accessToken
+    }));
+    const take = 50;
+    for (let skip = 0;; ) {
+      const result = await api.searchSearchDeployments22({
+        deploymentsSearchRequest2: {
+          searchTerm: packageName,
+          take,
+          skip,
+          operationStatuses: [],
+          activationStatuses: []
+        }
+      }, scope);
+      const values = result.values ?? [];
+      const match = values.find((deployment2) => deployment2.packageName === packageName && (folderPath === undefined || deployment2.folderPath === folderPath));
+      if (match) {
+        return match;
+      }
+      if (values.length < take) {
+        return;
+      }
+      skip += values.length;
+    }
+  })());
+  if (lookupError) {
+    return;
+  }
+  return deployment;
+}
 async function findDeploymentForError(auth, deploymentName) {
   const [lookupError, deployment] = await catchError(findDeploymentByName(auth, deploymentName));
   if (lookupError) {
@@ -38781,6 +38821,7 @@ var resolveConfigAsync = async ({
   customAuthority,
   customClientId,
   customClientSecret,
+  customClientAssertion,
   customScopes
 } = {}) => {
   const fileAuth = getAuthFileConfig();
@@ -38806,7 +38847,7 @@ var resolveConfigAsync = async ({
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && Boolean(clientSecret);
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && (Boolean(clientSecret) || Boolean(customClientAssertion));
   const scopes = resolveScopes(isExternalAppAuth, customScopes, fileAuth.scopes);
   return {
     clientId,
@@ -39924,7 +39965,6 @@ var getAuthContext = async (options = {}) => {
     tenantName
   };
 };
-
 // ../auth/src/index.ts
 init_constants();
 
@@ -40274,7 +40314,7 @@ class TextApiResponse3 {
 var package_default3 = {
   name: "@uipath/orchestrator-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -42865,8 +42905,8 @@ async function listDeploymentsAsync(options = {}) {
       skip: offset,
       orderByColumn: options.sortBy ?? "startTime",
       orderByDirection: options.sortOrder ?? "Descending",
-      operationStatuses: [],
-      activationStatuses: []
+      operationStatuses: options.operationStatuses ?? [],
+      activationStatuses: options.activationStatuses ?? []
     }
   }));
   if (listError) {
@@ -42883,11 +42923,16 @@ async function listDeploymentsAsync(options = {}) {
     name: d.name,
     packageName: d.packageName,
     packageVersion: d.packageVersion,
+    currentPackageVersion: d.currentPackageVersion,
+    targetPackageVersion: d.targetPackageVersion,
+    newPackageVersionAvailable: d.newPackageVersionAvailable,
+    operation: d.operation,
     operationStatus: d.operationStatus,
     activationStatus: d.activationStatus,
     folderPath: d.folderPath,
     installedRootFolderKey: d.installedRootFolderKey,
-    deploymentCreationTime: d.deploymentCreationTime
+    deploymentCreationTime: d.deploymentCreationTime,
+    actions: d.actions ?? []
   }));
   return { ok: true, deployments, limit, offset, total: result.count };
 }
@@ -43186,13 +43231,57 @@ async function deployRunAsync(options) {
   const finalInstanceId = activationInstanceId == null ? baseSuccess.instanceId : activationInstanceId;
   return { ...baseSuccess, activationStatus, instanceId: finalInstanceId };
 }
+var EXISTING_DEPLOYMENT_MARKER = "Deployment exists in a failed or running state";
+function isExistingDeploymentConflict(httpStatus, message, details, parsedErrors) {
+  if (httpStatus !== 400) {
+    return false;
+  }
+  if (message.includes(EXISTING_DEPLOYMENT_MARKER) || details.includes(EXISTING_DEPLOYMENT_MARKER)) {
+    return true;
+  }
+  if (parsedErrors) {
+    for (const fieldMessages of Object.values(parsedErrors)) {
+      if (fieldMessages.some((m) => m.includes(EXISTING_DEPLOYMENT_MARKER))) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function buildDeploymentExistsInstructions(packageName, existing) {
+  const base = `A deployment for '${packageName}' already exists and cannot be redeployed — it must be upgraded in place. ` + "For now, open the deployment in the Orchestrator UI and use the Upgrade button. " + "Run 'uip solution deploy list' to see the pending state — the Operation and TargetPackageVersion columns show whether an upgrade is queued.";
+  if (!existing) {
+    return base;
+  }
+  const target = existing.targetPackageVersion ?? existing.newPackageVersionAvailable;
+  const detail = existing.currentPackageVersion && target ? ` Existing deployment '${existing.name}' is at ${existing.currentPackageVersion} and can be upgraded to ${target}.` : ` Existing deployment: '${existing.name}'.`;
+  return `${base}${detail}`;
+}
 async function deployRunPersonalWorkspaceAsync(auth, options) {
   const [pwError, result] = await catchError(deployToPersonalWorkspace(auth, {
     packageName: options.packageName,
     packageVersion: options.packageVersion
   }, { tenant: options.tenant, loginValidity: options.loginValidity }));
   if (pwError) {
-    const { message, details } = await extractErrorDetails(pwError);
+    const { message, details, context, parsedErrors } = await extractErrorDetails(pwError);
+    if (isExistingDeploymentConflict(context?.httpStatus, message, details, parsedErrors)) {
+      const [pwResolveError, pw] = await catchError(resolvePersonalWorkspace({
+        tenant: options.tenant,
+        loginValidity: options.loginValidity,
+        envFilePath: options.envFilePath
+      }));
+      let scope;
+      if (!pwResolveError && pw) {
+        scope = async ({ init }) => ({
+          headers: {
+            ...init.headers,
+            "X-UIPATH-FolderKey": pw.key
+          }
+        });
+      }
+      const existing = await findDeploymentByPackageName(auth, options.packageName, undefined, scope);
+      return fail3("deployment_exists", message, buildDeploymentExistsInstructions(options.packageName, existing));
+    }
     return fail3("personal_workspace_deploy_failed", message, `Ensure the package was published to your Personal Workspace first: uip solution publish <package> --personal-workspace. Details: ${details}`);
   }
   return {
@@ -43332,4 +43421,4 @@ export {
   activateDeploymentAsync
 };
 
-//# debugId=656C3710CC9A83D264756E2164756E21
+//# debugId=CB347BC9915C717164756E2164756E21

package/dist/init.d.ts

@@ -1,6 +1,14 @@
 /**
  * Public `@uipath/solution-tool/init` entry: the programmatic init service for SDK
  * consumers, without the CLI side effects of `tool.ts`. Mirrors `@uipath/flow-tool/validation`.
+ *
+ * Also re-exports `addProjectArtifactsToSolutionAsync` so `*-tool init` paths
+ * (flow, maestro, agent, case) can generate the `resources/solution_folder/process/<kind>/`
+ * artifact-resource entries that `uip solution project add` produces. Without
+ * this step, init succeeds but `solution pack` would later miss the artifact
+ * resources, forcing a `solution project remove` + `add` recovery cycle.
  */
+export type { AddProjectArtifactsOptions, ProjectArtifactsResult, } from "./services/project-artifacts-service";
+export { addProjectArtifactsToSolutionAsync } from "./services/project-artifacts-service";
 export type { SolutionInitOptions, SolutionInitResult, SolutionInitStage, } from "./services/solution-init-service";
 export { SolutionInitError, solutionInitAsync, } from "./services/solution-init-service";