@uipath/solution-sdk 1.200.0-preview.120 → 1.201.0-preview.121

package/dist/solution-auth.js

@@ -30,6 +30,19 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
@@ -417,6 +430,12 @@ var init_is_in_ssh = __esm(() => {
 });
 
 // ../../node_modules/open/index.js
+var exports_open = {};
+__export(exports_open, {
+  openApp: () => openApp,
+  default: () => open_default,
+  apps: () => apps
+});
 import process8 from "node:process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -650,6 +669,21 @@ var fallbackAttemptSymbol, __dirname2, localXdgOpenPath, platform, arch, tryEach
     ...options,
     target
   });
+}, openApp = (name, options) => {
+  if (typeof name !== "string" && !Array.isArray(name)) {
+    throw new TypeError("Expected a valid `name`");
+  }
+  const { arguments: appArguments = [] } = options ?? {};
+  if (appArguments !== undefined && appArguments !== null && !Array.isArray(appArguments)) {
+    throw new TypeError("Expected `appArguments` as Array type");
+  }
+  return baseOpen({
+    ...options,
+    app: {
+      name,
+      arguments: appArguments
+    }
+  });
 }, apps, open_default;
 var init_open = __esm(() => {
   init_wsl_utils();
@@ -729,7 +763,8 @@ class NodeFileSystem {
   };
   utils = {
     open: async (url) => {
-      await open_default(url);
+      const { default: open2 } = await Promise.resolve().then(() => (init_open(), exports_open));
+      await open2(url);
     }
   };
   async readFile(path3, options) {
@@ -924,9 +959,7 @@ class NodeFileSystem {
   }
 }
 var LOCK_HEARTBEAT_MS = 5000, LOCK_STALE_MS = 15000, LOCK_MAX_WAIT_MS = 20000, LOCK_MAX_HOLD_MS = 60000, LOCK_RETRY_MIN_MS = 100, LOCK_RETRY_JITTER_MS = 200;
-var init_node = __esm(() => {
-  init_open();
-});
+var init_node = () => {};
 // ../filesystem/src/index.ts
 var fsInstance, getFileSystem = () => fsInstance;
 var init_src = __esm(() => {
@@ -934,10 +967,6 @@ var init_src = __esm(() => {
   init_node();
   fsInstance = new NodeFileSystem;
 });
-// ../auth/src/server.ts
-var init_server = __esm(() => {
-  init_constants();
-});
 
 // ../auth/src/config.ts
 init_constants();
@@ -1177,6 +1206,67 @@ var getTokenExpiration = (accessToken) => {
   }
 };
 
+// ../auth/src/sessionIdentity.ts
+var parseAuthFlow = (value) => value === "authorization_code" || value === "client_credentials" || value === "federated_credentials" ? value : undefined;
+var decodeClaims = (accessToken) => {
+  const [error, claims] = catchError(() => parseJWT(accessToken));
+  return error ? undefined : claims;
+};
+var asString = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
+var resolveIdentityType = (claims, authFlow, email) => {
+  const subType = asString(claims?.sub_type);
+  if (subType) {
+    return subType.startsWith("service") ? "Application" : "User";
+  }
+  if (authFlow) {
+    return authFlow === "authorization_code" ? "User" : "Application";
+  }
+  if (email)
+    return "User";
+  if (asString(claims?.client_id) && !asString(claims?.sub)) {
+    return "Application";
+  }
+  return;
+};
+var looksLikeEmail = (value) => value?.includes("@") ?? false;
+var pickEmail = (claims) => {
+  for (const candidate of [claims?.email, claims?.preferred_username]) {
+    const value = asString(candidate);
+    if (looksLikeEmail(value))
+      return value;
+  }
+  return;
+};
+var pickName = (claims) => {
+  const username = asString(claims?.preferred_username);
+  return asString(claims?.name) ?? (looksLikeEmail(username) ? undefined : username);
+};
+var resolveSessionIdentity = (accessToken, authFlow) => {
+  const claims = accessToken ? decodeClaims(accessToken) : undefined;
+  const email = pickEmail(claims);
+  const type = resolveIdentityType(claims, authFlow, email);
+  if (!type)
+    return;
+  const identity = { type };
+  if (authFlow)
+    identity.authFlow = authFlow;
+  if (type === "User") {
+    const userId = asString(claims?.sub);
+    if (userId)
+      identity.userId = userId;
+    if (email)
+      identity.userEmail = email;
+    const name = pickName(claims);
+    if (name)
+      identity.userName = name;
+    return identity;
+  }
+  const clientId = asString(claims?.client_id);
+  if (clientId)
+    identity.clientId = clientId;
+  return identity;
+};
+
 // ../auth/src/envAuth.ts
 var ENV_AUTH_ENABLE_VAR = "UIPATH_CLI_ENABLE_ENV_AUTH";
 var ENFORCE_ROBOT_AUTH_VAR = "UIPATH_CLI_ENFORCE_ROBOT_AUTH";
@@ -1226,6 +1316,7 @@ var readAuthFromEnv = () => {
   }
   const expiration = getTokenExpiration(accessToken);
   const loginStatus = expiration && expiration <= new Date ? "Expired" : "Logged in";
+  const identity = resolveSessionIdentity(accessToken);
   return {
     loginStatus,
     accessToken,
@@ -1235,7 +1326,8 @@ var readAuthFromEnv = () => {
     tenantName,
     tenantId,
     expiration,
-    source: "env" /* Env */
+    source: "env-vars" /* EnvironmentVariables */,
+    ...identity ? { identity } : {}
   };
 };
 
@@ -1488,6 +1580,9 @@ var refreshAccessToken = async ({
   return { accessToken: newAccessToken, refreshToken: newRefreshToken };
 };
 
+// ../auth/src/types.ts
+var AUTH_FLOW_ENV_VAR = "UIPATH_AUTH_FLOW";
+
 // ../auth/src/utils/envFile.ts
 init_src();
 init_constants();
@@ -1855,7 +1950,8 @@ async function buildFileStatus(tokens, credentials, globalHint) {
     tenantName: credentials.UIPATH_TENANT_NAME,
     tenantId: credentials.UIPATH_TENANT_ID,
     expiration: tokens.expiration,
-    source: "file" /* File */,
+    source: "saved-login" /* SavedLogin */,
+    ...identityFields(tokens.accessToken, credentials),
     ...tokens.persistenceWarning ? { hint: tokens.persistenceWarning, persistenceFailed: true } : {},
     ...tokens.lockReleaseFailed ? { lockReleaseFailed: true } : {},
     ...tokens.tokenRefresh ? { tokenRefresh: tokens.tokenRefresh } : {}
@@ -1868,7 +1964,12 @@ async function buildFileStatus(tokens, credentials, globalHint) {
   }
   return result;
 }
+function identityFields(accessToken, credentials) {
+  const identity = resolveSessionIdentity(accessToken, parseAuthFlow(credentials[AUTH_FLOW_ENV_VAR]));
+  return identity ? { identity } : {};
+}
 function buildRobotStatus(robotCreds) {
+  const identity = resolveSessionIdentity(robotCreds.accessToken);
   return {
     loginStatus: "Logged in",
     accessToken: robotCreds.accessToken,
@@ -1879,7 +1980,8 @@ function buildRobotStatus(robotCreds) {
     tenantId: robotCreds.tenantId,
     issuer: robotCreds.issuer,
     expiration: getTokenExpiration(robotCreds.accessToken),
-    source: "robot" /* Robot */
+    source: "robot" /* Robot */,
+    ...identity ? { identity } : {}
   };
 }
 var isFileNotFoundError = (error) => {
@@ -1930,7 +2032,8 @@ async function circuitBreakerShortCircuit(ctx) {
       tenantName: credentials.UIPATH_TENANT_NAME,
       tenantId: credentials.UIPATH_TENANT_ID,
       expiration,
-      source: "file" /* File */
+      source: "saved-login" /* SavedLogin */,
+      ...identityFields(accessToken, credentials)
     } : {},
     hint: globalHint ?? (tokenIsDead ? deadHint : backoffHint),
     refreshCircuitOpen: true,
@@ -1952,7 +2055,8 @@ async function lockAcquireFailureStatus(ctx, error) {
       tenantName: ctx.credentials.UIPATH_TENANT_NAME,
       tenantId: ctx.credentials.UIPATH_TENANT_ID,
       expiration: ctx.expiration,
-      source: "file" /* File */,
+      source: "saved-login" /* SavedLogin */,
+      ...identityFields(ctx.accessToken, ctx.credentials),
       hint: globalHint,
       tokenRefresh: {
         attempted: false,
@@ -2152,6 +2256,8 @@ init_constants();
 
 // ../auth/src/interactive.ts
 init_src();
+// ../auth/src/tenantSelection.ts
+var IDENTIFIER_STATUSES = new Set([400, 403, 404]);
 
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE = "TENANT_SELECTION_REQUIRED";
@@ -2162,10 +2268,6 @@ var TENANT_SELECTION_CODES = new Set([
 ]);
 // ../auth/src/logout.ts
 init_src();
-
-// ../auth/src/index.ts
-init_server();
-
 // src/solution-auth.ts
 async function getSolutionAuthContext(options) {
   const ctx = await getAuthContext({
@@ -2189,4 +2291,4 @@ export {
   getSolutionAuthContext
 };
 
-//# debugId=D8E920A0393CD84264756E2164756E21
+//# debugId=C583A49A0405670664756E2164756E21

package/dist/src/index.d.ts

@@ -3,10 +3,11 @@ export { getAvailablePublishLocationsV2, type PublishLocationType, type PublishL
 export * from "../generated/src/index.js";
 export { buildSolutionPackageFromDir, bundleSolution, resolveSolutionDir, } from "./bundle-service";
 export { type AutoInstallClientConfig, type DeploymentAutoInstallRequest, deploymentsAutoInstall, } from "./deployments-auto-install";
+export { getProjectDebugStatus, isDebugProvisioningSucceeded, isDebugProvisioningTerminal, type ProjectDebugStatusClientConfig, type ProjectDebugStatusError, type ProjectDebugStatusResponse, } from "./project-debug-status";
 export { type PackageVersionSearchFilter, type PackageVersionSearchRow, type PackageVersionsClientConfig, searchPackageVersions, } from "./search-package-versions";
 export type { AutoCreatedSolution, ParentSolutionDiscovery, PrepareProjectLocationOptions, PrepareProjectLocationResult, ProjectSolutionRegistration, RegisterProjectOptions, SolutionManifestCreation, } from "./solution-file";
 export { autoScaffoldSolution, createSolutionManifest, findNearestParentUipxFile, findSolutionFile, findSolutionFileUpward, isProjectRegisteredInSolution, normalizeProjectType, prepareProjectLocation, readSolutionManifest, readUipxFile, toPortableRelativePath, tryRegisterProjectInParentSolution, updateSolutionFile, updateUipxSolutionId, } from "./solution-file";
-export { getStudioWebSolutionProjects } from "./solution-info";
+export { getStudioWebSolutionProjects, type ListStudioWebSolutionsOptions, listStudioWebSolutions, type StudioWebSolutionsPage, } from "./solution-info";
 export type { BundleResult, SolutionImportResponse, StudioWebConfig, StudioWebSolutionProject, UipxFile, UipxProject, } from "./types";
 export { importSolution, overwriteSolution, solutionExistsOnStudioWeb, uploadOrOverwriteSolution, } from "./upload-service";
 export { SDK_USER_AGENT } from "./user-agent.js";

package/dist/src/project-debug-status.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Solution debug-provisioning status (Automation Solutions).
+ *
+ * Hand-written wrapper for
+ * `GET /api/v1/solutions/{solutionKey}/projects/debug/status`. It is the same
+ * endpoint Studio Web's provisioning flow polls when its SignalR
+ * `ProjectDebugStatus` event does not arrive in time
+ * (`ProvisionSolutionDebugService._pollDebugStatusFallback$`), which makes it
+ * the CLI's way to wait for a `debugProjectAsync` that answered
+ * `complete: false`.
+ *
+ * Generating it instead would take three things, none of them available here:
+ *
+ * 1. `src/scripts/generate-sdk.ts` excludes the whole `/api/v1/solutions/`
+ *    prefix as "problematic headers", so every path in this namespace is out
+ *    of scope by configuration — not merely missing. The two solutions/debug
+ *    paths that *are* in the committed swagger get filtered out for the same
+ *    reason; the generated client holds no `/api/v1/solutions/*` at all.
+ * 2. This path is absent from the committed swagger, which was last refreshed
+ *    2026-03-20, and the generator's source URL is auth-gated.
+ * 3. Lifting the prefix exclusion means finding out which headers broke the
+ *    generator in the first place, which nobody wrote down.
+ *
+ * So this file is a deviation from how the SDKs are meant to work — see
+ * `@uipath/orchestrator-sdk`, where every endpoint is generated and the
+ * hand-written layer is helpers only. To undo it: refresh the swagger with a
+ * valid session, add this path to `explicitlyIncludedPaths`, regenerate, and
+ * delete this file.
+ */
+/** Auth/endpoint inputs for {@link getProjectDebugStatus}. */
+export interface ProjectDebugStatusClientConfig {
+    /** Tenant-scoped Automation Solutions base path (`.../automationsolutions_`). */
+    basePath: string;
+    accessToken: string;
+}
+/** One provisioning error, as the status endpoint reports it. */
+export interface ProjectDebugStatusError {
+    message: string;
+    serviceName?: string;
+    resource?: {
+        key?: string;
+        name?: string;
+        kind?: string;
+        type?: string;
+    };
+}
+/**
+ * Response of the debug status endpoint (mirrors Studio Web's
+ * `ProjectDebugInfo`). `status` is open-ended on purpose: the service emits
+ * non-terminal statuses while provisioning is in flight, and the poll only
+ * acts on the terminal ones ({@link DEBUG_PROVISIONING_TERMINAL_STATUSES}).
+ */
+export interface ProjectDebugStatusResponse {
+    sessionId?: string;
+    status?: string;
+    errors?: ProjectDebugStatusError[];
+    internalFolderId?: number | null;
+}
+/** Whether the provisioning session reached any terminal status. */
+export declare const isDebugProvisioningTerminal: (status?: string) => boolean;
+/** Whether the provisioning session finished successfully. */
+export declare const isDebugProvisioningSucceeded: (status?: string) => boolean;
+/**
+ * Fetch the provisioning status of a solution debug session.
+ *
+ * Non-2xx responses throw the generated runtime's {@link ResponseError} so
+ * callers' `extractErrorDetails` handling (status + body parsing) works
+ * unchanged.
+ */
+export declare function getProjectDebugStatus(config: ProjectDebugStatusClientConfig, solutionKey: string, debugSessionId: string): Promise<ProjectDebugStatusResponse>;

package/dist/src/search-package-versions.d.ts

@@ -35,11 +35,12 @@ export interface PackageVersionSearchRow {
 /**
  * Search a package's published versions within a feed.
  *
- * `feedFolderKey` is sent as `X-UIPATH-FolderKey` so results are scoped to
- * that feed, matching the package search. Non-2xx responses throw the
- * generated runtime's {@link ResponseError}.
+ * When `feedFolderKey` is set, it is sent as `X-UIPATH-FolderKey` so results
+ * are scoped to that feed, matching the package search. Omitting it searches
+ * the tenant feed. Non-2xx responses throw the generated runtime's
+ * {@link ResponseError}.
  */
-export declare function searchPackageVersions(config: PackageVersionsClientConfig, packageKey: string, filter: PackageVersionSearchFilter, feedFolderKey: string): Promise<{
+export declare function searchPackageVersions(config: PackageVersionsClientConfig, packageKey: string, filter: PackageVersionSearchFilter, feedFolderKey?: string): Promise<{
     count?: number;
     values: PackageVersionSearchRow[];
 }>;

package/dist/src/solution-file.d.ts

@@ -11,7 +11,9 @@ import type { UipxFile, UipxProject } from "./types";
  * - `AlreadyRegistered` — Project was already in Projects[]; no write performed.
  * - `Skipped`           — A candidate solution was found but registration was deliberately
  *                         not attempted (ambiguous: multiple `.uipx` in same dir, or the
- *                         project dir sits outside the discovered solution dir).
+ *                         project dir sits outside the discovered solution dir, or the
+ *                         project's type cannot live in a solution — see
+ *                         {@link unsupportedSolutionProjectType}).
  * - `Failed`            — Registration was attempted and an error occurred (read/write/parse).
  * - `NotInSolution`     — No `.uipx` file was found by walking ancestor directories. The
  *                         project was created in standalone mode. This is the explicit

package/dist/src/solution-info.d.ts

@@ -1,6 +1,7 @@
 /**
  * Read solution metadata from UiPath Studio Web.
  */
+import { type PreviewSolutionDto } from "@uipath/studioweb-sdk";
 import type { StudioWebConfig, StudioWebSolutionProject } from "./types";
 /**
  * Fetch the projects of a Studio Web solution
@@ -14,3 +15,45 @@ import type { StudioWebConfig, StudioWebSolutionProject } from "./types";
  * produce a targeted error. Throws on any other non-2xx status.
  */
 export declare function getStudioWebSolutionProjects(config: StudioWebConfig, organizationName: string, solutionId: string): Promise<StudioWebSolutionProject[] | undefined>;
+/** Options for {@link listStudioWebSolutions}. */
+export interface ListStudioWebSolutionsOptions {
+    /** Server-side keyword match against solution and project names. */
+    name?: string;
+    /** Page size. Studio Web caps a page at 100 rows. */
+    limit?: number;
+    /**
+     * Rows to skip before the first returned one. Paging spans Studio Web's
+     * combined solutions + standalone-projects result set (the endpoint pages
+     * over both; only the solutions are returned here).
+     */
+    skip?: number;
+    /** Server column to sort by (e.g. `lastModifiedTime`). */
+    sortBy?: string;
+    /** Sort direction. */
+    sortOrder?: "asc" | "desc";
+}
+/** One page of Studio Web solutions. */
+export interface StudioWebSolutionsPage {
+    /** Solutions in this page, verbatim from the Studio Web response. */
+    solutions: PreviewSolutionDto[];
+    /**
+     * Rows the server returned in this page — solutions plus the standalone
+     * projects that were dropped. Callers paging with `skip` must advance by
+     * this count, not by `solutions.length`.
+     */
+    combinedCount: number;
+    /**
+     * Total matching rows as reported by the server. Counts the combined
+     * solutions + standalone-projects result set, not just solutions.
+     */
+    totalCount?: number;
+}
+/**
+ * List the current user's Studio Web solutions
+ * (`Solution_SearchSolutionsAndProjects` →
+ * `GET /api/Solution/SearchSolutionsAndProjects`).
+ *
+ * The endpoint also returns standalone projects; those are dropped — callers
+ * get solutions only. Throws on any non-2xx status.
+ */
+export declare function listStudioWebSolutions(config: StudioWebConfig, organizationName: string, options?: ListStudioWebSolutionsOptions): Promise<StudioWebSolutionsPage>;

package/dist/src/upload-service.d.ts

@@ -4,6 +4,15 @@
  */
 import type { IFileSystem } from "@uipath/filesystem";
 import type { SolutionImportResponse, StudioWebConfig } from "./types";
+/**
+ * Escape hatch for very large solutions or unusually slow links:
+ * `UIPATH_SOLUTION_UPLOAD_TIMEOUT_MS=300000`. Anything non-numeric or
+ * non-positive falls back to the default — the ceiling can be raised, not
+ * removed, so the silent hang cannot come back through a typo.
+ *
+ * Exported for tests only — not re-exported from the package barrel.
+ */
+export declare function resolveUploadTimeoutMs(): number;
 /**
  * Probe Studio Web for the existence of a solution by id.
  * Returns true on 2xx, false on 404. Throws on any other status so callers

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/solution-sdk",
   "license": "MIT",
-  "version": "1.200.0-preview.120",
+  "version": "1.201.0-preview.121",
   "repository": {
     "type": "git",
     "url": "https://github.com/UiPath/cli.git",
@@ -39,5 +39,5 @@
     "dist"
   ],
   "private": false,
-  "gitHead": "173ad4b4930bd3e17a493b32e9f1c3c616ea1c10"
+  "gitHead": "c70ccfc0b12e637441d67df1d212b71d7784b5f8"
 }