@uipath/solution-tool 1.202.1-preview.220 → 1.202.1-preview.239

package/dist/deploy.js

@@ -5,11 +5,11 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-0avmcp1d.js";
-import"./packager-tool-hf1vax5x.js";
-import"./packager-tool-242wgdxa.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+} from "./packager-tool-jzfs9dfs.js";
+import"./packager-tool-7wpe9zbr.js";
+import"./packager-tool-cmjqg8v6.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/index.js

@@ -2,21 +2,21 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-j3f1fhft.js";
-import"./packager-tool-vybnsg1q.js";
-import"./packager-tool-0avmcp1d.js";
-import"./packager-tool-mnw3sgv0.js";
-import"./packager-tool-wwhrtzjh.js";
+} from "./packager-tool-s9mb89vt.js";
+import"./packager-tool-1mhxcdsy.js";
+import"./packager-tool-jzfs9dfs.js";
+import"./packager-tool-fa1szz9y.js";
+import"./packager-tool-nknd7q3x.js";
 import"./packager-tool-p6mgvgdk.js";
-import"./packager-tool-3rsttfkz.js";
-import"./packager-tool-hf1vax5x.js";
-import"./packager-tool-242wgdxa.js";
-import"./packager-tool-9zpjm6ak.js";
+import"./packager-tool-8wm4p0c5.js";
+import"./packager-tool-7wpe9zbr.js";
+import"./packager-tool-cmjqg8v6.js";
+import"./packager-tool-9nq21cd6.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-0fh5tmf0.js";
+import"./packager-tool-w6jkk11r.js";
 import {
   Command
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 

package/dist/init.js

@@ -1,13 +1,13 @@
 import {
   SolutionInitError,
   solutionInitAsync
-} from "./packager-tool-mnw3sgv0.js";
+} from "./packager-tool-fa1szz9y.js";
 import {
   addProjectArtifactsToSolutionAsync
-} from "./packager-tool-9zpjm6ak.js";
+} from "./packager-tool-9nq21cd6.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/{list-spesv97s.js → list-vmvqzghp.js}

@@ -1,11 +1,11 @@
 import {
   getStudioWebAuth,
   useStudioWebAuth
-} from "./packager-tool-vybnsg1q.js";
+} from "./packager-tool-1mhxcdsy.js";
 import {
   getStudioWebSolutionProjects,
   listStudioWebSolutions
-} from "./packager-tool-242wgdxa.js";
+} from "./packager-tool-cmjqg8v6.js";
 import {
   DEFAULT_PAGE_SIZE,
   OutputFormatter,
@@ -16,7 +16,7 @@ import {
   parseBoundedInt,
   parseOffset,
   processContext
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 

package/dist/pack.js

@@ -1,11 +1,11 @@
 import {
   packSolutionAsync
-} from "./packager-tool-wwhrtzjh.js";
+} from "./packager-tool-nknd7q3x.js";
 import"./packager-tool-p6mgvgdk.js";
-import"./packager-tool-9zpjm6ak.js";
+import"./packager-tool-9nq21cd6.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/{packager-tool-vybnsg1q.js → packager-tool-1mhxcdsy.js}

@@ -1,7 +1,7 @@
 import {
   catchError,
   getAuthContext
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 
 // src/services/studio-web-auth-middleware.ts
 var studioWebAuthByCommand = new WeakMap;

package/dist/{packager-tool-hf1vax5x.js → packager-tool-7wpe9zbr.js}

@@ -1,15 +1,15 @@
 import {
   getAvailablePublishLocationsV2
-} from "./packager-tool-242wgdxa.js";
+} from "./packager-tool-cmjqg8v6.js";
 import {
   PersonalWorkspacesApi,
   createOrchestratorConfig
-} from "./packager-tool-0fh5tmf0.js";
+} from "./packager-tool-w6jkk11r.js";
 import {
   getLoginStatusAsync,
   getSdkUserAgentToken,
   installSdkUserAgentHeader
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 
 // ../pipelines-sdk/generated/src/runtime.ts
 var BASE_PATH = "https://alpha.uipath.com/uipattycyrhx/abizon_1/automationsolutions_".replace(/\/+$/, "");

package/dist/{packager-tool-3rsttfkz.js → packager-tool-8wm4p0c5.js}

@@ -3,14 +3,14 @@ import {
   PipelinesApi,
   feedScopeInitOverride,
   resolveFeedScope
-} from "./packager-tool-hf1vax5x.js";
+} from "./packager-tool-7wpe9zbr.js";
 import {
   Configuration as Configuration2,
   PackagesApi
-} from "./packager-tool-242wgdxa.js";
+} from "./packager-tool-cmjqg8v6.js";
 import {
   getSolutionAuthContext
-} from "./packager-tool-0fh5tmf0.js";
+} from "./packager-tool-w6jkk11r.js";
 import {
   PollOutcome,
   catchError,
@@ -19,7 +19,7 @@ import {
   logger,
   mapPollFailure,
   pollUntil
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import {
   strFromU8,
   strToU8,

package/dist/{packager-tool-9zpjm6ak.js → packager-tool-9nq21cd6.js}

@@ -2,7 +2,7 @@ import {
   UsersApi,
   createApiClient,
   getSolutionAuthContext
-} from "./packager-tool-0fh5tmf0.js";
+} from "./packager-tool-w6jkk11r.js";
 import {
   catchError,
   extractErrorMessage,
@@ -12,7 +12,7 @@ import {
   isGuid,
   logger,
   normalizeProjectType
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import {
   __commonJS,
   __toESM

package/dist/{packager-tool-242wgdxa.js → packager-tool-cmjqg8v6.js}

@@ -7,7 +7,7 @@ import {
   logger,
   readUipxFile,
   summarizePlatformBody
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import {
   zipSync
 } from "./packager-tool-dfrk01gn.js";
@@ -3105,7 +3105,7 @@ async function listStudioWebSolutions(config, organizationName, options = {}) {
 var package_default = {
   name: "@uipath/solution-sdk",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.1-preview.220",
+  version: "1.202.1-preview.239",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -3495,4 +3495,4 @@ async function searchPackageVersions(config, packageKey, filter, feedFolderKey)
 }
 export { Configuration, getAvailablePublishLocationsV2, DeploymentActivationStatus, DeploymentOperationStatus, SolutionDeploymentAction, DeploymentsApi, PackagesApi, SearchApi, StudioWebIncompatibleProjectError, bundleSolution, deploymentsAutoInstall, isDebugProvisioningTerminal, isDebugProvisioningSucceeded, getProjectDebugStatus, searchPackageVersions, getStudioWebSolutionProjects, listStudioWebSolutions, isSolutionUploadHttpError, buildSolutionUploadFailureOutput, solutionExistsOnStudioWeb, importSolution, overwriteSolution };
 
-//# debugId=E2D57B889B0522DF64756E2164756E21
+//# debugId=93C2883E0EF7F43164756E2164756E21

package/dist/{packager-tool-mnw3sgv0.js → packager-tool-fa1szz9y.js}

@@ -1,7 +1,7 @@
 import {
   catchError,
   getFileSystem
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 
 // src/services/solution-init-service.ts
 var AGENTS_FILENAME = "AGENTS.md";

package/dist/{packager-tool-0avmcp1d.js → packager-tool-jzfs9dfs.js}

@@ -7,7 +7,7 @@ import {
   listSelectablePublishLocations,
   resolveFeedScope,
   resolvePersonalWorkspace
-} from "./packager-tool-hf1vax5x.js";
+} from "./packager-tool-7wpe9zbr.js";
 import {
   Configuration as Configuration2,
   DeploymentOperationStatus,
@@ -16,11 +16,11 @@ import {
   SolutionDeploymentAction,
   deploymentsAutoInstall,
   searchPackageVersions
-} from "./packager-tool-242wgdxa.js";
+} from "./packager-tool-cmjqg8v6.js";
 import {
   getSolutionAuthContext,
   resolveFolder
-} from "./packager-tool-0fh5tmf0.js";
+} from "./packager-tool-w6jkk11r.js";
 import {
   DEFAULT_PAGE_SIZE,
   PollOutcome,
@@ -31,7 +31,7 @@ import {
   mapPollFailure,
   pollUntil,
   processContext
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import {
   __commonJS,
   __require

package/dist/{packager-tool-wwhrtzjh.js → packager-tool-nknd7q3x.js}

@@ -25,7 +25,7 @@ import {
   models_BindingsResourceType,
   readUipxProjects,
   syncAndLog
-} from "./packager-tool-9zpjm6ak.js";
+} from "./packager-tool-9nq21cd6.js";
 import {
   ToolResult as ToolResult2,
   toolsFactoryRepository as toolsFactoryRepository2
@@ -41,7 +41,7 @@ import {
   logger,
   telemetry,
   unsupportedSolutionProjectType
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 
 // ../filesystem/dist/index.js
 import fs from "node:fs";
@@ -24193,7 +24193,7 @@ var sdkUserAgentHostToken2 = singleton2("SdkUserAgentHostToken");
 var package_default = {
   name: "@uipath/project-packager",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.1-preview.220",
+  version: "1.202.1-preview.239",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -35686,7 +35686,165 @@ class FilterImplicitLimitError extends Error {
     this.instructions = "Pass --limit <n> to choose how many records the filter applies to. " + "To filter over all records, pass the command's maximum accepted --limit (see the option's description in --help).";
   }
 }
-function applyFilter(data, filter) {
+function countRecords(data) {
+  if (Array.isArray(data))
+    return data.length;
+  return data == null ? 0 : 1;
+}
+function availableFields(data) {
+  const records = Array.isArray(data) ? data : [data];
+  const keys = new Set;
+  for (const record of records) {
+    if (record && typeof record === "object" && !Array.isArray(record)) {
+      for (const key of Object.keys(record))
+        keys.add(key);
+    }
+  }
+  return [...keys];
+}
+function decodeQuotedIdentifier(whole, inner) {
+  const [error, decoded] = catchError3(() => JSON.parse(whole));
+  if (!error && typeof decoded === "string")
+    return decoded;
+  return inner.replace(/\\(.)/g, "$1");
+}
+function referencedFields(filter) {
+  const top = new Set;
+  const nested = new Set;
+  const withoutValueLiterals = filter.replace(/'(?:\\.|[^'\\])*'/g, " ").replace(/`(?:\\.|[^`\\])*`/g, " ");
+  const isPathTail = (text, index) => text[index - 1] === "." && /[A-Za-z0-9_"]/.test(text[index - 2] ?? "");
+  const quoted = [];
+  const withoutLiterals = withoutValueLiterals.replace(/"((?:\\.|[^"\\])*)"/g, (whole, name, index) => {
+    const isAlias = /^\s*:/.test(withoutValueLiterals.slice(index + whole.length));
+    if (!isAlias) {
+      quoted.push({
+        name: decodeQuotedIdentifier(whole, name),
+        index,
+        tail: isPathTail(withoutValueLiterals, index)
+      });
+    }
+    return `"${" ".repeat(whole.length - 2)}"`;
+  });
+  const descent = /[A-Za-z0-9_"]\s*[.[]/.exec(withoutLiterals);
+  const rootEnd = descent ? descent.index + 1 : Number.POSITIVE_INFINITY;
+  const place = (name, index, tail) => {
+    if (tail || index >= rootEnd)
+      nested.add(name);
+    else
+      top.add(name);
+  };
+  for (const entry of quoted)
+    place(entry.name, entry.index, entry.tail);
+  const identifiers = withoutLiterals.matchAll(/([A-Za-z_][A-Za-z0-9_]*)(\s*[:(])?/g);
+  const reserved = new Set(["true", "false", "null", "and", "or", "not"]);
+  for (const match of identifiers) {
+    const [, name, trailing] = match;
+    if (trailing || reserved.has(name))
+      continue;
+    place(name, match.index, isPathTail(withoutLiterals, match.index));
+  }
+  return {
+    top: [...top],
+    nested: [...nested].filter((name) => !top.has(name)),
+    hasPredicate: /\[\s*\?/.test(withoutValueLiterals)
+  };
+}
+function appearsBelowTopLevel(data, name) {
+  let budget = 2000;
+  const visit = (value, depth) => {
+    if (budget-- <= 0 || depth > 4)
+      return false;
+    if (value === null || typeof value !== "object")
+      return false;
+    if (Array.isArray(value))
+      return value.some((entry) => visit(entry, depth));
+    const record = value;
+    if (depth > 0 && Object.hasOwn(record, name))
+      return true;
+    return Object.values(record).some((entry) => visit(entry, depth + 1));
+  };
+  return visit(data, 0);
+}
+function alwaysNullKeys(records) {
+  const objects = records.filter((r) => r != null && typeof r === "object" && !Array.isArray(r));
+  if (objects.length === 0 || objects.length !== records.length)
+    return [];
+  const keys = [...new Set(objects.flatMap((o) => Object.keys(o)))];
+  if (keys.length === 0)
+    return [];
+  const nullKeys = keys.filter((key) => objects.every((record) => record[key] === null));
+  return nullKeys.length === keys.length ? nullKeys : [];
+}
+function carriesOnlyNulls(value) {
+  if (value === null)
+    return true;
+  if (Array.isArray(value)) {
+    return value.length > 0 && value.every(carriesOnlyNulls);
+  }
+  if (typeof value === "object" && value !== undefined) {
+    const values = Object.values(value);
+    return values.length > 0 && values.every(carriesOnlyNulls);
+  }
+  return false;
+}
+function nameList(names, cap22 = 12) {
+  const shown = names.slice(0, cap22).map((n) => `\`${n}\``);
+  const rest = names.length - shown.length;
+  return shown.join(", ") + (rest > 0 ? `, and ${rest} more` : "");
+}
+function buildFilterWarning(filter, data, outcome) {
+  const present = availableFields(data);
+  const refs = referencedFields(filter);
+  const unknown = refs.top.filter((name) => !present.includes(name) && !appearsBelowTopLevel(data, name));
+  const unchecked = refs.nested.filter((name) => !present.includes(name));
+  const count = countRecords(data);
+  const scope = `${count} record(s)`;
+  const isNotAField = (names) => `${nameList(names)} ${names.length === 1 ? "is not a field" : "are not fields"} on the ${scope} it read`;
+  const soundness = unchecked.length > 0 ? `${nameList(unchecked)} ${unchecked.length === 1 ? "reads" : "read"} below the top level, so ${unchecked.length === 1 ? "it was" : "they were"} not checked against the record keys` : refs.top.length > 0 ? "every field it names exists" : "";
+  const withSoundness = (base) => soundness ? `${base}, and ${soundness}` : base;
+  let detail;
+  let lede;
+  if (outcome.kind === "null-elements") {
+    lede = "returned only null values";
+    const projected = `all ${outcome.count} of the elements it projected are null`;
+    if (unknown.length > 0) {
+      detail = `${projected}, because ${isNotAField(unknown)}`;
+    } else if (unchecked.length > 0) {
+      detail = withSoundness(projected);
+    } else {
+      detail = `${projected}, and every field it names exists — a multi-select list ` + `(\`[A, B]\`) reads each entry against \`Data\` itself, so on a list ` + `result use \`[].[A, B]\` or \`[].{a: A, b: B}\` to read the records`;
+    }
+  } else if (outcome.kind === "null-rows") {
+    lede = "returned only null values";
+    const projected = `every value it projected is null on all ${outcome.count} row(s)`;
+    detail = unknown.length > 0 ? `${projected}, because ${isNotAField(unknown)}` : withSoundness(projected);
+  } else if (outcome.kind === "null-values") {
+    lede = "returned only null values";
+    const projected = `every key it projected (${nameList(outcome.keys)}) is null`;
+    const sameSet = unknown.length === outcome.keys.length && outcome.keys.every((k) => unknown.includes(k));
+    if (sameSet) {
+      detail = `${isNotAField(outcome.keys)}, so every key it projected is null`;
+    } else if (unknown.length > 0) {
+      detail = `${projected}, because ${isNotAField(unknown)}`;
+    } else {
+      detail = withSoundness(`${projected} on all ${scope}`);
+    }
+  } else {
+    lede = "returned nothing";
+    if (unknown.length > 0) {
+      detail = isNotAField(unknown);
+    } else {
+      const selection = refs.hasPredicate ? "no record matched" : "the expression resolved to no value";
+      detail = withSoundness(`${selection} — it read ${scope}`);
+    }
+  }
+  const fields = present.length > 0 ? ` Available fields: ${nameList(present)}.` : "";
+  return `--output-filter ${JSON.stringify(filter)} ${lede}: ${detail}.${fields}`;
+}
+function appendWarning(existing, note) {
+  return existing ? `${existing} ${note}` : note;
+}
+function applyFilter(data, filter, onWarning) {
   const codec = requireJmespath();
   let result;
   try {
@@ -35694,9 +35852,34 @@ function applyFilter(data, filter) {
   } catch (err) {
     throw new FilterEvaluationError(filter, err);
   }
-  if (result == null)
+  const inputCount = countRecords(data);
+  const warn = (outcome) => {
+    if (inputCount === 0)
+      return;
+    const note = buildFilterWarning(filter, data, outcome);
+    getOutputSink2().writeErr(`[WARN] ${note}
+`);
+    onWarning?.(note);
+  };
+  const warnIfAllNull = (records) => {
+    const keys = alwaysNullKeys(records);
+    if (keys.length > 0)
+      warn({ kind: "null-values", keys });
+  };
+  if (result == null) {
+    warn({ kind: "empty" });
     return [];
+  }
   if (Array.isArray(result)) {
+    if (result.length === 0) {
+      warn({ kind: "empty" });
+    } else if (result.every((entry) => entry === null)) {
+      warn({ kind: "null-elements", count: result.length });
+    } else if (result.every((entry) => Array.isArray(entry)) && carriesOnlyNulls(result)) {
+      warn({ kind: "null-rows", count: result.length });
+    } else {
+      warnIfAllNull(result);
+    }
     if (result.length > 0 && typeof result[0] !== "object") {
       const fieldMatch = filter.match(/\.(\w+)$/);
       const key = fieldMatch ? fieldMatch[1] : "Value";
@@ -35704,10 +35887,30 @@ function applyFilter(data, filter) {
     }
     return result;
   }
-  if (typeof result === "object")
+  if (typeof result === "object") {
+    warnIfAllNull([result]);
     return result;
+  }
   return { Value: result };
 }
+function filterFailureData(envelope) {
+  const filter = getOutputFilter();
+  const data = envelope.Data;
+  if (!filter || data == null)
+    return;
+  let note;
+  const [filterError, filtered] = catchError3(() => applyFilter(data, filter, (n) => {
+    note = n;
+  }));
+  if (filterError) {
+    envelope.Warning = appendWarning(envelope.Warning, `--output-filter was not applied, so Data is shown in full: ${filterError.message}`);
+    return;
+  }
+  envelope.Data = filtered;
+  if (note) {
+    envelope.Warning = appendWarning(envelope.Warning, note);
+  }
+}
 function defaultErrorCodeForResult(result) {
   switch (result) {
     case RESULTS2.AuthenticationError:
@@ -35790,8 +35993,14 @@ var OutputFormatter2;
     }
     const filter = getOutputFilter();
     if (filter) {
-      const filtered = applyFilter(data.Data, filter);
+      let note;
+      const filtered = applyFilter(data.Data, filter, (n) => {
+        note = n;
+      });
       data.Data = normalize2 ? normalizeDataKeys(filtered, verbatim, subtrees && { refs: subtrees.refs, mode: "skip" }) : filtered;
+      if (note) {
+        data.Warning = appendWarning(data.Warning, note);
+      }
     }
     logOutput(normalizeOutputKeys(data), getOutputFormat(), options?.tableRowStyle);
   }
@@ -35819,6 +36028,7 @@ var OutputFormatter2;
     delete envelope.TelemetryErrorClass;
     delete envelope.TelemetryTerminalOutcome;
     delete envelope.TelemetryTerminalSignal;
+    filterFailureData(envelope);
     if (!suppressTelemetry) {
       telemetry2.trackEvent(CommonTelemetryEvents.Error, {
         result: data.Result,
@@ -35867,13 +36077,20 @@ var OutputFormatter2;
   OutputFormatter22.log = log2;
   function formatToString(data) {
     const filter = getOutputFilter();
+    const envelope = data;
     if ("Data" in data && data.Data != null) {
       data.Data = normalizeDataKeys(data.Data);
       if (filter) {
-        data.Data = normalizeDataKeys(applyFilter(data.Data, filter));
+        let note;
+        data.Data = normalizeDataKeys(applyFilter(data.Data, filter, (n) => {
+          note = n;
+        }));
+        if (note) {
+          envelope.Warning = appendWarning(envelope.Warning, note);
+        }
       }
     }
-    const output = normalizeOutputKeys(data);
+    const output = normalizeOutputKeys(envelope);
     const lines = [];
     const sink = getOutputSink2();
     printOutput(output, getOutputFormat(), (msg) => {
@@ -36815,7 +37032,7 @@ var sdkUserAgentHostToken22 = singleton22("SdkUserAgentHostToken");
 var package_default2 = {
   name: "@uipath/project-packager",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.1-preview.220",
+  version: "1.202.1-preview.239",
   description: "UiPath Project Packager - core library for packing individual UiPath projects",
   type: "module",
   main: "./dist/index.js",
@@ -38994,4 +39211,4 @@ async function packSolutionAsync(solutionPath, options) {
 
 export { SolutionPackOptions, isUnpackableProjectTypeError, ensurePackagerTools, createSolutionPackager, readSolutionFileAsUint8Array, resolveSdkLogLevel, applyAuthConnection, SOLUTION_PATH_INSTRUCTIONS, checkSolutionPathAsync, GOVERNANCE_OPTION_INSTRUCTIONS, validateGovernanceOptions, PackCommandService, packSolutionAsync };
 
-//# debugId=CB833A912E7536EB64756E2164756E21
+//# debugId=98764E23F9340F0964756E2164756E21

package/dist/{packager-tool-j3f1fhft.js → packager-tool-s9mb89vt.js}

@@ -1,7 +1,7 @@
 import {
   getStudioWebAuthWithOrganizationId,
   useStudioWebAuth
-} from "./packager-tool-vybnsg1q.js";
+} from "./packager-tool-1mhxcdsy.js";
 import {
   activateDeploymentAsync,
   deployRunAsync,
@@ -11,11 +11,11 @@ import {
   listPackagesAsync,
   uninstallDeploymentAsync,
   upgradeDeploymentAsync
-} from "./packager-tool-0avmcp1d.js";
+} from "./packager-tool-jzfs9dfs.js";
 import {
   SolutionInitError,
   solutionInitAsync
-} from "./packager-tool-mnw3sgv0.js";
+} from "./packager-tool-fa1szz9y.js";
 import {
   GOVERNANCE_OPTION_INSTRUCTIONS,
   PackCommandService,
@@ -30,10 +30,10 @@ import {
   readSolutionFileAsUint8Array,
   resolveSdkLogLevel,
   validateGovernanceOptions
-} from "./packager-tool-wwhrtzjh.js";
+} from "./packager-tool-nknd7q3x.js";
 import {
   publishSolutionAsync
-} from "./packager-tool-3rsttfkz.js";
+} from "./packager-tool-8wm4p0c5.js";
 import {
   Configuration,
   PipelinesApi,
@@ -41,7 +41,7 @@ import {
   feedScopeInitOverride,
   listSelectablePublishLocations,
   resolveFeedScope
-} from "./packager-tool-hf1vax5x.js";
+} from "./packager-tool-7wpe9zbr.js";
 import {
   Configuration as Configuration2,
   DeploymentActivationStatus,
@@ -59,7 +59,7 @@ import {
   overwriteSolution,
   searchPackageVersions,
   solutionExistsOnStudioWeb
-} from "./packager-tool-242wgdxa.js";
+} from "./packager-tool-cmjqg8v6.js";
 import {
   Tokens,
   applyEntryPointEnhancementAsync,
@@ -83,13 +83,13 @@ import {
   syncAndLog,
   syncResourcesFromBindings,
   writeSolutionFile
-} from "./packager-tool-9zpjm6ak.js";
+} from "./packager-tool-9nq21cd6.js";
 import {
   ToolResult
 } from "./packager-tool-nzghfa48.js";
 import {
   getSolutionAuthContext
-} from "./packager-tool-0fh5tmf0.js";
+} from "./packager-tool-w6jkk11r.js";
 import {
   DEFAULT_PAGE_SIZE,
   Option,
@@ -122,7 +122,7 @@ import {
   unsupportedSolutionProjectType,
   updateUipxSolutionId,
   withCompleter
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 import {
   strFromU8,
   unzip,
@@ -135,7 +135,7 @@ import {
 var package_default = {
   name: "@uipath/solution-tool",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.1-preview.220",
+  version: "1.202.1-preview.239",
   description: "Create, pack, publish, and deploy UiPath Automation Solutions.",
   repository: {
     type: "git",
@@ -2397,9 +2397,9 @@ var SOLUTION_PACKAGES_LIST_EXAMPLES = [
       Code: "SolutionPackagesList",
       Data: [
         {
-          packageName: "MyPackage",
-          packageVersion: "1.0.0",
-          publishDate: "2025-04-15T10:30:00Z"
+          Name: "MyPackage",
+          LatestVersion: "1.0.0",
+          PublishDate: "2025-04-15T10:30:00Z"
         }
       ]
     }
@@ -6122,7 +6122,7 @@ var registerCommands = async (program) => {
   registerResourceCommand(program);
   registerDeleteCommand(program);
   if (isPreviewBuild()) {
-    const { registerListCommand } = await import("./list-spesv97s.js");
+    const { registerListCommand } = await import("./list-vmvqzghp.js");
     registerListCommand(program);
   }
   registerFeedsCommand(program);
@@ -6130,4 +6130,4 @@ var registerCommands = async (program) => {
 
 export { metadata, registerCommands };
 
-//# debugId=5123E04BEA4F7DBD64756E2164756E21
+//# debugId=C2455A3DB063712264756E2164756E21

package/dist/{packager-tool-1hjgq91f.js → packager-tool-vtkcc4qj.js}

@@ -4400,7 +4400,165 @@ class FilterImplicitLimitError extends Error {
     this.instructions = "Pass --limit <n> to choose how many records the filter applies to. " + "To filter over all records, pass the command's maximum accepted --limit (see the option's description in --help).";
   }
 }
-function applyFilter(data, filter) {
+function countRecords(data) {
+  if (Array.isArray(data))
+    return data.length;
+  return data == null ? 0 : 1;
+}
+function availableFields(data) {
+  const records = Array.isArray(data) ? data : [data];
+  const keys = new Set;
+  for (const record of records) {
+    if (record && typeof record === "object" && !Array.isArray(record)) {
+      for (const key of Object.keys(record))
+        keys.add(key);
+    }
+  }
+  return [...keys];
+}
+function decodeQuotedIdentifier(whole, inner) {
+  const [error, decoded] = catchError(() => JSON.parse(whole));
+  if (!error && typeof decoded === "string")
+    return decoded;
+  return inner.replace(/\\(.)/g, "$1");
+}
+function referencedFields(filter) {
+  const top = new Set;
+  const nested = new Set;
+  const withoutValueLiterals = filter.replace(/'(?:\\.|[^'\\])*'/g, " ").replace(/`(?:\\.|[^`\\])*`/g, " ");
+  const isPathTail = (text, index) => text[index - 1] === "." && /[A-Za-z0-9_"]/.test(text[index - 2] ?? "");
+  const quoted = [];
+  const withoutLiterals = withoutValueLiterals.replace(/"((?:\\.|[^"\\])*)"/g, (whole, name, index) => {
+    const isAlias = /^\s*:/.test(withoutValueLiterals.slice(index + whole.length));
+    if (!isAlias) {
+      quoted.push({
+        name: decodeQuotedIdentifier(whole, name),
+        index,
+        tail: isPathTail(withoutValueLiterals, index)
+      });
+    }
+    return `"${" ".repeat(whole.length - 2)}"`;
+  });
+  const descent = /[A-Za-z0-9_"]\s*[.[]/.exec(withoutLiterals);
+  const rootEnd = descent ? descent.index + 1 : Number.POSITIVE_INFINITY;
+  const place = (name, index, tail) => {
+    if (tail || index >= rootEnd)
+      nested.add(name);
+    else
+      top.add(name);
+  };
+  for (const entry of quoted)
+    place(entry.name, entry.index, entry.tail);
+  const identifiers = withoutLiterals.matchAll(/([A-Za-z_][A-Za-z0-9_]*)(\s*[:(])?/g);
+  const reserved = new Set(["true", "false", "null", "and", "or", "not"]);
+  for (const match of identifiers) {
+    const [, name, trailing] = match;
+    if (trailing || reserved.has(name))
+      continue;
+    place(name, match.index, isPathTail(withoutLiterals, match.index));
+  }
+  return {
+    top: [...top],
+    nested: [...nested].filter((name) => !top.has(name)),
+    hasPredicate: /\[\s*\?/.test(withoutValueLiterals)
+  };
+}
+function appearsBelowTopLevel(data, name) {
+  let budget = 2000;
+  const visit = (value, depth) => {
+    if (budget-- <= 0 || depth > 4)
+      return false;
+    if (value === null || typeof value !== "object")
+      return false;
+    if (Array.isArray(value))
+      return value.some((entry) => visit(entry, depth));
+    const record = value;
+    if (depth > 0 && Object.hasOwn(record, name))
+      return true;
+    return Object.values(record).some((entry) => visit(entry, depth + 1));
+  };
+  return visit(data, 0);
+}
+function alwaysNullKeys(records) {
+  const objects = records.filter((r) => r != null && typeof r === "object" && !Array.isArray(r));
+  if (objects.length === 0 || objects.length !== records.length)
+    return [];
+  const keys = [...new Set(objects.flatMap((o) => Object.keys(o)))];
+  if (keys.length === 0)
+    return [];
+  const nullKeys = keys.filter((key) => objects.every((record) => record[key] === null));
+  return nullKeys.length === keys.length ? nullKeys : [];
+}
+function carriesOnlyNulls(value) {
+  if (value === null)
+    return true;
+  if (Array.isArray(value)) {
+    return value.length > 0 && value.every(carriesOnlyNulls);
+  }
+  if (typeof value === "object" && value !== undefined) {
+    const values = Object.values(value);
+    return values.length > 0 && values.every(carriesOnlyNulls);
+  }
+  return false;
+}
+function nameList(names, cap2 = 12) {
+  const shown = names.slice(0, cap2).map((n) => `\`${n}\``);
+  const rest = names.length - shown.length;
+  return shown.join(", ") + (rest > 0 ? `, and ${rest} more` : "");
+}
+function buildFilterWarning(filter, data, outcome) {
+  const present = availableFields(data);
+  const refs = referencedFields(filter);
+  const unknown = refs.top.filter((name) => !present.includes(name) && !appearsBelowTopLevel(data, name));
+  const unchecked = refs.nested.filter((name) => !present.includes(name));
+  const count = countRecords(data);
+  const scope = `${count} record(s)`;
+  const isNotAField = (names) => `${nameList(names)} ${names.length === 1 ? "is not a field" : "are not fields"} on the ${scope} it read`;
+  const soundness = unchecked.length > 0 ? `${nameList(unchecked)} ${unchecked.length === 1 ? "reads" : "read"} below the top level, so ${unchecked.length === 1 ? "it was" : "they were"} not checked against the record keys` : refs.top.length > 0 ? "every field it names exists" : "";
+  const withSoundness = (base) => soundness ? `${base}, and ${soundness}` : base;
+  let detail;
+  let lede;
+  if (outcome.kind === "null-elements") {
+    lede = "returned only null values";
+    const projected = `all ${outcome.count} of the elements it projected are null`;
+    if (unknown.length > 0) {
+      detail = `${projected}, because ${isNotAField(unknown)}`;
+    } else if (unchecked.length > 0) {
+      detail = withSoundness(projected);
+    } else {
+      detail = `${projected}, and every field it names exists — a multi-select list ` + `(\`[A, B]\`) reads each entry against \`Data\` itself, so on a list ` + `result use \`[].[A, B]\` or \`[].{a: A, b: B}\` to read the records`;
+    }
+  } else if (outcome.kind === "null-rows") {
+    lede = "returned only null values";
+    const projected = `every value it projected is null on all ${outcome.count} row(s)`;
+    detail = unknown.length > 0 ? `${projected}, because ${isNotAField(unknown)}` : withSoundness(projected);
+  } else if (outcome.kind === "null-values") {
+    lede = "returned only null values";
+    const projected = `every key it projected (${nameList(outcome.keys)}) is null`;
+    const sameSet = unknown.length === outcome.keys.length && outcome.keys.every((k) => unknown.includes(k));
+    if (sameSet) {
+      detail = `${isNotAField(outcome.keys)}, so every key it projected is null`;
+    } else if (unknown.length > 0) {
+      detail = `${projected}, because ${isNotAField(unknown)}`;
+    } else {
+      detail = withSoundness(`${projected} on all ${scope}`);
+    }
+  } else {
+    lede = "returned nothing";
+    if (unknown.length > 0) {
+      detail = isNotAField(unknown);
+    } else {
+      const selection = refs.hasPredicate ? "no record matched" : "the expression resolved to no value";
+      detail = withSoundness(`${selection} — it read ${scope}`);
+    }
+  }
+  const fields = present.length > 0 ? ` Available fields: ${nameList(present)}.` : "";
+  return `--output-filter ${JSON.stringify(filter)} ${lede}: ${detail}.${fields}`;
+}
+function appendWarning(existing, note) {
+  return existing ? `${existing} ${note}` : note;
+}
+function applyFilter(data, filter, onWarning) {
   const codec = requireJmespath();
   let result;
   try {
@@ -4408,9 +4566,34 @@ function applyFilter(data, filter) {
   } catch (err) {
     throw new FilterEvaluationError(filter, err);
   }
-  if (result == null)
+  const inputCount = countRecords(data);
+  const warn = (outcome) => {
+    if (inputCount === 0)
+      return;
+    const note = buildFilterWarning(filter, data, outcome);
+    getOutputSink().writeErr(`[WARN] ${note}
+`);
+    onWarning?.(note);
+  };
+  const warnIfAllNull = (records) => {
+    const keys = alwaysNullKeys(records);
+    if (keys.length > 0)
+      warn({ kind: "null-values", keys });
+  };
+  if (result == null) {
+    warn({ kind: "empty" });
     return [];
+  }
   if (Array.isArray(result)) {
+    if (result.length === 0) {
+      warn({ kind: "empty" });
+    } else if (result.every((entry) => entry === null)) {
+      warn({ kind: "null-elements", count: result.length });
+    } else if (result.every((entry) => Array.isArray(entry)) && carriesOnlyNulls(result)) {
+      warn({ kind: "null-rows", count: result.length });
+    } else {
+      warnIfAllNull(result);
+    }
     if (result.length > 0 && typeof result[0] !== "object") {
       const fieldMatch = filter.match(/\.(\w+)$/);
       const key = fieldMatch ? fieldMatch[1] : "Value";
@@ -4418,10 +4601,30 @@ function applyFilter(data, filter) {
     }
     return result;
   }
-  if (typeof result === "object")
+  if (typeof result === "object") {
+    warnIfAllNull([result]);
     return result;
+  }
   return { Value: result };
 }
+function filterFailureData(envelope) {
+  const filter = getOutputFilter();
+  const data = envelope.Data;
+  if (!filter || data == null)
+    return;
+  let note;
+  const [filterError, filtered] = catchError(() => applyFilter(data, filter, (n) => {
+    note = n;
+  }));
+  if (filterError) {
+    envelope.Warning = appendWarning(envelope.Warning, `--output-filter was not applied, so Data is shown in full: ${filterError.message}`);
+    return;
+  }
+  envelope.Data = filtered;
+  if (note) {
+    envelope.Warning = appendWarning(envelope.Warning, note);
+  }
+}
 function defaultErrorCodeForResult(result) {
   switch (result) {
     case RESULTS.AuthenticationError:
@@ -4504,8 +4707,14 @@ var OutputFormatter;
     }
     const filter = getOutputFilter();
     if (filter) {
-      const filtered = applyFilter(data.Data, filter);
+      let note;
+      const filtered = applyFilter(data.Data, filter, (n) => {
+        note = n;
+      });
       data.Data = normalize ? normalizeDataKeys(filtered, verbatim, subtrees && { refs: subtrees.refs, mode: "skip" }) : filtered;
+      if (note) {
+        data.Warning = appendWarning(data.Warning, note);
+      }
     }
     logOutput(normalizeOutputKeys(data), getOutputFormat(), options?.tableRowStyle);
   }
@@ -4533,6 +4742,7 @@ var OutputFormatter;
     delete envelope.TelemetryErrorClass;
     delete envelope.TelemetryTerminalOutcome;
     delete envelope.TelemetryTerminalSignal;
+    filterFailureData(envelope);
     if (!suppressTelemetry) {
       telemetry.trackEvent(CommonTelemetryEvents.Error, {
         result: data.Result,
@@ -4581,13 +4791,20 @@ var OutputFormatter;
   OutputFormatter.log = log;
   function formatToString(data) {
     const filter = getOutputFilter();
+    const envelope = data;
     if ("Data" in data && data.Data != null) {
       data.Data = normalizeDataKeys(data.Data);
       if (filter) {
-        data.Data = normalizeDataKeys(applyFilter(data.Data, filter));
+        let note;
+        data.Data = normalizeDataKeys(applyFilter(data.Data, filter, (n) => {
+          note = n;
+        }));
+        if (note) {
+          envelope.Warning = appendWarning(envelope.Warning, note);
+        }
       }
     }
-    const output = normalizeOutputKeys(data);
+    const output = normalizeOutputKeys(envelope);
     const lines = [];
     const sink = getOutputSink();
     printOutput(output, getOutputFormat(), (msg) => {
@@ -7825,4 +8042,4 @@ async function findSolutionFileUpward(fs2, startDir) {
 
 export { getFileSystem, catchError, carriedInstructions, extractErrorDetails, extractErrorMessage, logger, telemetry, RESULTS, Pagination, OutputFormatter, summarizePlatformBody, Command, Option, isPreviewBuild, processContext, withCompleter, requireConfirmation, DEFAULT_PAGE_SIZE, resolveEnvReference, isGuid, createHiddenDeprecatedTenantOption, parseLimit, parseOffset, parseBoundedInt, registerPackageMetadataOptions, mapPackageMetadataOptions, PollOutcome, mapPollFailure, pollUntil, getSdkUserAgentToken, addSdkUserAgentHeader, installSdkUserAgentHeader, unsupportedSolutionProjectType, trackShipSucceeded, ensurePackagerFactory, getLoginStatusAsync, getAuthContext, normalizeProjectType, toPortableRelativePath, readUipxFile, resolveSolutionDir, updateUipxSolutionId, findSolutionFileUpward };
 
-//# debugId=3B95928D2AAC1F9764756E2164756E21
+//# debugId=CE7275788F98A6E164756E2164756E21

package/dist/{packager-tool-0fh5tmf0.js → packager-tool-w6jkk11r.js}

@@ -3,7 +3,7 @@ import {
   getAuthContext,
   getSdkUserAgentToken,
   installSdkUserAgentHeader
-} from "./packager-tool-1hjgq91f.js";
+} from "./packager-tool-vtkcc4qj.js";
 
 // ../solution-sdk/src/solution-auth.ts
 async function getSolutionAuthContext(options) {

package/dist/publish.js

@@ -1,10 +1,10 @@
 import {
   publishSolutionAsync
-} from "./packager-tool-3rsttfkz.js";
-import"./packager-tool-hf1vax5x.js";
-import"./packager-tool-242wgdxa.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+} from "./packager-tool-8wm4p0c5.js";
+import"./packager-tool-7wpe9zbr.js";
+import"./packager-tool-cmjqg8v6.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/resource.js

@@ -1,9 +1,9 @@
 import {
   resourceRefreshAsync
-} from "./packager-tool-9zpjm6ak.js";
+} from "./packager-tool-9nq21cd6.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/dist/templates/AGENTS.md

@@ -407,10 +407,13 @@ uip or assets create        # create an asset (see --help)
 
 ## Output Conventions for Agents
 
-Two rules make automation reliable:
+Three rules make automation reliable:
 
 1. **Never redirect or drop stderr.** Errors and confirmations go to stderr — `2>/dev/null` will silently hide failures and produce false retries.
-2. **Use `--output-filter <jmespath>`** to extract specific fields rather than piping JSON through external tools. The expression is applied to the `Data` array — start with `[]`, not with `Data[]`. On list commands with a default `--limit`, an explicit `--limit` is required with `--output-filter` (the filter only sees the records fetched). Example: `uip solution packages list --limit 100 --output-filter "[].name"`.
+2. **Use `--output-filter <jmespath>`** to extract specific fields rather than piping JSON through external tools. The expression is applied to the `Data` array — start with `[]`, not with `Data[]`. On list commands with a default `--limit`, an explicit `--limit` is required with `--output-filter` (the filter only sees the records fetched). Example: `uip solution packages list --limit 100 --output-filter "[].Name"`.
+3. **Match the key casing of the unfiltered output.** Filter keys are case-sensitive and most commands print `Data` keys in PascalCase, so write `[].Name`, not `[].name` — the wrong casing matches nothing and returns `Data: []`. A few commands pass their keys through verbatim (`uip maestro flow registry get` is one, where `Node.inputDefinition.fields` is correct). If you are unsure, run the command once without `--output-filter` and read the keys off the output.
+
+A filter that selects nothing still returns `Result: "Success"` with `Data: []` and exit 0 — that is a valid empty answer, not a failure. Check the `Warning` field and stderr. They say which it was: a field name that does not exist (fix the expression), no record matched or the expression resolved to no value (the answer really is empty), or a name that reads below the top level (`Items[].Name` reads `Name` off an `Items` entry, so only `Items` was checked — an empty `Items` is the usual cause, not a bad name).
 
 Standard success shape: `{ "Result": "Success", "Code": "<CommandCode>", "Data": ... }`.
 Standard failure shape: `{ "Result": "Failure", "Message": "<short>", "Instructions": "<actionable>" }`.

package/dist/tool.js

@@ -1,19 +1,19 @@
 import {
   metadata,
   registerCommands
-} from "./packager-tool-j3f1fhft.js";
-import"./packager-tool-vybnsg1q.js";
-import"./packager-tool-0avmcp1d.js";
-import"./packager-tool-mnw3sgv0.js";
-import"./packager-tool-wwhrtzjh.js";
+} from "./packager-tool-s9mb89vt.js";
+import"./packager-tool-1mhxcdsy.js";
+import"./packager-tool-jzfs9dfs.js";
+import"./packager-tool-fa1szz9y.js";
+import"./packager-tool-nknd7q3x.js";
 import"./packager-tool-p6mgvgdk.js";
-import"./packager-tool-3rsttfkz.js";
-import"./packager-tool-hf1vax5x.js";
-import"./packager-tool-242wgdxa.js";
-import"./packager-tool-9zpjm6ak.js";
+import"./packager-tool-8wm4p0c5.js";
+import"./packager-tool-7wpe9zbr.js";
+import"./packager-tool-cmjqg8v6.js";
+import"./packager-tool-9nq21cd6.js";
 import"./packager-tool-nzghfa48.js";
-import"./packager-tool-0fh5tmf0.js";
-import"./packager-tool-1hjgq91f.js";
+import"./packager-tool-w6jkk11r.js";
+import"./packager-tool-vtkcc4qj.js";
 import"./packager-tool-dfrk01gn.js";
 import"./packager-tool-1de529jm.js";
 export {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@uipath/solution-tool",
     "license": "SEE LICENSE IN LICENSE.txt",
-    "version": "1.202.1-preview.220",
+    "version": "1.202.1-preview.239",
     "description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
     "repository": {
         "type": "git",
@@ -47,5 +47,5 @@
         "dist"
     ],
     "private": false,
-    "gitHead": "a09041733b628c3f6b658a1f58349ea0f40bb492"
+    "gitHead": "97545a7857bdff7e6db62bbe13c6097607cf38f1"
 }