@uipath/maestro-builder-sdk 6.31.9 → 6.32.1

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:1715-1749` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/core/actions.d.ts:468-499` | Option shapes | 5 field(s) |
 | `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:140-185` | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
-| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1235-1258` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1258-1281` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:126-141` | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
 | `batchTransform` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:49-83` | Actions | Add AI-generated columns to a CSV — the platform's **Batch transform** node, `uipath.pattern.batch-transform` (service… |
 | `BatchTransformInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:48-63` | Option shapes | 4 field(s) |
 | `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:724-736` | Supporting types | One additional flow root, built by `.entryPoint()`. |
-| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:737-784` | Supporting types | 17 field(s) |
+| `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts:731-743` | Supporting types | One additional flow root, built by `.entryPoint()`. |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:744-791` | Supporting types | 17 field(s) |
 | `BuiltinToolName` | type | `dist/core/actions.d.ts:1123-1124` | Supporting types | The three platform-shipped built-in tools (fixed registry types). |
 | `BuiltinToolRef` | interface | `dist/core/actions.d.ts:1256-1276` | Supporting types | A platform built-in tool. |
 | `BuiltInValidatorGuardrail` | interface | `dist/core/actions.d.ts:819-860` | Supporting types | A platform-shipped validator, configured by parameters. |
@@ -113,10 +113,10 @@ could hand you spans for a version you do not have.
 | `documentClassify` | function | `dist/nodes/document/flow/factories.d.ts:8-16` | Actions | Classify a document into a document type (`uipath.document.classify`). |
 | `DocumentClassifyInputs` | interface | `dist/nodes/document/flow/spec.d.ts:9-18` | Option shapes | 4 field(s) |
 | `DocValidationInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:70-93` | Option shapes | The Document Validation task's subject — `variant: 'document-validation'` only. |
-| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:503-512` | Option shapes | Do-while options. |
+| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:510-519` | Option shapes | Do-while options. |
 | `dynamicExtract` | function | `dist/nodes/document/flow/factories.d.ts:17-27` | Actions | Extract fields from a document with an INLINE schema — Dynamic Extract (`uipath.ixp.extract-document-builder`), the… |
 | `DynamicExtractInputs` | interface | `dist/nodes/document/flow/spec.d.ts:19-53` | Option shapes | 5 field(s) |
-| `EdgeRoute` | interface | `dist/flow-sdk.d.ts:648-662` | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
+| `EdgeRoute` | interface | `dist/flow-sdk.d.ts:655-669` | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
 | `endCall` | function | `dist/core/actions.d.ts:1792-1799` | Actions | Hang up (`uipath.conversational.voice.end-call`). |
 | `EndCallInputs` | interface | `dist/core/actions.d.ts:246-253` | Option shapes | 1 field(s) |
 | `entryInput` | function | `dist/core/expr.d.ts:62-72` | Expressions and types | Reference an ENTRY POINT's scoped input: `entryInput('nightly', 'batchDate')` reads `$vars.nightly.output.batchDate` —… |
@@ -130,12 +130,12 @@ 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:1623-1638` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1646-1661` | Flow construction | Start building a flow with the given id. |
 | `FlowAction` | class | `dist/core/node-classes.d.ts:162-168` | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
 | `FlowActionSpec` | type | `dist/flow-sdk.d.ts:53-54` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:1500-1577` | Supporting types | Every action kind, keyed by kind, to the body of its spec — the arm's fields other than `kind`. |
-| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1259-1622` | Builders | 15 member(s) |
-| `FlowLayout` | interface | `dist/flow-sdk.d.ts:710-723` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1282-1645` | Builders | 15 member(s) |
+| `FlowLayout` | interface | `dist/flow-sdk.d.ts:717-730` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:126-161` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:176-183` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
 | `FlowTrigger` | class | `dist/core/node-classes.d.ts:169-175` | Supporting types | A node that starts the flow — pass an instance to `.trigger(…)`. |
@@ -184,12 +184,12 @@ could hand you spans for a version you do not have.
 | `lookupSpecOf` | function | `dist/core/lookups.d.ts:199-206` | Generated descriptors | The LookupSpec for one field, or `undefined` when it earns no helper. |
 | `LookupStrategy` | type | `dist/core/lookups.d.ts:1-10` | Generated descriptors | How `prepare` should retrieve the collection, chosen from the metadata. |
 | `LookupToken` | interface | `dist/core/lookups.d.ts:37-52` | Generated descriptors | An unresolved lookup: what `.byEmail(…)` returns. |
-| `LoopOptions` | interface | `dist/flow-sdk.d.ts:478-502` | Option shapes | Loop-specific options. |
+| `LoopOptions` | interface | `dist/flow-sdk.d.ts:485-509` | Option shapes | Loop-specific options. |
 | `manual` | function | `dist/flow-sdk.d.ts:181-190` | Flow construction | The manual trigger, explicitly. |
 | `McpToolRef` | interface | `dist/core/actions.d.ts:1135-1163` | Supporting types | An MCP server the agent may call tools on. |
 | `mock` | function | `dist/nodes/mock/flow/factories.d.ts:6-45` | Actions | Declare a PLACEHOLDER step — "a real node goes here later". |
 | `NodeContribution` | interface | `dist/core/node-classes.d.ts:102-125` | Supporting types | One validated construct, returned by FlowNode.contribute. |
-| `NodeLayout` | interface | `dist/flow-sdk.d.ts:633-647` | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
+| `NodeLayout` | interface | `dist/flow-sdk.d.ts:640-654` | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
 | `NodeOptions` | interface | `dist/flow-sdk.d.ts:391-444` | Option shapes | Options shared by every builder method that creates a definition-backed node: `version` selects the exact node… |
 | `onEvent` | function | `dist/flow-sdk.d.ts:191-229` | Flow construction | Start the flow when a connector event fires — e.g. an email arriving in a mailbox folder. |
 | `onEvent` | function | `dist/flow-sdk.d.ts:230-237` | Flow construction | Stringly form, for an event with no prepared module. |
@@ -212,7 +212,7 @@ could hand you spans for a version you do not have.
 | `resolvedValue` | function | `dist/core/lookups.d.ts:172-179` | Generated descriptors | The recorded id for a token, or `undefined`. |
 | `resolveEventWhere` | function | `dist/core/lookups.d.ts:207-224` | Generated descriptors | An event subscription's `where` with every lookup token swapped for the id `registry prepare --resolve` recorded, or a… |
 | `ReturnFieldType` | type | `dist/core/actions.d.ts:736-753` | Supporting types | A JSON-schema-ish type for one field of a step's declared `returns`. |
-| `ReturnOptions` | interface | `dist/flow-sdk.d.ts:445-477` | Option shapes | `.return(...)`-specific options. |
+| `ReturnOptions` | interface | `dist/flow-sdk.d.ts:445-484` | Option shapes | `.return(...)`-specific options. |
 | `rpaWorkflow` | function | `dist/core/actions.d.ts:1670-1714` | Actions | Invoke a deployed RPA (robotic process automation) workflow — a classic UI-automation process, published to… |
 | `RpaWorkflowInputs` | interface | `dist/core/actions.d.ts:409-467` | Option shapes | 7 field(s) |
 | `SCHEDULE_PRESETS` | const | `dist/flow-sdk.d.ts:128-135` | Flow construction | The eight intervals the designer offers in its Frequency dropdown. |
@@ -227,12 +227,12 @@ could hand you spans for a version you do not have.
 | `sendMessage` | function | `dist/nodes/conversation/flow/factories.d.ts:8-26` | Actions | Post an assistant message into a live conversation (`uipath.conversational.send-message`). |
 | `SendMessageInputs` | interface | `dist/nodes/conversation/flow/spec.d.ts:8-27` | Option shapes | 4 field(s) |
 | `ShownField` | interface | `dist/core/actions.d.ts:105-125` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
-| `Step` | type | `dist/flow-sdk.d.ts:513-632` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:785-1234` | Builders | Collects a sequence of steps. |
-| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:663-668` | Flow construction | The designer's sticky-note palette. |
-| `StickyNote` | interface | `dist/flow-sdk.d.ts:675-709` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
-| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:669-674` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1639-1678` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `Step` | type | `dist/flow-sdk.d.ts:520-639` | Supporting types |  |
+| `StepList` | class | `dist/flow-sdk.d.ts:792-1257` | Builders | Collects a sequence of steps. |
+| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:670-675` | Flow construction | The designer's sticky-note palette. |
+| `StickyNote` | interface | `dist/flow-sdk.d.ts:682-716` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
+| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:676-681` | Supporting types | A sticky note's swatch. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1662-1701` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:45-52` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:8-48` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:8-40` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -66,7 +66,7 @@ not find it either.
 | `app` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1337-1338` |
 | `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-175` |
 | `appVersion` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1339-1340` |
-| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1247` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1270` |
 | `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:984-1002` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:991-1009` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1119-1128` |
-| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:510-511` |
-| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:497-501` |
+| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1126-1135` |
+| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:517-518` |
+| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:504-508` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3483-3488` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1269-1274` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1615-1621` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1638-1644` |
 | `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` |
@@ -126,13 +126,13 @@ not find it either.
 | `code` | property | `ErrorDecl` | `dist/bpmn/bpmn-sdk.d.ts:439-440` |
 | `code` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:299-307` |
 | `code` | property | `ScriptInputs` | `dist/nodes/script/flow/spec.d.ts:8-9` |
-| `collapsed` | property | `NodeLayout` | `dist/flow-sdk.d.ts:645-646` |
+| `collapsed` | property | `NodeLayout` | `dist/flow-sdk.d.ts:652-653` |
 | `collection` | property | `LoopSpec` | `dist/bpmn/bpmn-sdk.d.ts:79-80` |
 | `collection` | property | `TransformInputs` | `dist/nodes/transform/flow/spec.d.ts:85-95` |
-| `color` | property | `StickyNote` | `dist/flow-sdk.d.ts:699-700` |
+| `color` | property | `StickyNote` | `dist/flow-sdk.d.ts:706-707` |
 | `completeWhen` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1249-1259` |
 | `completion` | property | `LoopSpec` | `dist/bpmn/bpmn-sdk.d.ts:85-86` |
-| `completionCondition` | property | `LoopOptions` | `dist/flow-sdk.d.ts:492-496` |
+| `completionCondition` | property | `LoopOptions` | `dist/flow-sdk.d.ts:499-503` |
 | `condition` | property | `BpmnFlow` | `dist/bpmn/bpmn-sdk.d.ts:350-351` |
 | `condition` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:314-320` |
 | `condition` | property | `FilterRule` | `dist/nodes/transform/flow/spec.d.ts:15` |
@@ -164,7 +164,7 @@ not find it either.
 | `connectorKey` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1184-1190` |
 | `connectorKey` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:366-367` |
 | `content` | property | `SendMessageInputs` | `dist/nodes/conversation/flow/spec.d.ts:20-21` |
-| `content` | property | `StickyNote` | `dist/flow-sdk.d.ts:697-698` |
+| `content` | property | `StickyNote` | `dist/flow-sdk.d.ts:704-705` |
 | `contentType` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:36` |
 | `context` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1526-1527` |
 | `context` | property | `ConversationalAgentSettings` | `dist/core/actions.d.ts:179-180` |
@@ -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:1129-1143` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1136-1150` |
 | `contribute` | method | `FlowNode` | `dist/core/node-classes.d.ts:144-153` |
 | `conversationalAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1536-1539` |
 | `conversationContext` | property | `FlowActionSpecs` | `dist/nodes/conversation/flow/spec.d.ts:55-58` |
@@ -207,13 +207,13 @@ not find it either.
 | `defaultOf` | property | `PendingExit` | `dist/bpmn/bpmn-sdk.d.ts:1924-1925` |
 | `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:763-768` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1476-1516` |
+| `definitions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:770-775` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1499-1539` |
 | `delay` | property | `FlowActionSpecs` | `dist/nodes/delay/flow/spec.d.ts:38-41` |
 | `dependsOn` | property | `LookupSpec` | `dist/core/lookups.d.ts:34-35` |
 | `description` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1244` |
 | `description` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:633` |
-| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:740-741` |
+| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:747-748` |
 | `description` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:1264-1265` |
 | `description` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:825` |
 | `description` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:525` |
@@ -225,7 +225,7 @@ not find it either.
 | `description` | property | `CustomGuardrail` | `dist/core/actions.d.ts:812` |
 | `description` | property | `EscalationRef` | `dist/core/actions.d.ts:1406-1407` |
 | `description` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:241` |
-| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1285-1292` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1308-1315` |
 | `description` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1211` |
 | `description` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:394-401` |
 | `description` | property | `IxpToolRef` | `dist/core/actions.d.ts:1384-1385` |
@@ -267,12 +267,12 @@ 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:1094-1118` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1101-1125` |
 | `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` |
 | `dynamicFewShotLearning` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1247-1248` |
-| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:721-722` |
+| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:728-729` |
 | `element` | property | `PlainTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1619-1620` |
 | `element` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:80-81` |
 | `elementId` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:378-385` |
@@ -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:1351-1401` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1374-1424` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
-| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:769-770` |
+| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:776-777` |
 | `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:793-818` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:800-825` |
 | `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` |
@@ -417,7 +417,7 @@ not find it either.
 | `headers` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1138-1139` |
 | `headers` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1216-1220` |
 | `height` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:606-607` |
-| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:707-708` |
+| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:714-715` |
 | `hidden` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:27` |
 | `hidden` | property | `RegistryInputField` | `dist/bpmn/typed-node.d.ts:61` |
 | `hitl` | property | `FlowActionSpecs` | `dist/nodes/hitl/flow/spec.d.ts:293-296` |
@@ -433,8 +433,8 @@ not find it either.
 | `id` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:368-369` |
 | `id` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:491-492` |
 | `id` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:624` |
-| `id` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:726-727` |
-| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:738` |
+| `id` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:733-734` |
+| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:745` |
 | `id` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:821-822` |
 | `id` | property | `CaseAppSection` | `dist/case/case-sdk.d.ts:576-577` |
 | `id` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1475-1480` |
@@ -450,7 +450,7 @@ not find it either.
 | `id` | property | `PinnedFlowId` | `dist/bpmn/bpmn-sdk.d.ts:1630-1631` |
 | `id` | property | `SchemaEntry` | `dist/bpmn/bpmn-sdk.d.ts:1001-1002` |
 | `id` | property | `ShownField` | `dist/core/actions.d.ts:107-108` |
-| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:687-696` |
+| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:694-703` |
 | `id` | property | `SwitchArm` | `dist/flow-sdk.d.ts:369-375` |
 | `id` | property | `VarEntry` | `dist/bpmn/bpmn-sdk.d.ts:992-993` |
 | `identifier` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:634` |
@@ -462,7 +462,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1548-1551` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1556-1568` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1579-1591` |
 | `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` |
@@ -475,8 +475,8 @@ not find it either.
 | `inputs` | property | `AgentInputs` | `dist/core/actions.d.ts:680-697` |
 | `inputs` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:481-485` |
 | `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:176-184` |
-| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:732-733` |
-| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:750` |
+| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:739-740` |
+| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:757` |
 | `inputs` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:516-517` |
 | `inputs` | property | `ClientSideToolRef` | `dist/core/actions.d.ts:1196-1197` |
 | `inputs` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:399-400` |
@@ -535,7 +535,7 @@ not find it either.
 | `kind` | property | `SubflowSpec` | `dist/flow-sdk.d.ts:47` |
 | `kind` | property | `WhenExpression` | `dist/case/case-sdk.d.ts:99-100` |
 | `kValue` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1251-1252` |
-| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1248-1257` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1271-1280` |
 | `label` | property | `AskedField` | `dist/core/actions.d.ts:130-131` |
 | `label` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:523` |
 | `label` | property | `FormFieldOption` | `dist/core/actions.d.ts:102-103` |
@@ -548,12 +548,12 @@ not find it either.
 | `labels` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:228-229` |
 | `lanes` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:527` |
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:646-647` |
-| `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:759-760` |
+| `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:766-767` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1293-1303` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1316-1326` |
 | `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:508-509` |
+| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:515-516` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
 | `location` | property | `AgenticProcessInputsBase` | `dist/core/actions.d.ts:550-560` |
 | `location` | property | `AgentInputs` | `dist/core/actions.d.ts:656-661` |
@@ -561,7 +561,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:1082-1093` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1089-1100` |
 | `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` |
@@ -630,7 +630,7 @@ not find it either.
 | `name` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:370-371` |
 | `name` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:493-494` |
 | `name` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:625` |
-| `name` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:739` |
+| `name` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:746` |
 | `name` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:824` |
 | `name` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:501-502` |
 | `name` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:198-199` |
@@ -650,7 +650,7 @@ not find it either.
 | `name` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1840-1841` |
 | `name` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:240` |
 | `name` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1499-1500` |
-| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1277-1284` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1300-1307` |
 | `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` |
@@ -678,7 +678,7 @@ not find it either.
 | `name` | property | `RegistryOutput` | `dist/bpmn/typed-node.d.ts:72` |
 | `name` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:1171-1172` |
 | `name` | property | `ResolvedEventTriggerOpts` | `dist/case/case-sdk.d.ts:266-267` |
-| `name` | property | `ReturnOptions` | `dist/flow-sdk.d.ts:460-476` |
+| `name` | property | `ReturnOptions` | `dist/flow-sdk.d.ts:460-483` |
 | `name` | property | `RpaWorkflowInputs` | `dist/core/actions.d.ts:421-422` |
 | `name` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:844-845` |
 | `name` | property | `SplitOpts` | `dist/bpmn/bpmn-sdk.d.ts:1830-1831` |
@@ -695,7 +695,7 @@ not find it either.
 | `name` | property | `VarDecl` | `dist/flow-sdk.d.ts:60` |
 | `name` | property | `VarOpts` | `dist/bpmn/bpmn-sdk.d.ts:1644-1645` |
 | `nodes` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:503-504` |
-| `nodes` | property | `FlowLayout` | `dist/flow-sdk.d.ts:719-720` |
+| `nodes` | property | `FlowLayout` | `dist/flow-sdk.d.ts:726-727` |
 | `nodes` | property | `ScopeStorage` | `dist/bpmn/bpmn-sdk.d.ts:1935-1936` |
 | `nodeType` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:62` |
 | `nodeType` | property | `LookupResolution` | `dist/core/lookups.d.ts:162` |
@@ -712,13 +712,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:873-933` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:880-940` |
 | `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:778-783` |
-| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1517-1555` |
+| `openTails` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:785-790` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1540-1578` |
 | `operation` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:37` |
 | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1287-1288` |
 | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:368-369` |
@@ -726,7 +726,7 @@ not find it either.
 | `operator` | property | `DataFabricFilter` | `dist/nodes/data-fabric/flow/spec.d.ts:29-30` |
 | `options` | property | `ActionField` | `dist/case/case-sdk.d.ts:445-449` |
 | `options` | property | `AskedField` | `dist/core/actions.d.ts:134-138` |
-| `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:730-731` |
+| `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:737-738` |
 | `options` | property | `InOutField` | `dist/core/actions.d.ts:155-159` |
 | `options` | property | `ShownField` | `dist/core/actions.d.ts:113-117` |
 | `or` | property | `DataFabricFilter` | `dist/nodes/data-fabric/flow/spec.d.ts:38-50` |
@@ -735,7 +735,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1452-1457` |
 | `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:211-225` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1569-1604` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1592-1627` |
 | `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` |
@@ -744,7 +744,7 @@ not find it either.
 | `outputRows` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:909-918` |
 | `outputs` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:464-465` |
 | `outputs` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1564-1565` |
-| `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:751` |
+| `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:758` |
 | `outputs` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:518-519` |
 | `outputs` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1483-1493` |
 | `outputs` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:248-262` |
@@ -770,8 +770,8 @@ not find it either.
 | `pageRange` | property | `DocumentClassifyInputs` | `dist/nodes/document/flow/spec.d.ts:12-13` |
 | `pageRange` | property | `DynamicExtractInputs` | `dist/nodes/document/flow/spec.d.ts:49-50` |
 | `pageRange` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:383-384` |
-| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:490-491` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1046-1081` |
+| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:497-498` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1053-1088` |
 | `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` |
@@ -790,7 +790,7 @@ not find it either.
 | `pinnedFlowIds` | property | `SugarRegistry` | `dist/bpmn/bpmn-sdk.d.ts:1951-1958` |
 | `plainTask` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2302-2331` |
 | `position` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:592-596` |
-| `position` | property | `NodeLayout` | `dist/flow-sdk.d.ts:635-639` |
+| `position` | property | `NodeLayout` | `dist/flow-sdk.d.ts:642-646` |
 | `preservation` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:511-512` |
 | `preserve` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3332-3347` |
 | `priority` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:453` |
@@ -870,7 +870,7 @@ not find it either.
 | `retry` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:830-831` |
 | `retryable` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:308-309` |
 | `retryCount` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:109-123` |
-| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1224-1233` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1247-1256` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
 | `returns` | property | `AgentInputs` | `dist/core/actions.d.ts:698-717` |
 | `returns` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:486-498` |
@@ -886,7 +886,7 @@ not find it either.
 | `role` | property | `FlowNode` | `dist/core/node-classes.d.ts:142-143` |
 | `role` | property | `FlowResource` | `dist/core/node-classes.d.ts:181-182` |
 | `role` | property | `FlowTrigger` | `dist/core/node-classes.d.ts:173-174` |
-| `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:656-661` |
+| `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:663-668` |
 | `rpa` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:751-760` |
 | `rpaWorkflow` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1512-1515` |
 | `rule` | property | `CaseRule` | `dist/case/case-sdk.d.ts:80` |
@@ -909,9 +909,9 @@ not find it either.
 | `schemas` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3433-3443` |
 | `schemas` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:509-510` |
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
-| `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:743-749` |
+| `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:750-756` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1436-1475` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1459-1498` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:758` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -937,7 +937,7 @@ not find it either.
 | `severity` | property | `ContributionDiagnostic` | `dist/core/node-classes.d.ts:31-32` |
 | `shared` | property | `VarDecl` | `dist/flow-sdk.d.ts:69-70` |
 | `shared` | property | `VarSpec` | `dist/flow-sdk.d.ts:94-126` |
-| `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:640-644` |
+| `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:647-651` |
 | `skip` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:515` |
 | `skip` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:101-102` |
 | `skipCondition` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1598-1599` |
@@ -983,16 +983,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:819-829` |
-| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:734-735` |
-| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:753` |
-| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:787` |
-| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:830-872` |
-| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:947-975` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1175-1203` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1204-1223` |
-| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:761-762` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1304-1329` |
+| `step` | method | `StepList` | `dist/flow-sdk.d.ts:826-836` |
+| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:741-742` |
+| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:760` |
+| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:794` |
+| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:837-879` |
+| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:954-982` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1182-1225` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1226-1246` |
+| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:768-769` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1327-1352` |
 | `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` |
@@ -1005,7 +1005,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:1003-1045` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:1010-1052` |
 | `systemPrompt` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:191-196` |
 | `systemPrompt` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:871-920` |
 | `systemPrompt` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:278-283` |
@@ -1030,7 +1030,7 @@ not find it either.
 | `temperature` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:981-982` |
 | `temperature` | property | `VoiceSettings` | `dist/core/actions.d.ts:270-271` |
 | `terminate` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:692-693` |
-| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1144-1174` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1151-1181` |
 | `threshold` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1495-1496` |
 | `timeCycle` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:201-202` |
 | `timeout` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:91-108` |
@@ -1050,16 +1050,16 @@ not find it either.
 | `tools` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1072-1094` |
 | `transform` | property | `FlowActionSpecs` | `dist/nodes/transform/flow/spec.d.ts:111-114` |
 | `transformation` | property | `FieldMapping` | `dist/nodes/transform/flow/spec.d.ts:30-31` |
-| `trigger` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:728-729` |
-| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:754-756` |
+| `trigger` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:735-736` |
+| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:761-763` |
 | `trigger` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1224-1232` |
 | `trigger` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:128-129` |
-| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1330-1350` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1353-1373` |
 | `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:771-777` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1402-1421` |
-| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:757-758` |
+| `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:778-784` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1425-1444` |
+| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:764-765` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
 | `type` | property | `ActionField` | `dist/case/case-sdk.d.ts:435-436` |
@@ -1115,7 +1115,7 @@ not find it either.
 | `value` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:205-206` |
 | `values` | property | `DataFabricCreateInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:132-137` |
 | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1199-1223` |
-| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1605-1614` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1628-1637` |
 | `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` |
@@ -1125,12 +1125,12 @@ not find it either.
 | `variant` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:187-191` |
 | `variant` | property | `TransformInputs` | `dist/nodes/transform/flow/spec.d.ts:96-105` |
 | `vars` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:640` |
-| `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:752` |
+| `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:759` |
 | `vars` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3086-3111` |
 | `vars` | property | `ScopeStorage` | `dist/bpmn/bpmn-sdk.d.ts:1939-1940` |
 | `varSchema` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:257-271` |
 | `version` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:626-632` |
-| `version` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:742` |
+| `version` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:749` |
 | `version` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1057-1067` |
 | `version` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1435-1436` |
 | `version` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:63` |
@@ -1138,7 +1138,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1289-1290` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2173` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1422-1435` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1445-1458` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:397-404` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2130-2131` |
@@ -1155,13 +1155,13 @@ not find it either.
 | `waitForEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2688-2729` |
 | `waitForMessage` | property | `FlowActionSpecs` | `dist/nodes/conversation/flow/spec.d.ts:51-54` |
 | `waitForTimer` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:877-883` |
-| `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:650-655` |
+| `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:657-662` |
 | `when` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:176-182` |
 | `when` | property | `SwitchArm` | `dist/flow-sdk.d.ts:362-367` |
 | `where` | property | `EventSubscription` | `dist/core/actions.d.ts:2139-2157` |
 | `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:2092-2109` |
 | `width` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:604-605` |
-| `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:705-706` |
-| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:701-702` |
-| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:703-704` |
+| `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:712-713` |
+| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:708-709` |
+| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:710-711` |
 | `zIndex` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:608-609` |

package/dist/check.js

@@ -26,6 +26,7 @@ import { compareSchemaVersions, schemaVersionRefusal } from './schema-version.js
 import { planFlowGlobals, planSharedInputs, sharedInputRoots } from './flow-variables.js';
 import { planOutputBacking } from './flow-output-backing.js';
 import { ownEntry } from './core/own-entry.js';
+import { endContentKey } from './flow-end-content.js';
 import { FLOW_NODE_TYPES } from './flow-node-registry.js';
 import { stepExits } from './flow-step-exits.js';
 import { plainHttpOnErrorMessage } from './nodes/http/flow/family.js';
@@ -4558,21 +4559,64 @@ function checkStepRefs(built, diags) {
     const scopeOf = new Map();
     /** Step name → the parallel arm it lives in, as `<parallel>#<index>`. */
     const armOf = new Map();
+    /**
+     * 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
+     * path that runs into the main path's End is one End with two incoming edges,
+     * which the product accepts and the canvas draws. Counted so a ref to a name
+     * two nodes share is refused rather than wired to whichever came first.
+     */
+    const endNames = new Map();
+    /**
+     * Per scope and End name, the content of each distinct `.return` asking for it.
+     * Two `.return`s with the same name AND the same values, label, version and
+     * updates are one End reached from two paths (serialize joins them); only a
+     * repeat that differs is a second End. Keyed by `endContentKey`, the key
+     * serialize joins on, so the two cannot disagree.
+     */
+    const endContents = new Map();
+    const stepNamesSeen = new Set();
     let seq = 0;
     const index = (steps, portList, scope, arm) => {
         for (const s of steps) {
-            if ('name' in s && s.kind !== 'return') {
-                if (!order.has(s.name))
-                    order.set(s.name, seq);
-                if (portList)
-                    inPortList.add(s.name);
-                scopeOf.set(s.name, scope);
-                if (arm)
-                    armOf.set(s.name, arm);
+            // A `return`'s own `name` is synthetic; its End is named by `options.name`.
+            const name = s.kind === 'return' ? s.options?.name : 'name' in s ? s.name : undefined;
+            if (name !== undefined) {
+                if (s.kind === 'return') {
+                    const key = JSON.stringify([scope, name]);
+                    const content = endContentKey(s);
+                    const seen = endContents.get(key) ?? endContents.set(key, new Set()).get(key);
+                    if (!seen.has(content)) {
+                        seen.add(content);
+                        endNames.set(name, (endNames.get(name) ?? 0) + 1);
+                    }
+                }
+                else
+                    stepNamesSeen.add(name);
+                // Exactly the step rule from before, for steps. A named End only fills a
+                // name nothing has claimed; a clash is REF_AMBIGUOUS_TARGET below.
+                if (s.kind !== 'return' || !order.has(name)) {
+                    if (!order.has(name))
+                        order.set(name, seq);
+                    if (portList)
+                        inPortList.add(name);
+                    scopeOf.set(name, scope);
+                    if (arm)
+                        armOf.set(name, arm);
+                }
             }
             seq++;
             if (s.kind === 'stepToList')
                 index(s.body, true, scope, arm);
+            // A `.stepSwitch` routes EVERY declared exit, as `.switch` routes every
+            // case, so its arms are not side paths: they inherit `portList`, as a
+            // `.switch` case does. So a ref into a step of an arm is legal from another
+            // arm AND from outside the `.stepSwitch` (before #1231 an arm step was not
+            // indexed, so a ref from outside was REF_UNKNOWN_TARGET even though
+            // serialize wired it). Walked so their Ends count toward DUP_END_NAME and
+            // are ref targets (#1231).
+            else if (s.kind === 'stepSwitch')
+                s.cases.forEach((c) => index(c.body, portList, scope, arm));
             else if (s.kind === 'branch') {
                 index(s.then, portList, scope, arm);
                 index(s.otherwise, portList, scope, arm);
@@ -4589,12 +4633,31 @@ function checkStepRefs(built, diags) {
         }
     };
     index(built.steps, false, '', undefined);
+    // An entry-point prefix is a path of its own that may end at the shared body's
+    // End, so its Ends count toward the duplicate-name rule below (#1231).
+    for (const ep of built.entryPoints ?? [])
+        index(ep.steps, false, '', undefined);
+    // Two `.return`s asking for the same End name with different content are two
+    // End nodes, which compile refuses rather than renaming the second `<name>2`
+    // (#1231). One End shared by several paths is spelled once, with every other
+    // path ending at it by `.stepToRef('<name>')`, or repeated identically.
+    for (const [name, count] of endNames) {
+        if (count < 2)
+            continue;
+        diags.push({
+            level: 'error', code: 'DUP_END_NAME', step: name,
+            message: `${count} different \`.return({}, { name: '${name}' })\` calls ask for the same End (their values, label, `
+                + `version or updates differ, or they sit in different scopes), so they would be ${count} End nodes with one id. `
+                + `To end several paths at one End, keep one \`.return({}, { name: '${name}' })\` and end the other paths with `
+                + `\`.stepToRef('${name}')\`; to have separate Ends, give each its own name.`,
+        });
+    }
     /** Every ref, with where it sits. */
     const found = [];
     const collect = (steps, from, scope, arm, enclosing = []) => {
         let source = from;
         for (const [i, s] of steps.entries()) {
-            if (s.kind === 'action')
+            if (s.kind === 'action' || s.kind === 'stepSwitch')
                 source = s.name;
             if (s.kind === 'stepToRef') {
                 found.push({
@@ -4607,6 +4670,8 @@ function checkStepRefs(built, diags) {
             }
             if (s.kind === 'stepToList')
                 collect(s.body, source, scope, arm, enclosing);
+            else if (s.kind === 'stepSwitch')
+                s.cases.forEach((c) => collect(c.body, s.name, scope, arm, enclosing));
             else if (s.kind === 'branch') {
                 collect(s.then, source, scope, arm, enclosing);
                 collect(s.otherwise, source, scope, arm, enclosing);
@@ -4622,6 +4687,8 @@ function checkStepRefs(built, diags) {
         }
     };
     collect(built.steps, undefined, '', undefined);
+    for (const ep of built.entryPoints ?? [])
+        collect(ep.steps, ep.id, '', undefined);
     for (const { target, from, after, scope, arm, enclosing } of found) {
         const where = from ? `after "${from}"` : 'at the start of the flow';
         const say = (level, code, message, suggestion) => {
@@ -4630,9 +4697,28 @@ function checkStepRefs(built, diags) {
         if (!order.has(target)) {
             const near = [...order.keys()].find((n) => n.toLowerCase() === target.toLowerCase());
             say('error', 'REF_UNKNOWN_TARGET', `.stepToRef('${target}') ${where} names a step this flow does not have`
-                + `${near ? ` (did you mean "${near}"?)` : ''}. It takes the same name you passed to .step().`, near ? `.stepToRef('${near}')` : undefined);
+                + `${near ? ` (did you mean "${near}"?)` : ''}. It takes the same name you passed to .step(), or the `
+                + `\`name\` of a \`.return({}, { name })\` End.`, near ? `.stepToRef('${near}')` : undefined);
+            continue;
+        }
+        const ends = endNames.get(target) ?? 0;
+        // Two Ends sharing the name are DUP_END_NAME above, reported once whether or
+        // not a ref names them; this is the step-and-End clash.
+        if (ends > 1)
+            continue;
+        if (ends > 0 && stepNamesSeen.has(target)) {
+            say('error', 'REF_AMBIGUOUS_TARGET', `.stepToRef('${target}') ${where} names both a step and an End called "${target}", so it is not clear which `
+                + `one the path should go to. Give the \`.return({}, { name })\` a name no step uses.`);
             continue;
         }
+        /**
+         * The target is an End and nothing else. An End has no "runs only when its
+         * port fired" meaning past itself: it ends the run, whichever path arrives.
+         * So a ref into an End that sits inside another port's path (two HTTP
+         * branches, two outcomes, a prefix and a branch, all ending at one End) is
+         * the product's own shape, one End with several incoming edges (#1231).
+         */
+        const endOnly = ends > 0;
         // A ref to a container the path is INSIDE names it as a step, so the edge
         // enters it from its outer input: it starts the loop over from its first
         // item, while the iteration the path was in never finishes. What the author
@@ -4643,10 +4729,10 @@ function checkStepRefs(built, diags) {
                 + `next iteration, or .break() to leave the loop.`, '.continue()');
             continue;
         }
-        if (inPortList.has(target)) {
+        if (inPortList.has(target) && !endOnly) {
             say('error', 'REF_INTO_PORT_LIST', `.stepToRef('${target}') ${where} targets a step inside another port's path. That path runs only when ITS `
                 + `port fired — it is not somewhere another edge can jump into. Point at a step on the main path, or end `
-                + `this one with .return() / .terminate().`);
+                + `this one with .return() / .terminate(). (A named End is the exception: any path may end there.)`);
             continue;
         }
         const targetScope = scopeOf.get(target) ?? '';

package/dist/decompile.js

@@ -1910,6 +1910,17 @@ function emitTrigger(e, depth, trigger, imp, o, inputNames = new Set()) {
 // and loop bodies. Non-reducible / non-reconverging graphs fall back to a marker
 // rather than a hard failure (a validating flow must still yield usable code).
 const EXIT = '#EXIT#';
+/**
+ * Every End more than one edge enters. A second path can reach one after its
+ * `.return(...)` is already written, and that path then ends there with a
+ * `.stepToRef` (#1231). Only a NAMED End is a ref target, so these are named up
+ * front (`Ctx.refTargets`), the default id `end` included.
+ */
+function sharedEnds(flow, graph) {
+    return new Set((flow.nodes ?? [])
+        .filter((n) => n.type === T.end && graph.inEdges(n.id).length > 1)
+        .map((n) => n.id));
+}
 /** The node ids in a scope: the `parentId` group (root scope = no `parentId`). */
 function scopeIds(nodes, parentId) {
     return new Set(nodes.filter((n) => (n.parentId ?? undefined) === parentId).map((n) => n.id));
@@ -2282,7 +2293,7 @@ function armCb(param, segs) {
 function returnSeg(node, ctx) {
     const updates = ctx.flow.variables?.variableUpdates?.[node.id] ?? [];
     const outputIds = new Set(readFlowGlobals(ctx.flow.variables).filter((g) => g.direction === 'out').map((g) => g.id));
-    const opts = returnOptsArg(node);
+    const opts = returnOptsArg(node, ctx.refTargets?.has(node.id) ?? false);
     const entries = updates.map((u) => `${key(u.variableId)}: ${emitVal(u.expression, ctx.imp, ctx.inputNames)}`);
     const written = new Set(updates.map((u) => u.variableId));
     for (const [name, out] of Object.entries(node.outputs ?? {})) {
@@ -2323,9 +2334,10 @@ function isIdentityEndSource(raw, name, isOutput = false) {
  * it — compile then refused its own decompiled source with `layout: "endNiceDay"
  * names no step or node in this flow`.
  */
-function returnOptsArg(node) {
+function returnOptsArg(node, referenced = false) {
     const parts = [];
-    if (node.id !== 'end')
+    // A `.stepToRef` into this End needs it named, `end` included (#1223).
+    if (node.id !== 'end' || referenced)
         parts.push(`name: ${tsLiteral(node.id)}`);
     const ver = verClause(node);
     if (ver)
@@ -2371,7 +2383,12 @@ function region(cursor, stop, scope, ipdom, ctx, refInto) {
     const segs = [];
     while (cursor !== undefined && cursor !== stop && cursor !== EXIT) {
         // A ref forward: this path re-enters a step the main path reaches later.
+        // That includes the main path's End: one End with several incoming edges is
+        // a valid flow (the canvas draws it, `edge add` writes it), and a named End is
+        // a ref target, so the side path joins it instead of minting a second End
+        // (#1223). The main path's `.return(...)` then carries the End's `name`.
         if (refInto?.has(cursor)) {
+            (ctx.refTargets ??= new Set()).add(cursor);
             segs.push(`.stepToRef(${tsLiteral(cursor)})`);
             return segs;
         }
@@ -2380,10 +2397,17 @@ function region(cursor, stop, scope, ipdom, ctx, refInto) {
             break;
         // A ref backward or sideways: this path has arrived somewhere already emitted.
         // Before, the walk simply stopped here — which silently dropped the rest of a
-        // cycle, and a backward edge is now something the builder can author. Ends and
-        // terminates are excluded: they are not named steps, so there is nothing a ref
-        // could resolve against, and each path emitting its own is already correct.
-        if (ctx.emitted.has(cursor) && node.type !== T.end && node.type !== T.terminate) {
+        // cycle, and a backward edge is now something the builder can author.
+        //
+        // That includes an End another path already ended at (#1231): two HTTP
+        // branches, two outcomes, or an entry-point prefix and a branch that all run
+        // into ONE End. A second `.return(...)` there compiled to a second End
+        // (`<id>2`); a ref names the one End. `decompile()` seeded `ctx.refTargets`
+        // with every End more than one edge enters, so the `.return(...)` emitted
+        // first already carries the End's `name` (only a named End is a ref target).
+        // Terminates are still excluded: each path emitting its own is a valid flow.
+        if (ctx.emitted.has(cursor) && node.type !== T.terminate
+            && (node.type !== T.end || ctx.refTargets?.has(cursor))) {
             segs.push(`.stepToRef(${tsLiteral(cursor)})`);
             return segs;
         }
@@ -3072,6 +3096,7 @@ function emitChildFlow(name, child, ctx) {
         emitted: new Set(),
         o: ctx.o,
     };
+    childCtx.refTargets = sharedEnds(child, childCtx.graph);
     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()');
@@ -3316,7 +3341,9 @@ export function decompile(flow, options = {}) {
     }
     emitVariables(e, d, flow, imp, new Set(triggerNodes.filter((t) => t !== trigger).map((t) => t.id)), shared);
     // Reconstruct the body: structured control flow recovered from the graph.
-    const ctx = { graph, flow, imp, inputNames, o: options, emitted: new Set(), shared };
+    const ctx = {
+        graph, flow, imp, inputNames, o: options, emitted: new Set(), shared, refTargets: sharedEnds(flow, graph),
+    };
     const scope = scopeIds(flow.nodes ?? [], undefined);
     const startId = trigger?.id ?? 'start';
     // Walked from the trigger's successors together: a `.parallel` placed first

package/dist/flow-end-content.d.ts

@@ -0,0 +1,16 @@
+import { type Expr } from './core/expr.js';
+import type { ReturnOptions } from './flow-sdk.js';
+/**
+ * What makes two `.return({}, { name })` calls the SAME End: their values,
+ * label, version and updates, in the source form serialize writes. Two calls
+ * with one name and one key are one End reached from two paths; a repeat with
+ * a different key is DUP_END_NAME (#1231).
+ *
+ * `check` and `serialize` both key on this, so they cannot disagree about which
+ * repeats join (#1238 review). An empty `updates` is the same as none: both
+ * write no update.
+ */
+export declare function endContentKey(step: {
+    values: Record<string, Expr>;
+    options?: ReturnOptions;
+}): string;

package/dist/flow-end-content.js

@@ -0,0 +1,25 @@
+import { toExpr } from './core/expr.js';
+/** The source form of one value, as the End's mapping or update writes it (before any rename). */
+function source(val) {
+    const e = toExpr(val);
+    return e.literal ? '=js:' + JSON.stringify(e.value) : '=js:' + e.js;
+}
+/**
+ * What makes two `.return({}, { name })` calls the SAME End: their values,
+ * label, version and updates, in the source form serialize writes. Two calls
+ * with one name and one key are one End reached from two paths; a repeat with
+ * a different key is DUP_END_NAME (#1231).
+ *
+ * `check` and `serialize` both key on this, so they cannot disagree about which
+ * repeats join (#1238 review). An empty `updates` is the same as none: both
+ * write no update.
+ */
+export function endContentKey(step) {
+    const o = step.options;
+    return JSON.stringify([
+        Object.entries(step.values).map(([k, v]) => [k, source(v)]),
+        o?.label ?? null,
+        o?.version ?? null,
+        Object.entries(o?.updates ?? {}).map(([k, v]) => [k, source(v)]),
+    ]);
+}

package/dist/flow-sdk.d.ts

@@ -464,8 +464,15 @@ export interface ReturnOptions extends NodeOptions {
      * @remarks
      * Like a step name this is identity, not decoration: use {@link NodeOptions.label}
      * for what the canvas shows. Two Ends in one scope asking for `done` with the
-     * same values, label and version are one End reached from both paths; Ends that
-     * differ are de-duplicated to `done` and `done2`.
+     * same values, label, version and updates are one End reached from both paths.
+     * Two that differ in any of these, or that sit in different scopes (a loop body
+     * and the main path), are refused (`check`: DUP_END_NAME; `compile --no-check`
+     * throws) rather than renamed `done2`.
+     *
+     * A named End is also a {@link StepList.stepToRef} target: another path can
+     * end at this End rather than at one of its own, from anywhere in the flow,
+     * including another port's path (an End runs nothing after itself). `check`
+     * refuses the ref (REF_AMBIGUOUS_TARGET) when a step has the same name.
      *
      * ```ts
      * .branch('checkTemperature', js`${input('tempF')} > 60`,
@@ -1196,7 +1203,22 @@ declare class StepList {
      * can prove it refuses; what depends on the runtime it warns about and leaves to
      * `uip maestro flow validate`.
      *
-     * @param target - The step to continue at, named as it was in `.step(...)`.
+     * The target may also be a NAMED End, `.return({…}, { name })`: the path then
+     * ends at that End node instead of one of its own, so one End has several
+     * incoming edges, as the canvas draws it. Unlike a step, an End inside another
+     * port's path is a valid target: two HTTP branches or two outcomes can end at
+     * one End. To end several paths at one End, spell its `.return` once and end
+     * the other paths with `.stepToRef('<name>')`.
+     *
+     * ```ts
+     * .step('fetch', http({ …, branches: [{ name: 'missing', condition: … }] }))
+     * .stepToList('branch-missing', (b) => b.step('log', script({ … })).stepToRef('done'))
+     * .step('use', script({ … }))
+     * .return({}, { name: 'done' })        // both paths end at this one End
+     * ```
+     *
+     * @param target - The step to continue at, named as it was in `.step(...)`, or
+     * the `name` of a `.return(...)` End.
      * @returns This builder. Nothing may follow: the path has been handed off.
      * @see stepToList
      */
@@ -1216,7 +1238,8 @@ declare class StepList {
      * ```
      *
      * @param port - The port of this step to leave, e.g. `'error'`.
-     * @param target - The step to continue at, named as it was in `.step(...)`.
+     * @param target - The step to continue at, named as it was in `.step(...)`, or
+     * the `name` of a `.return(...)` End.
      * @returns This builder, so calls chain — a side exit ends nothing.
      * @see stepToList
      */

package/dist/flow-sdk.js

@@ -840,7 +840,7 @@ class StepList {
         const target = maybeTarget === undefined ? portOrTarget : maybeTarget;
         if (typeof target !== 'string' || target.length === 0) {
             throw new TypeError(`.stepToRef() takes the NAME of the step to continue at — .stepToRef('priceIt') — and got ${JSON.stringify(target)}. `
-                + `It is the same name you passed to .step(), so the edge can be wired after the whole flow is built.`);
+                + `It is the same name you passed to .step() (or a .return() End's \`name\`), so the edge can be wired after the whole flow is built.`);
         }
         // A non-default port leaves the PRECEDING step, so it is guarded the same way
         // `.stepToList()` is; the default port continues the list and needs no source.

package/dist/serialize.js

@@ -65,6 +65,7 @@ import { resourceNodeSortOrder } from './core/process-resource-sort-order.js';
 import { types } from './core/expr.js';
 import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { ownEntry } from './core/own-entry.js';
+import { endContentKey } from './flow-end-content.js';
 import { jsonClone } from './core/json-clone.js';
 // core-definitions.json is an object keyed by "<nodeType>@<version>".
 const DEFS = BUNDLED_DEFINITIONS;
@@ -3862,6 +3863,7 @@ function newScope(outputs, vars = [], backing = new Map(), backingReads = backin
         stepNodeId: new Map(),
         pendingEdges: [],
         openTails: false,
+        endNodeId: new Map(),
     };
 }
 /**
@@ -3905,6 +3907,7 @@ function newScope(outputs, vars = [], backing = new Map(), backingReads = backin
  */
 /**
  * Wire every parked `.stepToRef('<step>')` edge, now that the whole scope exists.
+ * The target is a step, or else a named End (`.return({}, { name })`, #1223).
  *
  * An unresolved target should be impossible — `check`'s REF_UNKNOWN_TARGET
  * runs first and names the steps that do exist — but a serializer that silently
@@ -3914,10 +3917,12 @@ function newScope(outputs, vars = [], backing = new Map(), backingReads = backin
  */
 function resolveRejoins(scope, addEdge) {
     for (const { from, target } of scope.pendingEdges) {
-        const id = scope.stepNodeId.get(target);
+        const id = scope.stepNodeId.get(target) ?? scope.endNodeId.get(target);
         if (!id) {
+            const ends = [...scope.endNodeId.keys()];
             throw new Error(`.stepToRef('${target}') names a step this flow does not have. Known steps: `
-                + `${[...scope.stepNodeId.keys()].join(', ') || '(none)'}.`);
+                + `${[...scope.stepNodeId.keys()].join(', ') || '(none)'}`
+                + `${ends.length ? `; named Ends: ${ends.join(', ')}` : ''}.`);
         }
         // Through the serializer's own `addEdge`, so the id comes from the one
         // file-wide counter. A per-scope count (`edge_ref_${scope.edges.length}`)
@@ -6492,19 +6497,33 @@ export function serialize(built, opts = {}) {
                 // Decompile writes one `.return` per path into an End that several paths
                 // share, so a repeat of an earlier named End in this scope, with the same
                 // content, is that End reached again rather than a second one.
-                const sig = JSON.stringify([parentId ?? null, step.options?.label ?? null, step.options?.version ?? null, explicit, updates]);
+                // `endContentKey` is the key `check` counts DUP_END_NAME on, so `check`
+                // and `compile --no-check` agree on which repeats join.
+                const sig = JSON.stringify([parentId ?? null, endContentKey(step)]);
                 const prior = name === undefined ? undefined : namedEnds.get(scope)?.get(name);
                 if (prior?.sig === sig) {
                     for (const t of tails)
                         addEdge(scope, t, prior.id);
                 }
                 else {
+                    // A repeat that DIFFERS is refused, not renamed `<name>2`: the rename
+                    // turned one End shared by two paths into two Ends with no word said
+                    // (#1231). `check` reports it first as DUP_END_NAME; this is the
+                    // backstop for `--no-check`.
+                    if (prior) {
+                        throw new Error(`Two .return({}, { name: '${name}' }) calls ask for the same End with different values, label, version, updates or scope. `
+                            + `To end several paths at one End, keep one .return and end the others with .stepToRef('${name}'); `
+                            + `to have separate Ends, give each its own name.`);
+                    }
                     const id = uid(scope, name ?? 'end');
                     emitEnd(scope, id, tails, { label: step.options?.label, parentId, requestedVersion: step.options?.version, explicit });
                     if (updates.length)
                         scope.variableUpdates[id] = updates;
                     if (name !== undefined && !prior) {
                         (namedEnds.get(scope) ?? namedEnds.set(scope, new Map()).get(scope)).set(name, { id, sig });
+                        // A NAMED End can be a `.stepToRef` target (#1223); an unnamed one
+                        // cannot, since its id (`end`, `end2`, …) depends on emission order.
+                        scope.endNodeId.set(name, id);
                     }
                 }
                 tails = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.31.9",
+  "version": "6.32.1",
   "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": "e812e24ab6455bcc1ffeb6f806e9cd0d09cbe389"
+  "gitref": "275e6e4608b243bee96fd531b3228f95261f3b32"
 }