@uipath/maestro-builder-sdk 6.20.3 → 6.20.5

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

@@ -9,7 +9,7 @@ import { Expr, SCHEDULE_PRESETS, parseIxpProjectType, flatNameOf, flatNameSegmen
 import { FlowNode } from './core/node-classes.js';
 import { planContributionBindings } from './core/contribution-bindings.js';
 import { definitionHasErrorPort, errorPortRefusal } from './core/error-port.js';
-import { bundledActionNodeType, bundledDefinition, perCallDefinition, resolveContributionDefinition } from './serialize.js';
+import { actionVersion, bundledActionNodeType, bundledDefinition, perCallDefinition, resolveContributionDefinition } from './serialize.js';
 import { sdkFormFieldType } from './core/form-field-type.js';
 import { QUEUE_ITEM_RECORD_SCHEMA } from './core/queue-record.js';
 import { AGENTIC_PROCESS_FORMS } from './core/agentic-process-forms.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.
@@ -5083,13 +5087,15 @@ placed) {
         return;
     }
     // A typed family with a bundled definition: ask the definition serialize will
-    // emit, at the version it will emit (#1011). For instance `voiceAgent()`
-    // defaults to uipath.agent.voice@1.0 (no error port) and `{ version: '1.1' }`
-    // selects @1.1 (which has one).
+    // emit, at the version it will emit (#1011), chosen by the same selector
+    // serialize uses (#1041). For instance `voiceAgent()` defaults to
+    // uipath.agent.voice@1.0 (no error port) and `{ version: '1.1' }` selects @1.1
+    // (which has one); `hitl({ exposeError: true })` selects uipath.human-in-the-loop@1.2
+    // with no `{ version }` at all.
     // A version the SDK does not bundle (an inline agent's registry version) has
     // no definition here to ask; version resolution reports that, not this check.
     const bundledType = bundledActionNodeType(spec);
-    const bundledDef = bundledType ? bundledDefinition(bundledType, step.options?.version) : undefined;
+    const bundledDef = bundledType ? bundledDefinition(bundledType, actionVersion(spec, step.options?.version)) : undefined;
     // A per-tenant family: ask the definition serialize synthesizes for it (#1040).
     let perCallDef;
     if (!bundledType) {

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.d.ts

@@ -122,6 +122,26 @@ export declare function perCallDefinition(spec: {
     kind?: string;
     inputs?: any;
 } | undefined): any | undefined;
+/**
+ * The definition version serialize emits for a typed action step that is not
+ * yet on the node-type registry: the author's `{ version }` when given,
+ * otherwise the version the step's inputs select, otherwise `undefined` (the
+ * pinned default). Two such families pick a version themselves:
+ *
+ *  - `hitl`: `exposeError` selects `@1.2`, per-outcome routing selects `@1.1`;
+ *  - `inlineAgent`: the newest bundled version, not the first bundled entry.
+ *
+ * The emit paths read their version here, and `check` resolves the definition
+ * it asks about with this same version (#1041), so the two cannot pick
+ * different definitions. For instance `inlineAgent({ ... })` gives the newest
+ * bundled version in both. A registered family (e.g. `dataFabricRead`, whose
+ * `resultMode` selects `core.datafabric.read@1.4`) gets the same guarantee from
+ * the registry's `resolveVersion`, which check and serialize both call.
+ */
+export declare function actionVersion(spec: {
+    kind?: string;
+    inputs?: any;
+} | undefined, explicit: string | undefined): string | undefined;
 /**
  * The bundled definition of `nodeType` that `makeNode` resolves: the author's
  * exact `{ version }` when given, otherwise the pinned default (the first

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));
@@ -3835,6 +3836,45 @@ export function perCallDefinition(spec) {
         default: return undefined;
     }
 }
+/**
+ * The definition version serialize emits for a typed action step that is not
+ * yet on the node-type registry: the author's `{ version }` when given,
+ * otherwise the version the step's inputs select, otherwise `undefined` (the
+ * pinned default). Two such families pick a version themselves:
+ *
+ *  - `hitl`: `exposeError` selects `@1.2`, per-outcome routing selects `@1.1`;
+ *  - `inlineAgent`: the newest bundled version, not the first bundled entry.
+ *
+ * The emit paths read their version here, and `check` resolves the definition
+ * it asks about with this same version (#1041), so the two cannot pick
+ * different definitions. For instance `inlineAgent({ ... })` gives the newest
+ * bundled version in both. A registered family (e.g. `dataFabricRead`, whose
+ * `resultMode` selects `core.datafabric.read@1.4`) gets the same guarantee from
+ * the registry's `resolveVersion`, which check and serialize both call.
+ */
+export function actionVersion(spec, explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    // Keyed by the node type `bundledActionNodeType` already picks, so the
+    // version rule adds no second dispatch on the step's kind.
+    const type = bundledActionNodeType(spec);
+    if (type === NODE_TYPE.hitl)
+        return hitlNeededVersion(spec?.inputs);
+    if (type === INLINE_AGENT_TYPE)
+        return INLINE_AGENT_DEFAULT_VERSION;
+    return undefined;
+}
+/**
+ * The base human task version a task's inputs need when nothing is pinned:
+ * `exposeError` needs 1.2 (it adds the `error` output), and a task that
+ * routes per outcome needs 1.1. Only the base task reaches here: a variant
+ * (quick-form, app task) has its own node type and one definition.
+ */
+function hitlNeededVersion(inputs) {
+    if (inputs?.exposeError)
+        return '1.2';
+    return hitlExitModel(inputs, undefined).shape === 'per-outcome' ? '1.1' : undefined;
+}
 /**
  * The bundled definition of `nodeType` that `makeNode` resolves: the author's
  * exact `{ version }` when given, otherwise the pinned default (the first
@@ -4871,7 +4911,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 +4942,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);
@@ -5350,7 +5395,7 @@ export function serialize(built, opts = {}) {
             // the node to another version as a side effect (#956). Both now live in
             // the sidecar and on edges; neither selects a definition. An explicit
             // `{ version }` (what decompile writes back) resolves exactly.
-            const version = step.options?.version ?? INLINE_AGENT_DEFAULT_VERSION;
+            const version = actionVersion(spec, step.options?.version);
             // `definitions[]` holds one entry per type@version, so a flow where any
             // agent attaches memory keeps the handle for all of them.
             const withMemory = s.memory !== undefined
@@ -6272,13 +6317,12 @@ export function serialize(built, opts = {}) {
                 throw new Error(`"${step.name}": outcomePorts: true, but the '${spec.inputs?.variant}' variant reads its outcomes `
                     + `from its app and leaves on its single 'completed' exit. Route on out('${step.name}', 'Action') downstream.`);
             }
-            const neededVersion = hitlType !== NODE_TYPE.hitl ? undefined
-                : spec.inputs?.exposeError ? '1.2' : exitModel.shape === 'per-outcome' ? '1.1' : undefined;
             if (spec.inputs?.exposeError === true && pinned !== undefined && pinned !== '1.2') {
                 throw new Error(`"${step.name}": exposeError needs the task's 1.2 definition, but { version: '${pinned}' } pins it. `
                     + `Drop the pin or match it.`);
             }
-            const node = makeNode(hitlType, id, step.name, { parentId, requestedVersion: pinned ?? neededVersion });
+            // The same version `check` resolves the definition at (#1041).
+            const node = makeNode(hitlType, id, step.name, { parentId, requestedVersion: actionVersion(spec, pinned) });
             const { inputs, outputs } = hitlInputs(spec.inputs, id, built.id, step.name, scope.rename);
             node.inputs = inputs;
             // The definition's `outputDefinition` gives the two output SLOTS; the form

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.20.3",
+  "version": "6.20.5",
   "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": "2ed3ce64cea5047f9da44c287cacc18f0f66f37d"
 }