@uipath/maestro-builder-sdk 6.26.0 → 6.27.0

package/dist/api-index.md

@@ -37,7 +37,7 @@ could hand you spans for a version you do not have.
 
 ## `@uipath/maestro-builder-sdk`
 
-219 symbol(s). Import from `@uipath/maestro-builder-sdk`.
+220 symbol(s). Import from `@uipath/maestro-builder-sdk`.
 
 | Symbol | Kind | Declaration | Area | Summary |
 | --- | --- | --- | --- | --- |
@@ -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:1193-1216` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1224-1247` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `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:695-707` | Supporting types | One additional flow root, built by `.entryPoint()`. |
-| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:708-749` | Supporting types | 16 field(s) |
+| `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts:719-731` | Supporting types | One additional flow root, built by `.entryPoint()`. |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:732-773` | Supporting types | 16 field(s) |
 | `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:474-483` | Option shapes | Do-while options. |
+| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:498-507` | 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:619-633` | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
+| `EdgeRoute` | interface | `dist/flow-sdk.d.ts:643-657` | 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:1541-1556` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1572-1587` | 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:1217-1540` | Builders | 14 member(s) |
-| `FlowLayout` | interface | `dist/flow-sdk.d.ts:681-694` | 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:1248-1571` | Builders | 14 member(s) |
+| `FlowLayout` | interface | `dist/flow-sdk.d.ts:705-718` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:126-161` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:176-183` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
 | `FlowTrigger` | class | `dist/core/node-classes.d.ts:169-175` | Supporting types | A node that starts the flow — pass an instance to `.trigger(…)`. |
@@ -181,19 +181,19 @@ 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:453-473` | Option shapes | Loop-specific options. |
+| `LoopOptions` | interface | `dist/flow-sdk.d.ts:477-497` | 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:604-618` | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
-| `NodeOptions` | interface | `dist/flow-sdk.d.ts:367-420` | Option shapes | Options shared by every builder method that creates a definition-backed node: `version` selects the exact node… |
+| `NodeLayout` | interface | `dist/flow-sdk.d.ts:628-642` | 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. |
 | `out` | function | `dist/core/expr.d.ts:73-94` | Expressions and types | Reference an upstream step's output → `$vars.<step>.output[.<path>]`. |
 | `Outcome` | type | `dist/nodes/hitl/flow/spec.d.ts:94-113` | Supporting types | One completion button. |
 | `OutputColumn` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:41-47` | Supporting types | One column Batch Transform appends to the CSV. |
-| `PortArm` | interface | `dist/flow-sdk.d.ts:354-366` | Supporting types | One arm of a built `.stepSwitch` — the same shape as SwitchArm, but `value` names an exit the ACTION declares (a… |
+| `PortArm` | interface | `dist/flow-sdk.d.ts:378-390` | Supporting types | One arm of a built `.stepSwitch` — the same shape as SwitchArm, but `value` names an exit the ACTION declares (a… |
 | `ProcessLocation` | type | `dist/core/actions.d.ts:346-351` | Supporting types | Where a process resource lives: deployed to an Orchestrator folder (`'published'`, the default) or a sibling project of… |
 | `ProcessToolKind` | type | `dist/core/actions.d.ts:1258-1271` | Supporting types | The tool kinds that wrap a DEPLOYED tenant resource. |
 | `ProcessToolRef` | interface | `dist/core/actions.d.ts:1272-1301` | Supporting types | A deployed tenant resource the agent may invoke. |
@@ -209,7 +209,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:679-696` | Supporting types | A JSON-schema-ish type for one field of a step's declared `returns`. |
-| `ReturnOptions` | interface | `dist/flow-sdk.d.ts:421-452` | Option shapes | `.return(...)`-specific options. |
+| `ReturnOptions` | interface | `dist/flow-sdk.d.ts:445-476` | Option shapes | `.return(...)`-specific options. |
 | `rpaWorkflow` | function | `dist/core/actions.d.ts:1613-1657` | Actions | Invoke a deployed RPA (robotic process automation) workflow — a classic UI-automation process, published to… |
 | `RpaWorkflowInputs` | interface | `dist/core/actions.d.ts:352-410` | 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. |
@@ -224,16 +224,17 @@ 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:484-603` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:750-1192` | Builders | Collects a sequence of steps. |
-| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:634-639` | Flow construction | The designer's sticky-note palette. |
-| `StickyNote` | interface | `dist/flow-sdk.d.ts:646-680` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
-| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:640-645` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1557-1596` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `Step` | type | `dist/flow-sdk.d.ts:508-627` | Supporting types |  |
+| `StepList` | class | `dist/flow-sdk.d.ts:774-1223` | Builders | Collects a sequence of steps. |
+| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:658-663` | Flow construction | The designer's sticky-note palette. |
+| `StickyNote` | interface | `dist/flow-sdk.d.ts:670-704` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
+| `StickyNoteColor` | type | `dist/flow-sdk.d.ts:664-669` | Supporting types | A sticky note's swatch. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1588-1627` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `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) |
-| `SwitchArm` | interface | `dist/flow-sdk.d.ts:341-353` | Supporting types | One arm of a built `.switch` (the serializer's view: body already collected). |
+| `SwitchArm` | interface | `dist/flow-sdk.d.ts:358-377` | Supporting types | One arm of a built `.switch` (the serializer's view: body already collected). |
+| `SwitchCase` | type | `dist/flow-sdk.d.ts:341-357` | Supporting types | One case of `.switch(name, on, cases)`: either `{ value }`, taken when `on === value`, or `{ when }`, taken when its own… |
 | `tmpl` | function | `dist/core/expr.d.ts:283-293` | Expressions and types | Build a JS *string template* (for URLs, messages, etc.). |
 | `ToolRef` | type | `dist/core/actions.d.ts:1068-1077` | Supporting types | One tool on an inline agent — a discriminated union over the kinds the tenant's registry actually serves… |
 | `transform` | function | `dist/nodes/transform/flow/factories.d.ts:7-52` | Actions | Declare a Transform action — a chain of declarative operations over a collection. |

package/dist/api-members.md

@@ -5,12 +5,12 @@
 
 # Maestro Builder SDK — member index
 
-**A lookup table of 1115 rows — match one name in it, do not read it.**
+**A lookup table of 1116 rows — match one name in it, do not read it.**
 Grep or search for the member you have; the row it lands on is the whole
 answer. Reading top to bottom costs ~20x what the one row does and tells you
 nothing you asked for.
 
-Every field and method of every exported shape — 1115 across
+Every field and method of every exported shape — 1116 across
 200 interfaces and classes — keyed by the MEMBER's own name.
 
 **Use this when the name you have is a field or a method**, which is usually
@@ -28,7 +28,7 @@ truncated summary would, for less. Read the span.
 Member names repeat across shapes (`name` is declared on 69 of them), so the
 `Declared on` column is what makes a match actionable. For the whole shape
 rather than the one field, look that name up in [`api-index.md`](api-index.md) —
-which is why its span is not repeated on all 1115 rows here.
+which is why its span is not repeated on all 1116 rows here.
 
 **A name that misses both indexes is probably not part of the API.** The one
 that comes up is a RUNTIME output key — a human task's `Action`, a step's
@@ -66,7 +66,7 @@ not find it either.
 | `app` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1337-1338` |
 | `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-175` |
 | `appVersion` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1339-1340` |
-| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1205` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1236` |
 | `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` |
@@ -91,20 +91,20 @@ not find it either.
 | `body` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1146-1155` |
 | `body` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1169-1170` |
 | `body` | property | `JsonSchemaType` | `dist/case/case-sdk.d.ts:539` |
-| `body` | property | `PortArm` | `dist/flow-sdk.d.ts:364-365` |
+| `body` | property | `PortArm` | `dist/flow-sdk.d.ts:388-389` |
 | `body` | property | `SchemaEntry` | `dist/bpmn/bpmn-sdk.d.ts:1003-1004` |
-| `body` | property | `SwitchArm` | `dist/flow-sdk.d.ts:352` |
+| `body` | property | `SwitchArm` | `dist/flow-sdk.d.ts:376` |
 | `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:949-967` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:973-991` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1077-1086` |
-| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:481-482` |
-| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:468-472` |
+| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1108-1117` |
+| `breakEnabled` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:505-506` |
+| `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:492-496` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3483-3488` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1269-1274` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1533-1539` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1564-1570` |
 | `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:616-617` |
+| `collapsed` | property | `NodeLayout` | `dist/flow-sdk.d.ts:640-641` |
 | `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:670-671` |
+| `color` | property | `StickyNote` | `dist/flow-sdk.d.ts:694-695` |
 | `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:463-467` |
+| `completionCondition` | property | `LoopOptions` | `dist/flow-sdk.d.ts:487-491` |
 | `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:668-669` |
+| `content` | property | `StickyNote` | `dist/flow-sdk.d.ts:692-693` |
 | `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:1087-1101` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1118-1132` |
 | `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:734-739` |
-| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1433-1473` |
+| `definitions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:758-763` |
+| `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1464-1504` |
 | `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:711-712` |
+| `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:735-736` |
 | `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:1242-1249` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1273-1280` |
 | `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:252-256` |
 | `documentClassify` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:56-59` |
 | `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:84-85` |
-| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1052-1076` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1083-1107` |
 | `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:692-693` |
+| `edges` | property | `FlowLayout` | `dist/flow-sdk.d.ts:716-717` |
 | `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:1308-1358` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1339-1389` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
-| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:740-741` |
+| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:764-765` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
 | `entryWhen` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:947-956` |
-| `err` | method | `StepList` | `dist/flow-sdk.d.ts:758-783` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:782-807` |
 | `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:678-679` |
+| `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:702-703` |
 | `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:260-263` |
@@ -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:697-698` |
-| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:709` |
+| `id` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:721-722` |
+| `id` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:733` |
 | `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,8 +449,8 @@ 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:658-667` |
-| `id` | property | `SwitchArm` | `dist/flow-sdk.d.ts:345-351` |
+| `id` | property | `StickyNote` | `dist/flow-sdk.d.ts:682-691` |
+| `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` |
 | `identifier` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1102-1109` |
@@ -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:1474-1486` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1505-1517` |
 | `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:703-704` |
-| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:721` |
+| `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:727-728` |
+| `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:745` |
 | `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,23 +534,23 @@ 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:1206-1215` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1237-1246` |
 | `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` |
-| `label` | property | `NodeOptions` | `dist/flow-sdk.d.ts:398-419` |
+| `label` | property | `NodeOptions` | `dist/flow-sdk.d.ts:422-443` |
 | `label` | property | `ShownField` | `dist/core/actions.d.ts:67-68` |
-| `label` | property | `SwitchArm` | `dist/flow-sdk.d.ts:344` |
+| `label` | property | `SwitchArm` | `dist/flow-sdk.d.ts:368` |
 | `labels` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:458-459` |
 | `labels` | property | `EscalationRef` | `dist/core/actions.d.ts:1405-1406` |
 | `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:730-731` |
+| `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:754-755` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1250-1260` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1281-1291` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
-| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:479-480` |
+| `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:503-504` |
 | `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` |
@@ -558,7 +558,7 @@ not find it either.
 | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
 | `loop` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:335-336` |
 | `loop` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:832-833` |
-| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1040-1051` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1071-1082` |
 | `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` |
@@ -627,7 +627,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:710` |
+| `name` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:734` |
 | `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` |
@@ -647,7 +647,7 @@ not find it either.
 | `name` | property | `EventSubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:1840-1841` |
 | `name` | property | `EventTriggerOpts` | `dist/case/case-sdk.d.ts:240` |
 | `name` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1499-1500` |
-| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1234-1241` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1265-1272` |
 | `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` |
@@ -675,7 +675,7 @@ not find it either.
 | `name` | property | `RegistryOutput` | `dist/bpmn/typed-node.d.ts:72` |
 | `name` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:1114-1115` |
 | `name` | property | `ResolvedEventTriggerOpts` | `dist/case/case-sdk.d.ts:266-267` |
-| `name` | property | `ReturnOptions` | `dist/flow-sdk.d.ts:436-451` |
+| `name` | property | `ReturnOptions` | `dist/flow-sdk.d.ts:460-475` |
 | `name` | property | `RpaWorkflowInputs` | `dist/core/actions.d.ts:364-365` |
 | `name` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:844-845` |
 | `name` | property | `SplitOpts` | `dist/bpmn/bpmn-sdk.d.ts:1830-1831` |
@@ -692,7 +692,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:690-691` |
+| `nodes` | property | `FlowLayout` | `dist/flow-sdk.d.ts:714-715` |
 | `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` |
@@ -709,7 +709,7 @@ 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:838-898` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:862-922` |
 | `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` |
@@ -720,14 +720,14 @@ not find it either.
 | `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:701-702` |
+| `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:725-726` |
 | `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:1487-1522` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1518-1553` |
 | `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` |
@@ -736,7 +736,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:722` |
+| `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:746` |
 | `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` |
@@ -762,8 +762,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:461-462` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1004-1039` |
+| `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:485-486` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1035-1070` |
 | `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` |
@@ -782,7 +782,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:606-610` |
+| `position` | property | `NodeLayout` | `dist/flow-sdk.d.ts:630-634` |
 | `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` |
@@ -862,7 +862,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:1182-1191` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1213-1222` |
 | `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` |
@@ -878,7 +878,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:627-632` |
+| `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:651-656` |
 | `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` |
@@ -901,9 +901,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:714-720` |
+| `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:738-744` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1393-1432` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1424-1463` |
 | `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` |
@@ -929,7 +929,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:611-615` |
+| `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:635-639` |
 | `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` |
@@ -975,16 +975,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:784-794` |
-| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:705-706` |
-| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:724` |
-| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:752` |
-| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:795-837` |
-| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:912-940` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1133-1161` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1162-1181` |
-| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:732-733` |
-| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1261-1286` |
+| `step` | method | `StepList` | `dist/flow-sdk.d.ts:808-818` |
+| `steps` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:729-730` |
+| `steps` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:748` |
+| `steps` | property | `StepList` | `dist/flow-sdk.d.ts:776` |
+| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:819-861` |
+| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:936-964` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1164-1192` |
+| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1193-1212` |
+| `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:756-757` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1292-1317` |
 | `storageBucket` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:82-83` |
 | `strategy` | property | `LookupSpec` | `dist/core/lookups.d.ts:33` |
 | `style` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:597-598` |
@@ -997,7 +997,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:968-1003` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:992-1034` |
 | `systemPrompt` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:134-139` |
 | `systemPrompt` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:814-863` |
 | `systemPrompt` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:221-226` |
@@ -1022,7 +1022,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:1102-1132` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1133-1163` |
 | `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` |
@@ -1042,16 +1042,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:699-700` |
-| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:725-727` |
+| `trigger` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:723-724` |
+| `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:749-751` |
 | `trigger` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1224-1232` |
 | `trigger` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:128-129` |
-| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1287-1307` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1318-1338` |
 | `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:742-748` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1359-1378` |
-| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:728-729` |
+| `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:766-772` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1390-1409` |
+| `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:752-753` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
 | `type` | property | `ActionField` | `dist/case/case-sdk.d.ts:435-436` |
@@ -1081,7 +1081,7 @@ not find it either.
 | `unit` | property | `BuiltSla` | `dist/case/case-sdk.d.ts:189` |
 | `unit` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:169` |
 | `unresolved` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:728-740` |
-| `updates` | property | `NodeOptions` | `dist/flow-sdk.d.ts:381-397` |
+| `updates` | property | `NodeOptions` | `dist/flow-sdk.d.ts:405-421` |
 | `url` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:32` |
 | `url` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1134-1135` |
 | `url` | property | `HttpRequestToolRef` | `dist/core/actions.d.ts:1155-1156` |
@@ -1098,15 +1098,15 @@ not find it either.
 | `value` | property | `InOutField` | `dist/core/actions.d.ts:103-104` |
 | `value` | property | `LookupResolution` | `dist/core/lookups.d.ts:167-168` |
 | `value` | property | `LookupSpec` | `dist/core/lookups.d.ts:29-30` |
-| `value` | property | `PortArm` | `dist/flow-sdk.d.ts:362-363` |
+| `value` | property | `PortArm` | `dist/flow-sdk.d.ts:386-387` |
 | `value` | property | `ShownField` | `dist/core/actions.d.ts:71-77` |
-| `value` | property | `SwitchArm` | `dist/flow-sdk.d.ts:343` |
+| `value` | property | `SwitchArm` | `dist/flow-sdk.d.ts:360-361` |
 | `value` | property | `TaskInputBinding` | `dist/case/case-sdk.d.ts:485-486` |
 | `value` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:174-175` |
 | `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:1523-1532` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1554-1563` |
 | `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` |
@@ -1116,12 +1116,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:723` |
+| `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:747` |
 | `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:713` |
+| `version` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:737` |
 | `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` |
@@ -1129,8 +1129,8 @@ 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:1379-1392` |
-| `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:373-380` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1410-1423` |
+| `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` |
 | `versionTag` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:328-329` |
@@ -1146,12 +1146,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:621-626` |
+| `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:645-650` |
 | `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:676-677` |
-| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:672-673` |
-| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:674-675` |
+| `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:700-701` |
+| `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:696-697` |
+| `y` | property | `StickyNote` | `dist/flow-sdk.d.ts:698-699` |
 | `zIndex` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:608-609` |

package/dist/check.js

@@ -518,13 +518,51 @@ function checkFlow(built, ancestors, opts = {}) {
                 walk(s.otherwise, inLoop);
             }
             else if (s.kind === 'switch') {
-                addExpr(s.on.js, s.name);
+                if (s.on)
+                    addExpr(s.on.js, s.name);
+                for (const c of s.cases)
+                    if (c.when)
+                        addExpr(c.when.js, s.name);
                 switchNames.add(s.name);
+                s.cases.forEach((c, i) => {
+                    const hasValue = c.value !== undefined;
+                    const hasWhen = c.when !== undefined;
+                    if (hasValue === hasWhen || (hasValue && !s.on)) {
+                        diags.push({
+                            level: 'error',
+                            code: 'SWITCH_CASE_FORM',
+                            message: hasValue && hasWhen
+                                ? `Switch "${s.name}" case ${i + 1} has both \`value\` and \`when\`. Give it one: \`value\` is compared with \`on\`, \`when\` is the case's own condition.`
+                                : hasValue
+                                    ? `Switch "${s.name}" case ${i + 1} has a \`value\` but the switch has no \`on\` to compare it with. Pass \`on\`, or give the case a \`when\` condition.`
+                                    : `Switch "${s.name}" case ${i + 1} has neither \`value\` nor \`when\`.`,
+                            step: s.name,
+                        });
+                    }
+                    if (hasWhen && c.when.literal) {
+                        diags.push({
+                            level: 'error',
+                            code: 'SWITCH_CONST_WHEN',
+                            message: `Switch "${s.name}" case ${i + 1}'s \`when\` is the constant ${JSON.stringify(c.when.value)}, so it is always or never taken. Pass an expression.`,
+                            step: s.name,
+                        });
+                    }
+                });
                 // A constant discriminant can never match a case — it is what
                 // `.switch('q', 'quarter', …)` (a name where an expression belongs)
                 // degrades into once types are stripped, and it would emit
                 // `"quarter" === 2`: valid JS, always false, default arm every time.
-                if (s.on.literal)
+                // `on` is compared only with `value` cases; with none, it is unused.
+                const hasValueCase = s.cases.some((c) => c.value !== undefined);
+                if (s.on && !hasValueCase && s.cases.length > 0)
+                    diags.push({
+                        level: 'warning',
+                        code: 'SWITCH_ON_UNUSED',
+                        message: `Switch "${s.name}" has an \`on\`, but every case has its own \`when\` condition, so \`on\` is never compared. `
+                            + 'Pass `undefined` for `on`.',
+                        step: s.name,
+                    });
+                if (s.on?.literal && hasValueCase)
                     diags.push({
                         level: 'error',
                         code: 'SWITCH_CONST_ON',
@@ -563,12 +601,12 @@ function checkFlow(built, ancestors, opts = {}) {
                     seenIds.add(String(caseId));
                 });
                 for (const c of s.cases) {
-                    const key = `${typeof c.value}:${String(c.value)}`;
+                    const key = c.when !== undefined ? `when:${c.when.js}` : `${typeof c.value}:${String(c.value)}`;
                     if (seenValues.has(key))
                         diags.push({
                             level: 'error',
                             code: 'DUP_CASE',
-                            message: `Switch "${s.name}" has two cases for ${JSON.stringify(c.value)}; the second is unreachable `
+                            message: `Switch "${s.name}" has two cases for ${c.when !== undefined ? `when ${c.when.js}` : JSON.stringify(c.value)}; the second is unreachable `
                                 + '(the first matching case wins).',
                             step: s.name,
                         });
@@ -577,7 +615,7 @@ function checkFlow(built, ancestors, opts = {}) {
                         diags.push({
                             level: 'warning',
                             code: 'EMPTY_ARM',
-                            message: `Switch "${s.name}" has an empty arm for case ${JSON.stringify(c.value)}.`,
+                            message: `Switch "${s.name}" has an empty arm for case ${c.when !== undefined ? `when ${c.when.js}` : JSON.stringify(c.value)}.`,
                             step: s.name,
                         });
                     walk(c.body, inLoop);
@@ -3935,6 +3973,8 @@ function reportUnreachableHitlOutcomes(choices, exprs, diags) {
  * and so are object/array/any/file discriminants — nothing useful to compare.
  */
 function checkCaseValueTypes(s, typeOf, diags, triggerId) {
+    if (!s.on)
+        return;
     const refName = declaredRefName(s.on.js, triggerId);
     if (!refName)
         return;
@@ -3946,6 +3986,8 @@ function checkCaseValueTypes(s, typeOf, diags, triggerId) {
     if (!expected)
         return;
     for (const c of s.cases) {
+        if (c.value === undefined)
+            continue;
         const actual = typeof c.value;
         if (actual === expected)
             continue;

package/dist/decompile.js

@@ -2629,6 +2629,11 @@ function parseSwitchCase(expr) {
  * expression is `<discriminant> === <JSON-literal>`; the discriminant (shared by
  * all cases) becomes `on`, and each RHS literal a case `value`. The case port is
  * `case-<caseId>`; the optional default arm is the `default` port.
+ *
+ * A switch whose cases do NOT share that shape — the product's per-case form,
+ * `amount > 100` / `amount <= 100`, first truthy case wins — decompiles to
+ * `when:` cases with `on` left `undefined`, so each condition round-trips
+ * as written (#1131).
  */
 function emitSwitch(node, ipdom, scope, ctx, stop, refInto) {
     const r = ipdom.get(node.id) ?? stop;
@@ -2636,70 +2641,55 @@ function emitSwitch(node, ipdom, scope, ctx, stop, refInto) {
     let caseIndex = 0;
     let disc;
     let nonUniform = false; // a case whose expr isn't `<disc> === <literal>`, or a differing discriminant
-    const caseSrcs = [];
-    for (const c of cases) {
-        const parsed = parseSwitchCase(String(c.expression ?? ''));
-        let value = '0';
-        let valueLiteral = '';
-        if (parsed) {
+    // First pass: is every case one shared `<disc> === <literal>`? If not, every
+    // case is emitted as `when:` with its expression as written.
+    const parsed = cases.map((c) => {
+        const p = parseSwitchCase(String(c.expression ?? ''));
+        if (p) {
             if (disc === undefined)
-                disc = parsed.lhs;
-            else if (disc !== parsed.lhs)
+                disc = p.lhs;
+            else if (disc !== p.lhs)
                 nonUniform = true;
-            valueLiteral = parsed.literal;
-            value = parsed.value;
         }
         else {
             nonUniform = true;
-            // Keep the best-effort output the TODO comment points at.
-            const m = String(c.expression ?? '').match(/^(.*?)\s*===?\s*(.*)$/);
-            if (m && m[1].trim() && disc === undefined)
-                disc = m[1].trim();
-            if (m) {
-                valueLiteral = m[2].trim();
-                try {
-                    value = tsLiteral(JSON.parse(valueLiteral));
-                }
-                catch {
-                    const q = valueLiteral.match(/^'(.*)'$/);
-                    value = q ? tsLiteral(q[1]) : tsLiteral(valueLiteral);
-                }
-            }
         }
+        return { c, p };
+    });
+    const caseSrcs = parsed.map(({ c, p }) => {
         const armSegs = forkRegion(portEdges(ctx.graph, node.id, `case-${c.id}`), r, scope, ipdom, ctx, refInto);
-        const defaultLabel = `Case ${valueLiteral}`;
+        caseIndex += 1;
+        const defaultLabel = nonUniform || !p ? `Case ${caseIndex}` : `Case ${p.literal}`;
         const labelPart = c.label && c.label !== defaultLabel ? `, label: ${tsLiteral(c.label)}` : '';
         // The file's case id comes back when it is not the positional one serialize
         // derives (a designer-drawn switch uses `default-1`, …), so the recompiled
         // edges leave from the ORIGINAL node's handles, which merge keeps (#1130).
-        caseIndex += 1;
         const idPart = typeof c.id === 'string' && c.id !== '' && c.id !== `case_${caseIndex}` ? `, id: ${tsLiteral(c.id)}` : '';
-        caseSrcs.push(`{ value: ${value}${labelPart}${idPart}, body: ${armCb('b', armSegs)} }`);
+        const head = nonUniform || !p
+            ? `when: ${emitBareExpr(String(c.expression ?? ''), ctx.imp, ctx.inputNames)}`
+            : `value: ${p.value}`;
+        return `{ ${head}${labelPart}${idPart}, body: ${armCb('b', armSegs)} }`;
+    });
+    // A case with no condition has no `when:` that compiles: emitting `js\`\``
+    // would fail at compile ([EXPR_SYNTAX]) with no warning here.
+    const empty = cases.filter((c) => String(c.expression ?? '').trim() === '');
+    if (empty.length > 0) {
+        const listing = empty.map((c) => tsLiteral(c.label ?? c.id)).join(', ');
+        const message = `switch ${tsLiteral(node.id)} has a case with no condition (${listing}). `
+            + '`.switch()` needs a condition on every case, so the decompiled `when:` is empty and recompiling fails. '
+            + 'Give the case a condition in the .flow, or edit this switch in the .flow JSON directly.';
+        if (runStrict)
+            throw new Error(`decompile: ${message}`);
+        warnOnce(message);
     }
-    const on = emitBareExpr(disc ?? '', ctx.imp, ctx.inputNames);
+    const on = nonUniform ? 'undefined' : emitBareExpr(disc ?? '', ctx.imp, ctx.inputNames);
     const hasDefault = (node.inputs ?? {}).hasDefault === true || portEdge(ctx.graph, node.id, 'default') !== undefined;
     const defArm = hasDefault
         ? `, ${armCb('d', forkRegion(portEdges(ctx.graph, node.id, 'default'), r, scope, ipdom, ctx, refInto))}`
         : '';
     const caseList = `[\n${caseSrcs.map((c) => reindent(c, '  ')).join(',\n')},\n]`;
-    // The builder's `.switch(on, [{value}])` models `on === value` only. A flow whose
-    // cases carry arbitrary per-case boolean expressions (or a non-uniform
-    // discriminant) cannot round-trip through it — flag it rather than emit silently
-    // wrong values.
-    if (nonUniform) {
-        const listing = cases.map((c) => `${tsLiteral(c.label ?? c.id)}: ${tsLiteral(String(c.expression ?? ''))}`).join(', ');
-        const message = `switch ${tsLiteral(node.id)} has per-case conditions that are not one shared \`<discriminant> === <value>\` `
-            + `(${listing}). \`.switch()\` models only that form, so the decompiled \`on\`/\`value\` are placeholders: `
-            + 'recompiling either fails or changes which case runs. Edit this switch in the .flow JSON directly.';
-        if (runStrict)
-            throw new Error(`decompile: ${message}`);
-        warnOnce(message);
-    }
-    const warn = nonUniform
-        ? `\n/* TODO: this switch's case expressions are not a uniform \`<discriminant> === <value>\`; the recovered on/value are best-effort and need review. */`
-        : '';
     const ver = verArg(node);
-    return `.switch(${tsLiteral(node.id)}, ${on}, ${caseList}${defArm}${ver && !defArm ? ', undefined' : ''}${ver})${warn}`;
+    return `.switch(${tsLiteral(node.id)}, ${on}, ${caseList}${defArm}${ver && !defArm ? ', undefined' : ''}${ver})`;
 }
 /**
  * Recover `.stickyNotes([...])` from the scope's `stickyNote` nodes.

package/dist/flow-expr-check.js

@@ -147,7 +147,12 @@ function walk(steps, roots, out) {
                 walk(s.otherwise, roots, out);
                 break;
             case 'switch': {
-                pushExpr(s.on, s.name, roots, out);
+                if (s.on)
+                    pushExpr(s.on, s.name, roots, out);
+                // A `when` case's condition is read like a branch condition (#1131).
+                for (const c of s.cases)
+                    if (c.when)
+                        pushExpr(c.when, s.name, roots, out);
                 // Inside a case (or default) body the discriminant is bound to
                 // `$vars.value`, so it is a valid root only there.
                 const caseRoots = new Set(roots).add('value');

package/dist/flow-sdk.d.ts

@@ -338,9 +338,33 @@ export declare function conversationTrigger(): TriggerSpec;
 export declare function voiceTrigger(): TriggerSpec;
 /** A value a `.switch` case compares the discriminant against. */
 export type CaseValue = string | number | boolean;
+/**
+ * One case of `.switch(name, on, cases)`: either `{ value }`, taken when
+ * `on === value`, or `{ when }`, taken when its own condition is true (the
+ * product switch's per-case form, #1131). Cases are tried top to bottom and the
+ * first match wins.
+ */
+export type SwitchCase = ({
+    value: CaseValue;
+    when?: undefined;
+} | {
+    when: Expr;
+    value?: undefined;
+}) & {
+    body: (b: ArmBuilder) => void;
+    label?: string;
+    id?: string;
+};
 /** One arm of a built `.switch` (the serializer's view: body already collected). */
 export interface SwitchArm {
-    value: CaseValue;
+    /** The value `on` is compared against (`on === value`). Absent on a `when` case. */
+    value?: CaseValue;
+    /**
+     * The case's own boolean condition, instead of `on === value` — the product
+     * switch stores one condition per case and takes the first that is true
+     * (#1131). Exactly one of `value` / `when`.
+     */
+    when?: Expr;
     label?: string;
     /**
      * The case's wire id — `inputs.cases[].id`, and the `case-<id>` port its arm
@@ -500,7 +524,7 @@ export type Step = {
     kind: 'switch';
     name: string;
     label?: string;
-    on: Expr;
+    on?: Expr;
     cases: SwitchArm[];
     default?: Step[];
     options?: NodeOptions;
@@ -984,23 +1008,30 @@ declare class StepList {
      * ], (other) => other.step('unknown', script({ code: 'return "Unknown";' })))
      * ```
      *
+     * @example
+     * **Cases with their own conditions** (`on` is `undefined`)
+     * ```ts
+     * .switch('route', undefined, [
+     *   { when: js`$vars.start.output.amount > 100`, label: 'High', body: (b) => b.step('review', script({ code: 'return 1;' })) },
+     *   { when: js`$vars.start.output.amount <= 100`, label: 'Low', body: (b) => b.step('auto', script({ code: 'return 2;' })) },
+     * ])
+     * ```
+     *
      * @param name - The switch node's id.
-     * @param on - The value to compare each case against.
-     * @param cases - One entry per arm, evaluated top to bottom; the first strict
-     * match wins. `label` names the arm's outgoing edge. `id` keeps a case's wire
-     * id (`inputs.cases[].id`, port `case-<id>`); omitted, it is `case_<n>`.
+     * @param on - The value to compare each `value` case against; `undefined`
+     * when every case carries its own `when` condition.
+     * @param cases - One entry per arm, evaluated top to bottom; the first match
+     * wins. A case is `{ value }` (strict `on === value`) or `{ when }` (its own
+     * boolean expression). `label` names the arm's outgoing edge. `id` keeps a
+     * case's wire id (`inputs.cases[].id`, port `case-<id>`); omitted, it is
+     * `case_<n>`.
      * @param defaultFn - Receives a sub-builder for the arm taken when nothing
      * matches. Omit it and an unmatched value simply continues.
      * @param options - Node options; `version` selects the exact definition
      * version (see {@link NodeOptions}).
      * @returns This builder, after every arm has rejoined.
      */
-    switch(name: string, on: Expr, cases: {
-        value: CaseValue;
-        body: (b: ArmBuilder) => void;
-        label?: string;
-        id?: string;
-    }[], defaultFn?: (b: StepList) => void, options?: NodeOptions): this;
+    switch(name: string, on: Expr | undefined, cases: SwitchCase[], defaultFn?: (b: StepList) => void, options?: NodeOptions): this;
     /**
      * Run two or more arms **in parallel** from this point and join them back
      * together on a Merge node — the one place the builder stops being a straight

package/dist/flow-sdk.js

@@ -612,11 +612,23 @@ class StepList {
      * ], (other) => other.step('unknown', script({ code: 'return "Unknown";' })))
      * ```
      *
+     * @example
+     * **Cases with their own conditions** (`on` is `undefined`)
+     * ```ts
+     * .switch('route', undefined, [
+     *   { when: js`$vars.start.output.amount > 100`, label: 'High', body: (b) => b.step('review', script({ code: 'return 1;' })) },
+     *   { when: js`$vars.start.output.amount <= 100`, label: 'Low', body: (b) => b.step('auto', script({ code: 'return 2;' })) },
+     * ])
+     * ```
+     *
      * @param name - The switch node's id.
-     * @param on - The value to compare each case against.
-     * @param cases - One entry per arm, evaluated top to bottom; the first strict
-     * match wins. `label` names the arm's outgoing edge. `id` keeps a case's wire
-     * id (`inputs.cases[].id`, port `case-<id>`); omitted, it is `case_<n>`.
+     * @param on - The value to compare each `value` case against; `undefined`
+     * when every case carries its own `when` condition.
+     * @param cases - One entry per arm, evaluated top to bottom; the first match
+     * wins. A case is `{ value }` (strict `on === value`) or `{ when }` (its own
+     * boolean expression). `label` names the arm's outgoing edge. `id` keeps a
+     * case's wire id (`inputs.cases[].id`, port `case-<id>`); omitted, it is
+     * `case_<n>`.
      * @param defaultFn - Receives a sub-builder for the arm taken when nothing
      * matches. Omit it and an unmatched value simply continues.
      * @param options - Node options; `version` selects the exact definition
@@ -634,7 +646,14 @@ class StepList {
             // An arm's own `.label(...)` wins over the case config's `label`; either
             // overrides the serializer's derived `Case "<value>"`.
             const label = arm.armLabel ?? c.label;
-            return { value: c.value, ...(label !== undefined ? { label } : {}), ...(c.id !== undefined ? { id: c.id } : {}), body: arm.steps };
+            return {
+                // Both kept as given, so check can refuse a case with both or neither.
+                ...(c.value !== undefined ? { value: c.value } : {}),
+                ...(c.when !== undefined ? { when: toExpr(c.when) } : {}),
+                ...(label !== undefined ? { label } : {}),
+                ...(c.id !== undefined ? { id: c.id } : {}),
+                body: arm.steps,
+            };
         });
         let dflt;
         if (defaultFn) {
@@ -649,7 +668,7 @@ class StepList {
         this.steps.push({
             kind: 'switch',
             name,
-            on: toExpr(on),
+            ...(on !== undefined ? { on: toExpr(on) } : {}),
             cases: arms,
             ...(dflt !== undefined ? { default: dflt } : {}),
             ...(options ? { options } : {}),

package/dist/serialize.js

@@ -6171,8 +6171,12 @@ export function serialize(built, opts = {}) {
                 // must leave from ITS handles), else positional (#1130).
                 const cases = step.cases.map((c, i) => ({
                     id: c.id ?? `case_${i + 1}`,
-                    label: c.label ?? `Case ${caseLiteral(c.value)}`,
-                    expression: `${renameRefs(step.on.js, scope.rename)} === ${caseLiteral(c.value)}`,
+                    // A `when` case writes its own condition — the product's per-case form,
+                    // first truthy case wins (#1131). A `value` case compares with `on`.
+                    label: c.label ?? (c.when !== undefined ? `Case ${i + 1}` : `Case ${caseLiteral(c.value)}`),
+                    expression: c.when !== undefined
+                        ? renameRefs(c.when.js, scope.rename)
+                        : `${renameRefs(step.on?.js ?? 'undefined', scope.rename)} === ${caseLiteral(c.value)}`,
                 }));
                 node.inputs = { cases, hasDefault: step.default !== undefined };
                 scope.nodes.push(node);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.26.0",
+  "version": "6.27.0",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -92,5 +92,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "6f62b8136efeafdce6dde0429c7d98a59a4661d2"
+  "gitref": "69352e3f5c7c379e0e70b3c7b6fb2fba91255f84"
 }