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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +2 -2
  2. package/dist/THIRD-PARTY-NOTICES.md +4 -4
  3. package/dist/deploy-delete-service-gg00vadc.js +22 -0
  4. package/dist/deploy-status-service-cqfrvxpz.js +256 -0
  5. package/dist/deploy.d.ts +11 -4
  6. package/dist/deploy.js +19 -7
  7. package/dist/deployment-search-j34w33b2.js +49 -0
  8. package/dist/{embedded-file-reader-xxqe8vs8.js → embedded-file-reader-rf2g1kfj.js} +2 -2
  9. package/dist/feed-resolver-31gcvnnk.js +27 -0
  10. package/dist/feed-scope-failure-fwtdvvrh.js +18 -0
  11. package/dist/feed-session-sxga31vn.js +17 -0
  12. package/dist/index.js +27 -18
  13. package/dist/init.js +10 -7
  14. package/dist/{list-xjdnbyka.js → list-q4dzkv45.js} +9 -6
  15. package/dist/pack.js +14 -11
  16. package/dist/{packager-tool-7qmx64kz.js → packager-tool-00vh1ktg.js} +1022 -1342
  17. package/dist/packager-tool-1phh2rfx.js +37 -0
  18. package/dist/{packager-tool-vas0xg5h.js → packager-tool-2cntqvdv.js} +5 -3
  19. package/dist/{packager-tool-1haahq17.js → packager-tool-3enm2h28.js} +5 -5
  20. package/dist/{packager-tool-2syrt51a.js → packager-tool-3fv6zc86.js} +1062 -825
  21. package/dist/{packager-tool-grtmkd54.js → packager-tool-3m36mxn7.js} +16 -74
  22. package/dist/packager-tool-40vcj4wv.js +172 -0
  23. package/dist/packager-tool-482eg22x.js +322 -0
  24. package/dist/{packager-tool-k4mskzww.js → packager-tool-5dzjsw5q.js} +3 -3
  25. package/dist/{packager-tool-0f0wt9vh.js → packager-tool-5fjp60dk.js} +3071 -2794
  26. package/dist/{packager-tool-bkwnetqn.js → packager-tool-83rzavkx.js} +383 -88
  27. package/dist/{packager-tool-f423v35w.js → packager-tool-9hj0cfd0.js} +756 -359
  28. package/dist/{packager-tool-7znqtw3f.js → packager-tool-9vvdgbay.js} +8 -6
  29. package/dist/packager-tool-bqre28m1.js +43 -0
  30. package/dist/packager-tool-f5gq77m5.js +28 -0
  31. package/dist/{packager-tool-nzghfa48.js → packager-tool-fv7xyzg2.js} +550 -2
  32. package/dist/{packager-tool-3jrq7smt.js → packager-tool-gb35b4qs.js} +206 -289
  33. package/dist/{packager-tool-4kdt8mys.js → packager-tool-j30xck4w.js} +1008 -647
  34. package/dist/packager-tool-ks8spnq8.js +166 -0
  35. package/dist/packager-tool-q3tgpemc.js +113 -0
  36. package/dist/packager-tool-qdtjywsk.js +173 -0
  37. package/dist/{packager-tool-2p5yh1q9.js → packager-tool-qgaqqq41.js} +320 -151
  38. package/dist/packager-tool-qm24rbae.js +5889 -0
  39. package/dist/{packager-tool-resolver-fmjr60x8.js → packager-tool-resolver-2cbxyq6k.js} +6 -5
  40. package/dist/{packager-tool-znakt6yw.js → packager-tool-vh4ng74p.js} +8 -6
  41. package/dist/packager-tool-vmsxq1pc.js +104 -0
  42. package/dist/packager-tool-zf3929se.js +237 -0
  43. package/dist/packager-tool-zns6n8zp.js +837 -0
  44. package/dist/packager-tool.js +2 -2
  45. package/dist/prepare-solution-resources-p3gzdecy.js +25 -0
  46. package/dist/{project-contributions-cvttys34.js → project-contributions-txe8v6sm.js} +12 -9
  47. package/dist/publish.js +12 -7
  48. package/dist/resource.js +9 -6
  49. package/dist/services/activation.d.ts +17 -2
  50. package/dist/services/deploy-activate-service.d.ts +10 -0
  51. package/dist/services/deploy-delete-service.d.ts +82 -0
  52. package/dist/services/deploy-list-service.d.ts +15 -45
  53. package/dist/services/deploy-run-service.d.ts +36 -23
  54. package/dist/services/deploy-upgrade-service.d.ts +198 -39
  55. package/dist/services/deployment-feed-locator.d.ts +50 -12
  56. package/dist/services/deployment-search-client.d.ts +55 -0
  57. package/dist/services/deployment-search.d.ts +87 -34
  58. package/dist/services/deployment-state.d.ts +119 -0
  59. package/dist/services/feed-resolver.d.ts +31 -0
  60. package/dist/services/feed-session.d.ts +70 -0
  61. package/dist/services/folder-helper.d.ts +4 -27
  62. package/dist/services/http-status.d.ts +9 -0
  63. package/dist/services/incomplete-feed-sweep.d.ts +77 -0
  64. package/dist/services/legacy-deployment-search-v3.d.ts +23 -0
  65. package/dist/services/packages-list-service.d.ts +5 -0
  66. package/dist/services/pipeline-deploy-poll.d.ts +69 -0
  67. package/dist/services/publish-service.d.ts +14 -16
  68. package/dist/services/search-failure.d.ts +27 -0
  69. package/dist/templates/AGENTS.md +60 -20
  70. package/dist/tool.js +27 -18
  71. package/dist/utils/deployment-errors.d.ts +57 -0
  72. package/package.json +2 -2
  73. package/dist/packager-tool-jz2wbfjz.js +0 -2275
  74. package/dist/packager-tool-wtpe9285.js +0 -51960
  75. package/dist/prepare-solution-resources-wds3r8bq.js +0 -22
  76. package/dist/services/personal-workspace-deploy.d.ts +0 -49
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  registerPackagerFactories
3
- } from "./packager-tool-jz2wbfjz.js";
4
- import"./packager-tool-nzghfa48.js";
3
+ } from "./packager-tool-zns6n8zp.js";
4
+ import"./packager-tool-fv7xyzg2.js";
5
5
  import"./packager-tool-dfrk01gn.js";
6
6
  import"./packager-tool-1de529jm.js";
7
7
  export {
@@ -0,0 +1,25 @@
1
+ import {
2
+ prepareSolutionResources,
3
+ projectSubTypesFrom
4
+ } from "./packager-tool-9vvdgbay.js";
5
+ import"./packager-tool-vh4ng74p.js";
6
+ import"./packager-tool-5dzjsw5q.js";
7
+ import"./packager-tool-zns6n8zp.js";
8
+ import"./packager-tool-83rzavkx.js";
9
+ import"./packager-tool-gdtpsdn7.js";
10
+ import"./packager-tool-53w8skv5.js";
11
+ import"./packager-tool-fv7xyzg2.js";
12
+ import"./packager-tool-f5gq77m5.js";
13
+ import"./packager-tool-3fv6zc86.js";
14
+ import"./packager-tool-vmsxq1pc.js";
15
+ import"./packager-tool-5fjp60dk.js";
16
+ import"./packager-tool-gb35b4qs.js";
17
+ import"./packager-tool-zf3929se.js";
18
+ import"./packager-tool-dfrk01gn.js";
19
+ import"./packager-tool-1de529jm.js";
20
+ export {
21
+ prepareSolutionResources,
22
+ projectSubTypesFrom
23
+ };
24
+
25
+ //# debugId=CC58EF007B28349F64756E2164756E21
@@ -4,16 +4,19 @@ import {
4
4
  assertNoContributionErrors,
5
5
  collectProjectContributions,
6
6
  contributionErrorMessages
7
- } from "./packager-tool-znakt6yw.js";
8
- import"./packager-tool-k4mskzww.js";
9
- import"./packager-tool-jz2wbfjz.js";
10
- import"./packager-tool-bkwnetqn.js";
7
+ } from "./packager-tool-vh4ng74p.js";
8
+ import"./packager-tool-5dzjsw5q.js";
9
+ import"./packager-tool-zns6n8zp.js";
10
+ import"./packager-tool-83rzavkx.js";
11
11
  import"./packager-tool-gdtpsdn7.js";
12
12
  import"./packager-tool-53w8skv5.js";
13
- import"./packager-tool-nzghfa48.js";
14
- import"./packager-tool-2syrt51a.js";
15
- import"./packager-tool-3jrq7smt.js";
16
- import"./packager-tool-0f0wt9vh.js";
13
+ import"./packager-tool-fv7xyzg2.js";
14
+ import"./packager-tool-f5gq77m5.js";
15
+ import"./packager-tool-3fv6zc86.js";
16
+ import"./packager-tool-vmsxq1pc.js";
17
+ import"./packager-tool-5fjp60dk.js";
18
+ import"./packager-tool-gb35b4qs.js";
19
+ import"./packager-tool-zf3929se.js";
17
20
  import"./packager-tool-dfrk01gn.js";
18
21
  import"./packager-tool-1de529jm.js";
19
22
  export {
@@ -24,4 +27,4 @@ export {
24
27
  contributionErrorMessages
25
28
  };
26
29
 
27
- //# debugId=5BEB743E097B870464756E2164756E21
30
+ //# debugId=2A52F40C3341481B64756E2164756E21
package/dist/publish.js CHANGED
@@ -1,15 +1,20 @@
1
1
  import {
2
2
  publishSolutionAsync
3
- } from "./packager-tool-grtmkd54.js";
4
- import"./packager-tool-2p5yh1q9.js";
5
- import"./packager-tool-7qmx64kz.js";
6
- import"./packager-tool-2syrt51a.js";
7
- import"./packager-tool-3jrq7smt.js";
8
- import"./packager-tool-0f0wt9vh.js";
3
+ } from "./packager-tool-3m36mxn7.js";
4
+ import"./packager-tool-qgaqqq41.js";
5
+ import"./packager-tool-qdtjywsk.js";
6
+ import"./packager-tool-00vh1ktg.js";
7
+ import"./packager-tool-bqre28m1.js";
8
+ import"./packager-tool-f5gq77m5.js";
9
+ import"./packager-tool-3fv6zc86.js";
10
+ import"./packager-tool-vmsxq1pc.js";
11
+ import"./packager-tool-5fjp60dk.js";
12
+ import"./packager-tool-gb35b4qs.js";
13
+ import"./packager-tool-zf3929se.js";
9
14
  import"./packager-tool-dfrk01gn.js";
10
15
  import"./packager-tool-1de529jm.js";
11
16
  export {
12
17
  publishSolutionAsync
13
18
  };
14
19
 
15
- //# debugId=C6A6B2A4D9E3236B64756E2164756E21
20
+ //# debugId=53632877CEAF58FA64756E2164756E21
package/dist/resource.js CHANGED
@@ -1,16 +1,19 @@
1
1
  import {
2
2
  resourceRefreshAsync
3
- } from "./packager-tool-bkwnetqn.js";
3
+ } from "./packager-tool-83rzavkx.js";
4
4
  import"./packager-tool-gdtpsdn7.js";
5
5
  import"./packager-tool-53w8skv5.js";
6
- import"./packager-tool-nzghfa48.js";
7
- import"./packager-tool-2syrt51a.js";
8
- import"./packager-tool-3jrq7smt.js";
9
- import"./packager-tool-0f0wt9vh.js";
6
+ import"./packager-tool-fv7xyzg2.js";
7
+ import"./packager-tool-f5gq77m5.js";
8
+ import"./packager-tool-3fv6zc86.js";
9
+ import"./packager-tool-vmsxq1pc.js";
10
+ import"./packager-tool-5fjp60dk.js";
11
+ import"./packager-tool-gb35b4qs.js";
12
+ import"./packager-tool-zf3929se.js";
10
13
  import"./packager-tool-dfrk01gn.js";
11
14
  import"./packager-tool-1de529jm.js";
12
15
  export {
13
16
  resourceRefreshAsync
14
17
  };
15
18
 
16
- //# debugId=EF371AE5DDFD388A64756E2164756E21
19
+ //# debugId=95E0C3E4B3A79D3C64756E2164756E21
@@ -1,6 +1,7 @@
1
- import { type PollUntilResult } from "@uipath/common";
1
+ import { type CliErrorCode, type PollUntilResult, type RetryHint } from "@uipath/common";
2
2
  import type { DeploymentStatus } from "@uipath/pipelines-sdk";
3
- import type { DeploymentSearchItemDto2, InitOverrideFunction, SolutionAuthContext } from "@uipath/solution-sdk";
3
+ import type { DeploymentSearchItemDto2, InitOverrideFunction } from "@uipath/solution-sdk";
4
+ import type { SolutionAuthContext } from "@uipath/solution-sdk/auth";
4
5
  export type ActivationOptions = {
5
6
  timeoutSeconds: number;
6
7
  pollIntervalMs: number;
@@ -22,6 +23,20 @@ export type ActivationResult =
22
23
  phase: "preActivateSteps" | "activate";
23
24
  message: string;
24
25
  details: string;
26
+ /**
27
+ * The request's own classification. A caller that replaces the
28
+ * message needs it to tell a refusal about the name or feed (404,
29
+ * 400) from auth, permission, throttling, network and server
30
+ * failures, which stand on their own.
31
+ */
32
+ errorCode: CliErrorCode;
33
+ retry: RetryHint;
34
+ /**
35
+ * The HTTP status the request failed with, when it had one. Tells
36
+ * the 400 a name or feed gets from a 409 or 422, which share
37
+ * `invalid_argument` with it.
38
+ */
39
+ httpStatus?: number;
25
40
  deployment?: DeploymentSearchItemDto2;
26
41
  }
27
42
  /** Activation API returned no instance id — completed without polling. */
@@ -1,3 +1,4 @@
1
+ import { type CliErrorCode, type RetryHint } from "@uipath/common";
1
2
  export type ActivateDeploymentFailureReason = "auth_failed"
2
3
  /** Activation HTTP request failed (e.g. unknown deployment name). */
3
4
  | "request_failed"
@@ -36,6 +37,15 @@ export interface ActivateDeploymentFailure {
36
37
  message: string;
37
38
  instructions: string;
38
39
  exitCode: number;
40
+ /**
41
+ * Set only when the service knows better than the formatter's guess from
42
+ * the message — today, a refusal that followed a feed sweep which could
43
+ * not ask every feed: the sweep's classification for a refusal about the
44
+ * name or feed, the request's own for any other. Absent everywhere else,
45
+ * as before.
46
+ */
47
+ errorCode?: CliErrorCode;
48
+ retry?: RetryHint;
39
49
  }
40
50
  export type ActivateDeploymentResult = ActivateDeploymentSuccess | ActivateDeploymentFailure;
41
51
  /**
@@ -0,0 +1,82 @@
1
+ import { type CliErrorCode, type RetryHint } from "@uipath/common";
2
+ export type DeleteDeploymentFailureReason = "auth_failed"
3
+ /**
4
+ * No deployment with that name in the tenant feed or any feed swept after
5
+ * it — and every one of those feeds answered.
6
+ */
7
+ | "deployment_not_found"
8
+ /**
9
+ * The feed sweep found nothing while a feed it had to ask could not be
10
+ * searched — the tenant feed included, whose failure ends the sweep. Kept
11
+ * apart from `deployment_not_found` so a caller branching on the reason
12
+ * does not read "no such deployment" out of a network failure; the
13
+ * `errorCode`/`retry` carry the real cause.
14
+ */
15
+ | "lookup_failed"
16
+ /**
17
+ * The record's own `actions` list does not offer `Delete` — an operation is
18
+ * still running, or the deployment has to be uninstalled first.
19
+ */
20
+ | "delete_unavailable"
21
+ /** The DELETE request itself failed. */
22
+ | "delete_request_failed";
23
+ export interface DeleteDeploymentOptions {
24
+ /**
25
+ * Override the active tenant for auth resolution. The CLI's deprecated
26
+ * `--tenant` flag flows through here; library callers usually omit it.
27
+ */
28
+ tenant?: string;
29
+ /** Pin auth to this exact `.uipath/.auth` path. */
30
+ envFilePath?: string;
31
+ /** Minimum minutes before token expiration to trigger a refresh. Default 10. */
32
+ loginValidity?: number;
33
+ }
34
+ export interface DeleteDeploymentSuccess {
35
+ ok: true;
36
+ deploymentName: string;
37
+ deploymentKey: string;
38
+ }
39
+ export interface DeleteDeploymentFailure {
40
+ ok: false;
41
+ reason: DeleteDeploymentFailureReason;
42
+ message: string;
43
+ instructions: string;
44
+ exitCode: number;
45
+ errorCode?: CliErrorCode;
46
+ retry?: RetryHint;
47
+ }
48
+ export type DeleteDeploymentResult = DeleteDeploymentSuccess | DeleteDeploymentFailure;
49
+ /**
50
+ * Programmatic core of `uip solution deploy delete` (UV-16671, UV-16341).
51
+ *
52
+ * Calls `DELETE /api/deployments/{key}`, which the CLI never reached before:
53
+ * the SDK generator kept only `get` for that path, so the route looked absent
54
+ * and both tickets were read as a platform gap.
55
+ *
56
+ * Delete is not a second name for uninstall. `deploy uninstall` removes the
57
+ * provisioned resources and the solution folder of a live deployment, and
58
+ * Orchestrator refuses it (error `4007`) once the deployment is superseded,
59
+ * inactive, or left behind by a failed install — the states that leave a
60
+ * record only the Orchestrator Solutions UI could remove.
61
+ *
62
+ * The AS spec documents this operation with no summary and no description, so
63
+ * the states below come from a live staging tenant (2026-09-21) rather than
64
+ * from the contract:
65
+ *
66
+ * - **Installed**: a successful install (`ActivationStatus:
67
+ * NeedsSetupToActivate`) lists `[SetupActivation, Uninstall, Upgrade]` —
68
+ * no `Delete`. The CLI therefore cannot strand a live deployment's
69
+ * resources through this route, and the check below is what turns that
70
+ * refusal into the uninstall-first instruction.
71
+ * - **Uninstalled**: the record stays, with `Operation: Uninstall`,
72
+ * `ActivationStatus: None` and `Actions: [Delete]`. This is the state
73
+ * UV-16671 reports as removable only from the browser.
74
+ * - **Never installed**: a `Draft` record lists `[Install, Delete]` and
75
+ * deletes the same way (the UV-16341 shape).
76
+ *
77
+ * In every accepted case the server answers 204 and the row leaves
78
+ * `deploy list` immediately.
79
+ *
80
+ * Does not touch `OutputFormatter`/`processContext`.
81
+ */
82
+ export declare function deleteDeploymentAsync(deploymentName: string, options?: DeleteDeploymentOptions): Promise<DeleteDeploymentResult>;
@@ -1,80 +1,51 @@
1
- /**
2
- * Per-deployment row in {@link ListDeploymentsSuccess.deployments}. Mirrors
3
- * the SDK fields the CLI emits; string-enums widened to `string`/`string[]`
4
- * so the published `.d.ts` stays off the SDK's const-enum types.
5
- */
1
+ import { type CliErrorCode, type ErrorContext, type RetryHint } from "@uipath/common";
2
+ /** Enums are widened to `string` so the published `.d.ts` stays off the SDK's const enums. */
6
3
  export interface DeploymentSummary {
7
4
  key: string;
8
5
  installDeploymentKey: string;
9
6
  name: string;
10
7
  packageName: string;
11
8
  packageVersion: string;
12
- /** Version the deployment currently runs. Absent until a version is installed. */
9
+ /** Absent until a version is installed. */
13
10
  currentPackageVersion?: string | null;
14
- /** Version a pending in-place upgrade targets. Differs from `currentPackageVersion` when an upgrade is queued. */
11
+ /** Differs from `currentPackageVersion` while an upgrade is queued. */
15
12
  targetPackageVersion?: string | null;
16
- /** A newer published version, when one exists — the upgrade the deployment can move to. */
17
13
  newPackageVersionAvailable?: string | null;
18
- /** The last/pending deployment operation (e.g. `Install`, `VersionChange`). */
19
14
  operation: string;
20
15
  operationStatus: string;
21
16
  activationStatus: string;
22
17
  folderPath?: string | null;
23
18
  installedRootFolderKey?: string | null;
24
19
  deploymentCreationTime: Date;
25
- /** Pending workflow actions (e.g. `Upgrade`) — a queued in-place upgrade shows `["Upgrade"]`. */
26
20
  actions: string[];
27
21
  }
28
- export type ListDeploymentsFailureReason = "auth_failed" | "folder_resolution_failed" | "feed_resolution_failed" | "list_request_failed";
29
- /** Local mirror of solution-sdk's `OrderByDirection`; declared here so the `.d.ts` stays off the SDK type. */
22
+ export type ListDeploymentsFailureReason = "auth_failed" | "folder_resolution_failed" | "feed_resolution_failed" | "feed_requires_user_session" | "list_request_failed";
23
+ /** Mirrors the SDK's `OrderByDirection` so the `.d.ts` stays off the SDK type. */
30
24
  export type SortDirection = "Ascending" | "Descending";
31
25
  export interface ListDeploymentsOptions {
32
- /** Override the active tenant for auth + folder-lookup. The CLI's deprecated `--tenant` flag flows through here. */
33
26
  tenant?: string;
34
- /** Pin auth (+ folder lookup) to this exact `.uipath/.auth` path. */
35
27
  envFilePath?: string;
36
- /** Filter by parent folder path (e.g., `"Shared"`). Post-fetch substring match. */
28
+ /** Exact, case-insensitive full-path match on the parent folder; subfolders are not included. */
37
29
  folderPath?: string;
38
- /** Filter by parent folder key (GUID). Alternative to {@link folderPath}. */
39
30
  folderKey?: string;
40
- /** Scope the list to the caller's own Personal Workspace feed. */
41
31
  personalWorkspace?: boolean;
42
- /** Scope the list to a feed by name or folder key. Mutually exclusive with `personalWorkspace`. */
32
+ /** Feed name or folder key. Mutually exclusive with `personalWorkspace`. */
43
33
  feed?: string;
44
- /** Max deployments to fetch. Default `DEFAULT_PAGE_SIZE`. */
45
34
  limit?: number;
46
- /** Number of deployments to skip before the first fetched row (pre-filter). Default 0. */
47
35
  offset?: number;
48
- /** Column to sort by. Default `"startTime"`. */
49
36
  sortBy?: string;
50
- /** Sort direction. Default `"Descending"`. */
51
37
  sortOrder?: SortDirection;
52
- /**
53
- * Filter to these deployment operation statuses (e.g. `"InProgress"`).
54
- * Sent to the search request's `operationStatuses` array — filters
55
- * server-side, unlike {@link folderPath}.
56
- */
57
38
  operationStatuses?: string[];
58
- /**
59
- * Filter to these deployment activation statuses (e.g. `"Active"`).
60
- * Sent to the search request's `activationStatuses` array — filters
61
- * server-side, unlike {@link folderPath}.
62
- */
63
39
  activationStatuses?: string[];
64
- /** Minimum minutes before token expiration to trigger a refresh. Default 10. */
40
+ /** Refresh the token when it expires within this many minutes. Default 10. */
65
41
  loginValidity?: number;
66
42
  }
67
43
  export interface ListDeploymentsSuccess {
68
44
  ok: true;
69
45
  deployments: DeploymentSummary[];
70
- /** Echo of the request limit so callers can render pagination UI without re-deriving. */
71
46
  limit: number;
72
- /** Echo of the request offset. */
73
47
  offset: number;
74
- /** Total deployments on the server, pre folder filtering.
75
- * `undefined` when the response omits `count` — the SDK deserializer has
76
- * no fallback for it. `Pagination` then derives `HasMore` from
77
- * `returned === limit`. */
48
+ /** Filtered count; `undefined` when the response omits `count`. */
78
49
  total?: number;
79
50
  }
80
51
  export interface ListDeploymentsFailure {
@@ -83,12 +54,11 @@ export interface ListDeploymentsFailure {
83
54
  message: string;
84
55
  instructions: string;
85
56
  exitCode: number;
57
+ /** Set when the failure mode is known; the formatter infers one otherwise. */
58
+ errorCode?: CliErrorCode;
59
+ retry?: RetryHint;
60
+ context?: ErrorContext;
86
61
  }
87
62
  export type ListDeploymentsResult = ListDeploymentsSuccess | ListDeploymentsFailure;
88
- /**
89
- * Programmatic core of `uip solution deploy list`. Returns a tagged
90
- * {@link ListDeploymentsResult}; does not touch `OutputFormatter`/`processContext`.
91
- * Folder filtering is post-fetch (search API has no folder filter), so
92
- * `deployments.length` may be less than `limit`.
93
- */
63
+ /** Core of `uip solution deploy list`; returns a result and never writes output. */
94
64
  export declare function listDeploymentsAsync(options?: ListDeploymentsOptions): Promise<ListDeploymentsResult>;
@@ -1,12 +1,24 @@
1
1
  import { type CliErrorCode, type RetryHint } from "@uipath/common";
2
+ import { type PendingResource } from "./deployment-state";
2
3
  import { type FeedScope } from "./feed-resolver";
3
4
  /** Discriminator for {@link DeployFailure}; library callers can ignore the tag and read `.message`/`.instructions`. */
4
- export type DeployFailureReason = "auth_failed" | "folder_resolution_failed" | "config_file_not_found" | "config_file_read_failed" | "config_file_parse_failed" | "install_request_failed"
5
- /** Personal Workspace deploy via AS auto-install failed (publish first, then retry). */
5
+ export type DeployFailureReason = "auth_failed"
6
+ /**
7
+ * A feed or Personal Workspace deploy under an external app. The server
8
+ * applies the feed header to user-token requests only, so the install
9
+ * would silently land on the tenant feed.
10
+ */
11
+ | "feed_requires_user_session" | "folder_resolution_failed" | "config_file_not_found" | "config_file_read_failed" | "config_file_parse_failed" | "install_request_failed"
12
+ /**
13
+ * The name's newest generation is a pending draft for another version (an
14
+ * attempt that never completed), and the install route will not deploy past it.
15
+ */
16
+ | "pending_draft"
17
+ /** Personal Workspace install request refused by the server (publish first, then retry). */
6
18
  | "personal_workspace_deploy_failed"
7
19
  /** A --feed value couldn't be resolved to a selectable feed. */
8
20
  | "feed_resolution_failed"
9
- /** Folder-feed deploy via AS auto-install failed (publish to the feed first, then retry). */
21
+ /** Folder-feed install request refused by the server (publish to the feed first, then retry). */
10
22
  | "feed_deploy_failed"
11
23
  /** The requested deploy location isn't the feed folder or one of its descendants. */
12
24
  | "location_outside_feed"
@@ -16,10 +28,6 @@ export type DeployFailureReason = "auth_failed" | "folder_resolution_failed" | "
16
28
  * place instead of redeployed.
17
29
  */
18
30
  | "deployment_exists"
19
- /** Recovery: deployment completed but flagged "Needs Setup" — manual config required before activation. */
20
- | "needs_setup_to_activate"
21
- /** Recovery: deployment completed, ready to activate — auto-activation didn't run. */
22
- | "ready_to_activate"
23
31
  /** Recovery: deployment completed but activation failed (terminal). */
24
32
  | "activation_failed_post_deploy"
25
33
  /** Recovery or final-status: the deploy itself failed (e.g. ValidationFailed). */
@@ -64,9 +72,8 @@ export interface DeployOptions {
64
72
  /** Minimum minutes before token expiration to trigger a refresh. Default 10. */
65
73
  loginValidity?: number;
66
74
  /**
67
- * Feed / Personal Workspace deploys only: poll the new deployment to a
68
- * terminal state instead of returning as soon as the install is accepted.
69
- * The tenant path always polls, so this changes nothing there.
75
+ * @deprecated Ignored. Every deploy now polls the Pipelines install to a
76
+ * terminal state; kept so existing callers keep compiling.
70
77
  */
71
78
  wait?: boolean;
72
79
  /** Skip auto-activation; leave deployment in "Inactive (Ready to activate)" state. */
@@ -83,16 +90,11 @@ export interface DeployOptions {
83
90
  }
84
91
  export interface DeploySuccess {
85
92
  ok: true;
86
- /**
87
- * Tenant path: `"DeploymentSucceeded"` after polling reaches terminal.
88
- * Feed/PW path: `"DeploymentStarted"` — the AS auto-install endpoint
89
- * returns at request acceptance, before terminal state is observable — or
90
- * `"DeploymentSucceeded"` when `wait` was set and the poll got there.
91
- */
93
+ /** Terminal Pipelines status — `"DeploymentSucceeded"` on every path. */
92
94
  status: string;
93
- /** Tenant only — populated from Pipelines install result. Feed/PW returns no key. */
95
+ /** From the Pipelines status result. */
94
96
  deploymentKey?: string | null;
95
- /** Tenant only — Pipelines deployment id. Undefined for feed/PW (no Pipelines call). */
97
+ /** Pipelines deployment id — what `deploy status <id>` reads. */
96
98
  pipelineDeploymentId?: string;
97
99
  /** Allows `null` so `"InstanceId": null` reaches JSON output when the SDK reports null. */
98
100
  instanceId?: string | null;
@@ -106,18 +108,29 @@ export interface DeploySuccess {
106
108
  * caller can see both.
107
109
  */
108
110
  requestedFolderName?: string;
109
- /** "SuccessfulActivate" | "Skipped" | "NoInstance" — short canonical token. Feed/PW path emits `"Auto"` (server-side activation) or `"Skipped"`. */
111
+ /**
112
+ * `"SuccessfulActivate"` when the deployment runs, `"Skipped"` for
113
+ * `--skip-activate`, `"NoInstance"` when activation reported no instance
114
+ * — or the record's own `NeedsSetupToActivate` / `ReadyToActivate` when
115
+ * the install landed and the deployment is not live: the deploy itself
116
+ * succeeded, so that is a success that says what is left (STUD-81555).
117
+ */
110
118
  activationStatus: string;
119
+ /**
120
+ * The resources the deployment waits for, when it needs setup and the
121
+ * read succeeded. Absent otherwise; `nextSteps` says when the read failed.
122
+ */
123
+ pendingResources?: PendingResource[];
124
+ /** What is left before the deployment runs. Absent when nothing is. */
125
+ nextSteps?: string[];
111
126
  /** Feed/PW only — the caller-chosen deployment name (`--name`). */
112
127
  deploymentName?: string;
113
128
  /** Feed/PW only — package name as deployed. */
114
129
  packageName?: string;
115
130
  /** Feed/PW only — package version as deployed. */
116
131
  packageVersion?: string;
117
- /** Feed/PW only — future-tense human guidance ("Check status with..."). */
118
- nextSteps?: string;
119
- /** Which feed the deploy targeted — drives telemetry `target`. Defaults to tenant. */
120
- feedKind?: FeedScope["kind"];
132
+ /** Which feed the deploy targeted — drives telemetry `target`. */
133
+ feedKind: FeedScope["kind"];
121
134
  }
122
135
  export interface DeployFailure {
123
136
  ok: false;