@uipath/maestro-builder-sdk 6.28.0 → 6.29.0

package/dist/api-index.md

@@ -57,13 +57,13 @@ could hand you spans for a version you do not have.
 | `apiWorkflow` | function | `dist/core/actions.d.ts:1658-1692` | 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:411-442` | 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:1224-1247` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1230-1253` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:79-89` | 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) |
 | `BindingContribution` | interface | `dist/core/node-classes.d.ts:80-101` | Supporting types | A resource binding a contribution hoists to the flow's top-level `bindings` array — the shape the `.flow` format… |
 | `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts:719-731` | Supporting types | One additional flow root, built by `.entryPoint()`. |
-| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:732-773` | Supporting types | 16 field(s) |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:732-779` | Supporting types | 17 field(s) |
 | `BuiltinToolName` | type | `dist/core/actions.d.ts:1066-1067` | Supporting types | The three platform-shipped built-in tools (fixed registry types). |
 | `BuiltinToolRef` | interface | `dist/core/actions.d.ts:1199-1219` | Supporting types | A platform built-in tool. |
 | `BuiltInValidatorGuardrail` | interface | `dist/core/actions.d.ts:762-803` | Supporting types | A platform-shipped validator, configured by parameters. |
@@ -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:1572-1587` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1618-1633` | 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:1443-1520` | 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:1248-1571` | Builders | 14 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1254-1617` | Builders | 15 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:705-718` | 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. |
@@ -225,11 +225,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:63-78` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
 | `Step` | type | `dist/flow-sdk.d.ts:508-627` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:774-1223` | Builders | Collects a sequence of steps. |
+| `StepList` | class | `dist/flow-sdk.d.ts:780-1229` | Builders | Collects a sequence of steps. |
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:658-663` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:670-704` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:664-669` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1588-1627` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1634-1673` | 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

@@ -5,12 +5,12 @@
 
 # Maestro Builder SDK — member index
 
-**A lookup table of 1116 rows — match one name in it, do not read it.**
+**A lookup table of 1118 rows — match one name in it, do not read it.**
 Grep or search for the member you have; the row it lands on is the whole
 answer. Reading top to bottom costs ~20x what the one row does and tells you
 nothing you asked for.
 
-Every field and method of every exported shape — 1116 across
+Every field and method of every exported shape — 1118 across
 200 interfaces and classes — keyed by the MEMBER's own name.
 
 **Use this when the name you have is a field or a method**, which is usually
@@ -28,7 +28,7 @@ truncated summary would, for less. Read the span.
 Member names repeat across shapes (`name` is declared on 69 of them), so the
 `Declared on` column is what makes a match actionable. For the whole shape
 rather than the one field, look that name up in [`api-index.md`](api-index.md) —
-which is why its span is not repeated on all 1116 rows here.
+which is why its span is not repeated on all 1118 rows here.
 
 **A name that misses both indexes is probably not part of the API.** The one
 that comes up is a RUNTIME output key — a human task's `Action`, a step's
@@ -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:1236` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1242` |
 | `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` |
@@ -97,14 +97,14 @@ not find it either.
 | `body` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:176-181` |
 | `body` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:207-208` |
 | `boundaryEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2239-2246` |
-| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:973-991` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:979-997` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1108-1117` |
+| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1114-1123` |
 | `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:505-506` |
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:492-496` |
 | `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:1564-1570` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1610-1616` |
 | `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` |
@@ -172,7 +172,7 @@ not find it either.
 | `context` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:87` |
 | `contextRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1528-1535` |
 | `contextVerbatim` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1600-1605` |
-| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1118-1132` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1124-1138` |
 | `contribute` | method | `FlowNode` | `dist/core/node-classes.d.ts:144-153` |
 | `conversationalAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1479-1482` |
 | `conversationContext` | property | `FlowActionSpecs` | `dist/nodes/conversation/flow/spec.d.ts:55-58` |
@@ -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:758-763` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1464-1504` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1471-1511` |
 | `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:1187` |
@@ -225,7 +225,7 @@ not find it either.
 | `description` | property | `CustomGuardrail` | `dist/core/actions.d.ts:755` |
 | `description` | property | `EscalationRef` | `dist/core/actions.d.ts:1349-1350` |
 | `description` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:241` |
-| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1273-1280` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1280-1287` |
 | `description` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1154` |
 | `description` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:337-344` |
 | `description` | property | `IxpToolRef` | `dist/core/actions.d.ts:1327-1328` |
@@ -267,7 +267,7 @@ not find it either.
 | `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:252-256` |
 | `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:1083-1107` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1089-1113` |
 | `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` |
@@ -291,12 +291,12 @@ 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:1339-1389` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1346-1396` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
 | `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:764-765` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
 | `entryWhen` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:947-956` |
-| `err` | method | `StepList` | `dist/flow-sdk.d.ts:782-807` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:788-813` |
 | `error` | property | `BoundaryOpts` | `dist/bpmn/bpmn-sdk.d.ts:750-754` |
 | `error` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:696-706` |
 | `error` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1842-1847` |
@@ -461,7 +461,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1491-1494` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1505-1517` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1551-1563` |
 | `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` |
@@ -534,7 +534,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:1194-1195` |
-| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1237-1246` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1243-1252` |
 | `label` | property | `AskedField` | `dist/core/actions.d.ts:83-84` |
 | `label` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:523` |
 | `label` | property | `InOutField` | `dist/core/actions.d.ts:99-100` |
@@ -548,7 +548,7 @@ not find it either.
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:646-647` |
 | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:754-755` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1281-1291` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1288-1298` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:503-504` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
@@ -558,7 +558,7 @@ not find it either.
 | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
 | `loop` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:335-336` |
 | `loop` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:832-833` |
-| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1071-1082` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1077-1088` |
 | `managed` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:37-67` |
 | `marksCaseComplete` | property | `BuiltCaseExitCondition` | `dist/case/case-sdk.d.ts:354` |
 | `marksStageComplete` | property | `BuiltExitCondition` | `dist/case/case-sdk.d.ts:321` |
@@ -647,7 +647,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:1265-1272` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1272-1279` |
 | `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` |
@@ -709,11 +709,13 @@ not find it either.
 | `onError` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3259-3266` |
 | `onError` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3267-3274` |
 | `onError` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3275-3283` |
-| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:862-922` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:868-928` |
 | `onMessage` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3302-3310` |
 | `onMessage` | method | `ActivityBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3311-3319` |
 | `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:773-778` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1512-1550` |
 | `operation` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:37` |
 | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1230-1231` |
 | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:368-369` |
@@ -727,7 +729,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1395-1400` |
 | `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:1518-1553` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1564-1599` |
 | `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` |
@@ -763,7 +765,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:326-327` |
 | `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:485-486` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1035-1070` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1041-1076` |
 | `parallelGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2256-2265` |
 | `parameters` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1479-1480` |
 | `parameters` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1140-1145` |
@@ -862,7 +864,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:1213-1222` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1219-1228` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
 | `returns` | property | `AgentInputs` | `dist/core/actions.d.ts:641-660` |
 | `returns` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:429-441` |
@@ -903,7 +905,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:738-744` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1424-1463` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1431-1470` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:701` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -975,16 +977,16 @@ not find it either.
 | `startName` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1887-1888` |
 | `startPayload` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1889-1890` |
 | `startProcess` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2459-2478` |
-| `step` | method | `StepList` | `dist/flow-sdk.d.ts:808-818` |
+| `step` | method | `StepList` | `dist/flow-sdk.d.ts:814-824` |
 | `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:729-730` |
 | `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:748` |
-| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:776` |
-| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:819-861` |
-| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:936-964` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1164-1192` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1193-1212` |
+| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:782` |
+| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:825-867` |
+| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:942-970` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1170-1198` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1199-1218` |
 | `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:756-757` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1292-1317` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1299-1324` |
 | `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` |
@@ -997,7 +999,7 @@ not find it either.
 | `subType` | property | `VarSpec` | `dist/flow-sdk.d.ts:84-85` |
 | `summarize` | property | `FlowActionSpecs` | `dist/nodes/ai-patterns/flow/spec.d.ts:66-69` |
 | `summary` | property | `CaseAppConfig` | `dist/case/case-sdk.d.ts:585-586` |
-| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:992-1034` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:998-1040` |
 | `systemPrompt` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:134-139` |
 | `systemPrompt` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:814-863` |
 | `systemPrompt` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:221-226` |
@@ -1022,7 +1024,7 @@ not find it either.
 | `temperature` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:924-925` |
 | `temperature` | property | `VoiceSettings` | `dist/core/actions.d.ts:213-214` |
 | `terminate` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:692-693` |
-| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1133-1163` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1139-1169` |
 | `threshold` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1438-1439` |
 | `timeCycle` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:201-202` |
 | `timeout` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:91-108` |
@@ -1046,11 +1048,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:749-751` |
 | `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:1318-1338` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1325-1345` |
 | `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:766-772` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1390-1409` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1397-1416` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:752-753` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1106,7 +1108,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:1554-1563` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1600-1609` |
 | `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` |
@@ -1129,7 +1131,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1232-1233` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2116` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1410-1423` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1417-1430` |
 | `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:2073-2074` |

package/dist/decompile.js

@@ -2861,6 +2861,8 @@ function emitChildFlow(name, child, ctx) {
         o: ctx.o,
     };
     const parts = [`${ctx.imp.use('flow')}(${tsLiteral(name)})`];
+    // As for the root flow (emitFlow): every End is explicit, so nothing is implicit.
+    parts.push('.openTails()');
     // Variables.
     const shape = (dir) => `{ ${globals.filter((g) => g.direction === dir).map((g) => `${key(g.name ?? g.id)}: ${declExpr(g, dir !== 'inout', ctx.imp)}`).join(', ')} }`;
     if (globals.some((g) => g.direction === 'in'))
@@ -3050,6 +3052,11 @@ export function decompile(flow, options = {}) {
     }
     if (runCarried.size > 0)
         e.line(d, `.definitions([${[...runCarried.values()].join(', ')}])`);
+    // Every End in the file decompiles to an explicit `.return(...)` or
+    // `.terminate(...)`, so the source needs no implicit End: one would only add
+    // an End to a path the file leaves open (#1142). Always saying so, rather
+    // than detecting open tails, keeps this from drifting from what serialize caps.
+    e.line(d, '.openTails()');
     // Trigger nodes. One root is the default: the isDefaultEntryPoint carrier
     // when the file marks one (a multi-root flow always does), else `start`.
     // A node's TYPE is not enough: `uipath.connector.event.<key>.<event>` is a

package/dist/flow-node-type.d.ts

@@ -288,6 +288,12 @@ export interface FlowNodeType<Spec> extends NodeType<Spec, FlowNodeContribution,
      * envelope is in `<step>.output` (instance 430d43ad-4583-40c0-8f74-b49d2c4904e4).
      */
     readonly errorEnvelope?: string;
+    /**
+     * `true`: a path that ends on this node is capped with an End even under
+     * `.openTails()`. A human task sets it: the product's `hitl-completed`
+     * rule wants an edge after the task.
+     */
+    readonly capsOpenTail?: boolean;
     /**
      * The exits the AUTHOR named on this step — an HTTP call's response branches,
      * and the port each leaves on — or why it has none to route. What

package/dist/flow-sdk.d.ts

@@ -770,6 +770,12 @@ export interface BuiltFlow {
      * follows.
      */
     triggerId?: string;
+    /**
+     * `true` when `.openTails()` was called: a path that runs out of steps
+     * stops on its last node, with no End node added. Absent means the default —
+     * every such path is capped with an End.
+     */
+    openTails?: true;
 }
 /** Collects a sequence of steps. Used for the flow body and each branch/loop arm. */
 declare class StepList {
@@ -1261,6 +1267,7 @@ declare class FlowBuilder extends StepList {
     private _triggerOptions?;
     private _entryPoints;
     private _triggerId?;
+    private _openTails;
     constructor(_id: string);
     /**
      * Set the flow's display name.
@@ -1502,6 +1509,45 @@ declare class FlowBuilder extends StepList {
      * @throws Error when a manifest is not a node manifest, or two differ for one `nodeType@version`.
      */
     definitions(manifests: readonly Record<string, unknown>[]): this;
+    /**
+     * Leave a path that runs out of steps open, instead of ending it on an End node.
+     *
+     * @remarks
+     * By default compile caps every path that falls off the end of its
+     * step list with a `core.control.end` node, and that End maps the flow's
+     * outputs, so the run answers with them. The places this applies are the
+     * flow's own body, a subflow's body, and an `.onError` / `.stepToList` body.
+     *
+     * `.openTails()` leaves such a path open: its last node simply has no outgoing edge.
+     * It is the shape the classic CLI and the canvas write for a flow nobody gave
+     * an End node, and `uip maestro flow validate` accepts it. `flow-decompile`
+     * emits `.openTails()` for every file it decompiles (each End the file
+     * has becomes an explicit `.return(...)`), so a no-edit decompile → compile →
+     * merge does not add an End the author never drew.
+     *
+     * It changes only paths that fall off. `.return(...)`, `.terminate(...)`, a
+     * `.stepSwitch` exit with no arm and a human-task outcome with
+     * `action: 'End'` still emit their End. A human task that ends a path is
+     * still capped with an End (the product's `hitl-completed` rule wants an edge
+     * after it), so a file whose human task has no outgoing edge gains one on a
+     * round trip. A path left open maps no outputs, so a flow that declares
+     * `.output(...)` answers nothing on that path. Use `.return(...)` on the
+     * paths that must answer.
+     *
+     * A subflow's child flow has its own setting; it does not inherit the
+     * caller's.
+     *
+     * @example
+     * **Keep a classic flow's open tail open**
+     * ```ts
+     * flow('notify')
+     *   .openTails()
+     *   .step('send', script({ code: 'return { sent: true };' }))
+     * ```
+     *
+     * @returns This builder, so calls chain.
+     */
+    openTails(): this;
     /**
      * Declare the flow's inputs. Read them with `input('<name>')`.
      *

package/dist/flow-sdk.js

@@ -909,6 +909,7 @@ class FlowBuilder extends StepList {
     _triggerOptions;
     _entryPoints = [];
     _triggerId;
+    _openTails = false;
     constructor(_id) {
         super();
         this._id = _id;
@@ -1211,6 +1212,48 @@ class FlowBuilder extends StepList {
         this._definitions = [...known.values()];
         return this;
     }
+    /**
+     * Leave a path that runs out of steps open, instead of ending it on an End node.
+     *
+     * @remarks
+     * By default compile caps every path that falls off the end of its
+     * step list with a `core.control.end` node, and that End maps the flow's
+     * outputs, so the run answers with them. The places this applies are the
+     * flow's own body, a subflow's body, and an `.onError` / `.stepToList` body.
+     *
+     * `.openTails()` leaves such a path open: its last node simply has no outgoing edge.
+     * It is the shape the classic CLI and the canvas write for a flow nobody gave
+     * an End node, and `uip maestro flow validate` accepts it. `flow-decompile`
+     * emits `.openTails()` for every file it decompiles (each End the file
+     * has becomes an explicit `.return(...)`), so a no-edit decompile → compile →
+     * merge does not add an End the author never drew.
+     *
+     * It changes only paths that fall off. `.return(...)`, `.terminate(...)`, a
+     * `.stepSwitch` exit with no arm and a human-task outcome with
+     * `action: 'End'` still emit their End. A human task that ends a path is
+     * still capped with an End (the product's `hitl-completed` rule wants an edge
+     * after it), so a file whose human task has no outgoing edge gains one on a
+     * round trip. A path left open maps no outputs, so a flow that declares
+     * `.output(...)` answers nothing on that path. Use `.return(...)` on the
+     * paths that must answer.
+     *
+     * A subflow's child flow has its own setting; it does not inherit the
+     * caller's.
+     *
+     * @example
+     * **Keep a classic flow's open tail open**
+     * ```ts
+     * flow('notify')
+     *   .openTails()
+     *   .step('send', script({ code: 'return { sent: true };' }))
+     * ```
+     *
+     * @returns This builder, so calls chain.
+     */
+    openTails() {
+        this._openTails = true;
+        return this;
+    }
     /**
      * Declare the flow's inputs. Read them with `input('<name>')`.
      *
@@ -1310,6 +1353,7 @@ class FlowBuilder extends StepList {
             ...(this._triggerOptions !== undefined ? { triggerOptions: this._triggerOptions } : {}),
             ...(this._entryPoints.length ? { entryPoints: this._entryPoints } : {}),
             ...(this._triggerId !== undefined ? { triggerId: this._triggerId } : {}),
+            ...(this._openTails ? { openTails: true } : {}),
         };
         // First-level validation, intrinsic to running the SDK: catch a definitely-
         // broken expression HERE, before the model is serialized, rather than three

package/dist/nodes/hitl/flow/node-type.js

@@ -518,6 +518,7 @@ function hitlAt(typeName, version, factory) {
     return {
         kind: 'hitl', typeName, version, factory: 'hitl', definition: 'bundled',
         rawNode: { factory },
+        capsOpenTail: true,
         serialize: ({ inputs }, ctx) => {
             // How the task leaves its node — `hitlExitModel` (core/hitl-routing.ts)
             // has the product rule and what `.step()` means after each shape. An

package/dist/serialize.js

@@ -3893,6 +3893,7 @@ function newScope(outputs, vars = [], backing = new Map(), backingReads = backin
         agentSchemas: [],
         stepNodeId: new Map(),
         pendingEdges: [],
+        openTails: false,
     };
 }
 /**
@@ -4369,6 +4370,7 @@ export function serialize(built, opts = {}) {
     const subflows = {};
     const rootGlobals = emittableGlobals(built, `flow "${built.id}"`);
     const root = newScope(rootGlobals.outputs, rootGlobals.vars, rootGlobals.backing, rootGlobals.backingReads);
+    root.openTails = built.openTails === true;
     // `input('x')` lowers eagerly to `$vars.start.output.x` — `start` being the
     // trigger node's default id. When the flow renames the trigger, register that
     // rename so the SAME pass that rewrites step-name references rewrites these
@@ -4532,6 +4534,21 @@ export function serialize(built, opts = {}) {
             addEdge(scope, t, id);
         return node;
     }
+    /** Node ids whose type sets `capsOpenTail` (see {@link tailsToCap}). */
+    const capsOpenTail = new Set();
+    /**
+     * The tails of a path that ran out of steps which still need an End node.
+     *
+     * All of them by default. Under `.openTails()` (#1142) only the tails
+     * of a node whose type sets `capsOpenTail` (a human task: the product's
+     * `hitl-completed` rule wants an edge after it). Every other tail is left
+     * open, which is the shape the classic CLI and the canvas write.
+     */
+    function tailsToCap(scope, tails) {
+        if (!scope.openTails)
+            return [...tails];
+        return tails.filter((t) => capsOpenTail.has(t.node));
+    }
     /**
      * Emit a child flow into its own scope and register it under the calling
      * node's id — that key is how the format names a subflow body, and how
@@ -4559,6 +4576,7 @@ export function serialize(built, opts = {}) {
     function emitSubflowBodyIn(child, nodeId) {
         const childGlobals = emittableGlobals(child, `subflow "${nodeId}"`, 'subflow');
         const scope = newScope(childGlobals.outputs, childGlobals.vars, childGlobals.backing, childGlobals.backingReads);
+        scope.openTails = child.openTails === true;
         // Claim this copy's node ids UP FRONT, so the rename map is complete before
         // the first expression renders. A child's step names are free the first
         // time it runs; if any of them is already taken — which is what a second
@@ -4589,8 +4607,9 @@ export function serialize(built, opts = {}) {
         const tails = emit(child.steps, [{ node: startId, port: 'output' }], scope);
         // Same as the root's implicit End — mapped against the SUBFLOW's own
         // outputs, which is the scope the product validates a subflow body in.
-        if (tails.length)
-            emitEnd(scope, uid(scope, 'end'), tails);
+        const capped = tailsToCap(scope, tails);
+        if (capped.length)
+            emitEnd(scope, uid(scope, 'end'), capped);
         const globals = [];
         for (const inp of child.inputs)
             globals.push({ id: inp.name, name: inp.name, direction: 'in', type: inp.type, triggerNodeId: startId, ...varMeta(inp) });
@@ -4838,6 +4857,8 @@ export function serialize(built, opts = {}) {
         const impl = resolved.impl;
         const version = resolved.version;
         const id = stepUid(scope, step.name);
+        if (impl.capsOpenTail)
+            capsOpenTail.add(id);
         // As for every typed family: record the failure-envelope boundary before any
         // expression renders, so a handler reading this step resolves correctly.
         if (impl.errorEnvelope)
@@ -6017,9 +6038,10 @@ export function serialize(built, opts = {}) {
         // A body that runs out of steps ends the run on an End of its own (no
         // merge-back is inferred). That End maps the outputs like any other, so a
         // body that set them with `{ updates }` still answers (#742).
-        if (handlerTails.length) {
+        const capped = tailsToCap(scope, handlerTails);
+        if (capped.length) {
             const endId = uid(scope, `${source}${step.port === 'error' ? 'Error' : step.port.charAt(0).toUpperCase() + step.port.slice(1)}End`);
-            emitEnd(scope, endId, handlerTails, { parentId });
+            emitEnd(scope, endId, capped, { parentId });
         }
         return router !== undefined ? [] : tails;
     }
@@ -6485,8 +6507,10 @@ export function serialize(built, opts = {}) {
     // The implicit End a flow falls off the bottom into still terminates the
     // flow, so it maps the flow's outputs — each to itself, since no `.return`
     // named a value here.
-    if (finalTails.length)
-        emitEnd(root, uid(root, 'end'), finalTails);
+    // `.openTails()` leaves those tails open instead (#1142).
+    const finalCapped = tailsToCap(root, finalTails);
+    if (finalCapped.length)
+        emitEnd(root, uid(root, 'end'), finalCapped);
     // ── Additional entry points (design §5.1) ────────────────────────────────
     // Emitted AFTER the shared body so their prefixes can join it by name. Once a
     // flow has more than one root, every root carries the platform's entry-point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.28.0",
+  "version": "6.29.0",
   "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": "2129535cf7f13d90345db00a5d72d096c69fce04"
+  "gitref": "af71b0c21f732f056d19e802af1c987fd8528336"
 }