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

package/dist/scripts/generate-sdk.js

@@ -69,24 +69,31 @@ function filterSwaggerPaths(swagger) {
     "/api/v3/search/"
   ];
   const explicitlyIncludedPaths = [
-    "/api/deployments/{deploymentKey}",
-    "/api/deployments/{deploymentKey}/upgrade",
-    "/api/deployments/{deploymentKey}/run",
     "/api/deployments/{deploymentKey}/validation-result",
+    "/api/deployments/{deploymentKey}",
+    "/api/deployments/{deploymentKey}/resources",
     "/api/deployments/deploy",
     "/api/search/packages",
     "/api/v3/search/deployments"
   ];
+  const includedMethodsByPath = {
+    "/api/deployments/{deploymentKey}": ["get", "delete"],
+    "/api/deployments/{deploymentKey}/resources": ["get"]
+  };
   for (const [path, methods] of Object.entries(swagger.paths)) {
     const isExplicitlyIncluded = explicitlyIncludedPaths.includes(path);
     const shouldExclude = !isExplicitlyIncluded && excludedPathPrefixes.some((prefix) => path.startsWith(prefix));
     if (shouldExclude) {
       console.log(` Skipping path: ${path} (problematic headers)`);
     } else {
-      if (path === "/api/deployments/{deploymentKey}") {
+      const includedMethods = includedMethodsByPath[path];
+      if (includedMethods) {
         const pathMethods = methods;
-        filteredPaths[path] = { get: pathMethods.get };
-        console.log(`Including path: GET ${path} (explicitly included)`);
+        filteredPaths[path] = Object.fromEntries(includedMethods.map((method) => [
+          method,
+          pathMethods[method]
+        ]));
+        console.log(`Including path: ${includedMethods.map((method) => method.toUpperCase()).join(", ")} ${path} (explicitly included)`);
       } else {
         filteredPaths[path] = methods;
         console.log(`Including path: ${path}`);
@@ -199,4 +206,4 @@ export {
   main as generateSdk
 };
 
-//# debugId=DC425A840998D54264756E2164756E21
+//# debugId=5FDB74266FA3ECA564756E2164756E21

package/dist/solution-auth.js

@@ -1,6 +1,6 @@
 import {
   getSolutionAuthContext
-} from "./index-y8tgscfm.js";
+} from "./index-6gp5j7j5.js";
 import"./index-g0hcxnae.js";
 import"./index-1de529jm.js";
 export {

package/dist/src/index.d.ts

@@ -2,7 +2,6 @@ import "./user-agent.js";
 export { getAvailablePublishLocationsV2, type PublishLocationType, type PublishLocationV2, } from "@uipath/studioweb-sdk";
 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";

package/dist/src/resources/index.d.ts

@@ -18,7 +18,9 @@ export * from "./services/entry-point-spec-enhancer";
 export * from "./services/local-resource-matcher";
 export * from "./services/project-artifacts-service";
 export * from "./services/project-template-types";
+export * from "./services/remote-resources";
 export { normalizeResourceCasing, normalizeResourceFileCasing, saveCasingNormalized, } from "./services/resource-casing";
+export * from "./services/resource-name";
 export * from "./services/resource-refresh-service";
 export * from "./services/resource-remote-sync";
 export * from "./services/solution-manifest";

package/dist/src/resources/providers/resource-builder-init.d.ts

@@ -1,4 +1,4 @@
-import type { IResourceBuilderServices } from "@uipath/resource-builder-sdk";
+import { type IResourceBuilderServices } from "@uipath/resource-builder-sdk";
 /**
  * CLI entry for ResourceBuilderServices. Adds three providers on top of the SDK
  * defaults: `ArtefactPairBindingSolutionDefinitionFactory` (fills the

package/dist/src/resources/services/remote-resources.d.ts

@@ -0,0 +1,45 @@
+import type { IResourceBuilderServices } from "@uipath/resource-builder-sdk";
+import type { IResourceCatalogClientProxy } from "@uipath/resource-builder-sdk/clients";
+import type { EnhancedResourceDefinition, IImportResourceHelper } from "@uipath/resource-builder-sdk/helpers";
+import type { ResourceReferenceModel } from "@uipath/resource-builder-sdk/models";
+/** One resource catalog row; the SDK does not export a name for it. */
+export type CatalogEntity = NonNullable<Awaited<ReturnType<IResourceCatalogClientProxy["searchFolderEntities"]>>["items"]>[number];
+export interface RemoteResourceClients {
+    catalog: IResourceCatalogClientProxy;
+    importer: IImportResourceHelper;
+}
+export declare function getRemoteResourceClients(services: IResourceBuilderServices): RemoteResourceClients;
+export interface CatalogQuery {
+    name?: string;
+    entityTypes?: string[];
+}
+/** Pages through the resource catalog and returns the first row `match` accepts. */
+export declare function findCatalogEntityAsync(catalog: IResourceCatalogClientProxy, query: CatalogQuery, match: (entity: CatalogEntity) => boolean): Promise<CatalogEntity | undefined>;
+export declare function toResourceReference(entity: CatalogEntity): ResourceReferenceModel;
+/** A catalog entity named by what a cached catalog row already holds. */
+export interface CatalogReference {
+    kind: string;
+    type?: string;
+    key: string;
+    name?: string;
+    folderPath?: string;
+    folderKey?: string;
+}
+export declare function toCatalogReference(reference: CatalogReference): ResourceReferenceModel;
+/**
+ * The export carries the resource plus its transitive dependencies, so the
+ * definition is picked by key; `undefined` when the export holds none for it.
+ */
+export declare function exportResourceDefinitionAsync(importer: IImportResourceHelper, reference: ResourceReferenceModel): Promise<EnhancedResourceDefinition | undefined>;
+/** Reads a spec property by exact name, falling back to a case-insensitive match. */
+export declare function readSpecProperty(spec: Record<string, unknown> | null | undefined, name: string): unknown;
+/** Same row shape as `uip or packages entry-points`; the schemas stay JSON strings. */
+export interface CatalogEntryPoint {
+    UniqueId: string;
+    Path: string;
+    DisplayName: string;
+    InputArguments: unknown;
+    OutputArguments: unknown;
+}
+/** The `entryPoints` on an exported resource spec; `undefined` when the spec carries none. */
+export declare function readSpecEntryPoints(spec: Record<string, unknown> | null | undefined): CatalogEntryPoint[] | undefined;

package/dist/src/resources/services/resource-name.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Validation for a resource name that is about to become a file under
+ * `resources/<folder>/<kind>/<name>.json`. Shared by every path that mints a
+ * local resource (`solution resources add --source local`, `agent memory
+ * add` inside a solution), so a name is checked the same way before any
+ * write regardless of which tool asked.
+ */
+/** Orchestrator's most permissive resource-name limit is 256 chars (Asset). */
+export declare const MAX_RESOURCE_NAME_LENGTH = 256;
+export type ResourceNameValidation = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    instructions: string;
+};
+/**
+ * Check a resource name for length and unsafe characters. `optionName` is
+ * the CLI flag the name came from, so the message points at the right one
+ * (`--name` for `resources add`, `--memory-space` for `agent memory add`).
+ */
+export declare function validateResourceName(name: string, options?: {
+    optionName?: string;
+}): ResourceNameValidation;
+/** Throwing form for callers that already run inside a `catchError` block. */
+export declare function assertValidResourceName(name: string, options?: {
+    optionName?: string;
+}): void;

package/dist/src/resources/services/sync-resources-from-bindings.d.ts

@@ -26,8 +26,12 @@ export interface ResolvedKindMetadata {
      * newer metadata version still counts.
      */
     specProperties: Set<string>;
+    subtypes: string[];
+    typeMatched: boolean;
 }
 export { findMatchingLocalResource, findMatchingMemberResource, findMemberCloneResources, normalizeFolderPath, } from "./local-resource-matcher";
+export declare function formatResourceSubtypes(subtypes: string[]): string;
+export declare function sameResourceSubtype(a: string | undefined, b: string | undefined): boolean;
 interface SyncResult {
     created: number;
     imported: number;
@@ -61,10 +65,10 @@ export declare function uniqueNameForResource(name: string, kind: string, exclud
 export interface RcsMatch {
     key: string;
     name: string;
-    /** Subtype as RCS reports it (e.g. `Text` for Asset). `undefined` for
-     * kinds without a subtype (Queue). Callers may need to forward this to
-     * `addOrUpdateResourceToSolutionAsync`, which rejects type-less imports
-     * for kinds that SDK metadata indexes by (kind, type). */
+    /** Subtype in its solution name (e.g. `stringAsset` for a Text asset).
+     * `undefined` for kinds without a subtype (Queue). Callers may need to
+     * forward this to `addOrUpdateResourceToSolutionAsync`, which rejects
+     * type-less imports for kinds that SDK metadata indexes by (kind, type). */
     type?: string;
     folder?: {
         fullyQualifiedName: string;
@@ -83,9 +87,17 @@ export declare function findResourceByKeyInRcs(builder: ISolutionBuilder, kind:
 /**
  * Page through RCS for a given (kind, name) and collect every match. Returns
  * an empty array on lookup error (logged as a warning). Callers decide what
- * to do with 0/1/many matches.
+ * to do with 0/1/many matches. Callers that must tell "nothing matched"
+ * from "the catalog could not be searched" use {@link searchRcsResourcesStrict}.
  */
 export declare function searchRcsResources(builder: ISolutionBuilder, kind: string, name: string): Promise<RcsMatch[]>;
+/**
+ * Same search as {@link searchRcsResources}, but a failed catalog call is
+ * thrown instead of swallowed into an empty result. Use it where an empty
+ * answer leads to a user-facing "not found" that would be wrong after an
+ * auth or network failure.
+ */
+export declare function searchRcsResourcesStrict(builder: ISolutionBuilder, kind: string, name: string): Promise<RcsMatch[]>;
 export declare function findResourceInRcs(builder: ISolutionBuilder, kind: string, name: string, folderPath?: string): Promise<RcsMatch | undefined>;
 /**
  * Build a resolver that answers kind-metadata questions for many (kind, type)

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

@@ -1,8 +1,11 @@
+import { type SessionIdentity } from "@uipath/auth";
 export interface SolutionAuthContext {
     accessToken: string;
     basePath: string;
     organizationId: string;
     tenantName: string;
+    /** Who the session acts as, as the login status resolved it (see `AuthContext.identity`). */
+    identity?: SessionIdentity;
 }
 export declare function getSolutionAuthContext(options: {
     tenant?: string;

package/dist/src/zip-utils.d.ts

@@ -18,6 +18,14 @@ import type { IFileSystem } from "@uipath/filesystem";
  *                  restores its own packages on import, so uploading this one
  *                  only costs bundle size and time.
  *
+ *   .flow-sdk      The Maestro builder SDK's authoring work directory: the
+ *                  `.flow.ts` source, its author-side `bindings.json` and the
+ *                  generated connector modules. Studio Web reads none of them;
+ *                  it gets the compiled `.flow` and `bindings_v2.json` beside
+ *                  this folder. Excluded by name, not as "any dot-folder":
+ *                  `.project` (IDE state) and `.agent-builder` (inline agents)
+ *                  must still ship.
+ *
  * Callers can extend this set per-walk via the `additionalExcludeDirs` option
  * (sourced from a `.uipignore` file at the solution root by bundle-service).
  */

package/package.json

@@ -2,7 +2,7 @@
     "name": "@uipath/solution-sdk",
     "author": "UiPath",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.203.0-preview.212",
+    "version": "1.204.0-preview.211",
     "repository": {
         "type": "git",
         "url": "https://github.com/UiPath/cli.git",
@@ -40,5 +40,5 @@
         "dist"
     ],
     "private": false,
-    "gitHead": "15094ce85cf76c59a54affbed3304febc271f41a"
+    "gitHead": "275e01f1f6098d4c3bc9673f5225f33372822534"
 }

package/dist/generated/src/models/DeploymentRunResponse.d.ts

@@ -1,51 +0,0 @@
-/**
- * UiPath.AutomationSolutionsService.WebApi 1.0
- * Solutions API
- *
- * The version of the OpenAPI document: 1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import type { ServiceMessage } from './ServiceMessage';
-/**
- *
- * @export
- * @interface DeploymentRunResponse
- */
-export interface DeploymentRunResponse {
-    /**
-     *
-     * @type {string}
-     * @memberof DeploymentRunResponse
-     */
-    instanceId?: string | null;
-    /**
-     *
-     * @type {boolean}
-     * @memberof DeploymentRunResponse
-     */
-    scheduled: boolean;
-    /**
-     *
-     * @type {Array<ServiceMessage>}
-     * @memberof DeploymentRunResponse
-     */
-    errors: Array<ServiceMessage>;
-    /**
-     *
-     * @type {boolean}
-     * @memberof DeploymentRunResponse
-     */
-    complete: boolean;
-}
-/**
- * Check if a given object implements the DeploymentRunResponse interface.
- */
-export declare function instanceOfDeploymentRunResponse(value: object): value is DeploymentRunResponse;
-export declare function DeploymentRunResponseFromJSON(json: any): DeploymentRunResponse;
-export declare function DeploymentRunResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeploymentRunResponse;
-export declare function DeploymentRunResponseToJSON(json: any): DeploymentRunResponse;
-export declare function DeploymentRunResponseToJSONTyped(value?: DeploymentRunResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/generated/src/models/DeploymentUpgradeRequest.d.ts

@@ -1,38 +0,0 @@
-/**
- * UiPath.AutomationSolutionsService.WebApi 1.0
- * Solutions API
- *
- * The version of the OpenAPI document: 1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-/**
- *
- * @export
- * @interface DeploymentUpgradeRequest
- */
-export interface DeploymentUpgradeRequest {
-    /**
-     *
-     * @type {string}
-     * @memberof DeploymentUpgradeRequest
-     */
-    deploymentName?: string | null;
-    /**
-     *
-     * @type {string}
-     * @memberof DeploymentUpgradeRequest
-     */
-    packageVersionKey?: string | null;
-}
-/**
- * Check if a given object implements the DeploymentUpgradeRequest interface.
- */
-export declare function instanceOfDeploymentUpgradeRequest(value: object): value is DeploymentUpgradeRequest;
-export declare function DeploymentUpgradeRequestFromJSON(json: any): DeploymentUpgradeRequest;
-export declare function DeploymentUpgradeRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): DeploymentUpgradeRequest;
-export declare function DeploymentUpgradeRequestToJSON(json: any): DeploymentUpgradeRequest;
-export declare function DeploymentUpgradeRequestToJSONTyped(value?: DeploymentUpgradeRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/src/deployments-auto-install.d.ts

@@ -1,55 +0,0 @@
-/**
- * Automation Solutions "auto-install" deploy (v2).
- *
- * Hand-written wrapper — `POST /api/v2/deployments/auto-install` is not yet in
- * the committed swagger the generator pulls from, so it isn't in the generated
- * `DeploymentsApi`. It supersedes the older `POST /api/deployments/deploy`
- * (generated `deploymentsDeploy`) for feed deploys: unlike that endpoint, it
- * accepts a caller-chosen `deploymentName` and `solutionRootFolderName`
- * instead of auto-naming the deployment `AutoDeploy-<solution>`. It is the
- * same call Studio Web makes for a deploy-only ("packageAndDeploy: false")
- * flow. Once the v2 path ships in the spec, regenerate and drop this file in
- * favor of the generated method.
- */
-/** Auth/endpoint inputs for {@link deploymentsAutoInstall}. */
-export interface AutoInstallClientConfig {
-    /** Tenant-scoped Automation Solutions base path (`.../automationsolutions_`). */
-    basePath: string;
-    accessToken: string;
-}
-/** Body of `POST /api/v2/deployments/auto-install` (mirrors Studio Web). */
-export interface DeploymentAutoInstallRequest {
-    /** Caller-chosen deployment name — the field the v1 auto-deploy endpoint lacked. */
-    deploymentName: string;
-    packageVersionKey: string;
-    /** Client-generated GUID for the deployment to create. */
-    newDeploymentKey: string;
-    /** Activate right after install (server-side; no separate activate call). */
-    forceActivate: boolean;
-    /** Key of the folder the deployment installs into. The server creates
-     *  `solutionRootFolderName` under THIS folder — not under
-     *  `pathFullyQualifiedName`, which only feeds the deployment record. */
-    installationFolderKey: string;
-    /** FQN of that same folder — recorded as the deployment's displayed path,
-     *  so it must agree with `installationFolderKey`. */
-    pathFullyQualifiedName: string;
-    /** False → deploy an already-published package (the CLI's case). */
-    packageAndDeploy: boolean;
-    /** Name of the new Orchestrator folder created for the deployment. */
-    solutionRootFolderName: string;
-    pauseBeforeRun: boolean;
-    runtimeSetup?: {
-        requireServerlessTemplate: boolean;
-    };
-}
-/**
- * Deploy a feed package via the v2 auto-install endpoint.
- *
- * `feedFolderKey` is sent as `X-UIPATH-FolderKey` so the server resolves the
- * package version within that feed (same scoping the search endpoints use).
- * Non-2xx responses throw the generated runtime's {@link ResponseError} so
- * callers' `extractErrorDetails` handling (status + body parsing) works
- * unchanged. The response body is returned parsed when it is a JSON object,
- * `{}` otherwise — the endpoint's response shape is not pinned by the spec yet.
- */
-export declare function deploymentsAutoInstall(config: AutoInstallClientConfig, request: DeploymentAutoInstallRequest, feedFolderKey: string): Promise<Record<string, unknown>>;