@uipath/solution-sdk 1.198.0 → 1.199.0-preview.104

package/dist/index.js

@@ -2535,7 +2535,7 @@ class TextApiResponse {
 var package_default = {
   name: "@uipath/solution-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0-preview.104",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -12202,6 +12202,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"]],
@@ -12526,7 +12527,7 @@ function validateUipxFile(parsed, uipxFileName) {
     }
     if (typeof project.ProjectRelativePath !== "string" || !project.ProjectRelativePath.trim()) {
       const pathHint = typeof project.Path === "string" ? " Found Path, but .uipx uses ProjectRelativePath." : "";
-      throw new Error(`Invalid .uipx file: Projects[${index}] is missing ProjectRelativePath.${pathHint} Use 'uip solution project add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`);
+      throw new Error(`Invalid .uipx file: Projects[${index}] is missing ProjectRelativePath.${pathHint} Use 'uip solution projects add' to add projects, or set ProjectRelativePath to the project file path, for example "Foo/project.uiproj".`);
     }
   }
   return parsed;
@@ -12534,6 +12535,72 @@ function validateUipxFile(parsed, uipxFileName) {
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+async function createSolutionManifest(fs7, solutionDir, solutionName, options = {}) {
+  const resolvedDir = fs7.path.resolve(solutionDir);
+  if (!(options.allowExistingDir && await fs7.exists(resolvedDir))) {
+    await fs7.mkdir(resolvedDir);
+  }
+  const solutionId = crypto.randomUUID();
+  const manifest = {
+    DocVersion: "1.0.0",
+    StudioMinVersion: "2025.10.0",
+    SolutionId: solutionId,
+    Projects: []
+  };
+  const solutionFile = fs7.path.join(resolvedDir, `${solutionName}.uipx`);
+  await fs7.writeFile(solutionFile, `${JSON.stringify(manifest, null, 2)}
+`);
+  return {
+    solutionDir: resolvedDir,
+    solutionFile,
+    solutionId
+  };
+}
+var AUTO_SOLUTION_SUFFIX = "Solution";
+async function autoScaffoldSolution(fs7, baseDir, projectName) {
+  const solutionName = `${projectName}${AUTO_SOLUTION_SUFFIX}`;
+  const solutionDir = fs7.path.resolve(baseDir, solutionName);
+  const expectedSolutionFile = fs7.path.join(solutionDir, `${solutionName}.uipx`);
+  if (await fs7.exists(expectedSolutionFile)) {
+    return {
+      Name: solutionName,
+      Path: solutionDir,
+      SolutionFile: expectedSolutionFile
+    };
+  }
+  const { solutionFile } = await createSolutionManifest(fs7, solutionDir, solutionName, { allowExistingDir: true });
+  return {
+    Name: solutionName,
+    Path: solutionDir,
+    SolutionFile: solutionFile
+  };
+}
+async function prepareProjectLocation(fs7, candidateProjectDir, projectName, options = {}) {
+  const resolved = fs7.path.resolve(candidateProjectDir);
+  if (options.skipRegistration) {
+    return { projectDir: resolved };
+  }
+  const discovery = await findNearestParentUipxFile(fs7, resolved);
+  if (discovery.status !== "notFound") {
+    return { projectDir: resolved };
+  }
+  const baseDir = fs7.path.dirname(resolved);
+  const autoCreatedSolution = await autoScaffoldSolution(fs7, baseDir, projectName);
+  const projectDir = fs7.path.join(autoCreatedSolution.Path, projectName);
+  await warnIfCandidateDirShadowed(fs7, resolved, projectDir);
+  return { projectDir, autoCreatedSolution };
+}
+async function warnIfCandidateDirShadowed(fs7, candidateDir, projectDir) {
+  const [, exists2] = await catchError(fs7.exists(candidateDir));
+  if (!exists2) {
+    return;
+  }
+  const [, entries] = await catchError(fs7.readdir(candidateDir));
+  if (!entries || entries.length === 0) {
+    return;
+  }
+  logger.warn(`An existing directory "${candidateDir}" was left untouched. ` + `The project was created inside the auto-created solution at "${projectDir}". ` + "Run init from inside an existing solution, or pass --skip-solution-registration, if you meant to use the existing directory.");
+}
 function resolveSolutionDir(fs7, inputPath) {
   const resolved = fs7.path.resolve(inputPath);
   if (resolved.endsWith(".uipx")) {
@@ -12739,7 +12806,7 @@ ${readDirError.message}`)
         registration: {
           Status: "Skipped",
           Message: "Project registration skipped.",
-          Instructions: `Found multiple .uipx files in ${currentDir}: ${solutionFiles.join(", ")}. Run 'uip solution project add "${projectDir}" <solution.uipx>' to choose one.`
+          Instructions: `Found multiple .uipx files in ${currentDir}: ${solutionFiles.join(", ")}. Run 'uip solution projects add "${projectDir}" <solution.uipx>' to choose one.`
         }
       };
     }
@@ -12850,7 +12917,7 @@ async function readSolutionManifest(fs7, solutionFile) {
     const projectRelativePath = readString(project.ProjectRelativePath);
     if (!projectRelativePath) {
       return [
-        new Error(`Invalid solution file: Projects[${index}] is missing ProjectRelativePath. Use 'uip solution project add' to repair the manifest.`),
+        new Error(`Invalid solution file: Projects[${index}] is missing ProjectRelativePath. Use 'uip solution projects add' to repair the manifest.`),
         null
       ];
     }
@@ -12877,7 +12944,7 @@ function buildRegistrationSuccessInstructions(solutionDir) {
 function buildRegistrationFailureInstructions(projectDir, details) {
   return [
     "Automatic solution registration could not complete.",
-    `Run 'uip solution project add "${projectDir}" <solution.uipx>' after checking the project and solution files.`,
+    `Run 'uip solution projects add "${projectDir}" <solution.uipx>' after checking the project and solution files.`,
     `Details: ${details}`
   ].join(`
 `);
@@ -12886,14 +12953,14 @@ function buildStandaloneInstructions(projectDir) {
   return [
     "No parent solution was found by walking ancestor directories.",
     "Studio Web upload, `flow debug`, and packaging require an enclosing solution.",
-    `To link this project to a solution, run 'uip solution init "<SolutionName>"' then 'uip solution project add "${projectDir}" <SolutionName>.uipx'.`
+    `To link this project to a solution, run 'uip solution init "<SolutionName>"' then 'uip solution projects add "${projectDir}" <SolutionName>.uipx'.`
   ].join(`
 `);
 }
 function buildOptedOutInstructions(projectDir) {
   return [
     "Automatic solution registration was skipped because --skip-solution-registration was passed.",
-    `To register this project later, run 'uip solution project add "${projectDir}" <SolutionName>.uipx' from within the solution.`
+    `To register this project later, run 'uip solution projects add "${projectDir}" <SolutionName>.uipx' from within the solution.`
   ].join(`
 `);
 }
@@ -15143,6 +15210,7 @@ export {
   readUipxFile,
   readSolutionManifest,
   querystring,
+  prepareProjectLocation,
   overwriteSolution,
   normalizeProjectType,
   mapValues,
@@ -15190,10 +15258,12 @@ export {
   findNearestParentUipxFile,
   exists,
   createZipFromDir,
+  createSolutionManifest,
   collectFiles,
   canConsumeForm,
   bundleSolution,
   buildSolutionPackageFromDir,
+  autoScaffoldSolution,
   WorkflowActionToJSONTyped,
   WorkflowActionToJSON,
   WorkflowActionFromJSONTyped,
@@ -15375,4 +15445,4 @@ export {
   BASE_PATH
 };
 
-//# debugId=4CFFD07F599D197A64756E2164756E21
+//# debugId=08C1FEAB739492EB64756E2164756E21

package/dist/src/index.d.ts

@@ -1,8 +1,8 @@
 import "./user-agent.js";
 export * from "../generated/src/index.js";
 export { buildSolutionPackageFromDir, bundleSolution, resolveSolutionDir, } from "./bundle-service";
-export type { ParentSolutionDiscovery, ProjectSolutionRegistration, RegisterProjectOptions, } from "./solution-file";
-export { findNearestParentUipxFile, findSolutionFile, isProjectRegisteredInSolution, normalizeProjectType, readSolutionManifest, readUipxFile, toPortableRelativePath, tryRegisterProjectInParentSolution, updateSolutionFile, updateUipxSolutionId, } from "./solution-file";
+export type { AutoCreatedSolution, ParentSolutionDiscovery, PrepareProjectLocationOptions, PrepareProjectLocationResult, ProjectSolutionRegistration, RegisterProjectOptions, SolutionManifestCreation, } from "./solution-file";
+export { autoScaffoldSolution, createSolutionManifest, findNearestParentUipxFile, findSolutionFile, isProjectRegisteredInSolution, normalizeProjectType, prepareProjectLocation, readSolutionManifest, readUipxFile, toPortableRelativePath, tryRegisterProjectInParentSolution, updateSolutionFile, updateUipxSolutionId, } from "./solution-file";
 export { getStudioWebSolutionProjects } from "./solution-info";
 export type { BundleResult, SolutionImportResponse, StudioWebConfig, StudioWebSolutionProject, UipxFile, UipxProject, } from "./types";
 export { importSolution, overwriteSolution, solutionExistsOnStudioWeb, uploadOrOverwriteSolution, } from "./upload-service";

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

@@ -61,6 +61,101 @@ export declare function readUipxFile(fs: IFileSystem, solutionDir: string): Prom
     uipx: UipxFile;
     uipxFileName: string;
 }>;
+export interface SolutionManifestCreation {
+    solutionDir: string;
+    solutionFile: string;
+    solutionId: string;
+}
+export interface CreateSolutionManifestOptions {
+    /**
+     * When true, do not throw if `solutionDir` already exists; only the
+     * `.uipx` manifest write happens. Lets callers recover from a partial-
+     * failure prior run (dir created, manifest write failed) without manual
+     * cleanup. `uip solution init` keeps the default (throw on existing dir);
+     * `autoScaffoldSolution` sets this so the auto-scaffold path is genuinely
+     * idempotent.
+     */
+    allowExistingDir?: boolean;
+}
+/**
+ * Create a new solution directory containing a `.uipx` manifest with an empty
+ * Projects array. Used by commands that scaffold a parent solution on the
+ * user's behalf (e.g. `uip maestro flow init` when invoked outside a
+ * solution). `uip solution init` writes its own manifest in
+ * `solution-init-service.ts` because it preserves a caller-supplied file
+ * extension — keep the two skeletons in sync.
+ *
+ * Fails if `solutionDir` already exists unless `allowExistingDir` is set.
+ * AGENTS.md / CLAUDE.md briefing files are NOT written here — that template
+ * is owned by `@uipath/solution-tool`. Callers that want them should write
+ * them after this returns.
+ */
+export declare function createSolutionManifest(fs: IFileSystem, solutionDir: string, solutionName: string, options?: CreateSolutionManifestOptions): Promise<SolutionManifestCreation>;
+/**
+ * Reported under `Data.AutoCreatedSolution` in the *-init command output
+ * whenever the CLI scaffolded the parent solution itself. Absent when the
+ * command was run inside an existing solution.
+ */
+export interface AutoCreatedSolution {
+    Name: string;
+    Path: string;
+    SolutionFile: string;
+}
+/**
+ * Scaffold a `<projectName>Solution/` sibling directory containing an empty
+ * `.uipx` manifest. Idempotent across both happy and partial-failure paths:
+ *
+ *  - Existing `.uipx`            → reuse it (re-run with `--force`).
+ *  - Dir exists, no `.uipx` yet  → write the manifest into the existing dir
+ *                                  (recovers a previous run that crashed
+ *                                  between mkdir and writeFile).
+ *  - Neither exists              → mkdir + write manifest.
+ *
+ * Lower-level helper. Most callers want {@link prepareProjectLocation}, which
+ * runs discovery first and only scaffolds when nothing is found.
+ */
+export declare function autoScaffoldSolution(fs: IFileSystem, baseDir: string, projectName: string): Promise<AutoCreatedSolution>;
+export interface PrepareProjectLocationOptions {
+    /**
+     * Set when the caller passed `--skip-solution-registration`. Short-circuits
+     * the helper: no discovery, no scaffold, the candidate path is returned
+     * unchanged. Lets the user opt out of both registration AND the parent
+     * solution scaffold with a single flag.
+     */
+    skipRegistration?: boolean;
+}
+export interface PrepareProjectLocationResult {
+    /**
+     * Absolute path the project should be created at. When the helper
+     * scaffolded a parent solution, this is `<auto-solution>/<projectName>`;
+     * otherwise it equals the resolved `candidateProjectDir`.
+     */
+    projectDir: string;
+    /**
+     * Present when this call scaffolded a fresh parent solution. The
+     * `*-init` command surfaces it under `Data.AutoCreatedSolution` so callers
+     * can tell the auto-scaffold path apart from the in-existing-solution path.
+     */
+    autoCreatedSolution?: AutoCreatedSolution;
+}
+/**
+ * Resolve where an `*-init` command should write the new project, scaffolding
+ * a parent `.uipx` solution on the user's behalf when needed.
+ *
+ * Behavior:
+ *  - `skipRegistration` set         → return `candidateProjectDir` as-is.
+ *  - Inside an existing solution    → return `candidateProjectDir` as-is.
+ *  - Ambiguous discovery (skipped)  → return `candidateProjectDir` as-is; the
+ *                                     downstream `tryRegisterProjectInParentSolution`
+ *                                     call surfaces the ambiguity in
+ *                                     `SolutionRegistration.Status`.
+ *  - No parent solution found       → scaffold `<baseDir>/<projectName>Solution/`
+ *                                     and return its nested project path.
+ *
+ * The four `*-init` tools (agent / case / flow / maestro bpmn) share this
+ * helper so the auto-scaffold behavior stays uniform.
+ */
+export declare function prepareProjectLocation(fs: IFileSystem, candidateProjectDir: string, projectName: string, options?: PrepareProjectLocationOptions): Promise<PrepareProjectLocationResult>;
 /**
  * Resolve input to a solution directory path.
  * Accepts a directory path or a .uipx file path.
@@ -121,7 +216,7 @@ export declare function readSolutionManifest(fs: IFileSystem, solutionFile: stri
  * `Projects` array, malformed entry). The boolean return is reserved for
  * the answerable question "is this project listed?" — a corrupt manifest
  * is a separate failure mode that callers must not silently translate
- * into "not registered", since the repair (`uip solution project add`)
+ * into "not registered", since the repair (`uip solution projects add`)
  * won't fix a manifest that fails to parse.
  *
  * Used by `flow debug` to catch the empty-solution-archive case BEFORE

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/solution-sdk",
   "license": "MIT",
-  "version": "1.198.0",
+  "version": "1.199.0-preview.104",
   "repository": {
     "type": "git",
     "url": "https://github.com/UiPath/cli.git",
@@ -31,5 +31,5 @@
     "dist"
   ],
   "private": false,
-  "gitHead": "1fadf03d7a8dd102742571dff569fdac11808afb"
+  "gitHead": "829a8ab8a25bce5b62c284bd1ddc674d2947f647"
 }