@uipath/maestro-builder-sdk 6.31.1 → 6.31.3

package/dist/api-index.md

@@ -57,13 +57,13 @@ could hand you spans for a version you do not have.
 | `apiWorkflow` | function | `dist/core/actions.d.ts:1658-1692` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/core/actions.d.ts:411-442` | Option shapes | 5 field(s) |
 | `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:140-185` | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
-| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1231-1254` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `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(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:79-89` | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
 | `batchTransform` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:49-83` | Actions | Add AI-generated columns to a CSV — the platform's **Batch transform** node, `uipath.pattern.batch-transform` (service… |
 | `BatchTransformInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:48-63` | Option shapes | 4 field(s) |
 | `BindingContribution` | interface | `dist/core/node-classes.d.ts:80-101` | Supporting types | A resource binding a contribution hoists to the flow's top-level `bindings` array — the shape the `.flow` format… |
-| `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts:720-732` | Supporting types | One additional flow root, built by `.entryPoint()`. |
-| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:733-780` | Supporting types | 17 field(s) |
+| `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) |
 | `BuiltinToolName` | type | `dist/core/actions.d.ts:1066-1067` | Supporting types | The three platform-shipped built-in tools (fixed registry types). |
 | `BuiltinToolRef` | interface | `dist/core/actions.d.ts:1199-1219` | Supporting types | A platform built-in tool. |
 | `BuiltInValidatorGuardrail` | interface | `dist/core/actions.d.ts:762-803` | Supporting types | A platform-shipped validator, configured by parameters. |
@@ -111,10 +111,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:499-508` | Option shapes | Do-while options. |
+| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:503-512` | 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:644-658` | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
+| `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. |
 | `endCall` | function | `dist/core/actions.d.ts:1735-1742` | Actions | Hang up (`uipath.conversational.voice.end-call`). |
 | `EndCallInputs` | interface | `dist/core/actions.d.ts:189-196` | 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` —… |
@@ -128,12 +128,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:1619-1634` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1623-1638` | Flow construction | Start building a flow with the given id. |
 | `FlowAction` | class | `dist/core/node-classes.d.ts:162-168` | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
 | `FlowActionSpec` | type | `dist/flow-sdk.d.ts:53-54` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:1443-1520` | Supporting types | Every action kind, keyed by kind, to the body of its spec — the arm's fields other than `kind`. |
-| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1255-1618` | Builders | 15 member(s) |
-| `FlowLayout` | interface | `dist/flow-sdk.d.ts:706-719` | 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: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… |
 | `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(…)`. |
@@ -181,12 +181,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-498` | Option shapes | Loop-specific options. |
+| `LoopOptions` | interface | `dist/flow-sdk.d.ts:478-502` | 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:1078-1106` | 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:629-643` | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
+| `NodeLayout` | interface | `dist/flow-sdk.d.ts:633-647` | 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. |
@@ -224,12 +224,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:63-78` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
-| `Step` | type | `dist/flow-sdk.d.ts:509-628` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:781-1230` | Builders | Collects a sequence of steps. |
-| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:659-664` | Flow construction | The designer's sticky-note palette. |
-| `StickyNote` | interface | `dist/flow-sdk.d.ts:671-705` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
-| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:665-670` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1635-1674` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `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. |
 | `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:1243` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1247` |
 | `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:980-998` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:984-1002` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1115-1124` |
-| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:506-507` |
-| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:493-497` |
+| `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` |
 | `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:1611-1617` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1615-1621` |
 | `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:641-642` |
+| `collapsed` | property | `NodeLayout` | `dist/flow-sdk.d.ts:645-646` |
 | `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:695-696` |
+| `color` | property | `StickyNote` | `dist/flow-sdk.d.ts:699-700` |
 | `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:488-492` |
+| `completionCondition` | property | `LoopOptions` | `dist/flow-sdk.d.ts:492-496` |
 | `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:693-694` |
+| `content` | property | `StickyNote` | `dist/flow-sdk.d.ts:697-698` |
 | `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:122-123` |
@@ -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:1125-1139` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1129-1143` |
 | `contribute` | method | `FlowNode` | `dist/core/node-classes.d.ts:144-153` |
 | `conversationalAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1479-1482` |
 | `conversationContext` | property | `FlowActionSpecs` | `dist/nodes/conversation/flow/spec.d.ts:55-58` |
@@ -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:759-764` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1472-1512` |
+| `definitions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:763-768` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1476-1516` |
 | `delay` | property | `FlowActionSpecs` | `dist/nodes/delay/flow/spec.d.ts:38-41` |
 | `dependsOn` | property | `LookupSpec` | `dist/core/lookups.d.ts:34-35` |
 | `description` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1187` |
 | `description` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:633` |
-| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:736-737` |
+| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:740-741` |
 | `description` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:1207-1208` |
 | `description` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:768` |
 | `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:755` |
 | `description` | property | `EscalationRef` | `dist/core/actions.d.ts:1349-1350` |
 | `description` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:241` |
-| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1281-1288` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1285-1292` |
 | `description` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1154` |
 | `description` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:337-344` |
 | `description` | property | `IxpToolRef` | `dist/core/actions.d.ts:1327-1328` |
@@ -267,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:1090-1114` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1094-1118` |
 | `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:1190-1191` |
-| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:717-718` |
+| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:721-722` |
 | `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:1347-1397` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1351-1401` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
-| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:765-766` |
+| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:769-770` |
 | `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:789-814` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:793-818` |
 | `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:1159-1163` |
 | `height` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:606-607` |
-| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:703-704` |
+| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:707-708` |
 | `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:722-723` |
-| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:734` |
+| `id` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:726-727` |
+| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:738` |
 | `id` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:764-765` |
 | `id` | property | `CaseAppSection` | `dist/case/case-sdk.d.ts:576-577` |
 | `id` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1418-1423` |
@@ -449,7 +449,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:65-66` |
-| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:683-692` |
+| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:687-696` |
 | `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` |
@@ -461,7 +461,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1491-1494` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1552-1564` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1556-1568` |
 | `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` |
@@ -474,8 +474,8 @@ not find it either.
 | `inputs` | property | `AgentInputs` | `dist/core/actions.d.ts:623-640` |
 | `inputs` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:424-428` |
 | `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:176-184` |
-| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:728-729` |
-| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:746` |
+| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:732-733` |
+| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:750` |
 | `inputs` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:516-517` |
 | `inputs` | property | `ClientSideToolRef` | `dist/core/actions.d.ts:1139-1140` |
 | `inputs` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:399-400` |
@@ -534,7 +534,7 @@ not find it either.
 | `kind` | property | `SubflowSpec` | `dist/flow-sdk.d.ts:47` |
 | `kind` | property | `WhenExpression` | `dist/case/case-sdk.d.ts:99-100` |
 | `kValue` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1194-1195` |
-| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1244-1253` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1248-1257` |
 | `label` | property | `AskedField` | `dist/core/actions.d.ts:83-84` |
 | `label` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:523` |
 | `label` | property | `InOutField` | `dist/core/actions.d.ts:99-100` |
@@ -546,12 +546,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:755-756` |
+| `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:759-760` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1289-1299` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1293-1303` |
 | `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:504-505` |
+| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:508-509` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
 | `location` | property | `AgenticProcessInputsBase` | `dist/core/actions.d.ts:493-503` |
 | `location` | property | `AgentInputs` | `dist/core/actions.d.ts:599-604` |
@@ -559,7 +559,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:1078-1089` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1082-1093` |
 | `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` |
@@ -628,7 +628,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:735` |
+| `name` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:739` |
 | `name` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:767` |
 | `name` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:501-502` |
 | `name` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:198-199` |
@@ -648,7 +648,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:1273-1280` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1277-1284` |
 | `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` |
@@ -693,7 +693,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:715-716` |
+| `nodes` | property | `FlowLayout` | `dist/flow-sdk.d.ts:719-720` |
 | `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` |
@@ -710,27 +710,27 @@ 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:869-929` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:873-933` |
 | `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:774-779` |
-| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1513-1551` |
+| `openTails` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:778-783` |
+| `openTails` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1517-1555` |
 | `operation` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:37` |
 | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1230-1231` |
 | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:368-369` |
 | `operations` | property | `TransformInputs` | `dist/nodes/transform/flow/spec.d.ts:106-107` |
 | `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 | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:726-727` |
+| `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:730-731` |
 | `or` | property | `DataFabricFilter` | `dist/nodes/data-fabric/flow/spec.d.ts:38-50` |
 | `origin` | property | `PendingExit` | `dist/bpmn/bpmn-sdk.d.ts:1926-1931` |
 | `outcomePorts` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:230-244` |
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1395-1400` |
 | `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:211-225` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1565-1600` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1569-1604` |
 | `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` |
@@ -739,7 +739,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:747` |
+| `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:751` |
 | `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` |
@@ -765,8 +765,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:326-327` |
-| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:486-487` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1042-1077` |
+| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:490-491` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1046-1081` |
 | `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` |
@@ -785,7 +785,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:631-635` |
+| `position` | property | `NodeLayout` | `dist/flow-sdk.d.ts:635-639` |
 | `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` |
@@ -865,7 +865,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:1220-1229` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1224-1233` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
 | `returns` | property | `AgentInputs` | `dist/core/actions.d.ts:641-660` |
 | `returns` | property | `ApiWorkflowInputs` | `dist/core/actions.d.ts:429-441` |
@@ -881,7 +881,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:652-657` |
+| `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:656-661` |
 | `rpa` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:751-760` |
 | `rpaWorkflow` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:1455-1458` |
 | `rule` | property | `CaseRule` | `dist/case/case-sdk.d.ts:80` |
@@ -904,9 +904,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:739-745` |
+| `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:743-749` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1432-1471` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1436-1475` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:701` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -932,7 +932,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:636-640` |
+| `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:640-644` |
 | `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` |
@@ -978,16 +978,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:815-825` |
-| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:730-731` |
-| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:749` |
-| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:783` |
-| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:826-868` |
-| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:943-971` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1171-1199` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1200-1219` |
-| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:757-758` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1300-1325` |
+| `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` |
 | `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` |
@@ -1000,7 +1000,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:999-1041` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:1003-1045` |
 | `systemPrompt` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:134-139` |
 | `systemPrompt` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:814-863` |
 | `systemPrompt` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:221-226` |
@@ -1025,7 +1025,7 @@ not find it either.
 | `temperature` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:924-925` |
 | `temperature` | property | `VoiceSettings` | `dist/core/actions.d.ts:213-214` |
 | `terminate` | property | `EndOpts` | `dist/bpmn/bpmn-sdk.d.ts:692-693` |
-| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1140-1170` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1144-1174` |
 | `threshold` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1438-1439` |
 | `timeCycle` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:201-202` |
 | `timeout` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:91-108` |
@@ -1045,16 +1045,16 @@ not find it either.
 | `tools` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1015-1037` |
 | `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:724-725` |
-| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:750-752` |
+| `trigger` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:728-729` |
+| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:754-756` |
 | `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:1326-1346` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1330-1350` |
 | `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:767-773` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1398-1417` |
-| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:753-754` |
+| `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` |
 | `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` |
@@ -1109,7 +1109,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:1601-1610` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1605-1614` |
 | `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` |
@@ -1119,12 +1119,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:748` |
+| `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:752` |
 | `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:738` |
+| `version` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:742` |
 | `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` |
@@ -1132,7 +1132,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1232-1233` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2116` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1418-1431` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1422-1435` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:397-404` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2073-2074` |
@@ -1149,13 +1149,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:646-651` |
+| `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:650-655` |
 | `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:2082-2100` |
 | `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:2035-2052` |
 | `width` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:604-605` |
-| `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:701-702` |
-| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:697-698` |
-| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:699-700` |
+| `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` |
 | `zIndex` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:608-609` |

package/dist/check.js

@@ -31,6 +31,7 @@ import { stepExits } from './flow-step-exits.js';
 import { plainHttpOnErrorMessage } from './nodes/http/flow/family.js';
 import { resolveVersion, resolveVersionCarried } from './core/nodes/versioned.js';
 import { declaredErrorPortRefusal } from './core/error-port.js';
+import { bodyUsesBreak, loopParallelWarning, loopVersionRefusal } from './loop-version.js';
 export function check(built, opts = {}) {
     let diags = [];
     const uses = collectConnectionUses(() => { diags = checkFlow(built, [], opts); });
@@ -655,6 +656,14 @@ function checkFlow(built, ancestors, opts = {}) {
                 checkLoopListEnvelope(s, connectorSteps, opts, diags);
                 if (s.options?.completionCondition)
                     addExpr(s.options.completionCondition.js, s.name);
+                // The same refusal serialize throws, from the same helper: an option or
+                // a `.break()` the pinned version's definition cannot express (#1186).
+                const versionRefusal = loopVersionRefusal(s.name, s.options, bodyUsesBreak(s.body));
+                if (versionRefusal)
+                    diags.push({ level: 'error', code: 'LOOP_VERSION_UNSUPPORTED', step: s.name, message: versionRefusal });
+                const parallelWarning = loopParallelWarning(s.name, s.options);
+                if (parallelWarning)
+                    diags.push({ level: 'warning', code: 'LOOP_PARALLEL_LEGACY', step: s.name, message: parallelWarning });
                 loopNames.set(s.name, s.options?.version === '1.0.0' ? LOOP_FIELDS_1_0_0 : LOOP_FIELDS);
                 if (s.body.length === 0)
                     diags.push({ level: 'warning', code: 'EMPTY_LOOP', message: `Loop "${s.name}" has an empty body.`, step: s.name });

package/dist/flow-sdk.d.ts

@@ -479,8 +479,12 @@ export interface ReturnOptions extends NodeOptions {
  * Loop-specific options. Every `.loop()` emits the loop's v2.4 definition (the
  * version the registry serves: inner `start`/`continue`/`break` handles, and a
  * 1-based `currentIteration` output). The legacy 1.0.0 shape is emitted only for
- * an explicit `{ version: '1.0.0' }`, and that combined with any of these options
- * fails compilation: that definition cannot express them.
+ * an explicit `{ version: '1.0.0' }`. That definition declares `parallel` but no
+ * `completionCondition`, no `breakEnabled` and no `break` handle, so either of
+ * those options, or a `b.break()` in the body, fails `check` and compilation
+ * (`LOOP_VERSION_UNSUPPORTED`). `parallel: true` on 1.0.0 compiles, to round-trip
+ * a canvas loop, but `check` warns (`LOOP_PARALLEL_LEGACY`): that version is not
+ * confirmed to run iterations in parallel. `b.continue()` works on both versions.
  */
 export interface LoopOptions extends NodeOptions {
     /** Run iterations in parallel instead of sequentially. */

package/dist/loop-version.d.ts

@@ -0,0 +1,41 @@
+import type { LoopOptions, Step } from './flow-sdk.js';
+/** The wire type of `.loop()`. */
+export declare const LOOP_NODE_TYPE = "core.logic.loop";
+/** The `core.logic.loop` version `.loop()` emits unless `{ version }` pins another. */
+export declare const LOOP_DEFAULT_VERSION = "2.4";
+/** The version `.loop()` emits for these options. */
+export declare function loopVersion(options: LoopOptions | undefined): string;
+/**
+ * True when this loop version's body runs from the inner `start` handle and goes
+ * back through `continue` (2.x); false for the legacy `output`/`loopBack` shape.
+ * A version with no bundled definition counts as 2.x; its lookup fails later.
+ */
+export declare function loopHasInnerHandles(version: string): boolean;
+/**
+ * The features this loop uses that its version's definition cannot express, in
+ * a fixed order (`parallel`, `completionCondition`, `breakEnabled`, `break()`).
+ * Empty when all are supported, or when no definition is bundled for the version
+ * (an unknown version is reported elsewhere, by the definition lookup).
+ */
+export declare function unsupportedLoopFeatures(options: LoopOptions | undefined, usesBreak: boolean): string[];
+/**
+ * The refusal for a loop whose options or body need a definition the requested
+ * version does not have, or `undefined` when there is nothing to refuse.
+ * `serialize` throws it; `check` reports it as `LOOP_VERSION_UNSUPPORTED` with
+ * the same text, so the author reads one message in both places.
+ */
+export declare function loopVersionRefusal(name: string, options: LoopOptions | undefined, usesBreak: boolean): string | undefined;
+/**
+ * The warning for `parallel: true` on a 1.0.0 loop, or `undefined`. The 1.0.0
+ * definition declares the input, so the loop compiles and a canvas 1.0.0 loop
+ * round-trips; whether the 1.0.0 runtime runs its iterations in parallel is not
+ * confirmed, so a new loop that needs that should use the default version.
+ * `check` reports it as `LOOP_PARALLEL_LEGACY`.
+ */
+export declare function loopParallelWarning(name: string, options: LoopOptions | undefined): string | undefined;
+/**
+ * True when a container body (or an arm/handler inside it, but not a NESTED
+ * container's body) breaks: a nested `.loop()`/`.doWhile()` owns its own
+ * `.break()`.
+ */
+export declare function bodyUsesBreak(steps: Step[]): boolean;

package/dist/loop-version.js

@@ -0,0 +1,97 @@
+/**
+ * What each `core.logic.loop` version can express, read from the bundled
+ * definition of that version — the one answer `serialize` and `check` share.
+ *
+ * The definition is the authority:
+ * - an option is supported when the definition declares an input of that name;
+ * - `.break()` is supported when the definition declares a `break` target handle.
+ */
+import { BUNDLED_DEFINITIONS } from './flow-definitions.js';
+/** The wire type of `.loop()`. */
+export const LOOP_NODE_TYPE = 'core.logic.loop';
+/** The `core.logic.loop` version `.loop()` emits unless `{ version }` pins another. */
+export const LOOP_DEFAULT_VERSION = '2.4';
+/** The version `.loop()` emits for these options. */
+export function loopVersion(options) {
+    return options?.version ?? LOOP_DEFAULT_VERSION;
+}
+/**
+ * True when this loop version's body runs from the inner `start` handle and goes
+ * back through `continue` (2.x); false for the legacy `output`/`loopBack` shape.
+ * A version with no bundled definition counts as 2.x; its lookup fails later.
+ */
+export function loopHasInnerHandles(version) {
+    return loopDefinition(version) ? targetHandleIds(version).has('continue') : true;
+}
+/** The loop options whose support depends on the version, in message order. */
+const VERSIONED_OPTIONS = ['parallel', 'completionCondition', 'breakEnabled'];
+/**
+ * The features this loop uses that its version's definition cannot express, in
+ * a fixed order (`parallel`, `completionCondition`, `breakEnabled`, `break()`).
+ * Empty when all are supported, or when no definition is bundled for the version
+ * (an unknown version is reported elsewhere, by the definition lookup).
+ */
+export function unsupportedLoopFeatures(options, usesBreak) {
+    const def = loopDefinition(loopVersion(options));
+    if (!def)
+        return [];
+    const inputs = def.inputDefinition?.properties ?? {};
+    const out = VERSIONED_OPTIONS.filter((k) => options?.[k] !== undefined && !(k in inputs));
+    if (usesBreak && !targetHandleIds(loopVersion(options)).has('break'))
+        out.push('break()');
+    return out;
+}
+/**
+ * The refusal for a loop whose options or body need a definition the requested
+ * version does not have, or `undefined` when there is nothing to refuse.
+ * `serialize` throws it; `check` reports it as `LOOP_VERSION_UNSUPPORTED` with
+ * the same text, so the author reads one message in both places.
+ */
+export function loopVersionRefusal(name, options, usesBreak) {
+    const missing = unsupportedLoopFeatures(options, usesBreak);
+    if (missing.length === 0)
+        return undefined;
+    const version = loopVersion(options);
+    return `loop "${name}": ${missing.join('/')} ${missing.length === 1 ? 'needs' : 'need'} the loop's `
+        + `${LOOP_DEFAULT_VERSION} definition, but { version: '${version}' } was requested. `
+        + `Drop the version or request ${LOOP_DEFAULT_VERSION}.`;
+}
+/**
+ * The warning for `parallel: true` on a 1.0.0 loop, or `undefined`. The 1.0.0
+ * definition declares the input, so the loop compiles and a canvas 1.0.0 loop
+ * round-trips; whether the 1.0.0 runtime runs its iterations in parallel is not
+ * confirmed, so a new loop that needs that should use the default version.
+ * `check` reports it as `LOOP_PARALLEL_LEGACY`.
+ */
+export function loopParallelWarning(name, options) {
+    if (options?.parallel !== true || loopHasInnerHandles(loopVersion(options)))
+        return undefined;
+    return `loop "${name}": parallel: true on { version: '${loopVersion(options)}' } is written to the node, but `
+        + `that version is not confirmed to run iterations in parallel, so the loop may run them one by one. `
+        + `Keep it to round-trip an existing loop; for a new parallel loop, drop the version (${LOOP_DEFAULT_VERSION}).`;
+}
+/**
+ * True when a container body (or an arm/handler inside it, but not a NESTED
+ * container's body) breaks: a nested `.loop()`/`.doWhile()` owns its own
+ * `.break()`.
+ */
+export function bodyUsesBreak(steps) {
+    return steps.some((s) => s.kind === 'break'
+        || (s.kind === 'branch' && (bodyUsesBreak(s.then) || bodyUsesBreak(s.otherwise)))
+        || (s.kind === 'switch' && (s.cases.some((c) => bodyUsesBreak(c.body)) || (s.default ? bodyUsesBreak(s.default) : false)))
+        || (s.kind === 'stepSwitch' && s.cases.some((c) => bodyUsesBreak(c.body)))
+        || (s.kind === 'parallel' && s.arms.some(bodyUsesBreak))
+        || (s.kind === 'stepToList' && bodyUsesBreak(s.body)));
+}
+function loopDefinition(version) {
+    return BUNDLED_DEFINITIONS[`${LOOP_NODE_TYPE}@${version}`];
+}
+function targetHandleIds(version) {
+    const ids = new Set();
+    for (const group of loopDefinition(version)?.handleConfiguration ?? []) {
+        for (const h of group.handles ?? [])
+            if (h.type === 'target')
+                ids.add(h.id);
+    }
+    return ids;
+}

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

@@ -8,6 +8,7 @@
  */
 import { Expr } from '../../../core/expr.js';
 import { jsonClone } from '../../../core/json-clone.js';
+import { isRecord } from '../../../core/node-envelope.js';
 import { wireExprBody } from '../../../core/wire-expr.js';
 import { checkHttpRead, checkHttpStep, plainHttpOnErrorMessage } from './check.js';
 const PLAIN = 'core.action.http';
@@ -264,7 +265,7 @@ function liftHttp(node, ctx, managed) {
             return raw;
         return text.startsWith('=js:') ? ctx.expr(text) : text;
     };
-    const map = (m) => m && typeof m === 'object' && Object.keys(m).length
+    const map = (m) => isRecord(m) && Object.keys(m).length
         ? Object.fromEntries(Object.entries(m).map(([k, v]) => [k, value(v)]))
         : undefined;
     const text = (v) => (typeof v === 'string' ? v : undefined);

package/dist/nodes/queue/flow/check.d.ts

@@ -7,6 +7,19 @@ import type { FlowCheckContext } from '../../../flow-node-type.js';
 import type { QueueItemInputs } from './spec.js';
 /** Every code the family reports, with the severity it reports it at. */
 export declare const QUEUE_DIAGNOSTICS: DiagnosticCatalog;
+/**
+ * Whether a definition stores `inputs.itemData` as a JSON STRING — the 1.0 era.
+ * 1.1 and later declare an `object`. Read off the definition being emitted or
+ * lifted, not off a version number, so a carried definition of any era answers
+ * for itself.
+ */
+export declare function itemDataIsString(def: unknown): boolean;
+/**
+ * Why `item.<field>` cannot be an expression on a definition that stores the item
+ * as one JSON string. Shared by `check` (QUEUE_ITEM_EXPR_UNSUPPORTED) and the
+ * serializer's refusal, so the two say the same thing.
+ */
+export declare function queueItemExprMessage(step: string, typeName: string, version: string, field: string): string;
 /**
  * Check a `queueItem(...)` call.
  *
@@ -31,5 +44,7 @@ export declare const QUEUE_DIAGNOSTICS: DiagnosticCatalog;
  *  - `returns` on a step that does not wait (there is nothing per-tenant to
  *    declare), and a `wait: true` step whose result nothing can read.
  *  - a non-ISO `dueDate` / `deferDate`.
+ *  - an expression in `item` when the definition stores the item as one JSON
+ *    string (1.0): the serializer refuses it, so `check` reports it first.
  */
-export declare function checkQueueItem(inputs: QueueItemInputs | undefined, ctx: FlowCheckContext): void;
+export declare function checkQueueItem(inputs: QueueItemInputs | undefined, ctx: FlowCheckContext, typeName: string): void;

package/dist/nodes/queue/flow/check.js

@@ -11,6 +11,7 @@ export const QUEUE_DIAGNOSTICS = {
     QUEUE_NO_ITEM: { severity: 'warning', summary: 'the item carries no data' },
     QUEUE_ITEM_NOT_OBJECT: { severity: 'error', summary: 'the item is not an object' },
     QUEUE_ITEM_FIELD_NOT_PRIMITIVE: { severity: 'error', summary: 'an item field is not a primitive' },
+    QUEUE_ITEM_EXPR_UNSUPPORTED: { severity: 'error', summary: 'an expression in an item stored as one JSON string' },
     QUEUE_BAD_PRIORITY: { severity: 'error', summary: 'a priority the node type does not offer' },
     QUEUE_BAD_DATE: { severity: 'error', summary: 'a date Orchestrator cannot read' },
     QUEUE_RETURNS_WITHOUT_WAIT: { severity: 'warning', summary: 'returns without wait: true' },
@@ -18,6 +19,27 @@ export const QUEUE_DIAGNOSTICS = {
     QUEUE_READ_WITHOUT_RETURNS: { severity: 'error', summary: 'a field read off a wait result with no returns' },
     QUEUE_READ_UNKNOWN_FIELD: { severity: 'error', summary: 'a read of a field the step does not publish' },
 };
+/**
+ * Whether a definition stores `inputs.itemData` as a JSON STRING — the 1.0 era.
+ * 1.1 and later declare an `object`. Read off the definition being emitted or
+ * lifted, not off a version number, so a carried definition of any era answers
+ * for itself.
+ */
+export function itemDataIsString(def) {
+    const props = def
+        ?.inputDefinition?.properties;
+    return props?.itemData?.type === 'string';
+}
+/**
+ * Why `item.<field>` cannot be an expression on a definition that stores the item
+ * as one JSON string. Shared by `check` (QUEUE_ITEM_EXPR_UNSUPPORTED) and the
+ * serializer's refusal, so the two say the same thing.
+ */
+export function queueItemExprMessage(step, typeName, version, field) {
+    return `Queue step "${step}": ${typeName}@${version} stores the item as one JSON string, so \`item.${field}\` `
+        + `cannot be an expression there. Omit the { version } to emit the SDK's default version, which `
+        + `stores the item as an object of values and expressions.`;
+}
 /**
  * Check a `queueItem(...)` call.
  *
@@ -42,8 +64,10 @@ export const QUEUE_DIAGNOSTICS = {
  *  - `returns` on a step that does not wait (there is nothing per-tenant to
  *    declare), and a `wait: true` step whose result nothing can read.
  *  - a non-ISO `dueDate` / `deferDate`.
+ *  - an expression in `item` when the definition stores the item as one JSON
+ *    string (1.0): the serializer refuses it, so `check` reports it first.
  */
-export function checkQueueItem(inputs, ctx) {
+export function checkQueueItem(inputs, ctx, typeName) {
     const step = ctx.step;
     // Severity is the catalog's (QUEUE_DIAGNOSTICS): `at` and `warn` name the intent.
     const at = (code, message, suggestion) => ctx.report(code, message, suggestion);
@@ -83,7 +107,12 @@ export function checkQueueItem(inputs, ctx) {
             + `item's \`SpecificContent\`.`, `item: { InvoiceId: 'INV-1', Amount: 120 }`);
     }
     else {
+        const itemIsString = itemDataIsString(ctx.definition());
         for (const [k, v] of Object.entries(item)) {
+            if (v instanceof Expr && itemIsString) {
+                at('QUEUE_ITEM_EXPR_UNSUPPORTED', queueItemExprMessage(step, typeName, ctx.version, k));
+                continue;
+            }
             // An Expr is a reference the runtime resolves — its VALUE may be anything,
             // and nothing local can know, so it is not flagged here.
             if (v instanceof Expr)

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

@@ -1,6 +1,7 @@
 import { Expr } from '../../../core/expr.js';
 import { jsonClone } from '../../../core/json-clone.js';
-import { checkQueueItem } from './check.js';
+import { isRecord } from '../../../core/node-envelope.js';
+import { checkQueueItem, itemDataIsString, queueItemExprMessage } from './check.js';
 import { QUEUE_ITEM_RECORD_SCHEMA } from './record.js';
 const CREATE = 'core.action.queue.create';
 const CREATE_AND_WAIT = 'core.action.queue.create-and-wait';
@@ -159,6 +160,87 @@ function liftReturns(node) {
         .map(([k, v]) => [k, v.type]);
     return entries.length ? Object.fromEntries(entries) : undefined;
 }
+/**
+ * The surface's `item` as a 1.0 node stores it: one JSON string, `''` for no
+ * data (the 1.0 definition's own default). A JSON string holds DATA, so an
+ * expression in a field has no spelling there; it is refused rather than
+ * written as text the runtime would never evaluate.
+ */
+function itemDataString(item, step, typeName, version) {
+    const rows = Object.entries(item);
+    if (rows.length === 0)
+        return '';
+    for (const [k, v] of rows) {
+        if (v instanceof Expr)
+            throw new Error(queueItemExprMessage(step, typeName, version, k));
+    }
+    return JSON.stringify(item);
+}
+/** Whether `v` is, or holds at any depth, an integer JSON.parse could not represent exactly. */
+function hasUnsafeInteger(v) {
+    if (typeof v === 'number')
+        return Number.isInteger(v) && !Number.isSafeInteger(v);
+    if (Array.isArray(v))
+        return v.some(hasUnsafeInteger);
+    return isRecord(v) && Object.values(v).some(hasUnsafeInteger);
+}
+/**
+ * `inputs.itemData` back as the surface's `item`, in either wire shape:
+ *
+ *  - 1.1 and later: an object of field → value, each value as the author wrote it
+ *    (`=js:` text back to an Expr);
+ *  - 1.0: ONE JSON STRING (`"{\"invoiceId\":\"INV-1001\"}"`), which is parsed back
+ *    to the object it encodes; `''` is the 1.0 default, no data.
+ *
+ * `undefined`, with a warning, for a value `item` cannot hold without changing
+ * what the node does — a whole-item expression, a string that is not a JSON
+ * object, an integer beyond 2^53 (parsing rounds it), or a JSON field whose
+ * text starts with `=` (literal data at 1.0; it would become an expression once
+ * written as an object). The lift then
+ * declines the node and decompile keeps it as a `rawNode`, verbatim.
+ *
+ * Reading the shape off the value, never assuming it, is the point: treating
+ * the 1.0 string as an object spread it into one field per character
+ * (flow-builder-sdk#1164).
+ */
+function liftItem(raw, ctx, value) {
+    const decline = (why) => {
+        ctx.warn(`node ${JSON.stringify(ctx.nodeId)}: its queue item data (inputs.itemData) is ${why}, which \`queueItem({ item })\` `
+            + `cannot hold without changing it, so the source keeps the node as a rawNode, verbatim.`);
+        return undefined;
+    };
+    if (raw === undefined || raw === null)
+        return {};
+    if (typeof raw === 'string') {
+        if (raw === '')
+            return {};
+        if (raw.startsWith('='))
+            return decline('an expression for the whole item');
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return decline('a string that is not JSON');
+        }
+        if (!isRecord(parsed))
+            return decline('a JSON string that does not encode an object');
+        const expressionLike = Object.keys(parsed).find((k) => typeof parsed[k] === 'string' && parsed[k].startsWith('='));
+        if (expressionLike !== undefined)
+            return decline(`a JSON string whose field "${expressionLike}" starts with "="`);
+        // JSON.parse rounds an integer beyond 2^53 (`12345678901234567890` reads back
+        // as `12345678901234567000`), and the compile would write the rounded value.
+        const rounded = Object.keys(parsed).find((k) => hasUnsafeInteger(parsed[k]));
+        if (rounded !== undefined)
+            return decline(`a JSON string whose field "${rounded}" holds an integer too large to read back exactly`);
+        return parsed;
+    }
+    if (ctx.sourceText(raw) !== undefined)
+        return decline('an expression for the whole item');
+    if (!isRecord(raw))
+        return decline(Array.isArray(raw) ? 'an array' : `a ${typeof raw}`);
+    return Object.fromEntries(Object.entries(raw).map(([k, v]) => [k, value(v)]));
+}
 function queueAt(typeName, wait) {
     return {
         kind: 'queueItem', typeName, version: '1.2', factory: 'queueItem', definition: 'per-tenant', errorPort: true,
@@ -169,7 +251,8 @@ function queueAt(typeName, wait) {
             const { ids, entries } = queueItemBindings(s, ctx.bindings);
             for (const b of entries)
                 ctx.bind(b);
-            const manifest = queueItemDef(s, typeName, ctx.step, ids, ctx.definition(typeName, ctx.version));
+            const base = ctx.definition(typeName, ctx.version);
+            const manifest = queueItemDef(s, typeName, ctx.step, ids, base);
             return {
                 definition: { source: 'snapshot', nodeType: typeName, version: ctx.version, manifest },
                 // The result is read as `$vars.<step>.output`, like every other family: the
@@ -180,8 +263,11 @@ function queueAt(typeName, wait) {
                 inputs: {
                     queue: { name: s.queue, folderPath: s.folderPath, key: s.key },
                     // `itemData`, not `item`: the surface's name is friendlier, the node's is
-                    // the platform's. Rendered one level deep, as the item is FLAT.
-                    itemData: Object.fromEntries(Object.entries(s.item ?? {}).map(([k, v]) => [k, ctx.render(v)])),
+                    // the platform's. Rendered one level deep, as the item is FLAT — or, for a
+                    // definition of the 1.0 era, encoded as the one JSON string it declares.
+                    itemData: itemDataIsString(base)
+                        ? itemDataString(s.item ?? {}, ctx.step, typeName, ctx.version)
+                        : Object.fromEntries(Object.entries(s.item ?? {}).map(([k, v]) => [k, ctx.render(v)])),
                     priority: s.priority ?? 'Normal',
                     reference: s.reference === undefined ? '' : ctx.render(s.reference),
                     deferDate: s.deferDate === undefined ? '' : ctx.render(s.deferDate),
@@ -209,12 +295,14 @@ function queueAt(typeName, wait) {
             // A wait's `returns` is the schema serialize wrote for THIS step (the
             // template ships none), as the node's own `outputs` carries it.
             const returns = wait ? liftReturns(node) : undefined;
+            const item = liftItem(inputs.itemData, ctx, value);
+            if (item === undefined)
+                return undefined;
             return {
                 kind: 'queueItem',
                 inputs: {
                     queue: q.name, folderPath: q.folderPath, key: q.key,
-                    item: Object.fromEntries(Object.entries((inputs.itemData ?? {}))
-                        .map(([k, v]) => [k, value(v)])),
+                    item,
                     ...(typeof priority === 'string' ? { priority: priority } : {}),
                     ...(optional(inputs.reference) !== undefined ? { reference: optional(inputs.reference) } : {}),
                     ...(optional(inputs.deferDate) !== undefined ? { deferDate: optional(inputs.deferDate) } : {}),
@@ -249,7 +337,7 @@ function queueAt(typeName, wait) {
                 ],
             };
         },
-        check: ({ inputs }, ctx) => checkQueueItem(inputs, ctx),
+        check: ({ inputs }, ctx) => checkQueueItem(inputs, ctx, typeName),
         // check collected no expressions for a queue step before the port; unchanged by it.
         expressions: () => [],
         output: ({ inputs }) => queueOutput(inputs, wait),

package/dist/serialize.js

@@ -8,6 +8,7 @@
  */
 import ixpDefinition from './ixp-definition.json' with { type: 'json' };
 import { BUNDLED_DEFINITIONS, bundledVersions } from './flow-definitions.js';
+import { LOOP_DEFAULT_VERSION, bodyUsesBreak, loopHasInnerHandles, loopVersion, loopVersionRefusal } from './loop-version.js';
 import { Expr, toExpr, SCHEDULE_PRESETS, parseIxpProjectType, flatNameOf, flatNameSegmentsOf } from './flow-sdk.js';
 import { FlowAction, FlowTrigger } from './core/node-classes.js';
 import { CONTEXT_INDEX_DEFAULTS, CONTEXT_INDEX_DEFAULT_FILE_EXTENSION, contextIndexType } from './core/context-index.js';
@@ -75,15 +76,6 @@ const defByType = new Map();
 for (const d of Object.values(DEFS))
     if (!defByType.has(d.nodeType))
         defByType.set(d.nodeType, d);
-/** True when a container body (or an arm/handler inside it, but not a NESTED container's body) breaks. */
-function bodyUsesBreak(steps) {
-    return steps.some((s) => s.kind === 'break'
-        || (s.kind === 'branch' && (bodyUsesBreak(s.then) || bodyUsesBreak(s.otherwise)))
-        || (s.kind === 'switch' && (s.cases.some((c) => bodyUsesBreak(c.body)) || (s.default ? bodyUsesBreak(s.default) : false)))
-        || (s.kind === 'stepSwitch' && s.cases.some((c) => bodyUsesBreak(c.body)))
-        || (s.kind === 'parallel' && s.arms.some(bodyUsesBreak))
-        || (s.kind === 'stepToList' && bodyUsesBreak(s.body)));
-}
 const NODE_TYPE = {
     trigger: 'core.trigger.manual',
     scheduledTrigger: 'core.trigger.scheduled',
@@ -3448,8 +3440,6 @@ export function actionVersion(spec, explicit) {
 export function bundledDefinition(nodeType, requestedVersion) {
     return requestedVersion !== undefined ? DEFS[`${nodeType}@${requestedVersion}`] : defByType.get(nodeType);
 }
-/** The `core.logic.loop` version `.loop()` emits unless `{ version }` pins another. */
-const LOOP_DEFAULT_VERSION = '2.4';
 /**
  * The bundled definition a `.loop()` or `.doWhile()` container emits, at the
  * version serialize writes (`.loop()` defaults to `@2.4`, `.doWhile()` to the
@@ -6342,15 +6332,14 @@ export function serialize(built, opts = {}) {
                 // designer authors (inner start/continue/break handles, `currentIteration`
                 // output). 1.0.0 is the legacy shape the canvas shows in its old form; it
                 // is emitted only when { version: '1.0.0' } is pinned explicitly (#868).
-                // An explicit 1.0.0 plus a rich option is a contradiction the author must
-                // resolve, not a silent drop.
-                const rich = o.parallel !== undefined || o.completionCondition !== undefined || o.breakEnabled !== undefined || usesBreak;
-                const version = o.version ?? LOOP_DEFAULT_VERSION;
-                if (rich && version === '1.0.0') {
-                    throw new Error(`loop "${step.name}": parallel/completionCondition/breakEnabled/break() need the loop's 2.4 `
-                        + `definition, but { version: '1.0.0' } was requested. Drop the version or request 2.4.`);
-                }
-                const v24 = version !== '1.0.0';
+                // An option or a .break() the pinned version's definition cannot express
+                // is a contradiction the author must resolve, not a silent drop; `check`
+                // reports the same refusal from the same helper (#1186).
+                const refusal = loopVersionRefusal(step.name, o, usesBreak);
+                if (refusal)
+                    throw new Error(refusal);
+                const version = loopVersion(o);
+                const v24 = loopHasInnerHandles(version);
                 const id = stepUid(scope, step.name);
                 const node = makeNode(NODE_TYPE.loop, id, step.options?.label ?? step.label ?? step.name, { parentId, requestedVersion: version });
                 node.inputs = v24
@@ -6362,7 +6351,7 @@ export function serialize(built, opts = {}) {
                             : {}),
                         breakEnabled: (o.breakEnabled ?? false) || usesBreak,
                     }
-                    : { collection: renderValue(step.collection, scope.rename), parallel: false };
+                    : { collection: renderValue(step.collection, scope.rename), parallel: o.parallel ?? false };
                 scope.nodes.push(node);
                 for (const t of tails)
                     addEdge(scope, t, id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.31.1",
+  "version": "6.31.3",
   "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": "a2b7de2d90365755dd14494b4b3b3170c75d5932"
+  "gitref": "312d113c6d6ed072f209ca7faab413317d551880"
 }