@uipath/maestro-builder-sdk 6.20.3 → 6.20.4

package/dist/api-index.md

@@ -128,11 +128,11 @@ could hand you spans for a version you do not have.
 | `FilterCondition` | type | `dist/nodes/transform/flow/spec.d.ts:10-11` | Supporting types | Comparison a filter rule applies to a field. |
 | `FilterMatch` | type | `dist/nodes/transform/flow/spec.d.ts:8-9` | Supporting types | How a filter combines its rules: every rule must match, or any one. |
 | `FilterRule` | interface | `dist/nodes/transform/flow/spec.d.ts:12-24` | Supporting types | 3 field(s) |
-| `flow` | function | `dist/flow-sdk.d.ts:1473-1488` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1475-1490` | Flow construction | Start building a flow with the given id. |
 | `FlowAction` | class | `dist/core/node-classes.d.ts:162-168` | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
 | `FlowActionSpec` | type | `dist/flow-sdk.d.ts:48-49` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:1995-2104` | Supporting types | Every action kind, keyed by kind, to the body of its spec — the arm's fields other than `kind`. |
-| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1203-1472` | Builders | 13 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1203-1474` | Builders | 13 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:671-684` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:126-161` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:176-183` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
@@ -229,7 +229,7 @@ could hand you spans for a version you do not have.
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:624-629` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:636-670` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:630-635` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1489-1528` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1491-1530` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:40-47` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/core/actions.d.ts:2202-2242` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/core/actions.d.ts:674-706` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -104,7 +104,7 @@ not find it either.
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:458-462` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3483-3488` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1269-1274` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1465-1471` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1467-1473` |
 | `businessRule` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2527-2573` |
 | `by` | property | `LookupResolution` | `dist/core/lookups.d.ts:164` |
 | `by` | property | `LookupSpec` | `dist/core/lookups.d.ts:27-28` |
@@ -289,7 +289,7 @@ not find it either.
 | `entity` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1090-1091` |
 | `entry` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:528` |
 | `entry` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:520` |
-| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1291-1341` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1293-1343` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
 | `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:724-725` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
@@ -459,7 +459,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:2063-2066` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1416-1428` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1418-1430` |
 | `input` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1355-1356` |
 | `input` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1241-1242` |
 | `input` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3068-3076` |
@@ -725,7 +725,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1871-1876` |
 | `outcomes` | property | `HitlInputs` | `dist/core/actions.d.ts:445-459` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1429-1454` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1431-1456` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:90` |
 | `output` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3077-3085` |
 | `outputColumns` | property | `BatchTransformInputs` | `dist/core/actions.d.ts:722-726` |
@@ -901,7 +901,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:704-710` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1376-1415` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1378-1417` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:1177` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -1044,11 +1044,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:715-717` |
 | `trigger` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1224-1232` |
 | `trigger` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:128-129` |
-| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1272-1290` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1272-1292` |
 | `trigger` | property | `StartOpts` | `dist/bpmn/bpmn-sdk.d.ts:624-671` |
 | `triggeredByEvent` | property | `SubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:976-977` |
 | `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:726-732` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1342-1361` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1344-1363` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:718-719` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1104,7 +1104,7 @@ not find it either.
 | `value` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:205-206` |
 | `values` | property | `DataFabricCreateInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:132-137` |
 | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1199-1223` |
-| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1455-1464` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1457-1466` |
 | `var` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3059-3067` |
 | `var` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:494-495` |
 | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:251-252` |
@@ -1127,7 +1127,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1708-1709` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2933` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1362-1375` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1364-1377` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:368-375` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2890-2891` |

package/dist/check.js

@@ -1512,10 +1512,14 @@ function checkSubflow(step, child, inputs, parent, ancestors, diags) {
         return;
     }
     // A subflow always starts manually — its caller is what starts it. Nothing
-    // schedules a subflow, so a schedule here is silently ignored.
-    if (child.trigger !== undefined) {
+    // schedules a subflow, so a schedule here is silently ignored. `manual()` is
+    // what the child gets anyway, so `.trigger(manual(), { label, version })` is
+    // allowed: it is how the child's start node is labelled (#1050), and the
+    // form decompile writes for a renamed one.
+    if (child.trigger !== undefined && child.trigger.kind !== 'manual') {
         at('SUBFLOW_CHILD_TRIGGER', `Subflow "${step}" runs a flow with its own \`.trigger(…)\`. A subflow is started by its caller, never by a `
-            + `trigger of its own — the schedule would be dropped. Remove the .trigger() from "${child.id}".`);
+            + `trigger of its own — the schedule would be dropped. Remove the .trigger() from "${child.id}" `
+            + `(\`.trigger(manual(), { label })\` is allowed, to name the child's start node).`);
     }
     // `{ shared }` merges one input across a flow's ROOTS (#924). A subflow has
     // one root, its caller, so there is nothing to merge; serialize refuses it.

package/dist/core/subflow-start.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A subflow child's start-node label when the author sets none: `Start`, what
+ * Studio Web writes (the vendored golden `shared/sample-flows/new.flow`,
+ * `subflow1Start`). It is not the manual trigger definition's `Manual trigger`.
+ */
+export declare const SUBFLOW_START_LABEL = "Start";

package/dist/core/subflow-start.js

@@ -0,0 +1,6 @@
+/**
+ * A subflow child's start-node label when the author sets none: `Start`, what
+ * Studio Web writes (the vendored golden `shared/sample-flows/new.flow`,
+ * `subflow1Start`). It is not the manual trigger definition's `Manual trigger`.
+ */
+export const SUBFLOW_START_LABEL = 'Start';

package/dist/decompile.js

@@ -33,6 +33,7 @@ import { preserveSchemaVersion } from './schema-version.js';
 import { BUNDLED_DEFINITIONS, bundledVersions } from './flow-definitions.js';
 import { DEFAULT_TRIGGER_ID, Expr } from './core/expr.js';
 import { FLOW_NODE_TYPES } from './flow-node-registry.js';
+import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { commentText } from './core/comment-text.js';
 import { tsLiteral, tsNumber, tsText } from './core/ts-literal.js';
 import { contextIndexSlug, parseContextIndexType } from './core/context-index.js';
@@ -163,18 +164,22 @@ function verArg(node) {
 }
 /**
  * A trigger node's option clauses: its exact `version`, and its canvas `label`
- * when that differs from the definition's label (`definitionLabel`).
+ * when that differs from `defaultLabel` (the label serialize writes when the
+ * author sets none).
  */
-function triggerOptParts(node) {
+function triggerOptParts(node, defaultLabel = definitionLabel(node)) {
     const parts = [];
     const ver = verClause(node);
     if (ver)
         parts.push(ver);
-    const label = node.display?.label;
-    if (typeof label === 'string' && label !== definitionLabel(node))
-        parts.push(`label: ${tsLiteral(label)}`);
+    if (hasRenamedLabel(node, defaultLabel))
+        parts.push(`label: ${tsLiteral(node.display.label)}`);
     return parts;
 }
+function hasRenamedLabel(node, defaultLabel) {
+    const label = node.display?.label;
+    return typeof label === 'string' && label !== defaultLabel;
+}
 /** `triggerOptParts` as the `.trigger(spec, { ... })` options argument. */
 function triggerOptsArg(node) {
     const parts = triggerOptParts(node);
@@ -3073,7 +3078,8 @@ function emitSubflow(node, ctx) {
 /**
  * Render a child (sub)flow body as a nested `flow(name)…` builder expression
  * (parenthesized, no `.build()`). Reuses the same region machinery on the child's
- * own scope; the child's trigger is its `<caller>Start` node.
+ * own scope; the child's trigger is its `<caller>Start` node, written as
+ * `.trigger(manual(), { label })` only when its label is not `SUBFLOW_START_LABEL`.
  */
 function emitChildFlow(name, child, ctx) {
     const globals = readFlowGlobals(child.variables, runStrict);
@@ -3098,6 +3104,9 @@ function emitChildFlow(name, child, ctx) {
     }
     // Body: the child's trigger is its own manual Start; walk from its successor.
     const trigger = (child.nodes ?? []).find((n) => isTrigger(n.type) && !(child.edges ?? []).some((e) => e.targetNodeId === n.id));
+    if (trigger?.type === T.triggerManual && hasRenamedLabel(trigger, SUBFLOW_START_LABEL)) {
+        parts.push(`.trigger(${ctx.imp.use('manual')}(), { ${triggerOptParts(trigger, SUBFLOW_START_LABEL).join(', ')} })`);
+    }
     const scope = scopeIds(child.nodes ?? [], undefined);
     const entries = trigger ? scopeSuccEdges(childCtx.graph, trigger.id, scope) : [];
     const ipdom = entries.length

package/dist/flow-sdk.d.ts

@@ -1284,6 +1284,8 @@ declare class FlowBuilder extends StepList {
      * @param options - Node options; `version` selects the exact definition
      * version and `label` sets what the canvas shows on the trigger node
      * (default: the trigger definition's label, e.g. `Scheduled trigger`). See {@link NodeOptions}.
+     * On a flow run as a `subflow(...)`, only `manual()` is allowed — its caller
+     * starts it — and `label` names the child's start node (default: `Start`).
      * @returns This builder, so calls chain.
      * @defaultValue the manual trigger
      */

package/dist/flow-sdk.js

@@ -976,6 +976,8 @@ class FlowBuilder extends StepList {
      * @param options - Node options; `version` selects the exact definition
      * version and `label` sets what the canvas shows on the trigger node
      * (default: the trigger definition's label, e.g. `Scheduled trigger`). See {@link NodeOptions}.
+     * On a flow run as a `subflow(...)`, only `manual()` is allowed — its caller
+     * starts it — and `label` names the child's start node (default: `Start`).
      * @returns This builder, so calls chain.
      * @defaultValue the manual trigger
      */

package/dist/serialize.js

@@ -60,6 +60,7 @@ import { QUEUE_ITEM_RECORD_SCHEMA } from './core/queue-record.js';
 import { AGENTIC_PROCESS_FORMS } from './core/agentic-process-forms.js';
 import { resourceNodeSortOrder } from './core/process-resource-sort-order.js';
 import { types } from './core/expr.js';
+import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { ownEntry } from './core/own-entry.js';
 import { jsonClone } from './core/json-file.js';
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -4871,7 +4872,9 @@ export function serialize(built, opts = {}) {
      *
      * The child gets its own manual Start node (a subflow always starts manually
      * — nothing schedules a subflow; its caller is the trigger) and its own
-     * variables. Every `in` variable carries `triggerNodeId` pointing at that
+     * variables. A child's `.trigger(manual(), { label, version })` sets that
+     * node's canvas label and exact version; `check` refuses any other kind.
+     * Every `in` variable carries `triggerNodeId` pointing at that
      * Start: it is what binds the caller's value, and omitting it is the single
      * defect that makes a subflow validate clean and then fault at run time with
      * a null. It is emitted here, always, so it cannot be forgotten.
@@ -4900,7 +4903,10 @@ export function serialize(built, opts = {}) {
         // Without this a child that reads its own input points at a node that does
         // not exist in its scope.
         scope.rename.nodeIds.set('start', [startId]);
-        const start = makeNode(NODE_TYPE.trigger, startId, 'Start', { requestedVersion: child.triggerOptions?.version });
+        // The child's `.trigger(manual(), { label })`, else `SUBFLOW_START_LABEL`.
+        const start = makeNode(NODE_TYPE.trigger, startId, child.triggerOptions?.label ?? SUBFLOW_START_LABEL, {
+            requestedVersion: child.triggerOptions?.version,
+        });
         start.inputs = {};
         scope.nodes.push(start);
         const tails = emit(child.steps, [{ node: startId, port: 'output' }], scope);

package/package.json

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