@uipath/maestro-builder-sdk 6.10.0 → 6.10.2

package/dist/decompile.js

@@ -1923,15 +1923,37 @@ function armCb(param, segs) {
  * fall-off End the serializer always appends; it now decompiles to an explicit
  * `.return({}, { version })` so the End's exact definition version survives the
  * round trip (design §5.3) — recompiling emits the identical node.
+ *
+ * An End written by the designer or the product CLI carries its returned value
+ * ONLY in `outputs[name].source` — it writes no `variableUpdates` row. Reading
+ * updates alone decompiled such an End to `.return({})` and silently dropped the
+ * value it returned (a Decision's two Ends returning `'nice day'` /
+ * `'bring a jacket'` both came back empty). So an output whose source is not the
+ * identity `$vars.<name>` mapping `endOutputs` fills in is a returned value too.
  */
 function returnSeg(node, ctx) {
     const updates = ctx.flow.variables?.variableUpdates?.[node.id] ?? [];
     const opts = returnOptsArg(node);
-    if (updates.length === 0)
-        return `.return({}${opts})`;
     const entries = updates.map((u) => `${key(u.variableId)}: ${emitVal(u.expression, ctx.imp, ctx.inputNames)}`);
+    const written = new Set(updates.map((u) => u.variableId));
+    for (const [name, out] of Object.entries(node.outputs ?? {})) {
+        if (written.has(name))
+            continue;
+        const source = out?.source;
+        const raw = unwrapSource(source);
+        if (raw === undefined || isIdentityEndSource(raw, name))
+            continue;
+        entries.push(`${key(name)}: ${emitVal(source, ctx.imp, ctx.inputNames)}`);
+    }
+    if (entries.length === 0)
+        return `.return({}${opts})`;
     return `.return({ ${entries.join(', ')} }${opts})`;
 }
+/** The fill-in mapping `endOutputs` writes for an output no `.return` named: `=js:$vars.<name>`. */
+function isIdentityEndSource(raw, name) {
+    const body = raw.startsWith('=js:') ? raw.slice(4) : raw;
+    return body.trim() === `$vars.${name}`;
+}
 /**
  * The options argument for a `.return(...)` — `version`, plus the End's `name`
  * and `label` when they are not what the serializer would derive on its own.

package/dist/registry/prepare/messages.d.ts

@@ -187,16 +187,27 @@ export declare function candidateResolvesAllLine(label: string, lookups: number)
 export declare function candidateExhaustedLine(label: string, field: string, scanned: number): string;
 /** The terminal report's line for a candidate whose lookup failed for another reason: the error, verbatim. */
 export declare function candidateErrorLine(label: string, error: unknown): string;
+/**
+ * The command that shows what a lookup's collection holds on one connection.
+ *
+ * Every refusal that ends in "check the value" carries it: the value the author
+ * wrote may be one the task never named (an invented Slack channel), and
+ * without this line the only way to learn the real values is to leave the
+ * documented loop. The skills eval customer-escalation dead-ended exactly
+ * there on 2026-09-25 (UiPath/flow-builder-sdk#817).
+ */
+export declare function collectionListingHint(connectorKey: string, collection: string, connectionId: string): string;
 /**
  * An explicit `--connection-id` / `--connection` is the author's decision and
  * is not overridden. The alternatives are still named, because the whole cost
  * of this bug was not knowing they existed. `first` is the exhausted lookup's
- * own message; `others` the pasteable listing of the other candidates.
+ * own message; `others` the pasteable listing of the other candidates; `hint`
+ * the {@link collectionListingHint} for the pinned connection.
  */
-export declare function pinnedConnectionExhaustedMessage(first: string, connectorKey: string, othersCount: number, othersListing: string): string;
+export declare function pinnedConnectionExhaustedMessage(first: string, connectorKey: string, othersCount: number, othersListing: string, hint: string): string;
 /** The listing of other connections itself failed; the original lookup failure is what the author asked about. */
 export declare function candidateListingFailedMessage(first: string, error: unknown): string;
-export declare function onlyConnectionMessage(first: string, connectorKey: string): string;
+export declare function onlyConnectionMessage(first: string, connectorKey: string, hint: string): string;
 /** Two or more candidates resolve everything: reported, never chosen between. */
 export declare function severalConnectionsResolveMessage(count: number, connectorKey: string, listing: string): string;
 /**

package/dist/registry/prepare/messages.js

@@ -443,13 +443,27 @@ export function candidateExhaustedLine(label, field, scanned) {
 export function candidateErrorLine(label, error) {
     return `    ${label}  ${messageOf(error)}`;
 }
+/**
+ * The command that shows what a lookup's collection holds on one connection.
+ *
+ * Every refusal that ends in "check the value" carries it: the value the author
+ * wrote may be one the task never named (an invented Slack channel), and
+ * without this line the only way to learn the real values is to leave the
+ * documented loop. The skills eval customer-escalation dead-ended exactly
+ * there on 2026-09-25 (UiPath/flow-builder-sdk#817).
+ */
+export function collectionListingHint(connectorKey, collection, connectionId) {
+    return (`To see what ${pyRepr(collection)} holds on this connection:\n` +
+        `  uip is resources run list ${connectorKey} ${collection} --connection-id ${connectionId}`);
+}
 /**
  * An explicit `--connection-id` / `--connection` is the author's decision and
  * is not overridden. The alternatives are still named, because the whole cost
  * of this bug was not knowing they existed. `first` is the exhausted lookup's
- * own message; `others` the pasteable listing of the other candidates.
+ * own message; `others` the pasteable listing of the other candidates; `hint`
+ * the {@link collectionListingHint} for the pinned connection.
  */
-export function pinnedConnectionExhaustedMessage(first, connectorKey, othersCount, othersListing) {
+export function pinnedConnectionExhaustedMessage(first, connectorKey, othersCount, othersListing, hint) {
     let extra = "";
     if (othersCount > 0) {
         extra =
@@ -457,14 +471,16 @@ export function pinnedConnectionExhaustedMessage(first, connectorKey, othersCoun
                 `${othersListing}\n` +
                 "Re-run against one of those, or check the value. This run kept the connection you named.";
     }
-    return `${PREFIX}${first}${extra}`;
+    return `${PREFIX}${first}${extra}\n${hint}`;
 }
 /** The listing of other connections itself failed; the original lookup failure is what the author asked about. */
 export function candidateListingFailedMessage(first, error) {
     return `${PREFIX}${first}\n(could not list other connections: ${messageOf(error)})`;
 }
-export function onlyConnectionMessage(first, connectorKey) {
-    return (`${PREFIX}${first}\n` + `This is the only enabled ${connectorKey} connection on the tenant, so the value is what to check.`);
+export function onlyConnectionMessage(first, connectorKey, hint) {
+    return (`${PREFIX}${first}\n` +
+        `This is the only enabled ${connectorKey} connection on the tenant, so the value is what to check.\n` +
+        hint);
 }
 /** Two or more candidates resolve everything: reported, never chosen between. */
 export function severalConnectionsResolveMessage(count, connectorKey, listing) {
@@ -484,9 +500,7 @@ export function noConnectionResolvesMessage(connectorKey, first, lines, connecti
         `${first.field}: ${first.by}=${pyRepr(first.value)}\n` +
         `${lines.join("\n")}\n` +
         "Every candidate was read to the end, so the value is what to check now. " +
-        `To see what ${pyRepr(first.collection)} holds:\n` +
-        `  uip is resources run list ${connectorKey} ${first.collection} ` +
-        `--connection-id ${connectionId}`);
+        collectionListingHint(connectorKey, first.collection, connectionId));
 }
 // ---------------------------------------------------------------------------
 // The event path

package/dist/registry/prepare/retry.js

@@ -1,5 +1,5 @@
 import { ConnectionRefusal, candidateConnections, candidateListing } from "./connections.js";
-import { PrepareRefusal, candidateErrorLine, candidateExhaustedLine, candidateLabel, candidateListingFailedMessage, candidateResolvesAllLine, noConnectionResolvesMessage, onlyConnectionMessage, pinnedConnectionExhaustedMessage, severalConnectionsResolveMessage, tryingOtherConnectionsLine, } from "./messages.js";
+import { PrepareRefusal, candidateErrorLine, candidateExhaustedLine, candidateLabel, candidateListingFailedMessage, candidateResolvesAllLine, collectionListingHint, noConnectionResolvesMessage, onlyConnectionMessage, pinnedConnectionExhaustedMessage, severalConnectionsResolveMessage, tryingOtherConnectionsLine, } from "./messages.js";
 import { LookupExhausted, ResolutionRefusal, resolveOne } from "./resolve.js";
 import { pyGet, pyStrAny } from "./support.js";
 /**
@@ -61,7 +61,7 @@ export async function retryOtherConnections(ctx, plan, first) {
                 throw error;
             throw new PrepareRefusal(candidateListingFailedMessage(first.message, error), "LOOKUP_EXHAUSTED_PINNED");
         }
-        throw new PrepareRefusal(pinnedConnectionExhaustedMessage(first.message, ctx.connectorKey, others.length, candidateListing(others)), "LOOKUP_EXHAUSTED_PINNED");
+        throw new PrepareRefusal(pinnedConnectionExhaustedMessage(first.message, ctx.connectorKey, others.length, candidateListing(others), collectionListingHint(ctx.connectorKey, first.collection, ctx.connectionId)), "LOOKUP_EXHAUSTED_PINNED");
     }
     let candidates;
     try {
@@ -76,7 +76,7 @@ export async function retryOtherConnections(ctx, plan, first) {
     }
     const others = candidates.filter((row) => !sameId(row));
     if (others.length === 0) {
-        throw new PrepareRefusal(onlyConnectionMessage(first.message, ctx.connectorKey), "LOOKUP_EXHAUSTED_ONLY_CONNECTION");
+        throw new PrepareRefusal(onlyConnectionMessage(first.message, ctx.connectorKey, collectionListingHint(ctx.connectorKey, first.collection, ctx.connectionId)), "LOOKUP_EXHAUSTED_ONLY_CONNECTION");
     }
     ctx.reporter.info(tryingOtherConnectionsLine(first.field, others.length, ctx.connectorKey));
     const winners = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.10.0",
+  "version": "6.10.2",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -92,5 +92,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "d50db2eeec64253d691dc9512ee9e7027062665b"
+  "gitref": "0c68e2f56257719fc7db812ce8cdb3e097c5444c"
 }