@uipath/flow-tool 1.205.0-preview.276 → 1.206.0-preview.279

package/dist/{packager-tool-1nfbzy0h.js → packager-tool-72xwbsmw.js}

@@ -1,18 +1,42 @@
 import {
-  DEFAULT_INTERVAL_MS,
-  DEFAULT_TIMEOUT_MS,
-  pendingSecondsFor,
-  pendingStallInstructions
-} from "./packager-tool-aw9v0raw.js";
-import {
-  package_default
-} from "./packager-tool-wvmtp8zt.js";
+  getFileSystem
+} from "./packager-tool-vgrswa8p.js";
 import {
-  VALID_RESOURCE_TYPES
-} from "./packager-tool-27avrkyk.js";
+  CommandDimensions,
+  ShipDimensions,
+  catchError2
+} from "./packager-tool-pxq0bwp0.js";
 import {
-  UnknownEntryPointError
-} from "./packager-tool-4kr6g0zw.js";
+  carriedErrorCode,
+  extractErrorDetails,
+  extractErrorMessage,
+  extractErrorMessageSync,
+  appendOption,
+  ATTACHMENT_INSTRUCTIONS,
+  ATTACHMENT_UPLOAD_INSTRUCTIONS,
+  parseAttachmentSpec,
+  resolveAttachmentInputs,
+  instructionsFor,
+  RESULTS,
+  classifiedFailure,
+  authContextFailure,
+  summarizePlatformBody,
+  Option,
+  logger,
+  Pagination,
+  apiPagination,
+  OutputFormatter,
+  processContext,
+  createHiddenDeprecatedTenantOption,
+  parseLimit,
+  parseOffset,
+  parseBoundedInt,
+  registerPackageMetadataOptions,
+  mapPackageMetadataOptions,
+  ScreenLogger,
+  splitPackagedName,
+  trackShipSucceeded
+} from "./packager-tool-8ed52y5r.js";
 import {
   registerRegistryCommand,
   registerSharedDebugInstanceCommands,
@@ -20,56 +44,42 @@ import {
   registerSharedInstanceCommands,
   registerSharedProcessCommands,
   registerSharedProcessesCommands
-} from "./packager-tool-1d64q5s5.js";
+} from "./packager-tool-b2pkwwj1.js";
 import {
   evaluatorTypeAliases,
+  resolveLoginConfig,
   formatDuration,
-  formatEvalSetRunRow,
   formatEvaluatorScores,
+  remoteRunScore,
   formatRemoteEvalRunRow,
   isFailedRemoteRun,
   isTerminalRemoteStatus,
-  remoteRunScore,
-  resolveLoginConfig
-} from "./packager-tool-xk78j7dz.js";
+  formatEvalSetRunRow
+} from "./packager-tool-ac6rvny7.js";
+import {
+  pendingSecondsFor,
+  pendingStallInstructions,
+  DEFAULT_TIMEOUT_MS,
+  DEFAULT_INTERVAL_MS
+} from "./packager-tool-8c7nddd1.js";
 import {
-  setAgentProjectMetadataReader
-} from "./packager-tool-8qp60s20.js";
+  VALID_RESOURCE_TYPES
+} from "./packager-tool-k3egwd1m.js";
 import {
-  ATTACHMENT_INSTRUCTIONS,
-  ATTACHMENT_UPLOAD_INSTRUCTIONS,
-  CommandDimensions,
-  OutputFormatter,
-  Pagination,
-  RESULTS,
-  ScreenLogger,
-  ShipDimensions,
-  appendOption,
-  createHiddenDeprecatedTenantOption,
-  extractErrorMessage,
-  extractErrorMessageSync,
-  instructionsFor,
-  logger,
-  mapPackageMetadataOptions,
-  parseAttachmentSpec,
-  parseLimit,
-  parseOffset,
-  processContext,
-  registerPackageMetadataOptions,
-  resolveAttachmentInputs,
-  splitPackagedName,
-  summarizePlatformBody,
-  trackShipSucceeded
-} from "./packager-tool-apawc11t.js";
+  package_default
+} from "./packager-tool-7qtnffkc.js";
 import {
-  catchError
-} from "./packager-tool-t7ahhaer.js";
+  UnknownEntryPointError
+} from "./packager-tool-cvh1a0nm.js";
 import {
-  getFileSystem
-} from "./packager-tool-myhbp761.js";
+  setAgentProjectMetadataReader2
+} from "./packager-tool-q2f18crb.js";
 import {
-  __require
-} from "./packager-tool-1yh8g550.js";
+  formatTraceLine,
+  backendFailure,
+  genericObjectDiscoveryCommands,
+  addJobTracesOptions
+} from "./packager-tool-4zt1s51a.js";
 
 // src/utils/row-window.ts
 function addRowWindowOptions(command) {
@@ -91,17 +101,6 @@ function rowWindow(rows, options) {
     })
   };
 }
-function apiPagination(returned, options) {
-  const { limit, offset } = options;
-  if (limit === undefined && offset === 0) {
-    return;
-  }
-  return new Pagination({
-    returned,
-    limit: limit ?? Math.max(returned, 1),
-    offset
-  });
-}
 
 // src/commands/binding.ts
 var BINDING_LIST_EXAMPLES = [
@@ -163,8 +162,8 @@ var BINDING_DELETE_EXAMPLES = [
 var registerBindingCommand = (program) => {
   const binding = program.command("bindings").alias("binding").description("Manage bindings in a Flow file");
   addRowWindowOptions(binding.command("list")).description("List all bindings in a Flow file").argument("<file>", "Path to the .flow file").examples(BINDING_LIST_EXAMPLES).trackedAction(processContext, async (file, options) => {
-    const { listBindingsInFlow } = await import("./binding-service-0qffbxg7.js");
-    const [error, result] = await catchError(listBindingsInFlow(file));
+    const { listBindingsInFlow } = await import("./binding-service-s0wvr2xm.js");
+    const [error, result] = await catchError2(listBindingsInFlow(file));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -187,8 +186,8 @@ var registerBindingCommand = (program) => {
   });
   binding.command("create").alias("add").description(`Add a binding to a Flow file.
 ` + `Valid resource types: ${VALID_RESOURCE_TYPES.join(", ")}`).argument("<file>", "Path to the .flow file").argument("<name>", "Binding display name").argument("<resource>", "Resource type").argument("<default-value>", "Default value for the binding").option("--resource-key <key>", "Resource catalog identifier").option("--property-attribute <attr>", "Target node property (e.g., name, folderPath, connection)").option("--resource-sub-type <type>", "Resource sub-classification (e.g., Agent, Process)").examples(BINDING_ADD_EXAMPLES).trackedAction(processContext, async (file, name, resource, defaultValue, options) => {
-    const { addBindingToFlow } = await import("./binding-service-0qffbxg7.js");
-    const [error, result] = await catchError(addBindingToFlow(file, name, resource, defaultValue, {
+    const { addBindingToFlow } = await import("./binding-service-s0wvr2xm.js");
+    const [error, result] = await catchError2(addBindingToFlow(file, name, resource, defaultValue, {
       resourceKey: options.resourceKey,
       propertyAttribute: options.propertyAttribute,
       resourceSubType: options.resourceSubType
@@ -211,8 +210,8 @@ var registerBindingCommand = (program) => {
     });
   });
   binding.command("delete").alias("remove").description("Remove all bindings with a given resource key from a Flow file").argument("<file>", "Path to the .flow file").argument("<resource-key>", "Resource key of the bindings to remove").examples(BINDING_DELETE_EXAMPLES).trackedAction(processContext, async (file, resourceKey) => {
-    const { deleteBindingFromFlow } = await import("./binding-service-0qffbxg7.js");
-    const [error, result] = await catchError(deleteBindingFromFlow(file, resourceKey));
+    const { deleteBindingFromFlow } = await import("./binding-service-s0wvr2xm.js");
+    const [error, result] = await catchError2(deleteBindingFromFlow(file, resourceKey));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -267,7 +266,7 @@ function buildDebugSummary(result) {
 var FULL_DEBUG_OUTPUT_DIR = ".flow-debug";
 var FULL_DEBUG_OUTPUT_GITIGNORE = "# Written by `uip maestro flow debug --summary`: local debug records with tenant data.\n*\n";
 async function writeFullDebugOutput(fs, projectPath, envelope) {
-  const { findNearestParentUipxFile } = await import("./index-y1ym28vg.js");
+  const { findNearestParentUipxFile } = await import("./index-g2p2ww34.js");
   const projectDir = fs.path.resolve(projectPath);
   const discovery = await findNearestParentUipxFile(fs, projectDir);
   const solutionDir = discovery.status === "found" ? fs.path.dirname(discovery.solutionFile) : fs.path.resolve(projectDir, "..");
@@ -321,11 +320,14 @@ function buildHttpFailureOutput(err) {
   return output;
 }
 function pickRetryHint(err) {
+  if (isRetriedPoll403(err))
+    return "RetryAfter30Seconds";
   if (err.httpStatus < 500 || err.httpStatus >= 600) {
     return;
   }
   return (err.attempts ?? 1) > 1 ? "RetryWillNotFix" : "RetryAfter30Seconds";
 }
+var isRetriedPoll403 = (err) => err.httpStatus === 403 && err.stage === "poll-instance-status" && (err.attempts ?? 1) > 1;
 function pickInstructions(err) {
   const isOpaque5xx = err.httpStatus >= 500 && err.httpStatus < 600 && (err.parsedErrorCode === undefined || err.parsedErrorCode === "0");
   if (isOpaque5xx) {
@@ -338,6 +340,10 @@ function pickInstructions(err) {
     }
     return `The backend returned an unstructured ${err.httpStatus} during '${stage}'.${traceHint} ` + `This is often transient — wait ~30s and retry once. If it fails again, capture the traceId ` + `and ${err.method} ${err.endpoint} and escalate to the owning service team.`;
   }
+  if (isRetriedPoll403(err)) {
+    const traceIds = err.traceIds?.length ? ` traceIds: ${err.traceIds.join(", ")}.` : "";
+    return `${err.method} ${err.endpoint} returned 403 on all ${err.attempts} attempts during ` + `'poll-instance-status', after the run had started. PIMS answers 403 here when its ` + `authorization check times out, so this is usually not your login. Re-run 'debug' ` + `in ~30s. If it fails the same way again, run 'uip login' and verify the active ` + `tenant has access.${traceIds}`;
+  }
   if (err.httpStatus === 401 || err.httpStatus === 403) {
     return `Authentication/authorization rejected by ${err.method} ${err.endpoint}. ` + `Run 'uip login' and verify the active tenant has access.`;
   }
@@ -348,8 +354,8 @@ function pickInstructions(err) {
       const bodySuffix = body ? ` Platform response: "${body}".` : "";
       return `${err.method} ${err.endpoint} returned 404 during '${err.stage ?? "request"}', ` + `but the response was not a structured Orchestrator error — the request likely ` + `did not reach the tenant. This usually means the organization or tenant in your ` + `login session is wrong or was renamed. Run 'uip login tenant list' to see the ` + `current tenant names, re-select with 'uip login tenant set <name>' (or re-run ` + `'uip login'), then retry. Do not create a new workspace or retry as-is — the ` + `resource likely exists under the current tenant name.${bodySuffix}`;
     }
-    const detail2 = err.parsedErrorMessage ? ` Backend reported: "${err.parsedErrorMessage}".` : "";
-    return `${err.method} ${err.endpoint} returned 404 during '${err.stage ?? "request"}'. ` + `The target resource may not exist — verify upstream IDs (solutionId, instanceId) ` + `and re-run.${detail2}`;
+    const detail = err.parsedErrorMessage ? ` Backend reported: "${err.parsedErrorMessage}".` : "";
+    return `${err.method} ${err.endpoint} returned 404 during '${err.stage ?? "request"}'. ` + `The target resource may not exist — verify upstream IDs (solutionId, instanceId) ` + `and re-run.${detail}`;
   }
   const detail = err.parsedErrorMessage ? ` Backend reported: "${err.parsedErrorMessage}".` : "";
   return `${err.method} ${err.endpoint} failed with HTTP ${err.httpStatus} during ` + `'${err.stage ?? "request"}'.${detail} Inspect the response body for details ` + `and retry once before reporting.`;
@@ -365,7 +371,7 @@ function buildIncidentInstructions(incidents, instanceId) {
   const lines = summarizeIncidents(incidents);
   const first = incidents[0];
   const traceHint = first?.traceId ? ` traceId=${first.traceId}.` : "";
-  const detailHint = `Run 'uip maestro flow debug-instance incidents ${instanceId}' for ` + `the full backend payload (incidentId, errorDetails, AI summary).`;
+  const detailHint = `Run 'uip maestro flow debug-instances incidents ${instanceId}' for ` + `the full backend payload (incidentId, errorDetails, AI summary).`;
   return `Incident(s):
   - ${lines.join(`
   - `)}
@@ -374,14 +380,14 @@ ${detailHint}${traceHint}`;
 function variablesRetryCommand(instanceId, error) {
   const ids = error.expectedGlobals?.length ? error.expectedGlobals : error.missingGlobals;
   const expect = ids?.length ? ` --expected-outputs ${ids.join(" ")}` : "";
-  return `'uip maestro flow debug-instance variables ${instanceId}${expect}'`;
+  return `'uip maestro flow debug-instances variables ${instanceId}${expect}'`;
 }
 var CONVERSATIONAL_DEBUG_WARNING = "This flow, which starts on a conversation trigger, can only be debugged from a chat UI. " + `Debug it using the chat panel from either:
 ` + "  1. Studio Web — open the debug URL printed once the solution uploads " + `(also 'Data.studioWebUrl' in the result).
 ` + "  2. UiPath Maestro VS Code extension — open the flow and hit Debug.";
 async function readProjectFlowNodes(projectPath) {
-  const [error, nodes] = await catchError((async () => {
-    const { readFlowWorkflow, resolveProjectFlowFile } = await import("./flow-io-2qdyj5e0.js");
+  const [error, nodes] = await catchError2((async () => {
+    const { readFlowWorkflow, resolveProjectFlowFile } = await import("./flow-io-9q6xk473.js");
     const flowFilePath = await resolveProjectFlowFile(projectPath);
     const { workflow } = await readFlowWorkflow(flowFilePath);
     return workflow.nodes ?? [];
@@ -469,7 +475,7 @@ var FOLDER_RESOLUTION_INSTRUCTIONS = "Provide a valid --folder-key (UUID) or --f
 var FOLDER_RESOLUTION_NETWORK_INSTRUCTIONS = "The folder lookup itself failed (network / Orchestrator API). Re-authenticate with 'uip login', verify connectivity, and retry.";
 var DEBUG_FAILURE_INSTRUCTIONS = "Check that the flow project is valid, the selected folder is accessible, and Studio Web debug is available, then retry.";
 async function openInBrowserOrWarn(url) {
-  const [openError] = await catchError(async () => {
+  const [openError] = await catchError2(async () => {
     await getFileSystem().utils.open(url);
   });
   if (openError) {
@@ -512,12 +518,12 @@ function parsePositiveIntegerOption(value, optionName) {
 }
 function registerDebugCommand(program) {
   program.command("debug").description("Debug a flow project by uploading to Studio Web and running a debug session").argument("<project-path>", "Path to the flow project directory (must contain project.uiproj)").option("--folder-id <id>", "Orchestrator folder ID (OrganizationUnitId) as a positive integer. Mutually exclusive with --folder-key/--folder-path. Auto-detected if none are provided.").option("--folder-key <key>", "Orchestrator folder key (UUID). The CLI resolves it to the folder ID. Mutually exclusive with --folder-id/--folder-path.").option("--folder-path <path>", "Orchestrator folder path (e.g. 'Shared/Sub'). The CLI resolves it to the folder ID. Mutually exclusive with --folder-id/--folder-key.").option("--poll-interval <ms>", "Polling interval in milliseconds", "2000").option("--timeout <seconds>", "Maximum seconds to wait for debug completion").option("-i, --inputs <json>", "Input parameters as JSON string or @file.json").option("--entry-point <id>", "Entry point node id — a trigger node id from the .flow file. Defaults to the trigger marked isDefaultEntryPoint, else the first trigger").option("--attachment <name=path>", "Upload a file as a file-typed workflow input variable (repeatable). " + "Example: --attachment file1=./resume.pdf", appendOption, []).option("--summary", "Return only the run's status, its failed elements and the flow's declared outputs, " + "instead of every node's raw output. The full result, tenant data included, is written to " + "<solution>/.flow-debug/<project>.json (<project> relative to the solution; the folder's own " + ".gitignore ignores it; never packed or uploaded) and named in Data.fullOutputPath.").option("--open-in-browser", "Open the Studio Web URL in the browser once it is known.").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).examples(FLOW_DEBUG_EXAMPLES).trackedAction(processContext, async (projectPath, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
+    const { getAuthContext } = await import("./index-f5kq7265.js");
     const nodes = await readProjectFlowNodes(projectPath);
     let isConversational = false;
     if (nodes !== undefined) {
-      const { startsOnConversationTrigger } = await import("./debug-conversation-trigger-2crr9w4n.js");
-      const [entryPointError, conversational] = catchError(() => startsOnConversationTrigger({ nodes }, options.entryPoint));
+      const { startsOnConversationTrigger } = await import("./debug-conversation-trigger-3wzy90kj.js");
+      const [entryPointError, conversational] = catchError2(() => startsOnConversationTrigger({ nodes }, options.entryPoint));
       if (entryPointError instanceof UnknownEntryPointError) {
         OutputFormatter.error({
           Result: RESULTS.ValidationError,
@@ -540,82 +546,26 @@ function registerDebugCommand(program) {
       }
     }
     let urlReported = false;
-    const [loginError, login] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      requireOrganizationId: true,
+      requireOrganizationName: true,
+      requireTenantId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: LOGIN_INSTRUCTIONS
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError, LOGIN_INSTRUCTIONS));
       processContext.exit(1);
       return;
     }
     const {
-      loginStatus,
       baseUrl,
       accessToken,
       organizationId,
       tenantId,
       tenantName,
-      organizationUnitId,
       organizationName
-    } = login;
-    if (loginStatus !== "Logged in" || !baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Organization ID not available from login.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!tenantId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Tenant ID not available from login.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!tenantName) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Tenant name not available from login.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!accessToken) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Access token not available from login.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!organizationName) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Organization name not available from login. Required for Studio Web debug.",
-        Instructions: LOGIN_INSTRUCTIONS
-      });
-      processContext.exit(1);
-      return;
-    }
+    } = auth;
     const folderTargetingFlags = [
       options.folderId !== undefined ? "--folder-id" : undefined,
       options.folderKey !== undefined ? "--folder-key" : undefined,
@@ -644,8 +594,8 @@ function registerDebugCommand(program) {
       }
       userProvidedFolderId = parsed.value;
     } else if (options.folderKey !== undefined || options.folderPath !== undefined) {
-      const { resolveFolder } = await import("./index-wycgq0ff.js");
-      const [folderError, folder] = await catchError(resolveFolder({
+      const { resolveFolder } = await import("./index-4e3w8x62.js");
+      const [folderError, folder] = await catchError2(resolveFolder({
         folderKey: options.folderKey,
         folderPath: options.folderPath
       }, { loginValidity: options.loginValidity }));
@@ -669,7 +619,7 @@ function registerDebugCommand(program) {
       tenantId,
       tenantName,
       authToken: accessToken,
-      organizationUnitId: userProvidedFolderId ?? organizationUnitId,
+      organizationUnitId: userProvidedFolderId,
       organizationName,
       userProvidedFolderId
     };
@@ -678,23 +628,23 @@ function registerDebugCommand(program) {
     logger.info(`  Tenant: ${tenantName} (${tenantId})`);
     logger.info(`  Base URL: ${baseUrl}`);
     const {
-      DebugProvisioningMissingResourcesError,
+      FlowDebugMissingResourcesError,
       FlowDebugService,
       InboundVoiceDebugError,
       MissingSolutionWrapperError,
       UnregisteredProjectError
-    } = await import("./flow-debug-service-gc2ky1ve.js");
-    const { UnboundInlineEntityError } = await import("./inline-entity-resolver-c854cqma.js");
-    const { MaestroHttpError } = await import("./debug-http-client-yqjzsnhw.js");
+    } = await import("./flow-debug-service-hy21ddd9.js");
+    const { UnboundInlineEntityError } = await import("./inline-entity-resolver-0neh2b43.js");
+    const { MaestroHttpError } = await import("./debug-http-client-zydr7tna.js");
     const {
       buildPollTimeoutFailureOutput,
       DebugPollTimeoutError,
       isSuccessfulDebugStatus
-    } = await import("./debug-service-nra3n02y.js");
+    } = await import("./debug-service-hdktqeek.js");
     const {
       buildSolutionUploadFailureOutput,
       isSolutionUploadHttpError
-    } = await import("./index-y1ym28vg.js");
+    } = await import("./index-g2p2ww34.js");
     const service = new FlowDebugService;
     const parsedPollInterval = parsePositiveNumberOption(options.pollInterval || "2000", "--poll-interval");
     if (!parsedPollInterval.ok) {
@@ -723,8 +673,8 @@ function registerDebugCommand(program) {
     }
     let inputs;
     if (options.inputs) {
-      const { parseFlowInputs } = await import("./flow-api-sat010z1.js");
-      const [parseError, parsed] = await catchError(parseFlowInputs(options.inputs));
+      const { parseFlowInputs } = await import("./flow-api-d4dvmadm.js");
+      const [parseError, parsed] = await catchError2(parseFlowInputs(options.inputs));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -738,7 +688,7 @@ function registerDebugCommand(program) {
     }
     const attachmentSpecs = options.attachment ?? [];
     if (attachmentSpecs.length > 0) {
-      const [parseError, specs] = catchError(() => attachmentSpecs.map(parseAttachmentSpec));
+      const [parseError, specs] = catchError2(() => attachmentSpecs.map(parseAttachmentSpec));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -748,8 +698,8 @@ function registerDebugCommand(program) {
         processContext.exit(1);
         return;
       }
-      const { uploadJobAttachment } = await import("./index-wycgq0ff.js");
-      const [uploadError, resolved] = await catchError(resolveAttachmentInputs(specs, (bytes, fileName) => uploadJobAttachment(bytes, fileName, {
+      const { uploadJobAttachment } = await import("./index-4e3w8x62.js");
+      const [uploadError, resolved] = await catchError2(resolveAttachmentInputs(specs, (bytes, fileName) => uploadJobAttachment(bytes, fileName, {
         tenant: tenantName
       })));
       if (uploadError) {
@@ -780,7 +730,7 @@ function registerDebugCommand(program) {
       ...isConversational ? { uploadOnly: true } : {}
     };
     logger.info(`Starting Studio Web debug session for: ${projectPath}`);
-    const [executeError, result] = await catchError(service.executeProjectViaStudioWeb(projectPath, studioWebConfig, {
+    const [executeError, result] = await catchError2(service.executeProjectViaStudioWeb(projectPath, studioWebConfig, {
       onStatusChange: (st, executions) => {
         const completed = executions.filter((e) => e.status === "Completed").length;
         const total = executions.length;
@@ -790,8 +740,8 @@ function registerDebugCommand(program) {
           logger.info(`  ${icon} ${exec.elementId} [${exec.status}]`);
         }
       },
-      onIncident: (incidents2) => {
-        logger.warn(`Incidents: ${JSON.stringify(incidents2)}`);
+      onIncident: (incidents) => {
+        logger.warn(`Incidents: ${JSON.stringify(incidents)}`);
       },
       onStudioWebUrl: (url) => {
         if (options.openInBrowser !== true)
@@ -842,7 +792,7 @@ function registerDebugCommand(program) {
         processContext.exit(3);
         return;
       }
-      if (executeError instanceof DebugProvisioningMissingResourcesError) {
+      if (executeError instanceof FlowDebugMissingResourcesError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
           ErrorCode: "configuration_error",
@@ -851,14 +801,13 @@ function registerDebugCommand(program) {
           Retry: "RetryWillNotFix",
           Context: { stage: "prepare-debug-resources" },
           Data: {
-            provisioningStatus: executeError.status,
             missingResources: [
               ...executeError.missingResources
             ]
           }
         });
       } else if (executeError instanceof DebugPollTimeoutError) {
-        OutputFormatter.error(buildPollTimeoutFailureOutput(executeError, "uip maestro flow debug-instance incidents"));
+        OutputFormatter.error(buildPollTimeoutFailureOutput(executeError, "uip maestro flow debug-instances incidents"));
       } else if (executeError instanceof MaestroHttpError) {
         OutputFormatter.error(buildHttpFailureOutput(executeError));
       } else if (isSolutionUploadHttpError(executeError)) {
@@ -908,19 +857,19 @@ function registerDebugCommand(program) {
     };
     let data = fullData;
     if (options.summary) {
-      const summary2 = buildDebugSummary(result);
-      const [writeError, fullOutputPath] = await catchError(writeFullDebugOutput(getFileSystem(), projectPath, {
+      const summary = buildDebugSummary(result);
+      const [writeError, fullOutputPath] = await catchError2(writeFullDebugOutput(getFileSystem(), projectPath, {
         Result: success ? RESULTS.Success : RESULTS.Failure,
         Code: "FlowDebug",
         Data: fullData
       }));
       if (writeError) {
         logger.warn(`Could not write the full debug output: ${writeError.message}`);
-        summary2.fullOutputError = writeError.message;
+        summary.fullOutputError = writeError.message;
       } else {
-        summary2.fullOutputPath = fullOutputPath;
+        summary.fullOutputPath = fullOutputPath;
       }
-      data = summary2;
+      data = summary;
     }
     if (success) {
       const instructions = result.variablesError ? `Debug completed with status: ${result.finalStatus}, but the output variables could not be read after ${result.variablesError.attempts} attempt(s): ${result.variablesError.message}. Data.${options.summary ? "outputs" : "variables"} is absent and Data.variablesError explains why — treat the outputs as UNKNOWN, not empty. ` + `Retry with ${variablesRetryCommand(result.instanceId, result.variablesError)}.` : `Debug completed with status: ${result.finalStatus}`;
@@ -936,7 +885,7 @@ function registerDebugCommand(program) {
     const incidents = result.incidents ?? [];
     const summary = summarizeIncidents(incidents);
     const Message = incidents.length ? `Debug session ${result.finalStatus}. ${summary[0]}` : `Debug session ${result.finalStatus}. No incident details returned by PIMS.`;
-    const Instructions = incidents.length ? buildIncidentInstructions(incidents, result.instanceId) : `Run 'uip maestro flow debug-instance incidents ${result.instanceId}' to inspect the backend payload, then 'uip maestro flow incident summary' to confirm whether the process recorded a tenant-level incident.`;
+    const Instructions = incidents.length ? buildIncidentInstructions(incidents, result.instanceId) : `Run 'uip maestro flow debug-instances incidents ${result.instanceId}' to inspect the backend payload, then 'uip maestro flow incidents summary' to confirm whether the process recorded a tenant-level incident.`;
     const Context = {};
     if (incidents[0]?.errorCode) {
       Context.errorCode = incidents[0].errorCode;
@@ -955,6 +904,10 @@ function registerDebugCommand(program) {
     processContext.exit(1);
   });
 }
+// ../maestro-sdk/src/shared-commands/process-list-window.ts
+var MAX_PROCESS_PAGE_SIZE = 1000;
+var createProcessLimitOption = () => new Option("-l, --limit <number>", `Number of items to return (1-${MAX_PROCESS_PAGE_SIZE})`).argParser((raw) => parseBoundedInt(raw, "--limit", { min: 1, max: MAX_PROCESS_PAGE_SIZE }));
+var createProcessOffsetOption = () => new Option("--offset <number>", "Number of items to skip (0-1000000)").argParser(parseOffset).default(0);
 // src/commands/debug-instances.ts
 var registerDebugInstancesCommand = (program) => {
   registerSharedDebugInstanceCommands(program, {
@@ -984,7 +937,7 @@ var EDGE_LIST_EXAMPLES = [
 ];
 var EDGE_ADD_EXAMPLES = [
   {
-    Description: "Add an edge between two nodes in a flow",
+    Description: `Add an edge between two nodes. Without --source-port / --target-port each end uses its default port: the one the node's definition marks as default, else "output" / "input", else the node's only flow port.`,
     Command: "uip maestro flow edges create flow.json Node_1 Node_2",
     Output: {
       Code: "EdgeAddSuccess",
@@ -999,6 +952,38 @@ var EDGE_ADD_EXAMPLES = [
       }
     }
   },
+  {
+    Description: 'A script node has no "output" port, so the edge leaves on its only flow port, "success" ("error" is never a default)',
+    Command: "uip maestro flow edges create flow.json script1 Node_2",
+    Output: {
+      Code: "EdgeAddSuccess",
+      Data: {
+        Edge: {
+          id: "script1-success-Node_2-input",
+          source: "script1",
+          target: "Node_2",
+          sourcePort: "success",
+          targetPort: "input"
+        }
+      }
+    }
+  },
+  {
+    Description: "A decision has two flow ports and no default, so name the branch with --source-port",
+    Command: "uip maestro flow edges create flow.json decision1 Node_2 --source-port true",
+    Output: {
+      Code: "EdgeAddSuccess",
+      Data: {
+        Edge: {
+          id: "decision1-true-Node_2-input",
+          source: "decision1",
+          target: "Node_2",
+          sourcePort: "true",
+          targetPort: "input"
+        }
+      }
+    }
+  },
   {
     Description: "Re-running with the same arguments is idempotent: returns the existing edge id with code EdgeAlreadyExists and a stderr warning.",
     Command: "uip maestro flow edges create flow.json Node_1 Node_2",
@@ -1052,9 +1037,9 @@ function getDeleteEdgeInstructions(file) {
   return `Check that "${file}" exists and run 'uip maestro flow edges list ${file}' to find a valid edge ID, then retry.`;
 }
 async function runDeleteEdge(file, edgeId, code) {
-  const { deleteEdgeFromFlow } = await import("./edge-service-y44f2rgd.js");
+  const { deleteEdgeFromFlow } = await import("./edge-service-zck3s9ss.js");
   const normalizedEdgeId = edgeId.trim();
-  const [error, result] = await catchError(deleteEdgeFromFlow(file, normalizedEdgeId));
+  const [error, result] = await catchError2(deleteEdgeFromFlow(file, normalizedEdgeId));
   if (error) {
     OutputFormatter.error({
       Result: RESULTS.Failure,
@@ -1075,8 +1060,8 @@ async function runDeleteEdge(file, edgeId, code) {
 var registerEdgeCommand = (program) => {
   const edge = program.command("edges").alias("edge").description("Manage edges in a Flow file");
   addRowWindowOptions(edge.command("list")).description("List all edges in a Flow file").argument("<file>", "Path to the .flow file").examples(EDGE_LIST_EXAMPLES).trackedAction(processContext, async (file, options) => {
-    const { listEdgesInFlow } = await import("./edge-service-y44f2rgd.js");
-    const [error, result] = await catchError(listEdgesInFlow(file));
+    const { listEdgesInFlow } = await import("./edge-service-zck3s9ss.js");
+    const [error, result] = await catchError2(listEdgesInFlow(file));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -1097,9 +1082,9 @@ var registerEdgeCommand = (program) => {
       Pagination: window.pagination
     });
   });
-  edge.command("create").alias("add").description("Add an edge between two nodes in a Flow file").argument("<file>", "Path to the .flow file").argument("<source-id>", "ID of the source node").argument("<target-id>", "ID of the target node").option("--source-port <port>", 'Source port name (defaults to "output")').option("--target-port <port>", 'Target port name (defaults to "input")').examples(EDGE_ADD_EXAMPLES).trackedAction(processContext, async (file, sourceId, targetId, options) => {
-    const { addEdgeToFlow } = await import("./edge-service-y44f2rgd.js");
-    const [error, result] = await catchError(addEdgeToFlow(file, sourceId, targetId, {
+  edge.command("create").alias("add").description("Add an edge between two nodes in a Flow file").argument("<file>", "Path to the .flow file").argument("<source-id>", "ID of the source node").argument("<target-id>", "ID of the target node").option("--source-port <port>", `Source port name (defaults to the port the node's definition marks as default, else "output", else the node's only flow port)`).option("--target-port <port>", `Target port name (defaults to the port the node's definition marks as default, else "input", else the node's only flow port)`).examples(EDGE_ADD_EXAMPLES).trackedAction(processContext, async (file, sourceId, targetId, options) => {
+    const { addEdgeToFlow } = await import("./edge-service-zck3s9ss.js");
+    const [error, result] = await catchError2(addEdgeToFlow(file, sourceId, targetId, {
       sourcePort: options.sourcePort,
       targetPort: options.targetPort
     }));
@@ -1107,7 +1092,8 @@ var registerEdgeCommand = (program) => {
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: "Error adding edge",
-        Instructions: error.message
+        Instructions: error.message,
+        ErrorCode: carriedErrorCode(error)
       });
       processContext.exit(1);
       return;
@@ -1251,7 +1237,7 @@ async function resolveStudioWebConfig() {
 async function pollRemoteEvalSetRun(service, config, workloadId, evalSetRunId, timeoutMs) {
   const start = Date.now();
   while (Date.now() - start < timeoutMs) {
-    const [error, run] = await catchError(service.getRemoteEvalSetRun(config, workloadId, evalSetRunId));
+    const [error, run] = await catchError2(service.getRemoteEvalSetRun(config, workloadId, evalSetRunId));
     if (error) {
       OutputFormatter.log({
         Message: `Polling error: ${error.message}. Retrying...`
@@ -1338,9 +1324,9 @@ async function resolveRemoteTarget(service, options, config, requireSolutionId =
 function registerEvalRunCommand(evalCmd) {
   const runCmd = evalCmd.command("runs").alias("run").description("Run Flow evaluation sets in Studio Web");
   addStartOptions(runCmd.command("start").description("Start a Studio Web evaluation run (Flow solution must be available in Studio Web)")).option("--wait", "Wait for the evaluation to complete and show results").option("--timeout <seconds>", "Timeout in seconds for --wait polling", (value) => Number.parseInt(value, 10)).examples(FLOW_EVAL_RUN_START_EXAMPLES).trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const config = await resolveStudioWebConfig();
-      const { FlowEvalRunService } = await import("./flow-eval-run-service-2cbr0jtw.js");
+      const { FlowEvalRunService } = await import("./flow-eval-run-service-5en4ahyn.js");
       const service = new FlowEvalRunService;
       const result = await service.startRemoteEvalRun(options.path, options.set, config, {
         solutionId: options.solutionId,
@@ -1370,9 +1356,9 @@ function registerEvalRunCommand(evalCmd) {
     }
   });
   addTargetOptions(runCmd.command("status").description("Check the status of a Studio Web Flow evaluation run").argument("<eval-set-run-id>", "Evaluation set run ID")).examples(FLOW_EVAL_RUN_STATUS_EXAMPLES).trackedAction(processContext, async (evalSetRunId, options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const config = await resolveStudioWebConfig();
-      const { FlowEvalRunService } = await import("./flow-eval-run-service-2cbr0jtw.js");
+      const { FlowEvalRunService } = await import("./flow-eval-run-service-5en4ahyn.js");
       const service = new FlowEvalRunService;
       const target = await resolveRemoteTarget(service, options, config);
       const [run, evaluators] = await Promise.all([
@@ -1396,9 +1382,9 @@ function registerEvalRunCommand(evalCmd) {
     }
   });
   addTargetOptions(runCmd.command("results").description("Get detailed results for a Studio Web Flow evaluation run").argument("<eval-set-run-id>", "Evaluation set run ID")).option("--only-failed", "Show only failed or errored data points").option("--verbose", "Include evaluator justifications in output").option("--export-format <json|csv>", "Export results to file (json or csv)").examples(FLOW_EVAL_RUN_RESULTS_EXAMPLES).trackedAction(processContext, async (evalSetRunId, options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const config = await resolveStudioWebConfig();
-      const { FlowEvalRunService } = await import("./flow-eval-run-service-2cbr0jtw.js");
+      const { FlowEvalRunService } = await import("./flow-eval-run-service-5en4ahyn.js");
       const service = new FlowEvalRunService;
       const target = await resolveRemoteTarget(service, options, config);
       let evalRuns = await service.getRemoteEvalRuns(config, target.workloadId, evalSetRunId);
@@ -1430,9 +1416,9 @@ function registerEvalRunCommand(evalCmd) {
     }
   });
   addTargetOptions(addRowWindowOptions(runCmd.command("list")).description("List Studio Web evaluation runs for a Flow eval set")).examples(FLOW_EVAL_RUN_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const config = await resolveStudioWebConfig();
-      const { FlowEvalRunService } = await import("./flow-eval-run-service-2cbr0jtw.js");
+      const { FlowEvalRunService } = await import("./flow-eval-run-service-5en4ahyn.js");
       const service = new FlowEvalRunService;
       const target = await resolveRemoteTarget(service, options, config);
       const allRuns = await service.listRemoteEvalSetRuns(config, target.workloadId, target.evalSet.id);
@@ -1459,9 +1445,9 @@ function registerEvalRunCommand(evalCmd) {
     }
   });
   addTargetOptions(runCmd.command("compare").description("Compare results of two Studio Web Flow evaluation runs").argument("<eval-set-run-id>", "First evaluation set run ID").requiredOption("--compare-to <id>", "Second evaluation set run ID to compare against")).examples(FLOW_EVAL_RUN_COMPARE_EXAMPLES).trackedAction(processContext, async (evalSetRunId, options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const config = await resolveStudioWebConfig();
-      const { FlowEvalRunService } = await import("./flow-eval-run-service-2cbr0jtw.js");
+      const { FlowEvalRunService } = await import("./flow-eval-run-service-5en4ahyn.js");
       const service = new FlowEvalRunService;
       const target = await resolveRemoteTarget(service, options, config);
       const [runsA, runsB, runMetaA, runMetaB] = await Promise.all([
@@ -1593,8 +1579,8 @@ function registerEvalCommand(program) {
 function registerEvaluatorCommands(evalCmd) {
   const evaluator = evalCmd.command("evaluators").alias("evaluator").description("Manage Flow evaluators");
   evaluator.command("create").alias("add").description("Add an evaluator to the flow project").argument("<name>", "Evaluator name").requiredOption("--type <type>", `Evaluator type: ${evaluatorTypeAliases().join(", ")}`).option("--description <text>", "Evaluator description").option("--target-key <key>", "Target output key", "*").option("--model <model>", "LLM model for LLM judge evaluators").option("--prompt <prompt>", "Custom LLM judge prompt").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (name, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const created = await service.addEvaluator(options.path, {
         name,
@@ -1620,8 +1606,8 @@ function registerEvaluatorCommands(evalCmd) {
     }
   });
   addRowWindowOptions(evaluator.command("list")).description("List evaluators in a flow project").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const evaluators = await service.listEvaluators(options.path);
       const window = rowWindow(evaluators, options);
@@ -1643,8 +1629,8 @@ function registerEvaluatorCommands(evalCmd) {
     }
   });
   evaluator.command("delete").alias("remove").description("Remove an evaluator from a flow project").argument("<id>", "Evaluator ID, name, or file base name").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (id, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const removed = await service.removeEvaluator(options.path, id);
       if (!removed) {
@@ -1664,9 +1650,9 @@ function registerEvaluatorCommands(evalCmd) {
 function registerEvalSetCommands(evalCmd) {
   const set = evalCmd.command("sets").alias("set").description("Manage evaluation sets");
   set.command("create").alias("add").description("Create an evaluation set").argument("<name>", "Evaluation set name").option("--evaluators <refs>", "Comma-separated evaluator IDs or file base names (default: all)").option("--entry-point <id>", "Entry point node id — a trigger node id from the .flow file (not a BPMN path), stored as the eval set's selectedEntrypoint; defaults to the flow's trigger. An agent node id creates a node-scoped eval set (evaluates that node in isolation)").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (name, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
-      const { readEvalSetScope, readNodeTargetId } = await import("./flow-eval-node-target-cwxb4kfe.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
+      const { readEvalSetScope, readNodeTargetId } = await import("./flow-eval-node-target-tdrwqca7.js");
       const service = new FlowEvalService;
       const created = await service.addEvalSet(options.path, {
         name,
@@ -1692,9 +1678,9 @@ function registerEvalSetCommands(evalCmd) {
     }
   });
   addRowWindowOptions(set.command("list")).description("List evaluation sets").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
-      const { readEvalSetScope, readNodeTargetId } = await import("./flow-eval-node-target-cwxb4kfe.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
+      const { readEvalSetScope, readNodeTargetId } = await import("./flow-eval-node-target-tdrwqca7.js");
       const service = new FlowEvalService;
       const sets = await service.listEvalSets(options.path);
       const window = rowWindow(sets, options);
@@ -1721,8 +1707,8 @@ function registerEvalSetCommands(evalCmd) {
     }
   });
   set.command("delete").alias("remove").description("Remove an evaluation set").argument("<id>", "Evaluation set ID, name, or file base name").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (id, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const removed = await service.removeEvalSet(options.path, id);
       if (!removed) {
@@ -1741,12 +1727,12 @@ function registerEvalSetCommands(evalCmd) {
 }
 function registerEvaluationCommands(evalCmd) {
   evalCmd.command("create").alias("add").description("Add a data point to an evaluation set").argument("<name>", "Data point name").requiredOption("--set <name>", "Evaluation set name or ID").option("--inputs <json>", "Input values as a JSON object").option("--input-file <key=path>", "Attach a file as input <key>; repeatable", collectInputFile, []).option("--expected <json>", "Expected output as a JSON object").option("--criteria <json>", "Per-evaluator criteria JSON object keyed by evaluator id").option("--search-text <text>", "Search text for contains evaluators").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (name, options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const inputs = options.inputs === undefined ? {} : parseJsonObject(options.inputs, "--inputs");
       const inputFiles = parseInputFiles(options.inputFile);
       const expectedOutput = options.expected ? parseJsonObject(options.expected, "--expected") : undefined;
       const criteria = options.criteria ? parseCriteriaOption(options.criteria) : undefined;
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const evaluation = await service.addEvaluation(options.path, options.set, {
         name,
@@ -1772,8 +1758,8 @@ function registerEvaluationCommands(evalCmd) {
     }
   });
   addRowWindowOptions(evalCmd.command("list")).description("List data points in an evaluation set").requiredOption("--set <name>", "Evaluation set name or ID").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const evaluations = await service.listEvaluations(options.path, options.set);
       const window = rowWindow(evaluations, options);
@@ -1795,8 +1781,8 @@ function registerEvaluationCommands(evalCmd) {
     }
   });
   evalCmd.command("delete").alias("remove").description("Remove a data point from an evaluation set").argument("<id>", "Data point ID or name").requiredOption("--set <name>", "Evaluation set name or ID").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (id, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const removed = await service.removeEvaluation(options.path, options.set, id);
       if (!removed) {
@@ -1816,7 +1802,7 @@ function registerEvaluationCommands(evalCmd) {
 function registerSimulationCommands(evalCmd) {
   const simulation = evalCmd.command("simulations").alias("simulation").description("Manage simulations on eval data points");
   simulation.command("create").alias("add").description("Add or update a simulation on a data point").argument("<component-id>", "Component ID to simulate").requiredOption("--set <name>", "Evaluation set name or ID").requiredOption("--data-point <id>", "Data point name or ID").requiredOption("--strategy <strategy>", "Simulation strategy: Static or Llm").option("--component-type <type>", "Component type (defaults to Node when --parent is used)").option("--component-description <text>", "Component description").option("--simulation-instructions <text>", "Simulation instructions (for Llm strategy)").option("--mock-value <json>", "Mock output value as JSON (for Static strategy)").option("--parent <component-id>", "Parent agent component ID. When set, the simulation is added as a child tool simulation on the parent agent node.").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (componentId, options) => {
-    const [error] = await catchError((async () => {
+    const [error] = await catchError2((async () => {
       const strategy = options.strategy;
       if (strategy !== "Static" && strategy !== "Llm") {
         throw new Error(`--strategy must be Static or Llm (got "${strategy}")`);
@@ -1832,7 +1818,7 @@ function registerSimulationCommands(evalCmd) {
         throw new Error("--simulation-instructions is required for the Llm strategy");
       }
       const mockValue = options.mockValue !== undefined ? parseJsonValue(options.mockValue, "--mock-value") : undefined;
-      const simulation2 = {
+      const simulation = {
         componentId,
         componentType,
         componentDescription: options.componentDescription,
@@ -1840,10 +1826,10 @@ function registerSimulationCommands(evalCmd) {
         simulationInstruction: options.simulationInstructions,
         mockValue
       };
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       if (options.parent !== undefined) {
-        const { simulation: created, warning } = await service.addChildSimulation(options.path, options.set, options.dataPoint, options.parent, simulation2);
+        const { simulation: created, warning } = await service.addChildSimulation(options.path, options.set, options.dataPoint, options.parent, simulation);
         const data = {
           ComponentId: created.componentId,
           ComponentType: created.componentType,
@@ -1862,7 +1848,7 @@ function registerSimulationCommands(evalCmd) {
           Data: data
         });
       } else {
-        const created = await service.addSimulation(options.path, options.set, options.dataPoint, simulation2);
+        const created = await service.addSimulation(options.path, options.set, options.dataPoint, simulation);
         OutputFormatter.success({
           Result: RESULTS.Success,
           Code: "FlowEvalSimulationAdd",
@@ -1881,8 +1867,8 @@ function registerSimulationCommands(evalCmd) {
     }
   });
   addRowWindowOptions(simulation.command("list")).description("List simulations on a data point").requiredOption("--set <name>", "Evaluation set name or ID").requiredOption("--data-point <id>", "Data point name or ID").option("--parent <component-id>", "Parent agent component ID. When set, lists child tool simulations on the parent agent node.").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const simulations = options.parent !== undefined ? await service.listChildSimulations(options.path, options.set, options.dataPoint, options.parent) : await service.listSimulations(options.path, options.set, options.dataPoint);
       const window = rowWindow(simulations, options);
@@ -1905,8 +1891,8 @@ function registerSimulationCommands(evalCmd) {
     }
   });
   simulation.command("delete").alias("remove").description("Remove a simulation from a data point").argument("<component-id>", "Component ID to remove").requiredOption("--set <name>", "Evaluation set name or ID").requiredOption("--data-point <id>", "Data point name or ID").option("--parent <component-id>", "Parent agent component ID. When set, removes a child tool simulation from the parent agent node.").option("--path <path>", FLOW_EVAL_PATH_OPTION_DESCRIPTION2, ".").trackedAction(processContext, async (componentId, options) => {
-    const [error] = await catchError((async () => {
-      const { FlowEvalService } = await import("./flow-eval-service-24jbkhhz.js");
+    const [error] = await catchError2((async () => {
+      const { FlowEvalService } = await import("./flow-eval-service-2j28ect1.js");
       const service = new FlowEvalService;
       const removed = options.parent !== undefined ? await service.removeChildSimulation(options.path, options.set, options.dataPoint, options.parent, componentId) : await service.removeSimulation(options.path, options.set, options.dataPoint, componentId);
       if (!removed) {
@@ -1943,10 +1929,10 @@ function parsePosition(value) {
   return { x, y };
 }
 function parsePositionOption(raw) {
-  return catchError(() => parsePosition(raw));
+  return catchError2(() => parsePosition(raw));
 }
 function parseSchemaOption(raw) {
-  const [parseErr, parsed] = catchError(() => JSON.parse(raw));
+  const [parseErr, parsed] = catchError2(() => JSON.parse(raw));
   if (parseErr)
     return [parseErr, undefined];
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -2051,8 +2037,8 @@ var registerHitlCommand = (program) => {
       }
       schema = parsed;
     }
-    const { addHitlNode } = await import("./hitl-service-3m4ce3mt.js");
-    const [error, result] = await catchError(addHitlNode(file, {
+    const { addHitlNode } = await import("./hitl-service-hccqhm63.js");
+    const [error, result] = await catchError2(addHitlNode(file, {
       schema,
       priority: options.priority,
       position,
@@ -2144,9 +2130,9 @@ Packing or uploading the solution will sync solution resources automatically.`
 ];
 var registerInitCommand = (program) => {
   program.command("init").description("Create a new Flow project with boilerplate files. If run outside an existing solution, a parent '<name>Solution' is scaffolded automatically and the flow project is created inside it. If run inside an existing solution, the project is added to that solution.").argument("<name>", "Flow project name").option("--force", "Force initialization even if target directory exists and is not empty").option("--skip-solution-registration", "Do not auto-register this project in the surrounding solution").option("--automate", "Create a Maestro Automate project. Same Flow project and the same commands — it only changes the runtime profile written into operate.json.").option("--sdk-source [file]", "Also write the builder-SDK source: decompile the new .flow into <project>/.flow-sdk/<name>.flow.ts, or into [file] (relative to the current directory), creating its folder. Same as running 'uip maestro flow decompile <name>.flow -o <file> --no-pipeline' after init. Requires @uipath/maestro-builder-sdk.").examples(FLOW_INIT_EXAMPLES).trackedAction(processContext, async (name, options) => {
-    const { flowInitAsync, FlowInitSdkSourceError } = await import("./flow-init-service-k7k5vx2z.js");
-    const { RuntimeProfile } = await import("./maestro-automate-entry-6f9act3w.js");
-    const [error, result] = await catchError(flowInitAsync(name, {
+    const { flowInitAsync, FlowInitSdkSourceError } = await import("./flow-init-service-bj3ev9bz.js");
+    const { RuntimeProfile } = await import("./maestro-automate-entry-d1v5q5mv.js");
+    const [error, result] = await catchError2(flowInitAsync(name, {
       force: options.force,
       skipRegistration: options.skipSolutionRegistration === true,
       profile: options.automate ? RuntimeProfile.Lite : RuntimeProfile.Standard,
@@ -2217,6 +2203,8 @@ var VALID_JOB_STATES = [
 var DEFAULT_JOB_LIST_LIMIT = "50";
 var DEFAULT_JOB_LIST_OFFSET = "0";
 var DEFAULT_JOB_LIST_ORDER_BY = "Id desc";
+var FOLDER_KEY_ERRORS = new Set(["not_found", "invalid_argument"]);
+var FOLDER_KEY_INSTRUCTIONS = "Check the --folder-key (uip or folders list) and retry.";
 var FLOW_JOB_LIST_EXAMPLES = [
   {
     Description: "List recent Flow jobs in a folder",
@@ -2303,28 +2291,7 @@ function formatFlowJob(job) {
 function registerJobCommand(program) {
   const jobCmd = program.command("jobs").alias("job").description("Manage Flow jobs");
   jobCmd.command("list").description("List Flow jobs in a folder").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--folder-key <key>", "Folder key (GUID, defaults to authenticated folder)").option("--state <state>", `Filter by job state (${VALID_JOB_STATES.join(", ")})`).option("--process-name <name>", "Filter by Flow process name (contains match)").option("-l, --limit <number>", "Number of items to return", DEFAULT_JOB_LIST_LIMIT).option("--offset <number>", "Number of items to skip", DEFAULT_JOB_LIST_OFFSET).option("--sort-by <field>", "Sort results by field (e.g., 'Id desc')", DEFAULT_JOB_LIST_ORDER_BY).option("--all-fields", "Return all fields from the API response instead of a curated summary").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", (value) => Number.parseInt(value, 10), 10).examples(FLOW_JOB_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
-    }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth", loginError)
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
+    const { getAuthContext } = await import("./index-f5kq7265.js");
     const normalizedOptions = {
       tenant: normalizeOptionalOption(options.tenant),
       folderKey: normalizeOptionalOption(options.folderKey),
@@ -2332,16 +2299,18 @@ function registerJobCommand(program) {
       processName: normalizeOptionalOption(options.processName),
       orderBy: normalizeOptionalOption(options.sortBy)
     };
-    const tenantName = normalizedOptions.tenant || loginStatus.tenantName;
-    if (!tenantName || !loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Missing tenant or organization info.",
-        Instructions: instructionsFor("identity")
-      });
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: normalizedOptions.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
+    }));
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
+    const { tenantName } = auth;
     const state = normalizedOptions.state;
     if (state && !VALID_JOB_STATES.includes(state)) {
       OutputFormatter.error({
@@ -2370,14 +2339,14 @@ function registerJobCommand(program) {
       processKey: "",
       folderKey: normalizedOptions.folderKey ?? "",
       inputs: {},
-      authToken: loginStatus.accessToken ?? "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      tenantId: loginStatus.tenantId,
-      baseUrl: loginStatus.baseUrl
+      tenantId: auth.tenantId,
+      baseUrl: auth.baseUrl
     };
-    const { listFlowJobs } = await import("./flow-api-sat010z1.js");
-    const [listError, jobs] = await catchError(listFlowJobs(config, {
+    const { listFlowJobs } = await import("./flow-api-d4dvmadm.js");
+    const [listError, jobs] = await catchError2(listFlowJobs(config, {
       state,
       processName: normalizedOptions.processName,
       limit,
@@ -2406,48 +2375,30 @@ function registerJobCommand(program) {
       }
     });
   });
-  jobCmd.command("traces").description("Stream traces for a running job").argument("<job-key>", "Job key (GUID from run command)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--poll-interval <ms>", "Polling interval in milliseconds", "2000").option("--traces-service <name>", "Traces service name (default: llmopstenant_)", "llmopstenant_").option("--pretty", "Show traces in human-readable format instead of raw JSON").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).trackedAction(processContext, async (jobKey, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+  const tracesCmd = jobCmd.command("traces").description("Stream traces for a running job").argument("<job-key>", "Job key (GUID from run command)");
+  addJobTracesOptions(tracesCmd).trackedAction(processContext, async (jobKey, options) => {
+    const { getAuthContext } = await import("./index-f5kq7265.js");
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: options.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth", loginError)
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const tenantName = options.tenant || loginStatus.tenantName;
-    if (!tenantName || !loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Missing tenant or organization info.",
-        Instructions: instructionsFor("identity")
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
+    const { tenantName } = auth;
     const config = {
       processKey: "",
-      folderKey: "",
+      folderKey: options.folderKey ?? "",
       inputs: {},
-      authToken: loginStatus.accessToken ?? "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      tenantId: loginStatus.tenantId,
-      baseUrl: loginStatus.baseUrl,
+      tenantId: auth.tenantId,
+      baseUrl: auth.baseUrl,
       tracesServiceName: options.tracesService
     };
     const pollIntervalMs = parseInt(options.pollInterval || "2000", 10);
@@ -2463,9 +2414,23 @@ function registerJobCommand(program) {
     const pollSeconds = pollIntervalMs / 1000;
     logger.info(`Streaming traces for job: ${jobKey}
    Polling every ${pollSeconds}s...`);
-    const { formatTraceLine } = await import("./shared-utils-tqnx96mg.js");
-    const { streamJobTraces } = await import("./flow-api-sat010z1.js");
-    const [tracesError, result] = await catchError(streamJobTraces(config, jobKey, {
+    const { resolveFlowFolderId, streamJobTraces } = await import("./flow-api-d4dvmadm.js");
+    let folderId;
+    if (config.folderKey) {
+      const [folderError, resolvedId] = await catchError2(resolveFlowFolderId(config));
+      if (folderError) {
+        const failure = await backendFailure(folderError, instructionsFor("backend", folderError));
+        if (failure.ErrorCode !== undefined && FOLDER_KEY_ERRORS.has(failure.ErrorCode)) {
+          failure.Instructions = FOLDER_KEY_INSTRUCTIONS;
+        }
+        OutputFormatter.error(failure);
+        processContext.exit(1);
+        return;
+      }
+      folderId = resolvedId;
+    }
+    const [tracesError, result] = await catchError2(streamJobTraces(config, jobKey, {
+      folderId,
       onTrace: (trace) => {
         if (options.pretty) {
           ScreenLogger.progress(formatTraceLine(trace));
@@ -2473,8 +2438,8 @@ function registerJobCommand(program) {
           ScreenLogger.progress(JSON.stringify(trace));
         }
       },
-      onComplete: (result2) => {
-        ScreenLogger.progress(`Job ${jobKey}: ${result2.finalState} (${result2.duration}ms)`);
+      onComplete: (result) => {
+        ScreenLogger.progress(`Job ${jobKey}: ${result.finalState} (${result.duration}ms)`);
       },
       onError: (error) => {
         ScreenLogger.progress(`Error: ${error.message}`);
@@ -2502,50 +2467,31 @@ function registerJobCommand(program) {
     processContext.exit(result.success ? 0 : 1);
   });
   jobCmd.command("status").description("Get detailed status of a Flow job").argument("<job-key>", "Job key (GUID from run command)").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--folder-key <key>", "Folder key (GUID from list command, defaults to authenticated folder)").option("--detailed", "Show full response with all fields").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).examples(FLOW_JOB_STATUS_EXAMPLES).trackedAction(processContext, async (jobKey, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+    const { getAuthContext } = await import("./index-f5kq7265.js");
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: options.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth", loginError)
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const tenantName = options.tenant || loginStatus.tenantName;
-    if (!tenantName || !loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Missing tenant or organization info.",
-        Instructions: instructionsFor("identity")
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
+    const { tenantName } = auth;
     const config = {
       processKey: "",
       folderKey: options.folderKey ?? "",
       inputs: {},
-      authToken: loginStatus.accessToken ?? "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      tenantId: loginStatus.tenantId,
-      baseUrl: loginStatus.baseUrl
+      tenantId: auth.tenantId,
+      baseUrl: auth.baseUrl
     };
-    const { getJobStatusDetailed } = await import("./flow-api-sat010z1.js");
-    const [statusError, status] = await catchError(getJobStatusDetailed(config, jobKey));
+    const { getJobStatusDetailed } = await import("./flow-api-d4dvmadm.js");
+    const [statusError, status] = await catchError2(getJobStatusDetailed(config, jobKey));
     if (statusError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -2628,8 +2574,8 @@ var FLOW_MIGRATE_EXAMPLES = [
 ];
 var registerMigrateCommand = (program) => {
   program.command("migrate").description("Migrate a .flow file to the current workflow and node schema versions").argument("<file>", "Path to the .flow file").option("--dry-run", "Show what would change without writing the file").option("--no-include-optional", "Skip optional node migrations (e.g. typeVersion normalization). Default: optional migrations are applied.").examples(FLOW_MIGRATE_EXAMPLES).trackedAction(processContext, async (file, options) => {
-    const { migrateFlow } = await import("./flow-migrate-service-t3pnd2r3.js");
-    const [error, result] = await catchError(migrateFlow(file, {
+    const { migrateFlow } = await import("./flow-migrate-service-dkx85jj5.js");
+    const [error, result] = await catchError2(migrateFlow(file, {
       dryRun: options.dryRun,
       includeOptional: options.includeOptional
     }));
@@ -2794,9 +2740,9 @@ function getDeleteNodeInstructions(file) {
   return `Check that "${file}" exists and run 'uip maestro flow nodes list ${file}' to find a valid node ID, then retry.`;
 }
 async function runDeleteNode(file, nodeId, code) {
-  const { deleteNodeFromFlow } = await import("./node-service-d4xpqs0z.js");
+  const { deleteNodeFromFlow } = await import("./node-service-2nxpk751.js");
   const normalizedNodeId = nodeId.trim();
-  const [error, result] = await catchError(deleteNodeFromFlow(file, normalizedNodeId));
+  const [error, result] = await catchError2(deleteNodeFromFlow(file, normalizedNodeId));
   if (error) {
     OutputFormatter.error({
       Result: RESULTS.Failure,
@@ -2823,6 +2769,7 @@ var registerNodeCommand = (program) => {
   const node = program.command("nodes").alias("node").description("Manage nodes in a Flow file");
   node.command("create").alias("add").description(`Add a node to a Flow file.
 ` + "For connector nodes (type uipath.connector), do NOT pass --input here — " + `run 'nodes configure' afterwards to supply connection and endpoint details.
+Read file / Create file (core.action.file.*) also need 'nodes configure' to bind their Orchestrator connection; a connectionId passed in --input alone is not bound.
 Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIssue --label 'Create Jira Issue'`).argument("<file>", "Path to the .flow file").argument("<node-type>", "Node type identifier (e.g. core.trigger.manual)").option("-i, --input <json>", `JSON object of input values to set on the node (e.g. '{"script": "..."}')`).option("--position <x,y>", "Node position in the canvas (e.g. 250,150)").option("--label <label>", "Display label for the node").option("--source <uuid>", "Source UUID for nodes whose manifest declares a source dependency. Use the agent's ProjectId (inline agent nodes) or the resource id from the parent inline agent's resources[] (agent-tool resource nodes). Populates inputs.source.").option("--parent <node-id>", "Id of the existing node that should contain this node. Set when authoring a loop body whose containment cannot be " + "inferred from edges alone — typically the id of a " + "core.logic.loop node.").option("--metadata <file>", "Non-catalog activity only: the generated activity metadata (<Name>.json from 'uip is activities metadata generate'). The node definition is built from it instead of the registry; the node type must be uipath.connector.custom.<connector-key>.<slug>. Requires --scripts.").option("--scripts <dir>", "Non-catalog activity only: directory holding <scriptRef>.js for the action and every lookup the metadata references; the sources are embedded in the node. Requires --metadata.").examples(NODE_ADD_EXAMPLES).trackedAction(processContext, async (file, nodeType, options) => {
     if (options.metadata === undefined !== (options.scripts === undefined)) {
       OutputFormatter.error({
@@ -2839,7 +2786,7 @@ Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIss
     } : undefined;
     let inputs;
     if (options.input !== undefined) {
-      const [parseError, parsed] = catchError(() => JSON.parse(options.input));
+      const [parseError, parsed] = catchError2(() => JSON.parse(options.input));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -2862,7 +2809,7 @@ Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIss
     }
     let position;
     if (options.position !== undefined) {
-      const [posError, parsed] = catchError(() => parsePosition2(options.position));
+      const [posError, parsed] = catchError2(() => parsePosition2(options.position));
       if (posError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -2880,8 +2827,8 @@ Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIss
       NodeTypeNotEnabledError,
       NodeTypeNotFoundError,
       SourceRequiredError
-    } = await import("./node-service-d4xpqs0z.js");
-    const [error, result] = await catchError(addNodeToFlow(file, nodeType, {
+    } = await import("./node-service-2nxpk751.js");
+    const [error, result] = await catchError2(addNodeToFlow(file, nodeType, {
       position,
       label: options.label,
       inputs,
@@ -2899,11 +2846,7 @@ Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIss
         processContext.exit(1);
         return;
       }
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error adding node",
-        Instructions: error.message
-      });
+      OutputFormatter.error(await classifiedFailure("Error adding node", error));
       processContext.exit(1);
       return;
     }
@@ -2924,7 +2867,7 @@ Example: uip maestro flow nodes create flow.flow uipath.connector.jira.createIss
       }
     });
   });
-  node.command("configure").description(`Configure a connector or managed HTTP node with connection and method details.
+  node.command("configure").description(`Configure a connector, managed HTTP or file node with connection and method details.
 ` + `Run this after 'nodes create' — populates inputs.detail and creates workflow bindings.
 ` + `Use 'nodes list' to find the node ID.
 
@@ -2932,9 +2875,8 @@ CONNECTOR ACTIVITIES (type uipath.connector.*, NOT *.trigger.*)
   Required: connectionId, folderKey, method, endpoint.
   Generic activities (manifest activityType='Generic', e.g. *.insert-record,
     *.list-records) also require objectName. Discover with:
-      uip is resources list <connector-key> --operation <op> --connection-id <uuid>
-      uip is resources describe <connector-key> <object> --operation <op> --connection-id <uuid>
-  Curated activities: get method/endpoint from connectorMethodInfo in 'registry get'.
+` + genericObjectDiscoveryCommands("<connector-key>", "<uuid>", "<op>").map((command) => `      ${command}
+`).join("") + `  Curated activities: get method/endpoint from connectorMethodInfo in 'registry get'.
   Optional: bodyParameters, queryParameters, pathParameters, filter,
             customFieldsRequestDetails ({ objectActionName, parameterValues: [[k,v],...] });
   Examples:
@@ -2970,6 +2912,13 @@ CONNECTOR WAIT-FOR EVENTS (type uipath.connector.event.*)
   Example:
     --detail '{"connectionId":"<uuid>","folderKey":"<uuid>","eventMode":"polling","queryParameters":{"repo":"cli"}}'
 
+FILE NODES (type core.action.file.read, core.action.file.create)
+  Bind the Orchestrator connection the node reaches job attachments through.
+  Required: connectionId (a uipath-uipath-orchestrator connection UUID).
+  Optional: folderKey (defaults to the connection's folder).
+  Example:
+    --detail '{"connectionId":"<uuid>"}'
+
 MANAGED HTTP NODES (type core.action.http.v2)
 ` + `  Two authentication modes — set via the 'authentication' key:
 
@@ -2997,7 +2946,7 @@ MANAGED HTTP NODES (type core.action.http.v2)
       processContext.exit(1);
       return;
     }
-    const [parseError, parsed] = catchError(() => JSON.parse(options.detail));
+    const [parseError, parsed] = catchError2(() => JSON.parse(options.detail));
     if (parseError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -3007,14 +2956,32 @@ MANAGED HTTP NODES (type core.action.http.v2)
       processContext.exit(1);
       return;
     }
-    const { configureConnectorNode, InvalidDetailError } = await import("./connector-service-m08dysc2.js");
-    const [error, result] = await catchError(configureConnectorNode(file, nodeId, parsed));
+    const [
+      { configureConnectorNode, InvalidDetailError },
+      { ConnectionConnectorMismatchError }
+    ] = await Promise.all([
+      import("./connector-service-r86mtxwn.js"),
+      import("./index-5xh0cjag.js")
+    ]);
+    const [error, result] = await catchError2(configureConnectorNode(file, nodeId, parsed));
     if (error) {
-      const message = error instanceof InvalidDetailError ? "Invalid --detail" : "Error configuring node";
+      const callerError = error instanceof ConnectionConnectorMismatchError || error instanceof InvalidDetailError;
+      let message = "Error configuring node";
+      let instructions = error.message;
+      if (error instanceof ConnectionConnectorMismatchError) {
+        message = error.message;
+        instructions = error.instructions;
+      } else if (callerError) {
+        message = "Invalid --detail";
+      }
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Message: message,
-        Instructions: error.message
+        Instructions: instructions,
+        ...callerError && {
+          ErrorCode: "invalid_argument",
+          Retry: "RetryWillNotFix"
+        }
       });
       processContext.exit(1);
       return;
@@ -3033,8 +3000,8 @@ MANAGED HTTP NODES (type core.action.http.v2)
     });
   });
   addRowWindowOptions(node.command("list")).description("List all nodes in a Flow file").argument("<file>", "Path to the .flow file").examples(NODE_LIST_EXAMPLES).trackedAction(processContext, async (file, options) => {
-    const { listNodesInFlow } = await import("./node-service-d4xpqs0z.js");
-    const [error, result] = await catchError(listNodesInFlow(file));
+    const { listNodesInFlow } = await import("./node-service-2nxpk751.js");
+    const [error, result] = await catchError2(listNodesInFlow(file));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -3080,7 +3047,7 @@ var FLOW_PACK_EXAMPLES = [
 var registerPackCommand = (program) => {
   const command = program.command("pack").description("Pack a Flow project into a .nupkg file").argument("<project-path>", "Path to the Flow project directory").argument("<output-path>", "Output directory where the .nupkg will be saved").option("-n, --name <name>", "Package name (default: project folder name)").option("-v, --version <version>", "Package version (default: 1.0.0)", "1.0.0");
   registerPackageMetadataOptions(command).examples(FLOW_PACK_EXAMPLES).trackedAction(processContext, async (projectPath, outputPath, options) => {
-    const { FlowPackService } = await import("./flow-pack-service-b910q207.js");
+    const { FlowPackService } = await import("./flow-pack-service-58m51sp8.js");
     const service = new FlowPackService;
     const exitCode = await service.execute(projectPath, {
       output: outputPath,
@@ -3189,7 +3156,7 @@ async function resolveRelease(config, processKey) {
   const key = separator === -1 ? processKey : processKey.slice(0, separator);
   const version = separator === -1 ? undefined : processKey.slice(separator + 1);
   const byReleaseKey = config.releaseKey !== undefined;
-  const { escapeODataStringLiteral: esc, listFlowProcesses } = await import("./flow-api-sat010z1.js");
+  const { escapeODataStringLiteral: esc, listFlowProcesses } = await import("./flow-api-d4dvmadm.js");
   const processes = await listFlowProcesses(config, byReleaseKey ? `Key eq '${esc(config.releaseKey)}'` : `ProcessKey eq '${esc(key)}'`);
   const matches = processes.filter((candidate) => Boolean(candidate.key) && (byReleaseKey ? candidate.key === config.releaseKey : candidate.processKey === key && (version === undefined || candidate.processVersion === version)));
   const [release, ...extra] = matches;
@@ -3202,9 +3169,9 @@ async function resolveRelease(config, processKey) {
   return release;
 }
 async function resolveFolderForList(options) {
-  const { resolveFolder } = await import("./index-wycgq0ff.js");
+  const { resolveFolder } = await import("./index-4e3w8x62.js");
   if (options.folderKey && options.folderPath) {
-    const [pathError, pathFolder] = await catchError(resolveFolder({ folderPath: options.folderPath }, {
+    const [pathError, pathFolder] = await catchError2(resolveFolder({ folderPath: options.folderPath }, {
       tenant: options.tenant,
       loginValidity: options.loginValidity
     }));
@@ -3217,7 +3184,7 @@ async function resolveFolderForList(options) {
     return options.folderKey;
   }
   if (options.folderPath) {
-    const [resolveError, resolved] = await catchError(resolveFolder({ folderPath: options.folderPath }, {
+    const [resolveError, resolved] = await catchError2(resolveFolder({ folderPath: options.folderPath }, {
       tenant: options.tenant,
       loginValidity: options.loginValidity
     }));
@@ -3234,8 +3201,8 @@ async function resolveFolderForList(options) {
 function registerProcessCommand(program) {
   const processCmd = program.command("process").description("Manage Flow processes");
   registerSharedProcessCommands(processCmd, { toolLabel: "Flow" });
-  addRowWindowOptions(processCmd.command("list")).description("List available Flow projects. The releaseActive and releaseLatest fields reflect Orchestrator release-level state (whether the release is marked active or the highest version on the manifest) and do not indicate whether the process is deployed or runnable.").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--filter <odata>", "Additional OData filter").option("-f, --folder-key <key>", "Folder key (GUID)").option("--folder-path <path>", "Folder path (e.g. 'Shared/Invoices'). Alternative to --folder-key.").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).examples(FLOW_PROCESS_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
+  processCmd.command("list").description("List available Flow projects. The releaseActive and releaseLatest fields reflect Orchestrator release-level state (whether the release is marked active or the highest version on the manifest) and do not indicate whether the process is deployed or runnable.").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).addOption(createProcessLimitOption()).addOption(createProcessOffsetOption()).option("--filter <odata>", "Additional OData filter").option("-f, --folder-key <key>", "Folder key (GUID)").option("--folder-path <path>", "Folder path (e.g. 'Shared/Invoices'). Alternative to --folder-key.").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).examples(FLOW_PROCESS_LIST_EXAMPLES).trackedAction(processContext, async (options) => {
+    const { getAuthContext } = await import("./index-f5kq7265.js");
     if (options.folderKey === undefined && options.folderPath === undefined) {
       OutputFormatter.error({
         Result: RESULTS.ValidationError,
@@ -3245,47 +3212,19 @@ function registerProcessCommand(program) {
       processContext.exit(3);
       return;
     }
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: options.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth")
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const tenantName = options.tenant || loginStatus.tenantName;
-    if (!tenantName) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Tenant not provided and not available from login. Run 'uip login' or 'uip login tenant set <tenant>'.",
-        Instructions: instructionsFor("identity")
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Organization ID not available from login.",
-        Instructions: instructionsFor("identity")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const [resolveError, resolvedFolderKey] = await catchError(resolveFolderForList(options));
+    const { tenantName } = auth;
+    const [resolveError, resolvedFolderKey] = await catchError2(resolveFolderForList(options));
     if (resolveError) {
       OutputFormatter.error({
         Result: RESULTS.ValidationError,
@@ -3299,13 +3238,13 @@ function registerProcessCommand(program) {
       processKey: "",
       folderKey: resolvedFolderKey,
       inputs: {},
-      authToken: loginStatus.accessToken || "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      baseUrl: loginStatus.baseUrl
+      baseUrl: auth.baseUrl
     };
-    const { listFlowProcesses } = await import("./flow-api-sat010z1.js");
-    const [listError, processes] = await catchError(listFlowProcesses(config, options.filter, {
+    const { listFlowProcesses } = await import("./flow-api-d4dvmadm.js");
+    const [listError, processes] = await catchError2(listFlowProcesses(config, options.filter, {
       limit: options.limit,
       offset: options.offset
     }));
@@ -3334,59 +3273,31 @@ function registerProcessCommand(program) {
     });
   });
   processCmd.command("get").description("Get Flow project schema and details").argument("<process-key>", "Process key (e.g., MyFlow.flow.Flow:1.0.0)").argument("<feed-id>", "Feed ID (from 'flow project list')").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).examples(FLOW_PROCESS_GET_EXAMPLES).trackedAction(processContext, async (processKey, feedId, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+    const { getAuthContext } = await import("./index-f5kq7265.js");
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: options.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const tenantName = options.tenant || loginStatus.tenantName;
-    if (!tenantName) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Tenant not provided and not available from login. Run 'uip login' or 'uip login tenant set <tenant>'.",
-        Instructions: instructionsFor("identity")
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Organization ID not available from login.",
-        Instructions: instructionsFor("identity")
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
+    const { tenantName } = auth;
     const config = {
       processKey,
       folderKey: options.folderKey,
       inputs: {},
-      authToken: loginStatus.accessToken || "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      baseUrl: loginStatus.baseUrl,
+      baseUrl: auth.baseUrl,
       feedId
     };
-    const { getFlowEntryPoints } = await import("./flow-api-sat010z1.js");
-    const [entryPointsError, entryPoints] = await catchError(getFlowEntryPoints(config));
+    const { getFlowEntryPoints } = await import("./flow-api-d4dvmadm.js");
+    const [entryPointsError, entryPoints] = await catchError2(getFlowEntryPoints(config));
     if (entryPointsError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -3406,8 +3317,8 @@ function registerProcessCommand(program) {
       return;
     }
     const formattedData = entryPoints.map((ep) => {
-      const [, inputSchema] = catchError(() => JSON.parse(ep.InputArguments));
-      const [, outputSchema] = catchError(() => JSON.parse(ep.OutputArguments));
+      const [, inputSchema] = catchError2(() => JSON.parse(ep.InputArguments));
+      const [, outputSchema] = catchError2(() => JSON.parse(ep.OutputArguments));
       return {
         Path: ep.Path,
         DisplayName: ep.DisplayName,
@@ -3424,56 +3335,28 @@ function registerProcessCommand(program) {
     });
   });
   processCmd.command("run").description("Run a Flow project with inputs").argument("<process-key>", "Process key (e.g., MyFlow.flow.Flow:1.0.0)").argument("<folder-key>", "Folder key (GUID)").option("-i, --inputs <json>", "Input parameters as JSON string or @file.json").option("--attachment <name=path>", "Upload a local file as a file-typed workflow input variable (repeatable). Example: --attachment file1=./resume.pdf", appendOption, []).addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--release-key <key>", "Release key (GUID, from list command)").option("--feed-id <id>", "Feed ID for package lookup (optional)").option("--robot-ids <ids>", "Comma-separated robot IDs (optional)").option("--entry-point <id>", "Entry point node id — a trigger node id from the .flow file. Defaults to the release's default entry point").option("--validate", "Validate inputs against project schema (basic: required fields + primitive types)").option("--login-validity <minutes>", "Minimum minutes before token expiration to trigger a refresh (default: 10)", parseInt, 10).option("--wait", "Block until the job reaches a terminal state (Successful, Faulted, Stopped)").option("--timeout <seconds>", "Maximum seconds to wait (0 = no timeout). Requires --wait.", String(DEFAULT_TIMEOUT_MS / 1000)).option("--poll-interval <seconds>", "Seconds between status checks. Requires --wait.", String(DEFAULT_INTERVAL_MS / 1000)).examples(FLOW_PROCESS_RUN_EXAMPLES).trackedAction(processContext, async (processKey, folderKey, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
+    const { getAuthContext } = await import("./index-f5kq7265.js");
     const {
       parseFlowInputs,
       resolveEntryPoint,
       startFlowProjectJob,
       validateFlowInputs
-    } = await import("./flow-api-sat010z1.js");
-    const [loginError, loginStatus] = await catchError(getLoginStatusAsync({
-      ensureTokenValidityMinutes: options.loginValidity
+    } = await import("./flow-api-d4dvmadm.js");
+    const [authError, auth] = await catchError2(getAuthContext({
+      ensureTokenValidityMinutes: options.loginValidity,
+      tenant: options.tenant,
+      requireOrganizationId: true,
+      requireTenantName: true
     }));
-    if (loginError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: loginError.message,
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Not logged in. Run 'uip login' first.",
-        Instructions: instructionsFor("auth")
-      });
-      processContext.exit(1);
-      return;
-    }
-    const tenantName = options.tenant || loginStatus.tenantName;
-    if (!tenantName) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Tenant not provided and not available from login. Run 'uip login' or 'uip login tenant set <tenant>'.",
-        Instructions: instructionsFor("identity")
-      });
-      processContext.exit(1);
-      return;
-    }
-    if (!loginStatus.organizationId) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Organization ID not available from login.",
-        Instructions: instructionsFor("identity")
-      });
+    if (authError) {
+      OutputFormatter.error(await authContextFailure(authError));
       processContext.exit(1);
       return;
     }
+    const { tenantName } = auth;
     let inputs = {};
     if (options.inputs) {
-      const [parseError, parsed] = await catchError(parseFlowInputs(options.inputs));
+      const [parseError, parsed] = await catchError2(parseFlowInputs(options.inputs));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -3485,8 +3368,8 @@ function registerProcessCommand(program) {
       }
       inputs = parsed;
     } else {
-      const { readStdin } = await import("./input-reader-n7kzdrev.js");
-      const [stdinError, stdinData] = await catchError(readStdin());
+      const { readStdin } = await import("./input-reader-zqaep7k7.js");
+      const [stdinError, stdinData] = await catchError2(readStdin());
       if (stdinError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -3497,7 +3380,7 @@ function registerProcessCommand(program) {
         return;
       }
       if (stdinData) {
-        const [parseError, parsed] = await catchError(parseFlowInputs(stdinData));
+        const [parseError, parsed] = await catchError2(parseFlowInputs(stdinData));
         if (parseError) {
           OutputFormatter.error({
             Result: RESULTS.Failure,
@@ -3514,17 +3397,17 @@ function registerProcessCommand(program) {
       processKey,
       folderKey,
       inputs,
-      authToken: loginStatus.accessToken || "",
-      organizationId: loginStatus.organizationId,
+      authToken: auth.accessToken,
+      organizationId: auth.organizationId,
       tenantName,
-      tenantId: loginStatus.tenantId,
-      baseUrl: loginStatus.baseUrl,
+      tenantId: auth.tenantId,
+      baseUrl: auth.baseUrl,
       releaseKey: options.releaseKey,
       feedId: options.feedId
     };
     let mainEntryPointId;
     const fillRelease = async () => {
-      const [resolveError, release] = await catchError(resolveRelease(config, processKey));
+      const [resolveError, release] = await catchError2(resolveRelease(config, processKey));
       if (resolveError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -3550,7 +3433,7 @@ function registerProcessCommand(program) {
     }
     let entryPoint;
     if (options.entryPoint !== undefined) {
-      const [entryPointError, resolved] = await catchError(resolveEntryPoint(config, options.entryPoint));
+      const [entryPointError, resolved] = await catchError2(resolveEntryPoint(config, options.entryPoint));
       if (entryPointError instanceof UnknownEntryPointError) {
         OutputFormatter.error({
           Result: RESULTS.ValidationError,
@@ -3574,7 +3457,7 @@ function registerProcessCommand(program) {
     }
     const attachmentSpecs = options.attachment ?? [];
     if (attachmentSpecs.length > 0) {
-      const [parseError, specs] = catchError(() => attachmentSpecs.map(parseAttachmentSpec));
+      const [parseError, specs] = catchError2(() => attachmentSpecs.map(parseAttachmentSpec));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -3584,8 +3467,8 @@ function registerProcessCommand(program) {
         processContext.exit(1);
         return;
       }
-      const { uploadJobAttachment } = await import("./index-wycgq0ff.js");
-      const [uploadError, resolved] = await catchError(resolveAttachmentInputs(specs, (bytes, fileName) => uploadJobAttachment(bytes, fileName, {
+      const { uploadJobAttachment } = await import("./index-4e3w8x62.js");
+      const [uploadError, resolved] = await catchError2(resolveAttachmentInputs(specs, (bytes, fileName) => uploadJobAttachment(bytes, fileName, {
         tenant: tenantName
       })));
       if (uploadError) {
@@ -3618,7 +3501,7 @@ function registerProcessCommand(program) {
       }
     }
     if (options.validate) {
-      const [valError, validation] = await catchError(validateFlowInputs(config, inputs, entryPoint, mainEntryPointId));
+      const [valError, validation] = await catchError2(validateFlowInputs(config, inputs, entryPoint, mainEntryPointId));
       if (valError) {
         const code = flowProcessRunErrorCode(valError);
         OutputFormatter.error({
@@ -3674,7 +3557,7 @@ ${errorList}`,
     if (config.releaseKey === undefined && !await fillRelease()) {
       return;
     }
-    const [jobError, job] = await catchError(startFlowProjectJob(config));
+    const [jobError, job] = await catchError2(startFlowProjectJob(config));
     if (jobError) {
       const code = flowProcessRunErrorCode(jobError);
       OutputFormatter.error({
@@ -3710,7 +3593,7 @@ ${errorList}`,
       processContext.exit(1);
       return;
     }
-    const { handleFlowJobWait } = await import("./wait-for-flow-job-b0vj8828.js");
+    const { handleFlowJobWait } = await import("./wait-for-flow-job-a4xtda36.js");
     await handleFlowJobWait(job.key, {
       config,
       timeoutMs,
@@ -3752,33 +3635,20 @@ function getDefaultOutputPath(fs = getFileSystem()) {
 }
 var registerPublishCommand = (program) => {
   program.command("publish").description("Pack a Flow project and upload the resulting .nupkg to Orchestrator packages").argument("<project-path>", "Path to the Flow project directory").argument("[output-path]", "Output directory where the generated .nupkg will be saved").option("-n, --name <name>", "Package name (default: project folder name)").option("-v, --version <version>", "Package version (default: 1.0.0)", "1.0.0").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("--feed-id <feedId>", "Feed ID (optional, defaults to tenant feed). Mutually exclusive with --folder-key/--folder-path.").option("--folder-key <key>", "Folder key (GUID) of an Orchestrator folder hierarchy feed. The CLI resolves the folder's feed ID automatically. Mutually exclusive with --feed-id and --folder-path.").option("--folder-path <path>", "Folder path (e.g. 'Shared/Sub') of an Orchestrator folder hierarchy feed. The CLI resolves the folder's feed ID automatically. Mutually exclusive with --feed-id and --folder-key.").examples(FLOW_PUBLISH_EXAMPLES).trackedAction(processContext, async (projectPath, outputPath, options) => {
-    const { getLoginStatusAsync } = await import("./index-sqhbn7ew.js");
+    const { getAuthContext } = await import("./index-f5kq7265.js");
     const {
       createApiClient,
       PackageFeedsApi,
       ProcessesApi,
       resolveFolder
-    } = await import("./index-wycgq0ff.js");
+    } = await import("./index-4e3w8x62.js");
     const fs = getFileSystem();
     const shouldCleanupOutput = outputPath === undefined;
     const packageOutputPath = outputPath ?? getDefaultOutputPath(fs);
     try {
-      const [loginError, loginStatus] = await catchError(getLoginStatusAsync());
-      if (loginError) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: loginError.message,
-          Instructions: instructionsFor("auth", loginError)
-        });
-        processContext.exit(1);
-        return;
-      }
-      if (loginStatus.loginStatus !== "Logged in" || !loginStatus.baseUrl) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Not logged in. Run 'uip login' first.",
-          Instructions: instructionsFor("auth")
-        });
+      const [authError] = await catchError2(getAuthContext());
+      if (authError) {
+        OutputFormatter.error(await authContextFailure(authError));
         processContext.exit(1);
         return;
       }
@@ -3803,7 +3673,7 @@ var registerPublishCommand = (program) => {
       }
       let resolvedFeedId = options.feedId;
       if (folderTargetingSpecified) {
-        const [folderError, folder] = await catchError(resolveFolder({
+        const [folderError, folder] = await catchError2(resolveFolder({
           folderKey: options.folderKey,
           folderPath: options.folderPath
         }, { tenant: options.tenant }));
@@ -3817,7 +3687,7 @@ var registerPublishCommand = (program) => {
           processContext.exit(3);
           return;
         }
-        const [feedsApiError, feedsApi] = await catchError(createApiClient(PackageFeedsApi, {
+        const [feedsApiError, feedsApi] = await catchError2(createApiClient(PackageFeedsApi, {
           tenant: options.tenant
         }));
         if (feedsApiError) {
@@ -3829,7 +3699,7 @@ var registerPublishCommand = (program) => {
           processContext.exit(1);
           return;
         }
-        const [feedLookupError, folderFeedId] = await catchError(feedsApi.packageFeedsGetFolderFeed({
+        const [feedLookupError, folderFeedId] = await catchError2(feedsApi.packageFeedsGetFolderFeed({
           folderId: folder.id
         }));
         if (feedLookupError || !folderFeedId) {
@@ -3844,9 +3714,9 @@ var registerPublishCommand = (program) => {
         }
         resolvedFeedId = folderFeedId;
       }
-      const { FlowPackService } = await import("./flow-pack-service-b910q207.js");
+      const { FlowPackService } = await import("./flow-pack-service-58m51sp8.js");
       const service = new FlowPackService;
-      const [packError, packResult] = await catchError(service.executeAsync(projectPath, {
+      const [packError, packResult] = await catchError2(service.executeAsync(projectPath, {
         output: packageOutputPath,
         name: options.name,
         version: options.version
@@ -3869,7 +3739,7 @@ var registerPublishCommand = (program) => {
         processContext.exit(1);
         return;
       }
-      const [apiError, api] = await catchError(createApiClient(ProcessesApi, {
+      const [apiError, api] = await catchError2(createApiClient(ProcessesApi, {
         tenant: options.tenant
       }));
       if (apiError) {
@@ -3881,12 +3751,27 @@ var registerPublishCommand = (program) => {
         processContext.exit(1);
         return;
       }
-      const [readError, fileBuffer] = await catchError(fs.readFile(packResult.outputPath));
+      const [readError, fileBuffer] = await catchError2(fs.readFile(packResult.outputPath));
+      const readInstructions = `Verify the generated package exists at '${packResult.outputPath}' and that the current user can read it.`;
       if (readError) {
+        const details = await extractErrorDetails(readError);
         OutputFormatter.error({
           Result: RESULTS.Failure,
+          ErrorCode: details.errorCode,
           Message: `Flow publish failed: ${readError.message}`,
-          Instructions: `Verify the generated package exists at '${packResult.outputPath}' and that the current user can read it.`
+          Instructions: readInstructions,
+          Retry: details.retry
+        });
+        processContext.exit(1);
+        return;
+      }
+      if (fileBuffer === null) {
+        OutputFormatter.error({
+          Result: RESULTS.Failure,
+          ErrorCode: "not_found",
+          Message: `Flow publish failed: no package found at '${packResult.outputPath}'.`,
+          Instructions: readInstructions,
+          Retry: "RetryWillNotFix"
         });
         processContext.exit(1);
         return;
@@ -3895,7 +3780,7 @@ var registerPublishCommand = (program) => {
       const file = new File([fileBuffer], fileName, {
         type: "application/octet-stream"
       });
-      const [uploadError, uploadResult] = await catchError(api.processesUploadPackage({
+      const [uploadError, uploadResult] = await catchError2(api.processesUploadPackage({
         file,
         feedId: resolvedFeedId
       }));
@@ -3931,7 +3816,7 @@ var registerPublishCommand = (program) => {
       });
     } finally {
       if (shouldCleanupOutput) {
-        await catchError(fs.rm(packageOutputPath));
+        await catchError2(fs.rm(packageOutputPath));
       }
     }
   });
@@ -3945,8 +3830,8 @@ var registerRegistryCommand2 = (program) => {
 // src/commands/tidy.ts
 var registerTidyCommand = (program) => {
   program.command("format").description("Format a .flow file by auto-laying out nodes to prevent overlaps and arrange in a clean flow").argument("<file>", "Path to the .flow file").trackedAction(processContext, async (file) => {
-    const { tidyFlow } = await import("./tidy-service-hz61ypyj.js");
-    const [error, result] = await catchError(tidyFlow(file));
+    const { tidyFlow } = await import("./tidy-service-m33hhtc7.js");
+    const [error, result] = await catchError2(tidyFlow(file));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -4058,8 +3943,8 @@ var registerValidateCommand = (program) => {
     let governanceEnforcements;
     let availableModelNames;
     if (options.governance) {
-      const { fetchGovernanceData } = await import("./governance-fetcher-ffvbtwbd.js");
-      const [error, data] = await catchError(fetchGovernanceData());
+      const { fetchGovernanceData } = await import("./governance-fetcher-h8hpcwyh.js");
+      const [error, data] = await catchError2(fetchGovernanceData());
       if (error) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -4072,7 +3957,7 @@ var registerValidateCommand = (program) => {
       governanceEnforcements = data.enforcements;
       availableModelNames = data.modelNames;
     }
-    const { FlowValidateService } = await import("./flow-validate-service-x2mbk3et.js");
+    const { FlowValidateService } = await import("./flow-validate-service-9a3zate4.js");
     const service = new FlowValidateService({
       governanceEnforcements,
       availableModelNames,
@@ -4178,7 +4063,7 @@ function parseDefaultValue(value, type) {
     }
     case "object":
     case "array": {
-      const [parseErr, parsedValue] = catchError(() => JSON.parse(value));
+      const [parseErr, parsedValue] = catchError2(() => JSON.parse(value));
       if (parseErr) {
         return {
           error: `Invalid default value for type '${type}': must be valid JSON`
@@ -4203,7 +4088,7 @@ function parseDefaultValue(value, type) {
 var registerVariableCommand = (program) => {
   const variable = program.command("variables").alias("variable").description("Manage variables in a Flow file");
   variable.command("create").alias("add").description("Add a variable to a Flow file").argument("<file>", "Path to the .flow file").argument("<variable-id>", "Variable identifier (e.g. myInputVar)").requiredOption("-d, --direction <direction>", `Variable direction (${VALID_DIRECTIONS.join(", ")})`).option("-t, --type <type>", `Data type (${VALID_TYPES.join(", ")})`, "string").option("--default-value <value>", "Default value (parsed based on --type)").option("--description <text>", "Human-readable description").option("--schema <json>", "JSON schema for object/array types").option("--sub-type <subType>", "Sub-type for complex types").option("--trigger-node-id <nodeId>", "Trigger node an input variable belongs to (defaults to the flow's only trigger node; required when the flow has several)").examples(VARIABLE_ADD_EXAMPLES).trackedAction(processContext, async (file, variableId, options) => {
-    const { validateIdentifier } = await import("./index-gxcjq6ns.js");
+    const { validateIdentifier } = await import("./index-d4bdedx3.js");
     const identifierError = validateIdentifier(variableId, []);
     if (identifierError) {
       OutputFormatter.error({
@@ -4248,7 +4133,7 @@ var registerVariableCommand = (program) => {
     }
     let schema;
     if (options.schema !== undefined) {
-      const [parseError, parsed] = catchError(() => JSON.parse(options.schema));
+      const [parseError, parsed] = catchError2(() => JSON.parse(options.schema));
       if (parseError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -4269,8 +4154,8 @@ var registerVariableCommand = (program) => {
       }
       schema = parsed;
     }
-    const { addVariableToFlow } = await import("./variable-service-9ex4a93n.js");
-    const [error, variable2] = await catchError(addVariableToFlow(file, {
+    const { addVariableToFlow } = await import("./variable-service-ea1erf93.js");
+    const [error, variable] = await catchError2(addVariableToFlow(file, {
       id: variableId,
       direction: options.direction,
       type: options.type,
@@ -4293,12 +4178,12 @@ var registerVariableCommand = (program) => {
       Result: RESULTS.Success,
       Code: "VariableAddSuccess",
       Data: {
-        Variable: variable2
+        Variable: variable
       }
     });
   });
   variable.command("delete").alias("remove").description("Remove a variable from a Flow file").argument("<file>", "Path to the .flow file").argument("<variable-id>", "Variable identifier to remove").examples(VARIABLE_DELETE_EXAMPLES).trackedAction(processContext, async (file, variableId) => {
-    const { validateIdentifier } = await import("./index-gxcjq6ns.js");
+    const { validateIdentifier } = await import("./index-d4bdedx3.js");
     const identifierError = validateIdentifier(variableId, []);
     if (identifierError) {
       OutputFormatter.error({
@@ -4309,8 +4194,8 @@ var registerVariableCommand = (program) => {
       processContext.exit(1);
       return;
     }
-    const { deleteVariableFromFlow } = await import("./variable-service-9ex4a93n.js");
-    const [error, deletedVariable] = await catchError(deleteVariableFromFlow(file, variableId));
+    const { deleteVariableFromFlow } = await import("./variable-service-ea1erf93.js");
+    const [error, deletedVariable] = await catchError2(deleteVariableFromFlow(file, variableId));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -4329,8 +4214,8 @@ var registerVariableCommand = (program) => {
     });
   });
   addRowWindowOptions(variable.command("list")).description("List all variables in a Flow file").argument("<file>", "Path to the .flow file").examples(VARIABLE_LIST_EXAMPLES).trackedAction(processContext, async (file, options) => {
-    const { listVariablesInFlow } = await import("./variable-service-9ex4a93n.js");
-    const [error, result] = await catchError(listVariablesInFlow(file));
+    const { listVariablesInFlow } = await import("./variable-service-ea1erf93.js");
+    const [error, result] = await catchError2(listVariablesInFlow(file));
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -4356,12 +4241,12 @@ var registerVariableCommand = (program) => {
 // src/services/project-metadata-reader.ts
 async function readAgentProjectMetadata(projectDir) {
   const fs = getFileSystem();
-  const [readError, content] = await catchError(fs.readFile(fs.path.join(projectDir, "agent.json"), "utf-8"));
+  const [readError, content] = await catchError2(fs.readFile(fs.path.join(projectDir, "agent.json"), "utf-8"));
   if (readError || typeof content !== "string") {
     logger.debug(`No readable agent.json in ${projectDir}; the node will describe an autonomous agent.`);
     return {};
   }
-  const [parseError, parsed] = catchError(() => JSON.parse(content));
+  const [parseError, parsed] = catchError2(() => JSON.parse(content));
   if (parseError) {
     logger.debug(`Unparseable agent.json in ${projectDir}: ${parseError.message}. The node will describe an autonomous agent.`);
     return {};
@@ -4380,15 +4265,15 @@ async function readAgentProjectMetadata(projectDir) {
 var agentProjectMetadataReader = (projectDir, projectType) => projectType === "Agent" ? readAgentProjectMetadata(projectDir) : Promise.resolve({});
 
 // src/tool.ts
-var metadata = {
+var metadata2 = {
   name: "flow-tool",
   version: package_default.version,
   description: "Create, debug, and run UiPath Flow projects and jobs.",
   commandPrefix: "flow"
 };
-var registerCommands = async (program) => {
-  setAgentProjectMetadataReader(agentProjectMetadataReader);
-  const { registerFlowAuthoringCommands } = await import("./authoring-e1k40hyw.js");
+var registerCommands2 = async (program) => {
+  setAgentProjectMetadataReader2(agentProjectMetadataReader);
+  const { registerFlowAuthoringCommands } = await import("./authoring-x84r2a2j.js");
   registerFlowAuthoringCommands(program);
   registerInitCommand(program);
   registerPackCommand(program);
@@ -4412,6 +4297,6 @@ var registerCommands = async (program) => {
   registerVariableCommand(program);
 };
 
-export { metadata, registerCommands };
+export { metadata2, registerCommands2 };
 
-//# debugId=02B0582EB3A6477164756E2164756E21
+//# debugId=7295FBFAF8DE3F1964756E2164756E21