@uipath/maestro-builder-sdk 6.10.1 → 6.10.2

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.1",
+  "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": "388e366bc878b0b6701b2842d56479125f6a9edd"
+  "gitref": "0c68e2f56257719fc7db812ce8cdb3e097c5444c"
 }