@uipath/maestro-builder-sdk 6.46.4 → 6.46.6

package/dist/api-index.md

@@ -58,7 +58,7 @@ could hand you spans for a version you do not have.
 | `apiWorkflow` | function | `dist/nodes/process/flow/factories.d.ts:53-87` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/nodes/process/flow/spec.d.ts:70-101` | 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:1358-1381` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1364-1387` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:221-240` | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
 | `at` | function | `dist/flow-sdk.d.ts:693-721` | Flow construction | A node's layout at a canvas position — the short form of a NodeLayout for the `nodes` map of FlowBuilder.layout. |
 | `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… |
@@ -133,11 +133,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:1763-1778` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1769-1784` | 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:55-56` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:905-942` | 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:1382-1762` | Builders | 15 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1388-1768` | Builders | 15 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:807-820` | 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. |
@@ -237,11 +237,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:205-220` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
 | `Step` | type | `dist/flow-sdk.d.ts:557-677` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:882-1357` | Builders | Collects a sequence of steps. |
+| `StepList` | class | `dist/flow-sdk.d.ts:882-1363` | Builders | Collects a sequence of steps. |
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:760-765` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:772-806` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:766-771` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1779-1818` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1785-1824` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:47-54` | 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

@@ -67,7 +67,7 @@ not find it either.
 | `app` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1363-1364` |
 | `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-175` |
 | `appVersion` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1365-1366` |
-| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1370` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1376` |
 | `assignee` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:52-63` |
 | `async` | property | `OrchestratorAsyncOpts` | `dist/bpmn/bpmn-sdk.d.ts:1307-1311` |
 | `atRiskPercentage` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:132-137` |
@@ -100,12 +100,12 @@ not find it either.
 | `boundaryEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2278-2285` |
 | `branch` | method | `StepList` | `dist/flow-sdk.d.ts:1081-1099` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1217-1226` |
+| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1223-1232` |
 | `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:554-555` |
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:541-545` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3581-3586` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1370-1375` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1755-1761` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1761-1767` |
 | `businessRule` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:563-564` |
 | `businessRule` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2577-2641` |
 | `businessRule` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:854-882` |
@@ -177,7 +177,7 @@ not find it either.
 | `context` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:94` |
 | `contextRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1559-1566` |
 | `contextVerbatim` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1631-1636` |
-| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1227-1241` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1233-1247` |
 | `contribute` | method | `FlowNode` | `dist/core/node-classes.d.ts:144-153` |
 | `controlType` | property | `FormFieldSettings` | `dist/core/actions.d.ts:187-191` |
 | `conversationalAgent` | property | `FlowActionSpecs` | `dist/nodes/agent/flow/spec.d.ts:439-442` |
@@ -217,7 +217,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:860-865` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1615-1655` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1621-1661` |
 | `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:643` |
@@ -234,7 +234,7 @@ not find it either.
 | `description` | property | `CustomGuardrail` | `dist/core/actions.d.ts:436` |
 | `description` | property | `EscalationRef` | `dist/core/actions.d.ts:805-806` |
 | `description` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:243` |
-| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1408-1415` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1414-1421` |
 | `description` | property | `FormFieldSettings` | `dist/core/actions.d.ts:202-203` |
 | `description` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:610` |
 | `description` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:343-350` |
@@ -277,7 +277,7 @@ not find it either.
 | `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:285-289` |
 | `documentClassify` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:56-59` |
 | `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:84-85` |
-| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1192-1216` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1198-1222` |
 | `dueDate` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:50-51` |
 | `duration` | property | `TimerSpec` | `dist/bpmn/bpmn-sdk.d.ts:33-34` |
 | `dynamicExtract` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:60-63` |
@@ -302,7 +302,7 @@ not find it either.
 | `entity` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1116-1117` |
 | `entry` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:588` |
 | `entry` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:580` |
-| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1490-1540` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1496-1546` |
 | `entryPointId` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1637-1642` |
 | `entryPointId` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1522-1526` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:544-556` |
@@ -482,7 +482,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2305-2312` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/nodes/agent/flow/spec.d.ts:443-446` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1261-1286` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1696-1708` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1702-1714` |
 | `input` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1381-1382` |
 | `input` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1267-1268` |
 | `input` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3137-3145` |
@@ -558,7 +558,7 @@ not find it either.
 | `kind` | property | `SubflowSpec` | `dist/flow-sdk.d.ts:49` |
 | `kind` | property | `WhenExpression` | `dist/case/case-sdk.d.ts:99-100` |
 | `kValue` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:650-651` |
-| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1371-1380` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1377-1386` |
 | `label` | property | `AskedField` | `dist/core/actions.d.ts:225-226` |
 | `label` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:583` |
 | `label` | property | `ContextIndexRef` | `dist/core/actions.d.ts:899-903` |
@@ -574,7 +574,7 @@ not find it either.
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:706-707` |
 | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:856-857` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1240-1260` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1416-1442` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1422-1448` |
 | `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:552-553` |
@@ -585,7 +585,7 @@ not find it either.
 | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
 | `loop` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:345-346` |
 | `loop` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:858-859` |
-| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1180-1191` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1186-1197` |
 | `managed` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:37-67` |
 | `marksCaseComplete` | property | `BuiltCaseExitCondition` | `dist/case/case-sdk.d.ts:372` |
 | `marksStageComplete` | property | `BuiltExitCondition` | `dist/case/case-sdk.d.ts:339` |
@@ -677,7 +677,7 @@ not find it either.
 | `name` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1877-1878` |
 | `name` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:242` |
 | `name` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1530-1531` |
-| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1400-1407` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1406-1413` |
 | `name` | property | `FlowOpts` | `dist/bpmn/bpmn-sdk.d.ts:1674-1675` |
 | `name` | property | `GatewayOpts` | `dist/bpmn/bpmn-sdk.d.ts:786-787` |
 | `name` | property | `HandlerOpts` | `dist/bpmn/bpmn-sdk.d.ts:1772-1773` |
@@ -748,7 +748,7 @@ not find it either.
 | `onTimer` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3382-3390` |
 | `onTimer` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3391-3399` |
 | `openTails` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:875-880` |
-| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1656-1695` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1662-1701` |
 | `operation` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:37` |
 | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:686-687` |
 | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:386-387` |
@@ -764,7 +764,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:851-856` |
 | `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:211-225` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1287-1299` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1709-1744` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1715-1750` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:97` |
 | `output` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3146-3154` |
 | `outputColumns` | property | `BatchTransformInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:56-60` |
@@ -800,7 +800,7 @@ not find it either.
 | `pageRange` | property | `DynamicExtractInputs` | `dist/nodes/document/flow/spec.d.ts:49-50` |
 | `pageRange` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:332-333` |
 | `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:534-535` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1143-1179` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1143-1185` |
 | `parallelGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2295-2304` |
 | `parameters` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1505-1506` |
 | `parameters` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1166-1171` |
@@ -903,7 +903,7 @@ not find it either.
 | `retry` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:856-857` |
 | `retryable` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:318-319` |
 | `retryCount` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:109-123` |
-| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1347-1356` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1353-1362` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
 | `returns` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:302-321` |
 | `returns` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:88-100` |
@@ -945,7 +945,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3473-3502` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:840-846` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1169-1195` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1575-1614` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1581-1620` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:382` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -1026,10 +1026,10 @@ not find it either.
 | `steps` | property | `StepList` | `dist/flow-sdk.d.ts:884` |
 | `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:927-969` |
 | `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:1044-1072` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1281-1325` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1326-1346` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1287-1331` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1332-1352` |
 | `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:858-859` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1443-1468` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1449-1474` |
 | `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:657-658` |
@@ -1067,7 +1067,7 @@ not find it either.
 | `temperature` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:283-284` |
 | `temperature` | property | `VoiceSettings` | `dist/nodes/agent/flow/spec.d.ts:121-122` |
 | `terminate` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:718-719` |
-| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1242-1280` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1248-1286` |
 | `threshold` | property | `ContextIndexRef` | `dist/core/actions.d.ts:895-896` |
 | `timeCycle` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:201-202` |
 | `timeout` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:91-108` |
@@ -1091,11 +1091,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:851-853` |
 | `trigger` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1325-1333` |
 | `trigger` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:128-129` |
-| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1469-1489` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1475-1495` |
 | `trigger` | property | `StartOpts` | `dist/bpmn/bpmn-sdk.d.ts:641-688` |
 | `triggeredByEvent` | property | `SubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1002-1003` |
 | `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:868-874` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1541-1560` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1547-1566` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:854-855` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:704-705` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:680-681` |
@@ -1153,7 +1153,7 @@ not find it either.
 | `value` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:250-251` |
 | `values` | property | `DataFabricCreateInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:132-137` |
 | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1300-1324` |
-| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1745-1754` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1751-1760` |
 | `var` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3128-3136` |
 | `var` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:551-552` |
 | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:296-297` |
@@ -1177,7 +1177,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:688-689` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:1206` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1538-1539` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1561-1574` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1567-1580` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:399-406` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:1163-1164` |

package/dist/case/check.js

@@ -5,6 +5,7 @@ import { caseJsonPreservation, caseJsonPreservationErrors } from './preserve.js'
 import { EQUALS_EXPR_DIALECT, checkBindingLabels, checkConnectorContract, checkConnectorLookups, checkConnectorSchema, } from '../core/connector-checks.js';
 import { checkEventResolution } from '../core/event-checks.js';
 import { EXTERNAL_TASK_DESCRIPTOR_CONTRACT } from './external.js';
+import { isResourceLabelRefusal, resolveResourceRef } from './resource-identity.js';
 const TYPE_NAMES = new Set(Object.values(types));
 // audit-case-coverage: rule-slot table start
 // This runtime table must equal the committed matrix's rejected cells. The audit
@@ -257,7 +258,7 @@ export function check(built, opts = {}) {
     // positive that blocks emit (this gate runs before serialization), so it must be
     // re-derived from the serializer rather than from remembered probe results.
     for (const stage of built.stages) {
-        checkStage(stage, diags, refStage, refPlacement);
+        checkStage(stage, diags, refStage, refPlacement, opts.bindings);
         stage.slaRules.forEach((s, i) => checkSla(s, `stage "${stage.label}" SLA #${i + 1}`, diags));
     }
     built.slaRules.forEach((s, i) => checkSla(s, `case SLA #${i + 1}`, diags));
@@ -394,7 +395,7 @@ function isNilOrEmpty(value) {
         return Object.keys(value).length === 0;
     return false;
 }
-function checkStage(stage, diags, refStage, refPlacement) {
+function checkStage(stage, diags, refStage, refPlacement, bindings) {
     const where = `stage "${stage.label}"`;
     if (stage.exception && stage.required !== false)
         diags.push({
@@ -484,16 +485,15 @@ function checkStage(stage, diags, refStage, refPlacement) {
                 where: t.name,
             });
         // The builder binds a resource task itself: it mints the name/folderPath
-        // binding pair from the literal name and folder. A `=bindings.<id>` string
-        // passed as either becomes part of the binding key, which then names no
-        // resource (`=bindings.f.=bindings.n`) and dangles at deploy.
-        if (t.ref && [t.ref.name, t.ref.folderPath].some((v) => v.trim().startsWith('=bindings.')))
-            diags.push({
-                level: 'error',
-                code: 'RESOURCE_REF_IS_BINDING',
-                message: `Task "${t.name}" passes a "=bindings.<id>" reference as its resource name or folder. Pass the resource's own name and its folder, e.g. .agent('Contract Analysis', { folder: 'Shared/Legal' }); compile writes the name/folderPath binding pair keyed '<folder>.<name>' and points the task at it.`,
-                where: t.name,
-            });
+        // binding pair from the literal name and folder. A `=bindings.<label>` name
+        // or folder is read through bindings.json first, the way a connector's
+        // `connection:` label is; one bindings.json cannot answer is refused with the
+        // same text serialize throws (`resolveResourceRef`).
+        if (t.ref) {
+            const resolved = resolveResourceRef(t.ref, bindings, `Task "${t.name}"`);
+            if (isResourceLabelRefusal(resolved))
+                diags.push({ level: 'error', code: resolved.code, message: resolved.message, where: t.name });
+        }
         if (t.kind === 'business-rule') {
             if (!t.ref || !t.ref.name.trim() || !t.ref.folderPath.trim())
                 diags.push({

package/dist/case/resource-identity.d.ts

@@ -23,6 +23,7 @@
  * `case-validate-service.ts` exempts that prefix from its key/folder agreement
  * check.
  */
+import { type BindingsView } from '../core/binding-messages.js';
 export declare const SOLUTION_FOLDER = "solution_folder";
 export interface ResourceIdentity {
     /** The `resourceKey` both rows of the name/folderPath binding pair carry. */
@@ -42,3 +43,47 @@ export interface ResourceIdentity {
 export declare function resourceIdentity(name: string, folder: string): ResourceIdentity;
 /** True for the key of a resource built inside the same solution. */
 export declare function isInSolutionKey(resourceKey: string): boolean;
+/**
+ * Why a resource task's `=bindings.<label>` name or folder cannot be resolved.
+ *
+ * - `RESOURCE_REF_IS_BINDING`: there is no bindings.json (or it declares nothing),
+ *   so the label names nothing compile can read.
+ * - `RESOURCE_BINDING_UNDECLARED`: bindings.json does not declare the label, or
+ *   declares it with no value.
+ */
+export interface ResourceLabelRefusal {
+    code: 'RESOURCE_REF_IS_BINDING' | 'RESOURCE_BINDING_UNDECLARED';
+    message: string;
+}
+/**
+ * The literal name and folder of a resource task, with any `=bindings.<label>`
+ * resolved through the project's bindings.json, the way a connector task's
+ * `connection:` label is.
+ *
+ *   bindings.json  { "name": "agentName",   "default": "Agent" }
+ *                  { "name": "agentFolder", "default": "Shared/Golden" }
+ *   .agent('=bindings.agentName', { folder: '=bindings.agentFolder' })
+ *     -> { name: 'Agent', folderPath: 'Shared/Golden' }
+ *
+ * The task then compiles exactly as `.agent('Agent', { folder: 'Shared/Golden' })`
+ * does: compile mints the name/folderPath binding pair keyed `<folder>.<name>`.
+ * Passing the label straight through instead keyed the pair
+ * `=bindings.f.=bindings.n`, which names no resource and dangles at deploy.
+ *
+ * @param ref - The authored name and folder.
+ * @param bindings - The project's bindings.json, if any.
+ * @param where - The task, as a diagnostic names it.
+ * @returns The literal pair, or the refusal.
+ */
+export declare function resolveResourceRef(ref: {
+    name: string;
+    folderPath: string;
+}, bindings: BindingsView | undefined, where: string): {
+    name: string;
+    folderPath: string;
+} | ResourceLabelRefusal;
+/** True when {@link resolveResourceRef} refused. */
+export declare function isResourceLabelRefusal(r: {
+    name: string;
+    folderPath: string;
+} | ResourceLabelRefusal): r is ResourceLabelRefusal;

package/dist/case/resource-identity.js

@@ -23,6 +23,7 @@
  * `case-validate-service.ts` exempts that prefix from its key/folder agreement
  * check.
  */
+import { GUID_RE } from '../core/binding-messages.js';
 export const SOLUTION_FOLDER = 'solution_folder';
 const SOLUTION_FOLDER_KEY_PREFIX = `${SOLUTION_FOLDER}.`;
 /**
@@ -43,3 +44,72 @@ export function resourceIdentity(name, folder) {
 export function isInSolutionKey(resourceKey) {
     return resourceKey.startsWith(SOLUTION_FOLDER_KEY_PREFIX);
 }
+/** How a resource task's name or folder spells a bindings.json label. */
+const BINDING_LABEL_PREFIX = '=bindings.';
+/** The literal value bindings.json declares for `label`, or `undefined`. */
+function declaredValue(bindings, label) {
+    const entry = bindings?.entry?.(label);
+    // `default` is the value a person reads (the resource's name, the folder
+    // path); `resourceKey` can be the resource's GUID. A map-form bindings.json
+    // puts the value in both. A GUID-shaped `resourceKey` is never a name or a
+    // folder: taking it would key the pair `<folder>.<guid>`, which dangles at
+    // deploy, so the label falls through to RESOURCE_BINDING_UNDECLARED.
+    const fallback = typeof entry?.resourceKey === 'string' && GUID_RE.test(entry.resourceKey.trim()) ? undefined : entry?.resourceKey;
+    const value = entry ? (entry.default ?? fallback) : bindings?.resolve(label);
+    return typeof value === 'string' && value.trim() && !value.trim().startsWith(BINDING_LABEL_PREFIX)
+        ? value
+        : undefined;
+}
+/**
+ * The literal name and folder of a resource task, with any `=bindings.<label>`
+ * resolved through the project's bindings.json, the way a connector task's
+ * `connection:` label is.
+ *
+ *   bindings.json  { "name": "agentName",   "default": "Agent" }
+ *                  { "name": "agentFolder", "default": "Shared/Golden" }
+ *   .agent('=bindings.agentName', { folder: '=bindings.agentFolder' })
+ *     -> { name: 'Agent', folderPath: 'Shared/Golden' }
+ *
+ * The task then compiles exactly as `.agent('Agent', { folder: 'Shared/Golden' })`
+ * does: compile mints the name/folderPath binding pair keyed `<folder>.<name>`.
+ * Passing the label straight through instead keyed the pair
+ * `=bindings.f.=bindings.n`, which names no resource and dangles at deploy.
+ *
+ * @param ref - The authored name and folder.
+ * @param bindings - The project's bindings.json, if any.
+ * @param where - The task, as a diagnostic names it.
+ * @returns The literal pair, or the refusal.
+ */
+export function resolveResourceRef(ref, bindings, where) {
+    const out = { name: ref.name, folderPath: ref.folderPath };
+    for (const attribute of ['name', 'folderPath']) {
+        const authored = ref[attribute].trim();
+        if (!authored.startsWith(BINDING_LABEL_PREFIX))
+            continue;
+        const label = authored.slice(BINDING_LABEL_PREFIX.length);
+        const what = attribute === 'name' ? 'resource name' : 'folder';
+        const literal = `e.g. .agent('Contract Analysis', { folder: 'Shared/Legal' })`;
+        const declared = bindings?.declared?.() ?? [];
+        if (declared.length === 0)
+            return {
+                code: 'RESOURCE_REF_IS_BINDING',
+                message: `${where} passes "${authored}" as its ${what}, and there is no bindings.json declaring "${label}". `
+                    + `Declare it in bindings.json ({ "name": "${label}", "default": "<the ${what}>" }), or pass the ${what} itself, ${literal}; `
+                    + `compile writes the name/folderPath binding pair keyed '<folder>.<name>' and points the task at it.`,
+            };
+        const value = declaredValue(bindings, label);
+        if (value === undefined)
+            return {
+                code: 'RESOURCE_BINDING_UNDECLARED',
+                message: `${where} passes "${authored}" as its ${what}, but bindings.json does not declare "${label}" with a value `
+                    + `(it declares: ${declared.join(', ')}). Use one of those labels, add "${label}" with its ${what} as "default", `
+                    + `or pass the ${what} itself, ${literal}.`,
+            };
+        out[attribute] = value;
+    }
+    return out;
+}
+/** True when {@link resolveResourceRef} refused. */
+export function isResourceLabelRefusal(r) {
+    return 'code' in r;
+}

package/dist/case/serialize.js

@@ -18,7 +18,7 @@ import { resolveEventWhere } from '../core/lookups.js';
 import { resolveCaseSubscription } from './subscription.js';
 import { externalDescriptorRefusal } from './external.js';
 import { CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from './format-profile.js';
-import { resourceIdentity } from './resource-identity.js';
+import { isResourceLabelRefusal, resolveResourceRef, resourceIdentity } from './resource-identity.js';
 import { ownEntry } from '../core/own-entry.js';
 import { resolveSchemaVersion } from '../schema-version.js';
 import { caseJsonPreservation, caseJsonPreservationErrors, } from './preserve.js';
@@ -914,7 +914,7 @@ function taskData(task, resolver, taskId, stageId, ids) {
             // never literals: `validate` refuses a literal (CASE_MGMT_RESOURCE_TASK_
             // LITERAL_BINDING), and deploy re-targets a resource only through its
             // binding (#1240).
-            const { nameRef, folderRef } = referenceBindings(task.kind, task.ref, resolver, ids);
+            const { nameRef, folderRef } = referenceBindings(task.kind, task.ref, resolver, ids, task.name);
             const data = { name: nameRef, folderPath: folderRef };
             const elementId = `${stageId}-${taskId}`;
             if (task.inputs?.length)
@@ -940,7 +940,7 @@ function taskData(task, resolver, taskId, stageId, ids) {
             // The Action App the task opens, bound like any resource: an `app`
             // name/folderPath pair keyed `<deployment folder>.<app>` (#1240).
             if (task.ref) {
-                const { nameRef, folderRef } = referenceBindings('action', task.ref, resolver, ids);
+                const { nameRef, folderRef } = referenceBindings('action', task.ref, resolver, ids, task.name);
                 data.name = nameRef;
                 data.folderPath = folderRef;
             }
@@ -1278,7 +1278,12 @@ function resourceBinding(resolver, ids, binding, resourceKey, propertyAttribute,
 /** The binding `resource` an action task's Action App is bound by (no subtype). */
 const ACTION_APP_RESOURCE = 'app';
 /** The `=bindings.<id>` name/folderPath references of a published-resource task. */
-function referenceBindings(kind, ref, resolver, ids) {
+function referenceBindings(kind, authored, resolver, ids, taskName) {
+    // A `=bindings.<label>` name or folder reads through bindings.json to its
+    // literal value, so the task binds exactly as the literal form does.
+    const ref = resolveResourceRef(authored, resolver.bindings, `Task "${taskName}"`);
+    if (isResourceLabelRefusal(ref))
+        throw new Error(`[${ref.code}] ${ref.message}`);
     const binding = kind === 'business-rule'
         ? { resource: BUSINESS_RULE_RESOURCE }
         : kind === 'action'
@@ -1308,7 +1313,7 @@ function referenceBindings(kind, ref, resolver, ids) {
  *   (`=<Decision>.<column>`).
  */
 function businessRuleTaskData(task, resolver, elementId, ids) {
-    const { nameRef, folderRef } = referenceBindings(task.kind, task.ref, resolver, ids);
+    const { nameRef, folderRef } = referenceBindings(task.kind, task.ref, resolver, ids, task.name);
     const ownRow = (name, source, seed, extra = {}) => {
         const slot = ids.make('v', 8, `${elementId}:${seed}`);
         return { name, type: 'jsonSchema', id: slot, var: slot, value: slot, source, target: `=${slot}`, elementId, ...extra };

package/dist/check.js

@@ -2356,7 +2356,7 @@ function checkParallel(s, diags) {
     // flows have (a bare fan-out from the trigger, one arm terminating, the other
     // ending) — and the rule would be rejecting a correct flow. A terminate arm
     // never starves a join either: it stops the run, so the join is moot.
-    const reachesJoin = (arm) => arm.length > 0 && !arm.some((st) => st.kind === 'return' || st.kind === 'terminate');
+    const reachesJoin = armReachesJoin;
     if (arms.some(reachesJoin)) {
         arms.forEach((arm, i) => {
             const steps = Array.isArray(arm) ? arm : [];
@@ -2369,11 +2369,26 @@ function checkParallel(s, diags) {
         });
     }
 }
+/**
+ * Whether a `.parallel` arm hands its join an edge, as serialize wires it: it
+ * has a step, and `armTails` (serialize's `emit` tail for tail) leaves it at
+ * least one tail. So an arm that ends by `.return`, `.terminate`, `.break`,
+ * `.continue` or a `.stepToRef` on the default port does not, and neither does
+ * one that ends in a `.branch` / `.switch` / `.stepSwitch` every arm of which
+ * ends, or in a nested `.parallel` none of whose arms reaches its own join.
+ * When no arm hands on a tail, serialize emits no Merge at all (#1267), so the
+ * join rules (PARALLEL_ARM_RETURNS, REF_INTO_PARALLEL_ARM,
+ * REF_OUT_OF_PARALLEL_ARM) have no join to protect.
+ */
+function armReachesJoin(arm) {
+    return arm.length > 0 && armTails(arm, [{ from: '' }]).length > 0;
+}
 /**
  * The edges a step list hands on, mirroring serialize's `emit` tail for tail.
  *
  * `.branch` / `.switch` / `.stepSwitch` hand on every arm's tails (an empty arm
- * hands on the port it started from), a fan-out human task one per continuing
+ * hands on the port it started from), a `.parallel` its Merge when an arm
+ * reaches it and nothing otherwise, a fan-out human task one per continuing
  * outcome, a routed one its primary outcome; `.return` / `.terminate` / `.break`
  * and a `stepToRef('output', …)` hand on none, `.stepToList` leaves the path as
  * it was, and every other step hands on its own single edge.
@@ -2408,6 +2423,13 @@ function armTails(steps, incoming) {
                 ...(st.default !== undefined ? armTails(st.default, [{ from: st.name }]) : []),
             ];
         }
+        else if (st.kind === 'parallel') {
+            // serialize joins a nested `.parallel` at its Merge, the one edge it hands
+            // on, and emits no Merge, so no edge, when no arm hands on a tail (#1267).
+            // An empty arm hands on the path it started from, which the Merge joins.
+            const arms = Array.isArray(st.arms) ? st.arms : [];
+            tails = arms.some((arm) => armTails(arm, tails).length > 0) ? [{ from: st.name }] : [];
+        }
         else {
             tails = [{ from: st.name ?? st.kind }];
         }
@@ -3273,6 +3295,8 @@ function checkStepRefs(built, diags, reservedIds = []) {
     const scopeOf = new Map();
     /** Step name → the parallel arm it lives in, as `<parallel>#<index>`. */
     const armOf = new Map();
+    /** Every `.parallel` no arm of which reaches its join, so it has no Merge (#1267). */
+    const unjoined = new Set();
     /**
      * How many nodes answer to each NAMED End's name (`.return({}, { name })`), and
      * how many of those are steps. A named End is a ref target too (#1223): a side
@@ -3348,6 +3372,8 @@ function checkStepRefs(built, diags, reservedIds = []) {
                 index(s.default ?? [], portList, scope, arm);
             }
             else if (s.kind === 'parallel') {
+                if (!s.arms.some(armReachesJoin))
+                    unjoined.add(s.name);
                 // The fork node (`{ fork }`, #1310) is a node in this scope like the
                 // join: a `.stepToRef(<fork>)` is an edge serialize resolves.
                 const fork = parallelFork(s.options);
@@ -3555,8 +3581,11 @@ function checkStepRefs(built, diags, reservedIds = []) {
         // 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.
+        // A `.parallel` whose arms all end has no Merge to wait (#1267), so a ref
+        // into or out of one of its arms cannot hang a join either.
+        const joined = (a) => a !== undefined && !unjoined.has(a.slice(0, a.lastIndexOf('#')));
         if (targetArm !== arm && !terminateNames.has(target)) {
-            if (targetArm !== undefined) {
+            if (joined(targetArm)) {
                 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 `
                     + `an arm is not one of them, so the join may never settle. Verify with uip maestro flow validate.`);
@@ -3577,7 +3606,7 @@ function checkStepRefs(built, diags, reservedIds = []) {
                         + `so leave a decompiled one as it is.`);
                 }
             }
-            else if (arm !== undefined) {
+            else if (joined(arm)) {
                 say('warning', 'REF_OUT_OF_PARALLEL_ARM', `.stepToRef('${target}') ${where} leaves a parallel arm without reaching its Merge. That Merge waits for `
                     + `every branch it forked, so the token this arm owed it never arrives and the join may hang. Verify with `
                     + `uip maestro flow validate.`);

package/dist/decompile.js

@@ -1598,10 +1598,13 @@ function commonPostDominator(targets, ipdom) {
  *
  * When the arms meet at a merge node, every edge in `edges` is accounted
  * (edge accounting, #1125): the fold recreates each one. A fork whose arms
- * never meet at a merge node has no builder spelling. Like the same shape
- * mid-flow (`region`), it throws under `bestEffort: false`, and otherwise keeps
- * the first arm behind a `TODO: unstructured fan-out` marker. Only the kept
- * first edge is accounted; the others are reported as dropped at the marker.
+ * never meet again and each end (`unjoinedFork`) is a `.parallel(...)` whose
+ * arms all end, which serialize writes with no merge node (#1267); it folds the
+ * same way, and nothing follows it. Any other fork has no builder spelling.
+ * Like the same shape mid-flow (`region`), it throws under `bestEffort: false`,
+ * and otherwise keeps the first arm behind a `TODO: unstructured fan-out`
+ * marker. Only the kept first edge is accounted; the others are reported as
+ * dropped at the marker.
  */
 function forkRegion(edges, stop, scope, ipdom, ctx, refInto) {
     if (edges.length <= 1)
@@ -1614,11 +1617,19 @@ function forkRegion(edges, stop, scope, ipdom, ctx, refInto) {
     // here. Not at a merge node that is `stop`: the enclosing construct continues
     // from it, so a `.parallel` inside this arm cannot also own it.
     if (join === undefined || joinNode === undefined || !parallelJoinable(joinNode) || (join === stop && joinNode.type === T.merge)) {
+        const unjoined = unjoinedFork(targets, scope, ctx);
+        const stopBehind = unjoined ? terminateBehindStep(targets, scope, ipdom, ctx) : undefined;
+        if (unjoined && stopBehind === undefined) {
+            for (const e of edges)
+                ctx.graph.accounted.add(e);
+            return [parallelSeg(undefined, undefined, targets, scope, ipdom, ctx, refInto, undefined, edges[0].sourceNodeId).seg];
+        }
+        const why = stopBehind !== undefined ? terminateBehindStepWhy(stopBehind) : '';
         if (ctx.o.bestEffort === false)
-            throw new Error(`decompile: unstructured fan-out (${edges.length} edges).`);
+            throw new Error(`decompile: unstructured fan-out (${edges.length} edges)${why}.`);
         ctx.graph.accounted.add(edges[0]);
         return [
-            `/* TODO: unstructured fan-out (${commentText(edges.length)} edges) */`,
+            `/* TODO: unstructured fan-out (${commentText(edges.length)} edges)${commentText(why)} */`,
             dropEdges(edges.slice(1), ctx),
             ...region(targets[0], stop, scope, ipdom, ctx, refInto),
         ];
@@ -1657,8 +1668,18 @@ function parallelJoinable(join) {
  *
  * `fork` is the merge node a designer-drawn split leaves from, written as
  * `{ fork }` (#1310); the caller accounts its outgoing edges.
+ *
+ * With no `join` the fork is unjoined (`unjoinedFork`, #1267): every arm runs
+ * to its own End or Terminate, the `.parallel` gets a fresh name (`forkName`),
+ * and `next` is empty because nothing can follow it.
  */
 function parallelSeg(join, joinNode, targets, scope, ipdom, ctx, refInto, fork, source) {
+    if (join === undefined || joinNode === undefined) {
+        const name = forkName(source ?? fork?.id, ctx);
+        const arms = targets.map((t, i) => armCb(`a${i}`, region(t, EXIT, scope, ipdom, ctx, refInto)));
+        const seg = `.parallel(${tsLiteral(name)}, [\n${arms.map((a) => reindent(a, '  ')).join(',\n')},\n]${forkOptsArg(undefined, fork)})`;
+        return { seg, next: {} };
+    }
     const atMerge = joinNode.type === T.merge;
     const name = atMerge ? join : forkName(source ?? fork?.id, ctx);
     const arms = targets.map((t, i) => {
@@ -1677,13 +1698,80 @@ function parallelSeg(join, joinNode, targets, scope, ipdom, ctx, refInto, fork,
 function endsPath(seg) {
     return seg !== undefined && /^\.(stepToRef|break|continue|return|terminate)\(/.test(seg);
 }
+/**
+ * Whether a fan-out into `targets` is a `.parallel(...)` whose arms all end
+ * (#1267). serialize writes that `.parallel` with NO merge node: when no arm
+ * hands the join a tail there is nothing to join, so the fork's node just has
+ * one edge per arm out of one port. The canvas and the classic CLI draw the
+ * same shape (two edges out of one port, each into its own End). The file
+ * therefore holds everything but the fork's name, which no node carries.
+ *
+ * It is that shape when, within `scope`:
+ *  - every path out of every arm ends at an End or a Terminate. A path that
+ *    just stops on a step (a dangling node) would recompile with a tail, and a
+ *    tail makes serialize add a merge node the file does not have;
+ *  - the arms share no node but an End or Terminate. A shared End or Terminate
+ *    is fine: the second arm to reach it ends with `.stepToRef(...)`
+ *    (#1231/#1239). A shared step would be a reconvergence with no join.
+ */
+function unjoinedFork(targets, scope, ctx) {
+    const owner = new Map();
+    for (const [i, t] of targets.entries()) {
+        for (const n of forwardReach([t], scope, ctx.graph)) {
+            const type = ctx.graph.byId.get(n)?.type;
+            if (type === T.end || type === T.terminate)
+                continue;
+            if (scopeSucc(ctx.graph, n, scope).length === 0)
+                return false;
+            if ((owner.get(n) ?? i) !== i)
+                return false;
+            owner.set(n, i);
+        }
+    }
+    return true;
+}
+/**
+ * The Terminate an unjoined fork's arm would spell as `.terminate(...)` behind
+ * another step, or `undefined` when there is none. check refuses that inside a
+ * `.parallel` (TERMINATE_NOT_ARM_HEAD, an error), so folding it would turn a
+ * flow the user did not edit into source that fails compile with check; the
+ * fork stays unstructured instead. Whether the rule still holds now that the
+ * FIL lowering it was written for is gone is #1388.
+ *
+ * Mirrors check, which looks at an arm's top-level steps only: the nodes the
+ * arm's walk emits at top level are the arm target's post-dominator chain, so
+ * a Terminate on that chain, other than the target, is a top-level terminate
+ * behind a step. A Terminate an earlier arm already reaches is not: this arm
+ * spells it `.stepToRef(...)` (#1231/#1239). A Terminate on one side of a
+ * decision is nested in a `.branch` / `.switch`, which check accepts.
+ */
+function terminateBehindStep(targets, scope, ipdom, ctx) {
+    const earlier = new Set();
+    for (const t of targets) {
+        const seen = new Set([t]);
+        for (let n = ipdom.get(t); n !== undefined && n !== EXIT && !seen.has(n); n = ipdom.get(n)) {
+            seen.add(n);
+            if (ctx.graph.byId.get(n)?.type === T.terminate && !earlier.has(n))
+                return n;
+        }
+        for (const n of forwardReach([t], scope, ctx.graph))
+            earlier.add(n);
+    }
+    return undefined;
+}
+/** Why a fork with a Terminate behind a step stays unstructured, for the marker and the `--strict` error. */
+function terminateBehindStepWhy(stop) {
+    return `: terminate "${stop}" is not the first step of its arm, which check refuses inside a .parallel `
+        + '(TERMINATE_NOT_ARM_HEAD, flow-builder-sdk#1388)';
+}
 /**
  * A name for a `.parallel(...)` that creates no merge node: `<source>Fork`,
  * numbered when that is a node id, a declared input, variable or output, or a
  * name already minted. No node carries it (the arms join on a plain step by
- * ref), but it must still not collide with any of those: check reads a
- * `$vars.<name>` of a parallel's name as a read of its merge, so a variable
- * of that name would fail PARALLEL_HAS_NO_OUTPUT on recompile.
+ * ref, or never join, #1267), but it must still not collide with any of
+ * those: check reads a `$vars.<name>` of a parallel's name as a read of its
+ * merge, so a variable of that name would fail PARALLEL_HAS_NO_OUTPUT on
+ * recompile.
  */
 function forkName(source, ctx) {
     const base = `${source ?? 'parallel'}Fork`;
@@ -2125,11 +2213,21 @@ function region(cursor, stop, scope, ipdom, ctx, refInto) {
             cursor = fork.next.cursor;
             continue;
         }
+        // Parallel with no join: every arm ends, so serialize wrote no merge (#1267).
+        const unjoined = unjoinedFork(succ, scope, ctx);
+        const stopBehind = unjoined ? terminateBehindStep(succ, scope, ipdom, ctx) : undefined;
+        if (unjoined && stopBehind === undefined) {
+            const arms = succ.map((t) => follow(ctx.graph, node.id, t));
+            segs.push(parallelSeg(undefined, undefined, arms, scope, ipdom, ctx, refInto, undefined, node.id).seg);
+            flagDropped(node, ctx, segs);
+            return segs;
+        }
         // Unstructured fan-out we can't fold — best-effort marker.
         // No successor is walked: leave the edges unaccounted so `flagDropped` names each.
+        const why = stopBehind !== undefined ? terminateBehindStepWhy(stopBehind) : '';
         if (ctx.o.bestEffort === false)
-            throw new Error(`decompile: unstructured fan-out at "${node.id}".`);
-        segs.push(`/* TODO: unstructured fan-out at ${commentText(node.id)} (${commentText(succ.length)} successors) */`);
+            throw new Error(`decompile: unstructured fan-out at "${node.id}"${why}.`);
+        segs.push(`/* TODO: unstructured fan-out at ${commentText(node.id)} (${commentText(succ.length)} successors)${commentText(why)} */`);
         flagDropped(node, ctx, segs);
         return segs;
     }

package/dist/flow-sdk.d.ts

@@ -1154,6 +1154,12 @@ declare class StepList {
      * arm's output. The Merge itself computes nothing and publishes nothing — read
      * the steps inside the arms, never `$vars.<merge>`.
      *
+     * When EVERY arm ends — with `.return`, `.terminate`, or a `.stepToRef` to an
+     * End another arm wrote — there is nothing to join: no Merge is emitted, the
+     * fork is just one edge per arm, `name` names no node, and nothing may follow
+     * the `.parallel`. Decompile writes a fan-out whose arms never meet again
+     * this way, naming it `<node>Fork` after the node it leaves.
+     *
      * Arm semantics, what a local run does and does not prove, and the rules
      * `check` enforces: `references/parallel-merge.md`.
      *

package/dist/flow-sdk.js

@@ -759,6 +759,12 @@ class StepList {
      * arm's output. The Merge itself computes nothing and publishes nothing — read
      * the steps inside the arms, never `$vars.<merge>`.
      *
+     * When EVERY arm ends — with `.return`, `.terminate`, or a `.stepToRef` to an
+     * End another arm wrote — there is nothing to join: no Merge is emitted, the
+     * fork is just one edge per arm, `name` names no node, and nothing may follow
+     * the `.parallel`. Decompile writes a fan-out whose arms never meet again
+     * this way, naming it `<node>Fork` after the node it leaves.
+     *
      * Arm semantics, what a local run does and does not prove, and the rules
      * `check` enforces: `references/parallel-merge.md`.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.46.4",
+  "version": "6.46.6",
   "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": "d2cb008a329ef32af20be81f73a2ec726e22a13c"
+  "gitref": "64e024e591ad47ef3ebcdebe54d8a07ead2aa871"
 }