@uipath/solution-tool 1.203.0-preview.212 → 1.204.0-preview.211

package/README.md

@@ -11,7 +11,7 @@
 | `new` | Create a new solution |
 | `upload` | Upload a solution package |
 | `deploy run` | Deploy solution to environment |
-| `deploy status` | Check deployment status |
+| `deploy status` | Check a deployment by name, deployment key, or pipeline deployment ID |
 | `deploy activate` | Activate deployed solution |
 | `deploy uninstall` | Remove solution |
 | `deploy list` | List deployments |
@@ -27,7 +27,7 @@ uip solution publish <packagePath>
 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 deploy status <deployment-name>   # or a deployment key / pipeline deployment ID
 uip solution projects add ./my-solution/my-project ./my-solution/my-solution.uipx
 ```
 

package/dist/THIRD-PARTY-NOTICES.md

@@ -7,8 +7,8 @@ those licences require.
 
 22 bundled dependencies:
 
-- @uipath/resource-builder-sdk@2025.11.0-alpha5891-4020 — ISC
-- @uipath/resource-builder-tool@2025.11.0-alpha4535-3530 — ISC
+- @uipath/resource-builder-sdk@2025.11.0-alpha6004-4107 — ISC
+- @uipath/resource-builder-tool@2025.11.0-alpha6004-4107 — ISC
 - bundle-name@4.1.0 — MIT
 - commander@14.0.3 — MIT
 - default-browser@5.5.0 — MIT
@@ -32,7 +32,7 @@ those licences require.
 
 ---
 
-## @uipath/resource-builder-sdk@2025.11.0-alpha5891-4020
+## @uipath/resource-builder-sdk@2025.11.0-alpha6004-4107
 
 SPDX: ISC
 
@@ -42,7 +42,7 @@ applies, with copyright held by the package's authors.
 
 ---
 
-## @uipath/resource-builder-tool@2025.11.0-alpha4535-3530
+## @uipath/resource-builder-tool@2025.11.0-alpha6004-4107
 
 SPDX: ISC
 

package/dist/deploy-delete-service-gg00vadc.js

@@ -0,0 +1,22 @@
+import {
+  deleteDeploymentAsync
+} from "./packager-tool-q3tgpemc.js";
+import"./packager-tool-40vcj4wv.js";
+import"./packager-tool-482eg22x.js";
+import"./packager-tool-qgaqqq41.js";
+import"./packager-tool-qdtjywsk.js";
+import"./packager-tool-00vh1ktg.js";
+import"./packager-tool-bqre28m1.js";
+import"./packager-tool-f5gq77m5.js";
+import"./packager-tool-3fv6zc86.js";
+import"./packager-tool-vmsxq1pc.js";
+import"./packager-tool-5fjp60dk.js";
+import"./packager-tool-gb35b4qs.js";
+import"./packager-tool-zf3929se.js";
+import"./packager-tool-dfrk01gn.js";
+import"./packager-tool-1de529jm.js";
+export {
+  deleteDeploymentAsync
+};
+
+//# debugId=BCFE0E491B8154C164756E2164756E21

package/dist/deploy-status-service-cqfrvxpz.js

@@ -0,0 +1,256 @@
+import {
+  deploymentNextSteps,
+  needsPendingResources,
+  quoteForShell,
+  readPendingResourcesAsync
+} from "./packager-tool-ks8spnq8.js";
+import {
+  INCOMPLETE_SWEEP_ADVICE,
+  findDeploymentAcrossFeeds,
+  reportIncompleteSweepAsync
+} from "./packager-tool-40vcj4wv.js";
+import {
+  DeploymentSearchNeedsUserSessionError,
+  findCurrentDeploymentAsync,
+  findDeploymentByName,
+  httpStatusOf,
+  isAuthRefusal
+} from "./packager-tool-482eg22x.js";
+import {
+  Configuration as Configuration2,
+  PipelinesApi
+} from "./packager-tool-qgaqqq41.js";
+import {
+  feedScopeInitOverride,
+  feedSelectorFlag,
+  folderKeyInitOverride
+} from "./packager-tool-qdtjywsk.js";
+import {
+  Configuration,
+  DeploymentsApi
+} from "./packager-tool-00vh1ktg.js";
+import {
+  FeedReadRefusedError,
+  classifyFeedSession,
+  feedReadRefusalForApplication
+} from "./packager-tool-bqre28m1.js";
+import"./packager-tool-3fv6zc86.js";
+import"./packager-tool-vmsxq1pc.js";
+import {
+  catchError
+} from "./packager-tool-5fjp60dk.js";
+import"./packager-tool-gb35b4qs.js";
+import"./packager-tool-zf3929se.js";
+import"./packager-tool-dfrk01gn.js";
+import"./packager-tool-1de529jm.js";
+
+// src/services/deploy-status-service.ts
+class IncompleteFeedSweepError extends Error {
+  skipped;
+  name = "IncompleteFeedSweepError";
+  instructions;
+  errorCode;
+  retry;
+  constructor(report, skipped) {
+    super(report.message);
+    this.skipped = skipped;
+    const oneFeed = report.oneFeedFlags.length ? ` To look in one feed directly, pass ${report.oneFeedFlags.join(" or ")}.` : "";
+    this.instructions = `${INCOMPLETE_SWEEP_ADVICE} ${report.nextStep}${oneFeed} Details: ${report.details}`;
+    this.errorCode = report.errorCode;
+    this.retry = report.retry;
+  }
+}
+var GUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function looksLikeDeploymentKey(reference) {
+  return GUID.test(reference);
+}
+async function describeDeploymentByKeyAsync(auth, deploymentKey, scope, feedSelector = "", addressedBy = "key") {
+  const deploymentsApi = new DeploymentsApi(new Configuration({
+    basePath: auth.basePath,
+    accessToken: auth.accessToken
+  }));
+  const pipelinesApi = new PipelinesApi(new Configuration2({
+    basePath: auth.basePath,
+    accessToken: auth.accessToken
+  }));
+  const [lookupError, info] = await catchError(pipelinesApi.pipelinesGetDeploymentByKey({ key: deploymentKey }));
+  if (!lookupError && info) {
+    return describeFromLookupAsync(auth, deploymentsApi, deploymentKey, info, addressedBy);
+  }
+  if (lookupError && httpStatusOf(lookupError) !== 404) {
+    throw lookupError;
+  }
+  if (classifyFeedSession(auth) !== "user") {
+    return;
+  }
+  return describeViaSolutionsAsync(auth, deploymentsApi, deploymentKey, scope, feedSelector, addressedBy);
+}
+async function describeFromLookupAsync(auth, deploymentsApi, requestedKey, info, addressedBy) {
+  const feedScope = info.locationKey ? folderKeyInitOverride(info.locationKey) : undefined;
+  const selector = info.locationKey ? ` --feed ${info.locationKey}` : "";
+  const superseded = addressedBy === "key" && info.deploymentKey !== requestedKey;
+  const [rowError, headRow] = await catchError(findCurrentDeploymentAsync(auth, {
+    key: info.deploymentKey,
+    installDeploymentKey: info.installDeploymentKey,
+    packageName: info.packageName
+  }, feedScope));
+  const row = headRow && headRow.key === info.deploymentKey ? headRow : undefined;
+  const current = {
+    key: info.deploymentKey,
+    installDeploymentKey: info.installDeploymentKey,
+    name: info.deploymentName,
+    packageName: info.packageName,
+    packageVersion: info.packageVersion,
+    currentPackageVersion: row?.currentPackageVersion ?? info.packageVersion,
+    newPackageVersionAvailable: row?.newPackageVersionAvailable,
+    operation: info.operation,
+    operationStatus: info.operationStatus,
+    activationStatus: row?.activationStatus ?? (info.status === "SuccessfulActivate" ? "Active" : undefined),
+    actions: row?.actions,
+    deploymentStatus: info.status
+  };
+  const pendingResources = needsPendingResources(current) ? await readPendingResourcesAsync(deploymentsApi, current.key, feedScope) : undefined;
+  const steps = deploymentNextSteps(current, pendingResources, selector) ?? [];
+  if (!row && info.status === "SuccessfulInstall") {
+    steps.unshift(headRow ? `Deployment '${current.name}' is installed but not active (DeploymentStatus: SuccessfulInstall). What is left before it runs could not be read: the Solutions search does not list record '${current.key}' yet (its newest row is '${headRow.key}'). Run 'uip solution deploy status ${quoteForShell(current.name)}' again in a moment, or open the deployment in Orchestrator (Tenant > Solutions > Deployments).` : `Deployment '${current.name}' is installed but not active (DeploymentStatus: SuccessfulInstall). What is left before it runs could not be read: the Solutions search needs a user session${rowError ? ` (${rowError.message})` : ""}. Run 'uip solution deploy status ${quoteForShell(current.name)}' after 'uip login', or open the deployment in Orchestrator (Tenant > Solutions > Deployments).`);
+  }
+  if (superseded) {
+    steps.unshift(supersededLine(requestedKey, current, selector));
+  }
+  return {
+    requestedKey: addressedBy === "name" ? current.key : requestedKey,
+    current,
+    superseded,
+    ...rowError ? { chainLookupError: rowError.message } : {},
+    ...pendingResources ? { pendingResources } : {},
+    ...steps.length > 0 ? { nextSteps: steps } : {}
+  };
+}
+async function describeViaSolutionsAsync(auth, deploymentsApi, deploymentKey, scope, feedSelector, addressedBy) {
+  const [getError, requested] = await catchError(deploymentsApi.deploymentsGetByKey({ deploymentKey }, scope));
+  if (getError) {
+    if (httpStatusOf(getError) === 404) {
+      return;
+    }
+    throw getError;
+  }
+  if (!requested) {
+    return;
+  }
+  const [headError, head] = await catchError(findCurrentDeploymentAsync(auth, requested, scope));
+  const moved = headError || !head ? null : head.key !== requested.key;
+  const superseded = addressedBy === "name" && moved !== null ? false : moved;
+  const current = toCurrentRecord(head ?? requested, {
+    deploymentStatus: moved === true ? undefined : requested.status
+  });
+  const pendingResources = needsPendingResources(current) ? await readPendingResourcesAsync(deploymentsApi, current.key, scope) : undefined;
+  const steps = deploymentNextSteps(current, pendingResources, feedSelector) ?? [];
+  if (headError) {
+    steps.unshift(`The CLI could not check whether key '${deploymentKey}' is the deployment's current record (${headError.message}). The state above is this record's own and may be stale; take the current key from 'uip solution deploy list${feedSelector}'.`);
+  } else if (!head) {
+    steps.unshift(`Key '${deploymentKey}' has no current record in 'uip solution deploy list${feedSelector}', so whether it is current is not known and the state above may be stale. Take the key from that list; add --personal-workspace or --feed when the deployment lives outside the tenant feed.`);
+  } else if (superseded) {
+    steps.unshift(supersededLine(deploymentKey, current, feedSelector));
+  }
+  return {
+    requestedKey: addressedBy === "name" ? current.key : deploymentKey,
+    current,
+    superseded,
+    ...headError ? { chainLookupError: headError.message } : {},
+    ...pendingResources ? { pendingResources } : {},
+    ...steps.length > 0 ? { nextSteps: steps } : {}
+  };
+}
+function toCurrentRecord(record, extra) {
+  return {
+    key: record.key,
+    installDeploymentKey: record.installDeploymentKey,
+    name: record.name,
+    packageName: record.packageName,
+    packageVersion: record.packageVersion,
+    currentPackageVersion: record.currentPackageVersion,
+    newPackageVersionAvailable: record.newPackageVersionAvailable,
+    operation: record.operation,
+    operationStatus: record.operationStatus,
+    activationStatus: record.activationStatus,
+    actions: record.actions,
+    ...extra.deploymentStatus !== undefined ? { deploymentStatus: extra.deploymentStatus } : {}
+  };
+}
+function supersededLine(requestedKey, current, feedSelector) {
+  const version = current.currentPackageVersion ?? current.packageVersion;
+  return `Key '${requestedKey}' is superseded: '${current.name}' is now record '${current.key}' (${current.operation}/${current.operationStatus}, version ${version}). Every operation creates a new record; use the current key from now on, from 'uip solution deploy list${feedSelector}'.`;
+}
+async function describeDeploymentAsync(auth, reference, options) {
+  const { selectedFeed } = options;
+  const scope = selectedFeed ? feedScopeInitOverride(selectedFeed) : undefined;
+  const feedSelector = feedSelectorFlag(selectedFeed);
+  if (looksLikeDeploymentKey(reference)) {
+    const byKey = await describeDeploymentByKeyAsync(auth, reference, scope, feedSelector);
+    if (byKey) {
+      return byKey;
+    }
+    const session = classifyFeedSession(auth);
+    if (session === "unknown") {
+      return;
+    }
+    if (session === "application") {
+      if (selectedFeed && selectedFeed.kind !== "tenant") {
+        const refusal = feedReadRefusalForApplication(auth, `Reading a deployment by name in the feed '${selectedFeed.name ?? selectedFeed.folderKey}'`);
+        if (refusal) {
+          throw new FeedReadRefusedError(refusal);
+        }
+      }
+      const [searchError, found2] = await catchError(locateDeploymentByNameAsync(auth, reference, options));
+      if (unreadableByApplication(searchError)) {
+        return;
+      }
+      if (searchError) {
+        throw searchError;
+      }
+      return found2 ? describeLocatedDeploymentAsync(auth, found2) : undefined;
+    }
+  }
+  const found = await locateDeploymentByNameAsync(auth, reference, options);
+  return found ? describeLocatedDeploymentAsync(auth, found) : undefined;
+}
+function unreadableByApplication(error) {
+  const refused = (cause) => cause instanceof DeploymentSearchNeedsUserSessionError || isAuthRefusal(cause);
+  if (error instanceof IncompleteFeedSweepError) {
+    return error.skipped.every((feed) => feed.kind !== "tenant" || refused(feed.error));
+  }
+  return refused(error);
+}
+async function locateDeploymentByNameAsync(auth, reference, options) {
+  const { selectedFeed } = options;
+  if (selectedFeed) {
+    const scope = feedScopeInitOverride(selectedFeed);
+    const row = await findDeploymentByName(auth, reference, scope);
+    return row ? {
+      key: row.key,
+      scope,
+      feedSelector: feedSelectorFlag(selectedFeed)
+    } : undefined;
+  }
+  const { location, complete, skipped } = await findDeploymentAcrossFeeds(auth, reference, options.locate);
+  if (!location && !complete) {
+    const report = await reportIncompleteSweepAsync(reference, skipped);
+    throw new IncompleteFeedSweepError(report, skipped);
+  }
+  return location ? {
+    key: location.deployment.key,
+    scope: location.scope,
+    feedSelector: feedSelectorFlag(location.feed)
+  } : undefined;
+}
+function describeLocatedDeploymentAsync(auth, found) {
+  return describeDeploymentByKeyAsync(auth, found.key, found.scope, found.feedSelector, "name");
+}
+export {
+  IncompleteFeedSweepError,
+  describeDeploymentAsync,
+  describeDeploymentByKeyAsync,
+  looksLikeDeploymentKey
+};
+
+//# debugId=EC8CC1500C35E32864756E2164756E21

package/dist/deploy.d.ts

@@ -1,15 +1,19 @@
 /**
  * Public `@uipath/solution-tool/deploy` entry: the programmatic deployment
- * surface for SDK consumers (e.g. the VS Code extension). Six operations
+ * surface for SDK consumers (e.g. the VS Code extension). Seven operations
  * under one subpath:
  *
  *   - `deployRunAsync`         — install + poll + optional auto-activate
  *   - `listDeploymentsAsync`   — list recent deployments
  *   - `activateDeploymentAsync`— activate a previously-deployed solution
- *   - `upgradeDeploymentAsync` — queue an in-place upgrade to a newer version
- *     (preview, like its CLI verb; queuing alone does not guarantee execution
- *     — poll `listDeploymentsAsync` until the version changes)
+ *   - `upgradeDeploymentAsync` — upgrade an existing deployment in place via
+ *     the Pipelines install (validates before it installs; waits for the
+ *     terminal status unless `noWait`)
  *   - `uninstallDeploymentAsync` — uninstall a deployed solution
+ *   - `deleteDeploymentAsync`  — remove the deployment an uninstall leaves
+ *     behind, and the ones a superseded version or a failed install leave;
+ *     the two never overlap, since the service offers `Uninstall` or `Delete`
+ *     per state, never both
  *   - `listPackagesAsync`      — list published solution packages
  *
  * Each function returns a tagged result (`{ ok: true, ... } | { ok: false,
@@ -20,6 +24,8 @@
  */
 export type { ActivateDeploymentFailure, ActivateDeploymentFailureReason, ActivateDeploymentOptions, ActivateDeploymentResult, ActivateDeploymentSuccess, } from "./services/deploy-activate-service";
 export { activateDeploymentAsync } from "./services/deploy-activate-service";
+export type { DeleteDeploymentFailure, DeleteDeploymentFailureReason, DeleteDeploymentOptions, DeleteDeploymentResult, DeleteDeploymentSuccess, } from "./services/deploy-delete-service";
+export { deleteDeploymentAsync } from "./services/deploy-delete-service";
 export type { DeploymentSummary, ListDeploymentsFailure, ListDeploymentsFailureReason, ListDeploymentsOptions, ListDeploymentsResult, ListDeploymentsSuccess, SortDirection, } from "./services/deploy-list-service";
 export { listDeploymentsAsync } from "./services/deploy-list-service";
 export type { DeployFailure, DeployFailureReason, DeployOptions, DeployResult, DeploySuccess, } from "./services/deploy-run-service";
@@ -28,5 +34,6 @@ export type { UninstallDeploymentFailure, UninstallDeploymentFailureReason, Unin
 export { uninstallDeploymentAsync } from "./services/deploy-uninstall-service";
 export type { UpgradeDeploymentFailure, UpgradeDeploymentFailureReason, UpgradeDeploymentOptions, UpgradeDeploymentResult, UpgradeDeploymentSuccess, } from "./services/deploy-upgrade-service";
 export { upgradeDeploymentAsync } from "./services/deploy-upgrade-service";
+export type { PendingResource } from "./services/deployment-state";
 export type { ListPackagesFailure, ListPackagesFailureReason, ListPackagesOptions, ListPackagesResult, ListPackagesSuccess, PackageSummary, } from "./services/packages-list-service";
 export { listPackagesAsync } from "./services/packages-list-service";

package/dist/deploy.js

@@ -1,3 +1,6 @@
+import {
+  deleteDeploymentAsync
+} from "./packager-tool-q3tgpemc.js";
 import {
   activateDeploymentAsync,
   deployRunAsync,
@@ -5,16 +8,25 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-4kdt8mys.js";
-import"./packager-tool-2p5yh1q9.js";
-import"./packager-tool-7qmx64kz.js";
-import"./packager-tool-2syrt51a.js";
-import"./packager-tool-3jrq7smt.js";
-import"./packager-tool-0f0wt9vh.js";
+} from "./packager-tool-j30xck4w.js";
+import"./packager-tool-ks8spnq8.js";
+import"./packager-tool-40vcj4wv.js";
+import"./packager-tool-482eg22x.js";
+import"./packager-tool-qgaqqq41.js";
+import"./packager-tool-qdtjywsk.js";
+import"./packager-tool-00vh1ktg.js";
+import"./packager-tool-bqre28m1.js";
+import"./packager-tool-f5gq77m5.js";
+import"./packager-tool-3fv6zc86.js";
+import"./packager-tool-vmsxq1pc.js";
+import"./packager-tool-5fjp60dk.js";
+import"./packager-tool-gb35b4qs.js";
+import"./packager-tool-zf3929se.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {
   activateDeploymentAsync,
+  deleteDeploymentAsync,
   deployRunAsync,
   listDeploymentsAsync,
   listPackagesAsync,
@@ -22,4 +34,4 @@ export {
   upgradeDeploymentAsync
 };
 
-//# debugId=7A33750A991345B564756E2164756E21
+//# debugId=D91AF811F0A2AA3964756E2164756E21

package/dist/deployment-search-j34w33b2.js

@@ -0,0 +1,49 @@
+import {
+  MAX_LISTED_DEPLOYMENTS,
+  blocksRedeploy,
+  deploymentToTerminalPipelineResult,
+  findCurrentDeploymentAsync,
+  findDeploymentBestEffort,
+  findDeploymentByName,
+  findDeploymentsByName,
+  findDeploymentsByPackageName,
+  findLiveDeploymentByName,
+  formatExistingDeployments,
+  httpStatusOf,
+  interpretFailedDeployPoll,
+  isCompletedUninstall,
+  isPipelineDeploymentNotFoundError,
+  mapOperationStatusToPipelineStatus,
+  newestDeploymentRow,
+  resolveInstalledFolder
+} from "./packager-tool-482eg22x.js";
+import"./packager-tool-qgaqqq41.js";
+import"./packager-tool-00vh1ktg.js";
+import"./packager-tool-bqre28m1.js";
+import"./packager-tool-vmsxq1pc.js";
+import"./packager-tool-5fjp60dk.js";
+import"./packager-tool-gb35b4qs.js";
+import"./packager-tool-zf3929se.js";
+import"./packager-tool-dfrk01gn.js";
+import"./packager-tool-1de529jm.js";
+export {
+  MAX_LISTED_DEPLOYMENTS,
+  blocksRedeploy,
+  deploymentToTerminalPipelineResult,
+  findCurrentDeploymentAsync,
+  findDeploymentBestEffort,
+  findDeploymentByName,
+  findDeploymentsByName,
+  findDeploymentsByPackageName,
+  findLiveDeploymentByName,
+  formatExistingDeployments,
+  httpStatusOf,
+  interpretFailedDeployPoll,
+  isCompletedUninstall,
+  isPipelineDeploymentNotFoundError,
+  mapOperationStatusToPipelineStatus,
+  newestDeploymentRow,
+  resolveInstalledFolder
+};
+
+//# debugId=EE2A815D94C3F5D164756E2164756E21