@uipath/flow-tool 1.201.0 → 1.202.0-preview.136

package/dist/utils/handle-expansion.d.ts

@@ -58,6 +58,22 @@ export declare function parseVisibleInputKey(visible: unknown): string | null;
  *   flag flows that actually work.
  */
 export declare function isHandleVisible(handle: Pick<HandleEntry, "visible">, node: HandleExpansionNode): boolean;
+/**
+ * Derive the source handle IDs a node exposes from its declared outcomes.
+ *
+ * A Studio Web-authored HITL quick-form node keeps its buttons in
+ * `inputs.schema.outcomes` (e.g. `[{id:"approve"},{id:"reject"}]`). When a
+ * node has outcomes, the canvas wires each outgoing edge to a source handle
+ * `outcome-<outcomeId>` — one per outcome — but the static manifest only
+ * declares the single `completed` source handle. Without deriving these,
+ * `flow validate` rejects every multi-outcome edge as an "undeclared source
+ * handle" even though `flow debug` runs the flow fine (UV-16067).
+ *
+ * Returns `outcome-<id>` for every outcome that carries a string `id`, or an
+ * empty array when the node declares no outcomes — leaving the existing static
+ * `completed` handle as the only source for the single default outcome case.
+ */
+export declare function deriveOutcomeHandleIds(node: HandleExpansionNode): string[];
 export declare function expandHandleIds(handle: HandleEntry, node: HandleExpansionNode): string[];
 /**
  * True when `id` still carries an unsubstituted `{...}` placeholder — i.e.

package/dist/validation.js

@@ -1,39 +1,59 @@
 import {
   FlowValidateService,
   connectorNodeValidator
-} from "./packager-tool-3vdpx9ng.js";
-import"./packager-tool-7yjpwj92.js";
-import"./packager-tool-3y0k15sv.js";
-import"./packager-tool-0sz8se22.js";
-import"./packager-tool-pkq70dec.js";
-import"./packager-tool-cvwr40ax.js";
-import"./packager-tool-9qecd4wb.js";
+} from "./packager-tool-zke08y39.js";
+import"./packager-tool-4fhgws0x.js";
+import"./packager-tool-mwvbq6ef.js";
+import"./packager-tool-2wefykg9.js";
+import"./packager-tool-nq4rcqqg.js";
+import"./packager-tool-8j92afwp.js";
+import"./packager-tool-v2rkcehq.js";
+import"./packager-tool-v86fdwvs.js";
+import"./packager-tool-jc34wvrw.js";
+import"./packager-tool-4hx14snw.js";
+import"./packager-tool-a1hbfmws.js";
+import"./packager-tool-cdwpc9fh.js";
+import"./packager-tool-g9y14b10.js";
+import"./packager-tool-5z1eg3ea.js";
+import"./packager-tool-v9rrz038.js";
+import"./packager-tool-fjaa8d3v.js";
+import"./packager-tool-v9psxdy5.js";
+import"./packager-tool-ywqc9rtf.js";
+import"./packager-tool-f0kd5kq4.js";
+import"./packager-tool-0gctz400.js";
 import"./packager-tool-qa9gftnj.js";
-import"./packager-tool-1cb0d5e0.js";
-import"./packager-tool-5arsyj36.js";
-import"./packager-tool-17cn3xb7.js";
-import"./packager-tool-1gt6js73.js";
+import"./packager-tool-yc4kw997.js";
+import"./packager-tool-7exrv6w7.js";
+import"./packager-tool-8dszjcg5.js";
+import"./packager-tool-eebq62fq.js";
+import"./packager-tool-94w17vf8.js";
+import"./packager-tool-6m078z5s.js";
+import"./packager-tool-tn5e7wnb.js";
+import"./packager-tool-xhzfwa5p.js";
 import"./packager-tool-nkrmjr3a.js";
-import"./packager-tool-y3dezh8k.js";
+import"./packager-tool-rs6jm14d.js";
 import"./packager-tool-hk1gxnth.js";
-import"./packager-tool-v74yk918.js";
-import"./packager-tool-xj0agqpk.js";
-import"./packager-tool-3wygxefb.js";
-import"./packager-tool-sc961w0q.js";
-import"./packager-tool-m6x5sczh.js";
-import"./packager-tool-vdd02vns.js";
-import"./packager-tool-p9j43p8h.js";
-import"./packager-tool-jysvpt8p.js";
-import"./packager-tool-78a3szsp.js";
-import"./packager-tool-0567pxpm.js";
+import"./packager-tool-em5r6g6j.js";
+import"./packager-tool-9bec251q.js";
+import"./packager-tool-z9bfhmm5.js";
 import"./packager-tool-6ejqwbw9.js";
 import"./packager-tool-mcaf4ewf.js";
-import"./packager-tool-tq9q9m77.js";
+import"./packager-tool-eypvc2kv.js";
+import"./packager-tool-5qaxht3k.js";
+import"./packager-tool-0v3s8r01.js";
+import"./packager-tool-p9stswjj.js";
+import"./packager-tool-vpqyvh4c.js";
+import"./packager-tool-gbgfwx8f.js";
+import"./packager-tool-58q3tvh7.js";
+import"./packager-tool-sc961w0q.js";
+import"./packager-tool-m5qfverj.js";
+import"./packager-tool-e0p2zsyc.js";
+import"./packager-tool-a42jnpy5.js";
 import"./packager-tool-c23zrhj8.js";
-import"./packager-tool-wckvcay0.js";
+import"./packager-tool-1yh8g550.js";
 export {
-  connectorNodeValidator,
-  FlowValidateService
+  FlowValidateService,
+  connectorNodeValidator
 };
 
-//# debugId=D53F1C5C51DBE10464756E2164756E21
+//# debugId=CDB8D9866CEE1AC364756E2164756E21

package/dist/variable-service-er7ph4br.js

@@ -0,0 +1,152 @@
+import {
+  readFlowWorkflow,
+  writeFlowWorkflow
+} from "./packager-tool-94w17vf8.js";
+import"./packager-tool-6m078z5s.js";
+import {
+  addVariable
+} from "./packager-tool-tn5e7wnb.js";
+import"./packager-tool-xhzfwa5p.js";
+import"./packager-tool-nkrmjr3a.js";
+import"./packager-tool-rs6jm14d.js";
+import"./packager-tool-hk1gxnth.js";
+import"./packager-tool-em5r6g6j.js";
+import"./packager-tool-9bec251q.js";
+import"./packager-tool-z9bfhmm5.js";
+import"./packager-tool-6ejqwbw9.js";
+import"./packager-tool-mcaf4ewf.js";
+import"./packager-tool-5qaxht3k.js";
+import"./packager-tool-0v3s8r01.js";
+import {
+  createWorkflowVariable
+} from "./packager-tool-vpqyvh4c.js";
+import"./packager-tool-gbgfwx8f.js";
+import"./packager-tool-58q3tvh7.js";
+import"./packager-tool-sc961w0q.js";
+import {
+  isExpressionValue,
+  isStartEventNode
+} from "./packager-tool-m5qfverj.js";
+import"./packager-tool-e0p2zsyc.js";
+import"./packager-tool-a42jnpy5.js";
+import"./packager-tool-c23zrhj8.js";
+import"./packager-tool-1yh8g550.js";
+
+// src/services/variable-service.ts
+var expressionText = (expression) => {
+  if (typeof expression === "string")
+    return expression;
+  if (isExpressionValue(expression))
+    return expression.expression;
+  return "";
+};
+var listVariablesInFlow = async (filePath) => {
+  const { workflow } = await readFlowWorkflow(filePath);
+  const globals = (workflow.variables?.globals ?? []).map((v) => ({
+    id: v.id,
+    type: v.type,
+    direction: v.direction,
+    ...v.defaultValue !== undefined && { defaultValue: v.defaultValue },
+    ...v.description !== undefined && { description: v.description },
+    ...v.triggerNodeId !== undefined && {
+      triggerNodeId: v.triggerNodeId
+    }
+  }));
+  const nodes = (workflow.variables?.nodes ?? []).map((v) => ({
+    id: v.id,
+    type: v.type,
+    nodeId: v.binding.nodeId,
+    outputId: v.binding.outputId,
+    ...v.description !== undefined && { description: v.description }
+  }));
+  const variables = [...globals, ...nodes];
+  return { variables, count: variables.length };
+};
+var resolveTriggerNodeId = (nodes, explicitTriggerNodeId) => {
+  const triggerNodes = nodes.filter((node) => isStartEventNode({
+    id: node.id,
+    type: node.type,
+    typeVersion: node.typeVersion ?? "1.0"
+  }));
+  if (explicitTriggerNodeId !== undefined) {
+    if (!nodes.some((node) => node.id === explicitTriggerNodeId)) {
+      const available = nodes.map((node) => node.id).join(", ");
+      throw new Error(available ? `Node '${explicitTriggerNodeId}' not found in the flow. Available nodes: ${available}` : `Node '${explicitTriggerNodeId}' not found. The flow has no nodes`);
+    }
+    if (!triggerNodes.some((node) => node.id === explicitTriggerNodeId)) {
+      const triggerIds = triggerNodes.map((node) => node.id).join(", ");
+      throw new Error(triggerIds ? `Node '${explicitTriggerNodeId}' is not a trigger node. Trigger nodes in this flow: ${triggerIds}` : `Node '${explicitTriggerNodeId}' is not a trigger node. The flow has no trigger nodes`);
+    }
+    return explicitTriggerNodeId;
+  }
+  if (triggerNodes.length === 0) {
+    return;
+  }
+  if (triggerNodes.length > 1) {
+    const triggerIds = triggerNodes.map((node) => node.id).join(", ");
+    throw new Error(`Flow has multiple trigger nodes (${triggerIds}); each is a separate entry point. Pass --trigger-node-id <nodeId> to choose which one this input belongs to`);
+  }
+  return triggerNodes[0].id;
+};
+var addVariableToFlow = async (filePath, options) => {
+  if (options.triggerNodeId !== undefined && options.direction !== "in") {
+    throw new Error(`--trigger-node-id applies only to input variables (--direction in), but --direction is '${options.direction}'`);
+  }
+  const { workflow, refMap } = await readFlowWorkflow(filePath);
+  const globals = workflow.variables?.globals ?? [];
+  const duplicate = globals.find((v) => v.id === options.id);
+  if (duplicate) {
+    throw new Error(`Variable '${options.id}' already exists in the flow file`);
+  }
+  const triggerNodeId = options.direction === "in" ? resolveTriggerNodeId(workflow.nodes ?? [], options.triggerNodeId) : undefined;
+  const created = createWorkflowVariable({
+    id: options.id,
+    direction: options.direction,
+    type: options.type,
+    subType: options.subType,
+    defaultValue: options.defaultValue,
+    description: options.description,
+    schema: options.schema
+  });
+  const variable = triggerNodeId === undefined ? created : { ...created, triggerNodeId };
+  addVariable(workflow, variable);
+  await writeFlowWorkflow(filePath, workflow, refMap);
+  return variable;
+};
+var deleteVariableFromFlow = async (filePath, variableId) => {
+  const { workflow, refMap } = await readFlowWorkflow(filePath);
+  const globals = workflow.variables?.globals ?? [];
+  const target = globals.find((v) => v.id === variableId);
+  if (!target) {
+    const available = globals.map((v) => v.id).join(", ");
+    throw new Error(available ? `Variable '${variableId}' not found. Available variables: ${available}` : `Variable '${variableId}' not found. No variables exist in this flow file`);
+  }
+  const updatedGlobals = globals.filter((v) => v.id !== variableId);
+  let updatedVariableUpdates = workflow.variables?.variableUpdates;
+  if (updatedVariableUpdates) {
+    const cleaned = {};
+    for (const [nodeId, updates] of Object.entries(updatedVariableUpdates)) {
+      const varRefPattern = new RegExp(`\\$vars\\.${variableId}\\b`);
+      const filtered = updates.filter((u) => u.variableId !== variableId && !varRefPattern.test(expressionText(u.expression)));
+      if (filtered.length > 0) {
+        cleaned[nodeId] = filtered;
+      }
+    }
+    updatedVariableUpdates = Object.keys(cleaned).length > 0 ? cleaned : undefined;
+  }
+  workflow.variables = {
+    ...workflow.variables,
+    globals: updatedGlobals.length > 0 ? updatedGlobals : undefined,
+    variableUpdates: updatedVariableUpdates
+  };
+  await writeFlowWorkflow(filePath, workflow, refMap);
+  return target;
+};
+export {
+  addVariableToFlow,
+  deleteVariableFromFlow,
+  listVariablesInFlow,
+  resolveTriggerNodeId
+};
+
+//# debugId=48628F6C2A3679DC64756E2164756E21

package/dist/wait-for-flow-job-45p1a444.js

@@ -0,0 +1,134 @@
+import {
+  getJobStatusDetailed
+} from "./packager-tool-wcha0e5r.js";
+import {
+  DEFAULT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_MS,
+  PENDING_NORMAL_SECONDS,
+  PENDING_STALLED_SECONDS,
+  pendingSecondsFor,
+  pendingStallInstructions
+} from "./packager-tool-tf3d2y8z.js";
+import"./packager-tool-g9y14b10.js";
+import"./packager-tool-5z1eg3ea.js";
+import"./packager-tool-v9rrz038.js";
+import"./packager-tool-fjaa8d3v.js";
+import"./packager-tool-f0kd5kq4.js";
+import"./packager-tool-0gctz400.js";
+import"./packager-tool-qa9gftnj.js";
+import"./packager-tool-yc4kw997.js";
+import"./packager-tool-eypvc2kv.js";
+import {
+  OutputFormatter,
+  PollOutcome,
+  catchError,
+  isFailureStatus,
+  isTerminalStatus,
+  msToDuration,
+  pollUntil,
+  processContext
+} from "./packager-tool-5qaxht3k.js";
+import"./packager-tool-0v3s8r01.js";
+import"./packager-tool-1yh8g550.js";
+
+// src/utils/wait-for-flow-job.ts
+function toIsoString(value) {
+  if (value == null) {
+    return "";
+  }
+  return value instanceof Date ? value.toISOString() : value;
+}
+async function waitForFlowJob(jobKey, options) {
+  return pollUntil({
+    fn: () => getJobStatusDetailed(options.config, jobKey),
+    until: (job) => isTerminalStatus(job.state),
+    getStatus: (job) => job.state,
+    label: `job ${jobKey}`,
+    logPrefix: "flow",
+    intervalMs: options.intervalMs ?? DEFAULT_INTERVAL_MS,
+    timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    signal: processContext.pollSignal
+  });
+}
+async function handleFlowJobWait(jobKey, options) {
+  const [waitError, result] = await catchError(waitForFlowJob(jobKey, options));
+  if (waitError) {
+    OutputFormatter.error({
+      Result: "Failure",
+      Message: "Error waiting for job",
+      Instructions: waitError.message
+    });
+    processContext.exit(1);
+    return;
+  }
+  if (result.outcome === PollOutcome.Completed) {
+    if (!result.data) {
+      OutputFormatter.error({
+        Result: "Failure",
+        Message: `Job '${jobKey}' completed but returned no data.`,
+        Instructions: "Check job status manually."
+      });
+      processContext.exit(1);
+      return;
+    }
+    const job = result.data;
+    if (isFailureStatus(job.state)) {
+      OutputFormatter.error({
+        Result: "Failure",
+        Message: `Job reached terminal failure state: ${job.state}`,
+        Instructions: job.info || "Check job logs for details."
+      });
+      processContext.exit(1);
+      return;
+    }
+    OutputFormatter.success({
+      Result: "Success",
+      Code: "FlowJobWaitComplete",
+      Data: {
+        Key: job.key,
+        State: job.state,
+        Duration: msToDuration(result.elapsedMs),
+        StartTime: toIsoString(job.startTime),
+        EndTime: toIsoString(job.endTime)
+      }
+    });
+    processContext.exit(0);
+    return;
+  }
+  const lastStatus = result.data?.state ?? "unknown";
+  const EXIT_CODES = {
+    [PollOutcome.Timeout]: 2,
+    [PollOutcome.Failed]: 1,
+    [PollOutcome.Interrupted]: 1,
+    [PollOutcome.Aborted]: 1
+  };
+  const messages = {
+    [PollOutcome.Timeout]: `Timed out after ${Math.round(result.elapsedMs / 1000)}s. Last status: ${lastStatus}`,
+    [PollOutcome.Failed]: `Polling failed: ${result.error?.message ?? "too many consecutive errors"}`,
+    [PollOutcome.Interrupted]: `Interrupted. Last status: ${lastStatus}`,
+    [PollOutcome.Aborted]: `Polling aborted for job '${jobKey}'.`
+  };
+  const pendingSeconds = result.outcome === PollOutcome.Timeout ? pendingSecondsFor(result.data?.state, result.data?.creationTime) : undefined;
+  const slowPendingSeconds = pendingSeconds !== undefined && pendingSeconds >= PENDING_NORMAL_SECONDS ? pendingSeconds : undefined;
+  const failure = {
+    Result: "Failure",
+    Message: messages[result.outcome] ?? `Polling failed for job '${jobKey}'.`,
+    Instructions: slowPendingSeconds !== undefined ? pendingStallInstructions(slowPendingSeconds) : result.outcome === PollOutcome.Timeout ? "Increase --timeout or check the job status manually." : "Check job logs for details."
+  };
+  if (result.outcome === PollOutcome.Timeout) {
+    failure.ErrorCode = "timeout";
+    if (pendingSeconds !== undefined && pendingSeconds >= PENDING_STALLED_SECONDS) {
+      failure.Retry = "RetryWillNotFix";
+    }
+  }
+  OutputFormatter.error(failure);
+  processContext.exit(EXIT_CODES[result.outcome] ?? 1);
+}
+export {
+  DEFAULT_INTERVAL_MS,
+  DEFAULT_TIMEOUT_MS,
+  handleFlowJobWait,
+  waitForFlowJob
+};
+
+//# debugId=B4069F720472708A64756E2164756E21