@uipath/maestro-builder-sdk 6.32.1 → 6.32.2

package/dist/api-index.md

@@ -57,7 +57,7 @@ could hand you spans for a version you do not have.
 | `apiWorkflow` | function | `dist/core/actions.d.ts:1715-1749` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/core/actions.d.ts:468-499` | Option shapes | 5 field(s) |
 | `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:140-185` | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
-| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1258-1281` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1267-1290` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:126-141` | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
 | `batchTransform` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:49-83` | Actions | Add AI-generated columns to a CSV — the platform's **Batch transform** node, `uipath.pattern.batch-transform` (service… |
 | `BatchTransformInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:48-63` | Option shapes | 4 field(s) |
@@ -130,11 +130,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:1646-1661` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1655-1670` | 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:53-54` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:1500-1577` | 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:1282-1645` | Builders | 15 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1291-1654` | Builders | 15 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:717-730` | 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. |
@@ -228,11 +228,11 @@ could hand you spans for a version you do not have.
 | `SendMessageInputs` | interface | `dist/nodes/conversation/flow/spec.d.ts:8-27` | Option shapes | 4 field(s) |
 | `ShownField` | interface | `dist/core/actions.d.ts:105-125` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
 | `Step` | type | `dist/flow-sdk.d.ts:520-639` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:792-1257` | Builders | Collects a sequence of steps. |
+| `StepList` | class | `dist/flow-sdk.d.ts:792-1266` | Builders | Collects a sequence of steps. |
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:670-675` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:682-716` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:676-681` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1662-1701` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1671-1710` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:45-52` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:8-48` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:8-40` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -66,7 +66,7 @@ not find it either.
 | `app` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1337-1338` |
 | `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-175` |
 | `appVersion` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1339-1340` |
-| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1270` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1279` |
 | `assignee` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:52-63` |
 | `async` | property | `OrchestratorAsyncOpts` | `dist/bpmn/bpmn-sdk.d.ts:1281-1285` |
 | `atRiskPercentage` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:132-137` |
@@ -104,7 +104,7 @@ not find it either.
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:504-508` |
 | `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:1638-1644` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1647-1653` |
 | `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` |
@@ -208,7 +208,7 @@ not find it either.
 | `deferDate` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:48-49` |
 | `definition` | property | `NodeContribution` | `dist/core/node-classes.d.ts:111-112` |
 | `definitions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:770-775` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1499-1539` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1508-1548` |
 | `delay` | property | `FlowActionSpecs` | `dist/nodes/delay/flow/spec.d.ts:38-41` |
 | `dependsOn` | property | `LookupSpec` | `dist/core/lookups.d.ts:34-35` |
 | `description` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1244` |
@@ -225,7 +225,7 @@ not find it either.
 | `description` | property | `CustomGuardrail` | `dist/core/actions.d.ts:812` |
 | `description` | property | `EscalationRef` | `dist/core/actions.d.ts:1406-1407` |
 | `description` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:241` |
-| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1308-1315` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1317-1324` |
 | `description` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1211` |
 | `description` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:394-401` |
 | `description` | property | `IxpToolRef` | `dist/core/actions.d.ts:1384-1385` |
@@ -291,7 +291,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:1374-1424` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1383-1433` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
 | `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:776-777` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
@@ -462,7 +462,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1548-1551` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1579-1591` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1588-1600` |
 | `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` |
@@ -535,7 +535,7 @@ not find it either.
 | `kind` | property | `SubflowSpec` | `dist/flow-sdk.d.ts:47` |
 | `kind` | property | `WhenExpression` | `dist/case/case-sdk.d.ts:99-100` |
 | `kValue` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1251-1252` |
-| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1271-1280` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1280-1289` |
 | `label` | property | `AskedField` | `dist/core/actions.d.ts:130-131` |
 | `label` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:523` |
 | `label` | property | `FormFieldOption` | `dist/core/actions.d.ts:102-103` |
@@ -550,7 +550,7 @@ not find it either.
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:646-647` |
 | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:766-767` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1316-1326` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1325-1335` |
 | `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:252-284` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:515-516` |
@@ -650,7 +650,7 @@ not find it either.
 | `name` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1840-1841` |
 | `name` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:240` |
 | `name` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1499-1500` |
-| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1300-1307` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1309-1316` |
 | `name` | property | `FlowOpts` | `dist/bpmn/bpmn-sdk.d.ts:1637-1638` |
 | `name` | property | `GatewayOpts` | `dist/bpmn/bpmn-sdk.d.ts:760-761` |
 | `name` | property | `HandlerOpts` | `dist/bpmn/bpmn-sdk.d.ts:1735-1736` |
@@ -718,7 +718,7 @@ not find it either.
 | `onTimer` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3284-3292` |
 | `onTimer` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3293-3301` |
 | `openTails` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:785-790` |
-| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1540-1578` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1549-1587` |
 | `operation` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:37` |
 | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1287-1288` |
 | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:368-369` |
@@ -735,7 +735,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1452-1457` |
 | `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:211-225` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1592-1627` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1601-1636` |
 | `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/nodes/ai-patterns/flow/spec.d.ts:56-60` |
@@ -870,7 +870,7 @@ not find it either.
 | `retry` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:830-831` |
 | `retryable` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:308-309` |
 | `retryCount` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:109-123` |
-| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1247-1256` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1256-1265` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
 | `returns` | property | `AgentInputs` | `dist/core/actions.d.ts:698-717` |
 | `returns` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:486-498` |
@@ -911,7 +911,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:750-756` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1459-1498` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1468-1507` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:758` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -989,10 +989,10 @@ not find it either.
 | `steps` | property | `StepList` | `dist/flow-sdk.d.ts:794` |
 | `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:837-879` |
 | `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:954-982` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1182-1225` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1226-1246` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1190-1234` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1235-1255` |
 | `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:768-769` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1327-1352` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1336-1361` |
 | `storageBucket` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:82-83` |
 | `strategy` | property | `LookupSpec` | `dist/core/lookups.d.ts:33` |
 | `style` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:597-598` |
@@ -1030,7 +1030,7 @@ not find it either.
 | `temperature` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:981-982` |
 | `temperature` | property | `VoiceSettings` | `dist/core/actions.d.ts:270-271` |
 | `terminate` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:692-693` |
-| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1151-1181` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1151-1189` |
 | `threshold` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1495-1496` |
 | `timeCycle` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:201-202` |
 | `timeout` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:91-108` |
@@ -1054,11 +1054,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:761-763` |
 | `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:1353-1373` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1362-1382` |
 | `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:778-784` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1425-1444` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1434-1453` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:764-765` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1115,7 +1115,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:1628-1637` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1637-1646` |
 | `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` |
@@ -1138,7 +1138,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1289-1290` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2173` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1445-1458` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1454-1467` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:397-404` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2130-2131` |

package/dist/check.js

@@ -26,6 +26,7 @@ import { compareSchemaVersions, schemaVersionRefusal } from './schema-version.js
 import { planFlowGlobals, planSharedInputs, sharedInputRoots } from './flow-variables.js';
 import { planOutputBacking } from './flow-output-backing.js';
 import { ownEntry } from './core/own-entry.js';
+import { terminateStepClashMessage, terminateTwiceMessage } from './flow-terminate-names.js';
 import { endContentKey } from './flow-end-content.js';
 import { FLOW_NODE_TYPES } from './flow-node-registry.js';
 import { stepExits } from './flow-step-exits.js';
@@ -271,8 +272,24 @@ function checkFlow(built, ancestors, opts = {}) {
             // referenceable — registering it would report DUP_STEP the second time one
             // appears. The port-edge kinds carry no name at all.
             if ('name' in s && s.kind !== 'return') {
-                if (stepNames.has(s.name))
-                    diags.push({ level: 'error', code: 'DUP_STEP', message: `Duplicate step name "${s.name}".`, step: s.name });
+                if (stepNames.has(s.name)) {
+                    // Two `.terminate('<name>')` calls are two Terminate nodes: the second
+                    // would be renamed `<name>2`, so paths that all stop at ONE Terminate
+                    // come back with an extra node (#1239). Same code as any step clash (a
+                    // Terminate's name is a step name), with the remedy spelled out.
+                    // A step and a Terminate sharing a name (either order) get the same
+                    // words serialize throws for them: rename one.
+                    const twoTerminates = s.kind === 'terminate' && terminateNames.has(s.name);
+                    const oneTerminate = (s.kind === 'terminate') !== terminateNames.has(s.name);
+                    diags.push({
+                        level: 'error', code: 'DUP_STEP', step: s.name,
+                        message: twoTerminates
+                            ? terminateTwiceMessage(s.name)
+                            : oneTerminate
+                                ? terminateStepClashMessage(s.name)
+                                : `Duplicate step name "${s.name}".`,
+                    });
+                }
                 stepNames.add(s.name);
                 declared.add(s.name); // a step's output is referenceable by name
             }
@@ -4576,6 +4593,12 @@ function checkStepRefs(built, diags) {
      */
     const endContents = new Map();
     const stepNamesSeen = new Set();
+    /**
+     * Every `.terminate('<name>')`. A Terminate is a step-named node (two with one
+     * name are DUP_STEP), and, like an End, it runs nothing after itself, so it is
+     * a ref target from any path, another port's path included (#1239).
+     */
+    const terminateNames = new Set();
     let seq = 0;
     const index = (steps, portList, scope, arm) => {
         for (const s of steps) {
@@ -4593,6 +4616,8 @@ function checkStepRefs(built, diags) {
                 }
                 else
                     stepNamesSeen.add(name);
+                if (s.kind === 'terminate')
+                    terminateNames.add(name);
                 // Exactly the step rule from before, for steps. A named End only fills a
                 // name nothing has claimed; a clash is REF_AMBIGUOUS_TARGET below.
                 if (s.kind !== 'return' || !order.has(name)) {
@@ -4697,8 +4722,8 @@ function checkStepRefs(built, diags) {
         if (!order.has(target)) {
             const near = [...order.keys()].find((n) => n.toLowerCase() === target.toLowerCase());
             say('error', 'REF_UNKNOWN_TARGET', `.stepToRef('${target}') ${where} names a step this flow does not have`
-                + `${near ? ` (did you mean "${near}"?)` : ''}. It takes the same name you passed to .step(), or the `
-                + `\`name\` of a \`.return({}, { name })\` End.`, near ? `.stepToRef('${near}')` : undefined);
+                + `${near ? ` (did you mean "${near}"?)` : ''}. It takes the same name you passed to .step() or `
+                + `.terminate(), or the \`name\` of a \`.return({}, { name })\` End.`, near ? `.stepToRef('${near}')` : undefined);
             continue;
         }
         const ends = endNames.get(target) ?? 0;
@@ -4717,8 +4742,11 @@ function checkStepRefs(built, diags) {
          * So a ref into an End that sits inside another port's path (two HTTP
          * branches, two outcomes, a prefix and a branch, all ending at one End) is
          * the product's own shape, one End with several incoming edges (#1231).
+         * A Terminate is the same: it stops the run whichever path arrives, so two
+         * side paths stopping at one Terminate is one node with two incoming edges
+         * (#1239). A step sharing a Terminate's name is DUP_STEP, reported apart.
          */
-        const endOnly = ends > 0;
+        const terminal = ends > 0 || terminateNames.has(target);
         // A ref to a container the path is INSIDE names it as a step, so the edge
         // enters it from its outer input: it starts the loop over from its first
         // item, while the iteration the path was in never finishes. What the author
@@ -4729,10 +4757,11 @@ function checkStepRefs(built, diags) {
                 + `next iteration, or .break() to leave the loop.`, '.continue()');
             continue;
         }
-        if (inPortList.has(target) && !endOnly) {
+        if (inPortList.has(target) && !terminal) {
             say('error', 'REF_INTO_PORT_LIST', `.stepToRef('${target}') ${where} targets a step inside another port's path. That path runs only when ITS `
                 + `port fired — it is not somewhere another edge can jump into. Point at a step on the main path, or end `
-                + `this one with .return() / .terminate(). (A named End is the exception: any path may end there.)`);
+                + `this one with .return() / .terminate(). (A named End or a Terminate is the exception: any path may end `
+                + `there.)`);
             continue;
         }
         const targetScope = scopeOf.get(target) ?? '';
@@ -4760,7 +4789,10 @@ function checkStepRefs(built, diags) {
         // Best effort from here: the mechanism is understood, the runtime's behaviour
         // is not measured, so these WARN and leave the verdict to `validate`.
         const targetArm = armOf.get(target);
-        if (targetArm !== arm) {
+        // A Terminate stops the whole run, every branch with it, so no Merge is left
+        // waiting: a ref into or out of an arm that ends at one cannot hang a join
+        // (#1239). An End stops only its own path, so it keeps the warnings.
+        if (targetArm !== arm && !terminateNames.has(target)) {
             if (targetArm !== undefined) {
                 say('warning', 'REF_INTO_PARALLEL_ARM', `.stepToRef('${target}') ${where} points INTO a parallel arm from outside it. The Merge those arms join `
                     + `on is a bpmn:ParallelGateway, which waits for every branch it forked — an extra token arriving inside `

package/dist/decompile.js

@@ -2405,9 +2405,12 @@ function region(cursor, stop, scope, ipdom, ctx, refInto) {
         // (`<id>2`); a ref names the one End. `decompile()` seeded `ctx.refTargets`
         // with every End more than one edge enters, so the `.return(...)` emitted
         // first already carries the End's `name` (only a named End is a ref target).
-        // Terminates are still excluded: each path emitting its own is a valid flow.
-        if (ctx.emitted.has(cursor) && node.type !== T.terminate
-            && (node.type !== T.end || ctx.refTargets?.has(cursor))) {
+        //
+        // And a Terminate another path already stopped at (#1239). A Terminate is
+        // always named (its id is its `.terminate('<name>')`), so it needs no
+        // seeding: a second `.terminate(...)` there compiled to a second Terminate
+        // (`<id>2`), or failed check as DUP_STEP; a ref names the one Terminate.
+        if (ctx.emitted.has(cursor) && (node.type !== T.end || ctx.refTargets?.has(cursor))) {
             segs.push(`.stepToRef(${tsLiteral(cursor)})`);
             return segs;
         }

package/dist/flow-sdk.d.ts

@@ -1163,6 +1163,14 @@ declare class StepList {
      * What aborts, what the run reports, and what each local rung can prove:
      * `references/terminate.md`.
      *
+     * The name is a step name, so a Terminate is also a {@link StepList.stepToRef}
+     * target: another path can stop at this Terminate rather than at one of its
+     * own, from anywhere in the flow, including another port's path. To stop
+     * several paths at one Terminate, spell its `.terminate` once and end the
+     * other paths with `.stepToRef('<name>')`. Two `.terminate`s asking for the
+     * same name are refused (`check`: DUP_STEP; `compile --no-check` throws)
+     * rather than renamed `<name>2`.
+     *
      * @example
      * **Abort the sibling arm from inside a parallel**
      * ```ts
@@ -1208,7 +1216,8 @@ declare class StepList {
      * incoming edges, as the canvas draws it. Unlike a step, an End inside another
      * port's path is a valid target: two HTTP branches or two outcomes can end at
      * one End. To end several paths at one End, spell its `.return` once and end
-     * the other paths with `.stepToRef('<name>')`.
+     * the other paths with `.stepToRef('<name>')`. A `.terminate('<name>')` is a
+     * target in the same way: any path may stop at it.
      *
      * ```ts
      * .step('fetch', http({ …, branches: [{ name: 'missing', condition: … }] }))
@@ -1217,8 +1226,8 @@ declare class StepList {
      * .return({}, { name: 'done' })        // both paths end at this one End
      * ```
      *
-     * @param target - The step to continue at, named as it was in `.step(...)`, or
-     * the `name` of a `.return(...)` End.
+     * @param target - The step to continue at, named as it was in `.step(...)` or
+     * `.terminate(...)`, or the `name` of a `.return(...)` End.
      * @returns This builder. Nothing may follow: the path has been handed off.
      * @see stepToList
      */
@@ -1238,8 +1247,8 @@ declare class StepList {
      * ```
      *
      * @param port - The port of this step to leave, e.g. `'error'`.
-     * @param target - The step to continue at, named as it was in `.step(...)`, or
-     * the `name` of a `.return(...)` End.
+     * @param target - The step to continue at, named as it was in `.step(...)` or
+     * `.terminate(...)`, or the `name` of a `.return(...)` End.
      * @returns This builder, so calls chain — a side exit ends nothing.
      * @see stepToList
      */

package/dist/flow-sdk.js

@@ -816,6 +816,14 @@ class StepList {
      * What aborts, what the run reports, and what each local rung can prove:
      * `references/terminate.md`.
      *
+     * The name is a step name, so a Terminate is also a {@link StepList.stepToRef}
+     * target: another path can stop at this Terminate rather than at one of its
+     * own, from anywhere in the flow, including another port's path. To stop
+     * several paths at one Terminate, spell its `.terminate` once and end the
+     * other paths with `.stepToRef('<name>')`. Two `.terminate`s asking for the
+     * same name are refused (`check`: DUP_STEP; `compile --no-check` throws)
+     * rather than renamed `<name>2`.
+     *
      * @example
      * **Abort the sibling arm from inside a parallel**
      * ```ts

package/dist/flow-terminate-names.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The words for a `.terminate('<name>')` whose name is already taken (#1239).
+ * `check` (DUP_STEP) and `serialize` (the `--no-check` backstop) both use them,
+ * so one clash gets one explanation whichever reports it.
+ */
+/** Two `.terminate('<name>')` calls: keep one and end the other paths at it. */
+export declare function terminateTwiceMessage(name: string): string;
+/** A step and a `.terminate('<name>')` share a name: they are different nodes, so rename one. */
+export declare function terminateStepClashMessage(name: string): string;

package/dist/flow-terminate-names.js

@@ -0,0 +1,17 @@
+/**
+ * The words for a `.terminate('<name>')` whose name is already taken (#1239).
+ * `check` (DUP_STEP) and `serialize` (the `--no-check` backstop) both use them,
+ * so one clash gets one explanation whichever reports it.
+ */
+/** Two `.terminate('<name>')` calls: keep one and end the other paths at it. */
+export function terminateTwiceMessage(name) {
+    return `Duplicate step name "${name}": two \`.terminate('${name}')\` calls ask for the same Terminate. Each `
+        + `\`.terminate\` makes a Terminate node of its own. To stop several paths at one Terminate, keep one `
+        + `\`.terminate('${name}')\` and end the other paths with \`.stepToRef('${name}')\`; to have separate `
+        + `Terminates, give each its own name.`;
+}
+/** A step and a `.terminate('<name>')` share a name: they are different nodes, so rename one. */
+export function terminateStepClashMessage(name) {
+    return `Duplicate step name "${name}": a step and a \`.terminate('${name}')\` both use it, and a node id names `
+        + `one node. Rename one of them.`;
+}

package/dist/serialize.js

@@ -66,6 +66,7 @@ import { types } from './core/expr.js';
 import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { ownEntry } from './core/own-entry.js';
 import { endContentKey } from './flow-end-content.js';
+import { terminateStepClashMessage, terminateTwiceMessage } from './flow-terminate-names.js';
 import { jsonClone } from './core/json-clone.js';
 // core-definitions.json is an object keyed by "<nodeType>@<version>".
 const DEFS = BUNDLED_DEFINITIONS;
@@ -4368,6 +4369,8 @@ export function serialize(built, opts = {}) {
     const takenIds = new Set([built.triggerId ?? 'start']);
     /** Per scope, each named `.return` End emitted so far and its content. */
     const namedEnds = new Map();
+    /** Per scope, the names a `.terminate` claimed: which remedy a later clash gets (#1239). */
+    const terminateNames = new Map();
     let edgeSeq = 0;
     /** Claim a globally unique node id, honouring the scope's rename map. */
     function uid(scope, base) {
@@ -6425,6 +6428,20 @@ export function serialize(built, opts = {}) {
                 // version and its handleConfiguration has exactly one TARGET handle. Its
                 // terminal flow-output mappings are separate metadata required by the
                 // product validator; they do not create a readable node output.
+                //
+                // A Terminate is a `.stepToRef` target (its name is a step name), so a
+                // second `.terminate` asking for a name this scope already holds is
+                // refused, not renamed `<name>2`: that rename turned one Terminate two
+                // paths share into two Terminates with no word said (#1239). `check`
+                // reports it first as DUP_STEP; this is the backstop for `--no-check`.
+                // The remedy depends on what holds the name: another Terminate (end the
+                // other paths at it) or a step of another kind (rename one).
+                if (scope.stepNodeId.has(step.name)) {
+                    throw new Error(terminateNames.get(scope)?.has(step.name)
+                        ? terminateTwiceMessage(step.name)
+                        : terminateStepClashMessage(step.name));
+                }
+                (terminateNames.get(scope) ?? terminateNames.set(scope, new Set()).get(scope)).add(step.name);
                 const id = stepUid(scope, step.name);
                 const node = makeNode(NODE_TYPE.terminate, id, step.options?.label ?? step.label ?? step.name, { parentId, requestedVersion: step.options?.version });
                 node.inputs = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.32.1",
+  "version": "6.32.2",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -93,5 +93,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "275e6e4608b243bee96fd531b3228f95261f3b32"
+  "gitref": "c5c161d5160cc033040ad150154c4fb55e9bada8"
 }