@uipath/maestro-builder-sdk 6.32.2 → 6.32.4

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:1267-1290` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1269-1292` | 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: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) |
+| `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts:733-745` | Supporting types | One additional flow root, built by `.entryPoint()`. |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:746-793` | 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:510-519` | Option shapes | Do-while options. |
+| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:512-521` | 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:655-669` | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
+| `EdgeRoute` | interface | `dist/flow-sdk.d.ts:657-671` | 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:1655-1670` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1657-1672` | 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:1291-1654` | Builders | 15 member(s) |
-| `FlowLayout` | interface | `dist/flow-sdk.d.ts:717-730` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1293-1656` | Builders | 15 member(s) |
+| `FlowLayout` | interface | `dist/flow-sdk.d.ts:719-732` | 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:485-509` | Option shapes | Loop-specific options. |
+| `LoopOptions` | interface | `dist/flow-sdk.d.ts:487-511` | 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:640-654` | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
+| `NodeLayout` | interface | `dist/flow-sdk.d.ts:642-656` | 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-484` | Option shapes | `.return(...)`-specific options. |
+| `ReturnOptions` | interface | `dist/flow-sdk.d.ts:445-486` | 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:520-639` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:792-1266` | Builders | Collects a sequence of steps. |
-| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:670-675` | Flow construction | The designer's sticky-note palette. |
-| `StickyNote` | interface | `dist/flow-sdk.d.ts:682-716` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
-| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:676-681` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1671-1710` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `Step` | type | `dist/flow-sdk.d.ts:522-641` | Supporting types |  |
+| `StepList` | class | `dist/flow-sdk.d.ts:794-1268` | Builders | Collects a sequence of steps. |
+| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:672-677` | Flow construction | The designer's sticky-note palette. |
+| `StickyNote` | interface | `dist/flow-sdk.d.ts:684-718` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
+| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:678-683` | Supporting types | A sticky note's swatch. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1673-1712` | 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:1279` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1281` |
 | `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:991-1009` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:993-1011` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `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` |
+| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1128-1137` |
+| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:519-520` |
+| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:506-510` |
 | `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:1647-1653` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1649-1655` |
 | `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:652-653` |
+| `collapsed` | property | `NodeLayout` | `dist/flow-sdk.d.ts:654-655` |
 | `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:706-707` |
+| `color` | property | `StickyNote` | `dist/flow-sdk.d.ts:708-709` |
 | `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:499-503` |
+| `completionCondition` | property | `LoopOptions` | `dist/flow-sdk.d.ts:501-505` |
 | `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:704-705` |
+| `content` | property | `StickyNote` | `dist/flow-sdk.d.ts:706-707` |
 | `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:1136-1150` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1138-1152` |
 | `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:770-775` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1508-1548` |
+| `definitions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:772-777` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1510-1550` |
 | `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:747-748` |
+| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:749-750` |
 | `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:1317-1324` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1319-1326` |
 | `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:1101-1125` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1103-1127` |
 | `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:728-729` |
+| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:730-731` |
 | `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:1383-1433` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1385-1435` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
-| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:776-777` |
+| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:778-779` |
 | `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:800-825` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:802-827` |
 | `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:714-715` |
+| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:716-717` |
 | `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:733-734` |
-| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:745` |
+| `id` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:735-736` |
+| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:747` |
 | `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:694-703` |
+| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:696-705` |
 | `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:1588-1600` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1590-1602` |
 | `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:739-740` |
-| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:757` |
+| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:741-742` |
+| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:759` |
 | `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:1280-1289` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1282-1291` |
 | `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:766-767` |
+| `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:768-769` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1325-1335` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1327-1337` |
 | `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:252-284` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
-| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:515-516` |
+| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:517-518` |
 | `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:1089-1100` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1091-1102` |
 | `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:746` |
+| `name` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:748` |
 | `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:1309-1316` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1311-1318` |
 | `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-483` |
+| `name` | property | `ReturnOptions` | `dist/flow-sdk.d.ts:460-485` |
 | `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:726-727` |
+| `nodes` | property | `FlowLayout` | `dist/flow-sdk.d.ts:728-729` |
 | `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:880-940` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:882-942` |
 | `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:785-790` |
-| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1549-1587` |
+| `openTails` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:787-792` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1551-1589` |
 | `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:737-738` |
+| `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:739-740` |
 | `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:1601-1636` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1603-1638` |
 | `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:758` |
+| `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:760` |
 | `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:497-498` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1053-1088` |
+| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:499-500` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1055-1090` |
 | `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:642-646` |
+| `position` | property | `NodeLayout` | `dist/flow-sdk.d.ts:644-648` |
 | `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:1256-1265` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1258-1267` |
 | `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:663-668` |
+| `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:665-670` |
 | `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:750-756` |
+| `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:752-758` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1468-1507` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1470-1509` |
 | `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:647-651` |
+| `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:649-653` |
 | `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: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:1190-1234` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1235-1255` |
-| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:768-769` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1336-1361` |
+| `step` | method | `StepList` | `dist/flow-sdk.d.ts:828-838` |
+| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:743-744` |
+| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:762` |
+| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:796` |
+| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:839-881` |
+| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:956-984` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1192-1236` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1237-1257` |
+| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:770-771` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1338-1363` |
 | `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:1010-1052` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:1012-1054` |
 | `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:1151-1189` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1153-1191` |
 | `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:735-736` |
-| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:761-763` |
+| `trigger` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:737-738` |
+| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:763-765` |
 | `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:1362-1382` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1364-1384` |
 | `trigger` | property | `StartOpts` | `dist/bpmn/bpmn-sdk.d.ts:624-671` |
 | `triggeredByEvent` | property | `SubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:976-977` |
-| `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:778-784` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1434-1453` |
-| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:764-765` |
+| `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:780-786` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1436-1455` |
+| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:766-767` |
 | `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:1637-1646` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1639-1648` |
 | `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:759` |
+| `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:761` |
 | `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:749` |
+| `version` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:751` |
 | `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:1454-1467` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1456-1469` |
 | `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:657-662` |
+| `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:659-664` |
 | `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:712-713` |
-| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:708-709` |
-| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:710-711` |
+| `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:714-715` |
+| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:710-711` |
+| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:712-713` |
 | `zIndex` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:608-609` |

package/dist/check.js

@@ -51,6 +51,36 @@ export function check(built, opts = {}) {
     }
     return diags;
 }
+/**
+ * A step's node id is its name with every character outside `[A-Za-z0-9_]`
+ * made `_`, and `compile` never renames one to make it unique (#1249). So two
+ * different names that give one id (`a b` and `a_b`), or a step of the flow
+ * itself named like its trigger, are an error here, as the same name twice is
+ * DUP_STEP. `serialize` refuses both too, for the paths that skip `check`.
+ * A subflow's own start is the SDK's to name, so `trigger` is the flow's only.
+ */
+function checkStepIds(stepNames, trigger, diags) {
+    const byId = new Map();
+    for (const name of stepNames) {
+        const id = name.replace(/[^A-Za-z0-9_]/g, '_') || 'node';
+        const first = byId.get(id);
+        if (first !== undefined) {
+            diags.push({
+                level: 'error', code: 'STEP_ID_COLLISION', step: name,
+                message: `Steps "${first}" and "${name}" would both get node id "${id}". Give them names that differ in `
+                    + 'letters, digits or "_".',
+            });
+        }
+        else if (id === trigger) {
+            diags.push({
+                level: 'error', code: 'STEP_ID_COLLISION', step: name,
+                message: `Step "${name}" has the trigger's node id "${id}". Rename the step.`,
+            });
+        }
+        if (first === undefined)
+            byId.set(id, name);
+    }
+}
 /**
  * `ancestors` is the chain of child flows currently being checked, innermost
  * last — used to prefix a child's diagnostics with the step that runs it, and
@@ -898,6 +928,9 @@ function checkFlow(built, ancestors, opts = {}) {
         }
         walk(ep.steps);
     }
+    // After the entry-point loop, so prefix steps are in `stepNames`: serialize
+    // claims body and prefix step ids together (#1249).
+    checkStepIds(stepNames, ancestors.length === 0 ? triggerId : undefined, diags);
     if (built.entryPoints?.length && !built.steps.some((st) => 'name' in st && st.kind !== 'return')) {
         diags.push({
             level: 'error', code: 'ENTRY_POINT_NO_SHARED_BODY',
@@ -915,7 +948,9 @@ function checkFlow(built, ancestors, opts = {}) {
                 + `${conversationRoots.map((id) => `"${id}"`).join(', ')}. Keep one and give the others another trigger.`,
         });
     }
-    checkStepRefs(built, diags);
+    // The root trigger and entry points hold node ids of their own; a subflow's
+    // start is the SDK's to name, so it reserves nothing.
+    checkStepRefs(built, diags, ancestors.length === 0 ? [triggerId, ...(built.entryPoints ?? []).map((ep) => ep.id)] : []);
     checkArmScopedReads(built, diags);
     // A fire-and-forget dispatch publishes no output: any read of it would wait
     // on a value the run will never produce. Error reads stay legal — dispatch
@@ -4568,7 +4603,7 @@ function checkArmScopedReads(built, diags) {
  * Backward targets are ALLOWED. Flow JSON can express a backward edge, so the SDK
  * can author one; refusing it would fence off something the wire format permits.
  */
-function checkStepRefs(built, diags) {
+function checkStepRefs(built, diags, reservedIds = []) {
     const order = new Map();
     /** Steps that live inside a port list — a path only that port reaches. */
     const inPortList = new Set();
@@ -4619,7 +4654,7 @@ function checkStepRefs(built, diags) {
                 if (s.kind === 'terminate')
                     terminateNames.add(name);
                 // Exactly the step rule from before, for steps. A named End only fills a
-                // name nothing has claimed; a clash is REF_AMBIGUOUS_TARGET below.
+                // name nothing has claimed; a clash is STEP_ID_COLLISION below (#1253).
                 if (s.kind !== 'return' || !order.has(name)) {
                     if (!order.has(name))
                         order.set(name, seq);
@@ -4677,6 +4712,41 @@ function checkStepRefs(built, diags) {
                 + `\`.stepToRef('${name}')\`; to have separate Ends, give each its own name.`,
         });
     }
+    // A named End's node id is its name with every character outside
+    // `[A-Za-z0-9_]` made `_`, as a step's is, and compile never renames it
+    // (#1253): it is an id the author chose, or a decompiled file's own. So an End
+    // whose name gives the id of another End, a step, the trigger or an entry
+    // point is refused here, and `serialize` throws for it under `--no-check`.
+    // Before, it was the End that moved (`.step('x').return({}, { name: 'x' })`
+    // compiled to End `x2`), or, emitted first, the step.
+    const safeId = (n) => n.replace(/[^A-Za-z0-9_]/g, '_') || 'node';
+    const stepById = new Map();
+    for (const n of stepNamesSeen)
+        if (!stepById.has(safeId(n)))
+            stepById.set(safeId(n), n);
+    const endById = new Map();
+    for (const name of endNames.keys()) {
+        const id = safeId(name);
+        const other = endById.get(id);
+        if (other !== undefined) {
+            diags.push({
+                level: 'error', code: 'DUP_END_NAME', step: name,
+                message: `Ends "${other}" and "${name}" would both get node id "${id}". Give them names that differ in `
+                    + 'letters, digits or "_".',
+            });
+            continue;
+        }
+        endById.set(id, name);
+        const step = stepById.get(id);
+        if (step !== undefined || reservedIds.includes(id)) {
+            diags.push({
+                level: 'error', code: 'STEP_ID_COLLISION', step: name,
+                message: `End "${name}" (\`.return({}, { name: '${name}' })\`) would get node id "${id}", which `
+                    + `${step !== undefined ? `step "${step}"` : 'the trigger or an entry point'} has. Compile will not rename `
+                    + 'either one, so give the End a name no step or trigger uses.',
+            });
+        }
+    }
     /** Every ref, with where it sits. */
     const found = [];
     const collect = (steps, from, scope, arm, enclosing = []) => {
@@ -4731,11 +4801,10 @@ function checkStepRefs(built, diags) {
         // 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.`);
+        // A step and an End sharing the name are STEP_ID_COLLISION above, refused
+        // where they are declared, so the ref has nothing more to say (#1253).
+        if (ends > 0 && stepNamesSeen.has(target))
             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.

package/dist/flow-sdk.d.ts

@@ -467,12 +467,14 @@ export interface ReturnOptions extends NodeOptions {
      * 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`.
+     * throws) rather than renamed `done2`. The name is never renamed to make it
+     * unique: a name that gives the node id of a step, the trigger or an entry
+     * point is refused too (STEP_ID_COLLISION), as is a second End whose name gives
+     * the same id (`a b` and `a_b`, DUP_END_NAME).
      *
      * 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.
+     * including another port's path (an End runs nothing after itself).
      *
      * ```ts
      * .branch('checkTemperature', js`${input('tempF')} > 60`,

package/dist/serialize.js

@@ -4166,9 +4166,9 @@ function terminateOutputs(scope) {
 /**
  * Rewrite `$vars.<step>` references through a scope's rename map.
  *
- * A name maps to the ids claimed for it in order; a reference resolves to the
- * first, which is the only sensible reading when a scope has two steps of the
- * same name (an error in its own right — DUP_STEP).
+ * A name maps to the id claimed for it (a list only for the type's sake: a
+ * scope with two steps of one name is refused before anything renders, #1249);
+ * a reference resolves to the first.
  */
 function renameRefs(text, rename) {
     if (rename.nodeIds.size === 0 && rename.errorEnvelopes.size === 0 && !rename.vars?.size)
@@ -4189,32 +4189,89 @@ function renameRefs(text, rename) {
         return `$vars.${nodeId}.${envelope}`;
     }));
 }
-/** Every step name a flow declares in its own scope (not its children's). */
-function stepNamesOf(steps, out = []) {
+/**
+ * Every step name a flow declares in its own scope (not its children's),
+ * port paths (`.stepToList`, `.onError`) included: their steps are nodes of
+ * this scope too, so they need an id claimed with the rest.
+ */
+function stepNamesOf(steps, out = [], terminates) {
     for (const s of steps) {
         // `return` carries a synthetic `name` but creates no node named after it (an
         // End id is claimed as `end`); `stepToRef` has no `name` at all (it is one edge).
         if ('name' in s && s.kind !== 'return')
             out.push(s.name);
+        // How many `.terminate`s hold each name, so a clash gets the right remedy (#1239).
+        if (s.kind === 'terminate' && terminates)
+            terminates.set(s.name, (terminates.get(s.name) ?? 0) + 1);
+        if (s.kind === 'stepToList')
+            stepNamesOf(s.body, out, terminates);
         if (s.kind === 'branch') {
-            stepNamesOf(s.then, out);
-            stepNamesOf(s.otherwise, out);
+            stepNamesOf(s.then, out, terminates);
+            stepNamesOf(s.otherwise, out, terminates);
         }
         else if (s.kind === 'switch') {
-            s.cases.forEach((c) => stepNamesOf(c.body, out));
-            stepNamesOf(s.default ?? [], out);
+            s.cases.forEach((c) => stepNamesOf(c.body, out, terminates));
+            stepNamesOf(s.default ?? [], out, terminates);
         }
         else if (s.kind === 'stepSwitch')
-            s.cases.forEach((c) => stepNamesOf(c.body, out));
+            s.cases.forEach((c) => stepNamesOf(c.body, out, terminates));
         else if (s.kind === 'parallel')
-            s.arms.forEach((a) => stepNamesOf(a, out));
+            s.arms.forEach((a) => stepNamesOf(a, out, terminates));
         else if (s.kind === 'loop')
-            stepNamesOf(s.body, out);
+            stepNamesOf(s.body, out, terminates);
         else if (s.kind === 'doWhile')
-            stepNamesOf(s.body, out);
+            stepNamesOf(s.body, out, terminates);
+    }
+    return out;
+}
+/**
+ * The node names one scope declares, walked the way `check`'s `.stepToRef`
+ * index walks them: port paths (`.stepToList`, `.onError`) and `.stepSwitch`
+ * arms included, since their nodes live in this scope too.
+ *
+ * `steps` are step names (a terminate included); `ends` are the `name`s of
+ * NAMED Ends, `.return({}, { name })`. An unnamed `.return()` is the SDK's to
+ * name (`end`, `end2`, ...) and is not listed.
+ */
+function namedNodesOf(steps, out = { steps: [], ends: [] }, seenEnds = new Set()) {
+    for (const s of steps) {
+        if (s.kind === 'return') {
+            // Two `.return`s with one name and the same content are ONE End reached
+            // from two paths (#1234), so the name is listed once. One that differs is
+            // listed again, and `claimEndIds` refuses it as DUP_END_NAME.
+            const name = s.options?.name;
+            // `endContentKey` is the key `check` counts DUP_END_NAME on, so the two agree.
+            const key = JSON.stringify([name, endContentKey(s)]);
+            if (name !== undefined && !seenEnds.has(key)) {
+                seenEnds.add(key);
+                out.ends.push(name);
+            }
+        }
+        else if ('name' in s)
+            out.steps.push(s.name);
+        if (s.kind === 'stepToList')
+            namedNodesOf(s.body, out, seenEnds);
+        else if (s.kind === 'branch') {
+            namedNodesOf(s.then, out, seenEnds);
+            namedNodesOf(s.otherwise, out, seenEnds);
+        }
+        else if (s.kind === 'switch') {
+            s.cases.forEach((c) => namedNodesOf(c.body, out, seenEnds));
+            namedNodesOf(s.default ?? [], out, seenEnds);
+        }
+        else if (s.kind === 'stepSwitch')
+            s.cases.forEach((c) => namedNodesOf(c.body, out, seenEnds));
+        else if (s.kind === 'parallel')
+            s.arms.forEach((a) => namedNodesOf(a, out, seenEnds));
+        else if (s.kind === 'loop' || s.kind === 'doWhile')
+            namedNodesOf(s.body, out, seenEnds);
     }
     return out;
 }
+/** A name as the node id `claimId` would give it before any de-duplication. */
+function safeNodeId(name) {
+    return name.replace(/[^A-Za-z0-9_]/g, '_') || 'node';
+}
 export function serialize(built, opts = {}) {
     /**
      * Definitions the flow carries (`.definitions()`, #1128), by `type@version` —
@@ -4364,19 +4421,22 @@ export function serialize(built, opts = {}) {
         root.rename.nodeIds.set('start', [built.triggerId]);
     }
     // Every node id emitted anywhere in the file. `start` is taken before
-    // anything else: the root trigger's id is fixed, so a step named `start` must
-    // be renamed rather than silently collide with it.
+    // anything else: the root trigger's id is fixed, so a step named like the
+    // trigger is refused (claimStepIds).
     const takenIds = new Set([built.triggerId ?? 'start']);
     /** Per scope, each named `.return` End emitted so far and its content. */
     const namedEnds = new Map();
     /** Per scope, the names a `.terminate` claimed: which remedy a later clash gets (#1239). */
     const terminateNames = new Map();
     let edgeSeq = 0;
-    /** Claim a globally unique node id, honouring the scope's rename map. */
-    function uid(scope, base) {
-        const pre = scope.pending.get(base);
-        if (pre && pre.length > 0)
-            return pre.shift();
+    /**
+     * Claim a globally unique node id for a node the SDK names itself: an End,
+     * a subflow's Start, an agent's context or tool node, an error-port End.
+     * Those ids are the SDK's to choose, so a clash is settled by `claimId`'s
+     * numeric suffix (`end`, `end2`, …). A step's id never comes from here; see
+     * `stepUid`.
+     */
+    function uid(_scope, base) {
         return claimId(base);
     }
     function claimId(base) {
@@ -4400,18 +4460,133 @@ export function serialize(built, opts = {}) {
         return claimId(base);
     }
     /**
-     * `uid` for a node that IS an author's step, recording which id that step got.
+     * Claim the node id of every NAMED End of one scope, before anything in the
+     * scope is emitted (#1253).
+     *
+     * A named End's id is the author's choice, or a decompiled file's own node
+     * id, so it is never quietly renamed. Before this it went through `uid`, the
+     * allocator for ids the SDK makes up, which settles a clash by emission order
+     * with a numeric suffix: `.step('x').return({}, { name: 'x' })` came out as
+     * End `x2`, and an unnamed `.return()` emitted first turned a named `end`
+     * into `end2`. Now:
+     *
+     * - two Ends whose names give one id are refused (`check`: DUP_END_NAME);
+     * - an End whose name gives a step's id, the trigger's or an entry point's
+     *   is refused (`check`: STEP_ID_COLLISION);
+     * - every other id is claimed here, so the ids the SDK makes up (`end`,
+     *   `end2`, an agent's context node, ...) are the ones that move.
+     *
+     * `check` reports these first; this is the backstop for `compile --no-check`,
+     * the draft-tolerant merge compile and a direct `serialize()`. A subflow COPY
+     * is the one place ids move: `copyPrefix` is set when the copy is prefixed.
+     */
+    function claimEndIds(scope, nodes, where, reserved, copyPrefix = '') {
+        const stepIds = new Map(nodes.steps.map((n) => [safeNodeId(n), n]));
+        const endIds = new Map();
+        for (const name of nodes.ends) {
+            const id = safeNodeId(name);
+            const end = endIds.get(id);
+            if (end !== undefined) {
+                throw new Error(end === name
+                    ? `${where}: [DUP_END_NAME] Two .return({}, { name: '${name}' }) calls ask for the same End with different `
+                        + `values, label, version or updates. 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.'
+                    : `${where}: [DUP_END_NAME] Ends "${end}" and "${name}" would both get node id "${id}". Give them names `
+                        + 'that differ in letters, digits or "_".');
+            }
+            const step = stepIds.get(id);
+            if (step !== undefined || reserved.includes(id)) {
+                throw new Error(`${where}: [STEP_ID_COLLISION] End "${name}" (.return({}, { name: '${name}' })) has the node id "${id}" of `
+                    + `${step !== undefined ? `step "${step}"` : 'the trigger or an entry point'}, and compile will not rename it "${id}2". `
+                    + 'Give the End a name no step or trigger uses.');
+            }
+            endIds.set(id, name);
+        }
+        for (const [id, name] of endIds) {
+            if (!copyPrefix && takenIds.has(id)) {
+                throw new Error(`${where}: End "${name}" has node id "${id}", which another node already holds (internal: claimEndIds ran late).`);
+            }
+            scope.endNodeId.set(name, claimId(copyPrefix + id));
+        }
+    }
+    /**
+     * Claim the node ids for every step of one scope, BEFORE any node of the
+     * scope (or of a subflow it calls) is emitted, so an author's step name
+     * always gets its id ahead of the ids the SDK makes up (#1249).
+     *
+     * A step's id is its name: the author's name, or a decompiled file's own
+     * node id. It is never quietly renamed:
+     *
+     * - Two steps whose names give the same id (`.step('x')` twice, or `a b`
+     *   beside `a_b`) are refused. `check` reports them as DUP_STEP /
+     *   STEP_ID_COLLISION; this is the backstop for every path that skips it
+     *   (`compile --no-check`, the draft-tolerant merge compile, a direct
+     *   `serialize()`). Renaming the second to `x2` left `.stepToRef('x')` and
+     *   `$vars.x` pointing at the first, with no word said.
+     * - In the flow itself, a step named like the trigger is refused the same
+     *   way (STEP_ID_COLLISION).
+     * - A subflow body whose ids are already taken (a second copy of the same
+     *   child, or a child step sharing a name with a caller's step) is the one
+     *   place ids move: the whole copy is prefixed with the calling step's name,
+     *   and `rename` points its expressions at the prefixed ids.
+     */
+    function claimStepIds(scope, names, where, copyPrefix, alsoIds = [], terminates = new Map()) {
+        const seen = new Map();
+        for (const n of names) {
+            const safe = n.replace(/[^A-Za-z0-9_]/g, '_') || 'node';
+            const first = seen.get(safe);
+            if (first !== undefined) {
+                // A name a `.terminate` holds gets the same words `check` gives (#1239):
+                // two Terminates -> end the other paths at one; a step and a Terminate
+                // -> rename one.
+                const t = first === n ? (terminates.get(n) ?? 0) : 0;
+                throw new Error(first !== n
+                    ? `${where}: [STEP_ID_COLLISION] steps "${first}" and "${n}" would both get node id "${safe}". Give them `
+                        + 'names that differ in letters, digits or "_".'
+                    : t >= 2 ? `${where}: [DUP_STEP] ${terminateTwiceMessage(n)}`
+                        : t === 1 ? `${where}: [DUP_STEP] ${terminateStepClashMessage(n)}`
+                            : `${where}: [DUP_STEP] two steps are named "${n}". A step name is its node's id and \`.stepToRef\` / `
+                                + `\`$vars\` name it, so compile will not rename the second one "${n}2". Give each step its own name; to `
+                                + `send several paths to one step, keep one and end the others with .stepToRef('${n}').`);
+            }
+            seen.set(safe, n);
+        }
+        // A subflow copy's named Ends (`alsoIds`) decide the prefix with its steps (#1253).
+        const prefix = copyPrefix !== undefined && [...seen.keys(), ...alsoIds].some((id) => takenIds.has(id)) ? copyPrefix : '';
+        for (const [safe, n] of seen) {
+            if (!prefix && takenIds.has(safe)) {
+                throw new Error(`${where}: [STEP_ID_COLLISION] step "${n}" has the trigger's node id "${safe}", and compile will not `
+                    + `rename it "${safe}2". Rename the step.`);
+            }
+            const id = claimId(prefix + safe);
+            if (copyPrefix !== undefined)
+                (scope.rename.nodeIds.get(n) ?? scope.rename.nodeIds.set(n, []).get(n)).push(id);
+            scope.pending.set(n, id);
+        }
+        return prefix;
+    }
+    /**
+     * The node id of an author's step: the one `claimStepIds` claimed for it,
+     * recorded so `.stepToRef('<step>')` can find it.
      *
      * `.stepToRef('<step>')` names a step, and the id it was emitted under is not
-     * derivable from the name: `uid` sanitizes, de-duplicates against every id in
-     * the file, and hands a subflow COPY a prefixed one from the rename map. So
-     * the mapping is recorded where it is decided rather than reconstructed later
-     * — the derived-names lesson (G-20), one layer in.
+     * always the name: a subflow COPY's steps are prefixed. So the mapping is
+     * recorded where it is decided rather than reconstructed later — the
+     * derived-names lesson (G-20), one layer in.
      */
     function stepUid(scope, stepName) {
-        const id = uid(scope, stepName);
-        if (!scope.stepNodeId.has(stepName))
-            scope.stepNodeId.set(stepName, id);
+        // Unreachable after `claimStepIds`, which refuses a repeated name first;
+        // kept so no future emission path can bring back the silent `<name>2`.
+        if (scope.stepNodeId.has(stepName)) {
+            throw new Error(`step "${stepName}" is emitted twice in one scope (internal: DUP_STEP reached stepUid).`);
+        }
+        const id = scope.pending.get(stepName);
+        if (id === undefined) {
+            throw new Error(`step "${stepName}" has no claimed node id (internal: stepNamesOf missed a step kind).`);
+        }
+        scope.pending.delete(stepName);
+        scope.stepNodeId.set(stepName, id);
         return id;
     }
     /**
@@ -4579,13 +4754,12 @@ export function serialize(built, opts = {}) {
         // copy of the same child looks like — the whole copy is prefixed with the
         // calling step's name, keeping the two bodies apart in the one flat
         // namespace the `subflows` map keeps.
-        const names = stepNamesOf(child.steps);
-        const prefix = names.some((n) => takenIds.has(n)) ? `${nodeId}_` : '';
-        for (const n of names) {
-            const id = claimId(prefix + n);
-            (scope.rename.nodeIds.get(n) ?? scope.rename.nodeIds.set(n, []).get(n)).push(id);
-            (scope.pending.get(n) ?? scope.pending.set(n, []).get(n)).push(id);
-        }
+        // A child's named Ends belong to the copy too, so they decide the prefix
+        // with its steps and move with it (#1253).
+        const childNodes = namedNodesOf(child.steps);
+        const childTerminates = new Map();
+        const prefix = claimStepIds(scope, stepNamesOf(child.steps, [], childTerminates), `subflow "${nodeId}"`, `${nodeId}_`, childNodes.ends.map(safeNodeId), childTerminates);
+        claimEndIds(scope, childNodes, `subflow "${nodeId}"`, [], prefix);
         const startId = uid(scope, `${nodeId}Start`);
         // A CHILD's inputs are published as the child's own start node, whose id is
         // `<caller>Start` — not `start`. `input('x')` lowers eagerly to
@@ -6532,15 +6706,17 @@ export function serialize(built, opts = {}) {
                             + `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');
+                    // A named End's id was claimed up front, exactly or refused, by
+                    // `claimEndIds` (#1253); only an unnamed End's id is the SDK's to make up.
+                    const id = name === undefined ? uid(scope, 'end') : scope.endNodeId.get(name);
+                    if (id === undefined) {
+                        throw new Error(`End "${name}" has no claimed node id (internal: namedNodesOf missed a step kind).`);
+                    }
                     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 = [];
@@ -6548,6 +6724,23 @@ export function serialize(built, opts = {}) {
         }
         return tails;
     }
+    // The flow's own step ids (entry-point prefixes included: they emit into the
+    // root scope) are claimed before anything else but the trigger, so a subflow
+    // body or an SDK-made node that shares a step's name is the one that moves.
+    // Its named Ends are claimed right after, before anything is emitted, so an
+    // id the SDK makes up is the one that moves (#1253).
+    {
+        const rootTerminates = new Map();
+        const rootSteps = stepNamesOf(built.steps, [], rootTerminates);
+        for (const ep of built.entryPoints ?? [])
+            stepNamesOf(ep.steps, rootSteps, rootTerminates);
+        claimStepIds(root, rootSteps, `flow "${built.id}"`, undefined, [], rootTerminates);
+        const seenEnds = new Set();
+        const rootNodes = namedNodesOf(built.steps, undefined, seenEnds);
+        for (const ep of built.entryPoints ?? [])
+            namedNodesOf(ep.steps, rootNodes, seenEnds);
+        claimEndIds(root, rootNodes, `flow "${built.id}"`, [built.triggerId ?? 'start', ...(built.entryPoints ?? []).map((ep) => ep.id)]);
+    }
     const finalTails = emit(built.steps, [{ node: built.triggerId ?? 'start', port: 'output' }], root);
     // 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`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.32.2",
+  "version": "6.32.4",
   "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": "c5c161d5160cc033040ad150154c4fb55e9bada8"
+  "gitref": "9a7e5f98ca054b05f74ac655b8725bf4e3b50e89"
 }