@uipath/maestro-builder-sdk 6.25.0 → 6.26.0

package/dist/api-index.md

@@ -57,13 +57,13 @@ could hand you spans for a version you do not have.
 | `apiWorkflow` | function | `dist/core/actions.d.ts:1658-1692` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/core/actions.d.ts:411-442` | Option shapes | 5 field(s) |
 | `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:140-185` | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
-| `ArmBuilder` | class | `dist/flow-sdk.d.ts:1187-1210` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `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(...)`. |
 | `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-743` | Supporting types | 15 field(s) |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts:708-749` | 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. |
@@ -128,11 +128,11 @@ could hand you spans for a version you do not have.
 | `FilterCondition` | type | `dist/nodes/transform/flow/spec.d.ts:10-11` | Supporting types | Comparison a filter rule applies to a field. |
 | `FilterMatch` | type | `dist/nodes/transform/flow/spec.d.ts:8-9` | Supporting types | How a filter combines its rules: every rule must match, or any one. |
 | `FilterRule` | interface | `dist/nodes/transform/flow/spec.d.ts:12-24` | Supporting types | 3 field(s) |
-| `flow` | function | `dist/flow-sdk.d.ts:1493-1508` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1541-1556` | 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:1211-1492` | Builders | 13 member(s) |
+| `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… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:126-161` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:176-183` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
@@ -225,11 +225,11 @@ could hand you spans for a version you do not have.
 | `SendMessageInputs` | interface | `dist/nodes/conversation/flow/spec.d.ts:8-27` | Option shapes | 4 field(s) |
 | `ShownField` | interface | `dist/core/actions.d.ts:63-78` | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
 | `Step` | type | `dist/flow-sdk.d.ts:484-603` | Supporting types |  |
-| `StepList` | class | `dist/flow-sdk.d.ts:744-1186` | Builders | Collects a sequence of steps. |
+| `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:1509-1548` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1557-1596` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:45-52` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/nodes/ai-patterns/flow/factories.d.ts:8-48` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/nodes/ai-patterns/flow/spec.d.ts:8-40` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -5,12 +5,12 @@
 
 # Maestro Builder SDK — member index
 
-**A lookup table of 1113 rows — match one name in it, do not read it.**
+**A lookup table of 1115 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 — 1113 across
+Every field and method of every exported shape — 1115 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 1113 rows here.
+which is why its span is not repeated on all 1115 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:1199` |
+| `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1205` |
 | `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:943-961` |
+| `branch` | method | `StepList` | `dist/flow-sdk.d.ts:949-967` |
 | `branches` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:25-30` |
-| `break` | method | `StepList` | `dist/flow-sdk.d.ts:1071-1080` |
+| `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` |
 | `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:1485-1491` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1533-1539` |
 | `businessRule` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2527-2573` |
 | `by` | property | `LookupResolution` | `dist/core/lookups.d.ts:164` |
 | `by` | property | `LookupSpec` | `dist/core/lookups.d.ts:27-28` |
@@ -172,7 +172,7 @@ not find it either.
 | `context` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:87` |
 | `contextRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1528-1535` |
 | `contextVerbatim` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1600-1605` |
-| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1081-1095` |
+| `continue` | method | `StepList` | `dist/flow-sdk.d.ts:1087-1101` |
 | `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,6 +207,8 @@ 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` |
 | `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` |
@@ -223,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:1235-1242` |
+| `description` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1242-1249` |
 | `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` |
@@ -265,7 +267,7 @@ not find it either.
 | `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:252-256` |
 | `documentClassify` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:56-59` |
 | `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:84-85` |
-| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1046-1070` |
+| `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1052-1076` |
 | `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` |
@@ -289,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:1301-1351` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1308-1358` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
-| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:734-735` |
+| `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:740-741` |
 | `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:752-777` |
+| `err` | method | `StepList` | `dist/flow-sdk.d.ts:758-783` |
 | `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` |
@@ -459,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:1426-1438` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1474-1486` |
 | `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` |
@@ -532,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:1200-1209` |
+| `label` | method | `ArmBuilder` | `dist/flow-sdk.d.ts:1206-1215` |
 | `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,7 +548,7 @@ not find it either.
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:646-647` |
 | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:730-731` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
-| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1243-1253` |
+| `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1250-1260` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:479-480` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
@@ -556,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:1034-1045` |
+| `loop` | method | `StepList` | `dist/flow-sdk.d.ts:1040-1051` |
 | `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` |
@@ -645,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:1227-1234` |
+| `name` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1234-1241` |
 | `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` |
@@ -707,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:832-892` |
+| `onError` | method | `StepList` | `dist/flow-sdk.d.ts:838-898` |
 | `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` |
@@ -725,7 +727,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1395-1400` |
 | `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:211-225` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1439-1474` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1487-1522` |
 | `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` |
@@ -761,7 +763,7 @@ not find it either.
 | `pageRange` | property | `DynamicExtractInputs` | `dist/nodes/document/flow/spec.d.ts:49-50` |
 | `pageRange` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:326-327` |
 | `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:461-462` |
-| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:998-1033` |
+| `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:1004-1039` |
 | `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` |
@@ -860,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:1176-1185` |
+| `return` | method | `StepList` | `dist/flow-sdk.d.ts:1182-1191` |
 | `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` |
@@ -901,7 +903,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:714-720` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1386-1425` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1393-1432` |
 | `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` |
@@ -973,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:778-788` |
+| `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:746` |
-| `stepSwitch` | method | `StepList` | `dist/flow-sdk.d.ts:789-831` |
-| `stepToList` | method | `StepList` | `dist/flow-sdk.d.ts:906-934` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1127-1155` |
-| `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1156-1175` |
+| `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:1254-1279` |
+| `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1261-1286` |
 | `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` |
@@ -995,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:962-997` |
+| `switch` | method | `StepList` | `dist/flow-sdk.d.ts:968-1003` |
 | `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` |
@@ -1020,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:1096-1126` |
+| `terminate` | method | `StepList` | `dist/flow-sdk.d.ts:1102-1132` |
 | `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` |
@@ -1044,11 +1046,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:725-727` |
 | `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:1280-1300` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1287-1307` |
 | `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:736-742` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1352-1371` |
+| `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` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1104,7 +1106,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:1475-1484` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1523-1532` |
 | `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` |
@@ -1127,7 +1129,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:1372-1385` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1379-1392` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:373-380` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2073-2074` |

package/dist/case/compile-cli.js

@@ -10,7 +10,8 @@
  * Output defaults to the plan file the project in the working directory ships
  * (`caseplan.case` for a project `uip maestro case init` scaffolded), else
  * `caseplan.json`. An `-o` that names a different plan file than the project
- * ships is refused (CASE_OUTPUT_NOT_SHIPPED).
+ * ships is refused (CASE_OUTPUT_NOT_SHIPPED), and so is a plan file written into
+ * a solution directory above its Case project (CASE_OUTPUT_OUTSIDE_PROJECT).
  */
 import { reportDiagnostics, reportResult, thrownDiagnostic } from '../cli-result.js';
 import { writeJsonFile } from '../core/json-file.js';
@@ -67,7 +68,7 @@ export async function run(argv) {
     const out = flagValue(argv, '-o') ?? shippedCasePlanName('.') ?? 'caseplan.json';
     const shadow = shadowedOutputDiagnostic(out);
     if (shadow) {
-        console.error(`  ✗ [${shadow.code}] ${shadow.message}`);
+        console.error(`  ✗ [${shadow.code}] ${shadow.message} Fix: ${shadow.suggestion}.`);
         reportDiagnostics([...diags, shadow]);
         console.error('compile: 1 error(s); not emitting.');
         return 1;
@@ -96,6 +97,9 @@ export async function run(argv) {
  * `uip maestro case init` scaffolds `caseplan.case` since uipath-cli#5004.
  */
 const CASE_PLAN_FILE_NAMES = ['caseplan.case', 'caseplan.json', 'case.stage.json', 'default.stage.json'];
+/** The file that makes a directory a project, and the `ProjectType` a Case project declares in it. */
+const PROJECT_FILE = 'project.uiproj';
+const CASE_PROJECT_TYPE = 'CaseManagement';
 /**
  * The plan file the project in `dir` ships, or undefined when `dir` is not a
  * Case project. Decided as the packager decides: the first plan file present in
@@ -126,6 +130,11 @@ function shadowedOutputDiagnostic(outPath) {
     if (!CASE_PLAN_FILE_NAMES.includes(name.toLowerCase()))
         return undefined;
     const dir = dirname(outPath);
+    // First: a plan file already in a solution directory would otherwise make it
+    // look like a project that ships that file.
+    const outside = outsideProjectDiagnostic(outPath);
+    if (outside)
+        return outside;
     const shipped = shippedCasePlanName(dir);
     if (!shipped || shipped === name)
         return undefined;
@@ -138,6 +147,53 @@ function shadowedOutputDiagnostic(outPath) {
         suggestion: `compile with -o ${target}`,
     };
 }
+/**
+ * A plan file in a non-project dir that holds Case projects (a solution dir) is
+ * packed by none. A directory that is itself a project, or holds no Case
+ * project, is not checked.
+ */
+function outsideProjectDiagnostic(outPath) {
+    const dir = dirname(outPath);
+    if (existsSync(join(dir, PROJECT_FILE)))
+        return undefined;
+    const projects = childCaseProjects(dir);
+    if (projects.length === 0)
+        return undefined;
+    const targets = projects.map((p) => join(dir, p, shippedCasePlanName(join(dir, p)) ?? CASE_PLAN_FILE_NAMES[0]));
+    return {
+        level: 'error',
+        code: 'CASE_OUTPUT_OUTSIDE_PROJECT',
+        message: `${outPath} is in a solution directory, not a Case project; no project packs it. ` +
+            `The Case project${projects.length > 1 ? 's here are' : ' here is'} ${projects.map((p) => join(dir, p)).join(', ')}.`,
+        suggestion: projects.length === 1 ? `compile with -o ${targets[0]}` : `compile with -o one of: ${targets.join(', ')}`,
+    };
+}
+/**
+ * Subdirectories of `dir` (or links to one) whose `project.uiproj` declares a
+ * CaseManagement project.
+ */
+function childCaseProjects(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        // A link counts: the read below fails for a link to a file.
+        .filter((e) => e.isDirectory() || e.isSymbolicLink())
+        .map((e) => e.name)
+        .filter((name) => {
+        try {
+            return JSON.parse(readFileSync(join(dir, name, PROJECT_FILE), 'utf8'))?.ProjectType === CASE_PROJECT_TYPE;
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
 /** The case file `package-descriptor.json` in `dir` ships, if it names one. */
 function describedCaseFileName(dir) {
     const descriptorPath = join(dir, 'package-descriptor.json');

package/dist/check.js

@@ -29,7 +29,7 @@ import { ownEntry } from './core/own-entry.js';
 import { FLOW_NODE_TYPES } from './flow-node-registry.js';
 import { stepExits } from './flow-step-exits.js';
 import { plainHttpOnErrorMessage } from './nodes/http/flow/family.js';
-import { resolveVersion } from './core/nodes/versioned.js';
+import { resolveVersion, resolveVersionCarried } from './core/nodes/versioned.js';
 import { declaredErrorPortRefusal } from './core/error-port.js';
 export function check(built, opts = {}) {
     let diags = [];
@@ -275,7 +275,7 @@ function checkFlow(built, ancestors, opts = {}) {
                 declared.add(s.name); // a step's output is referenceable by name
             }
             if ((s.kind === 'stepToList' || s.kind === 'stepToRef') && s.port === 'error')
-                checkOnError(s, prevPortSource, diags, prevPortSource && checkedSteps.get(prevPortSource.name));
+                checkOnError(s, prevPortSource, diags, prevPortSource && checkedSteps.get(prevPortSource.name), carriedLookup([built, ...ancestors]));
             if ((s.kind === 'stepToList' || s.kind === 'stepToRef') && s.port.startsWith('branch-')) {
                 const want = s.port.slice('branch-'.length);
                 const prevSpec = prevAction?.spec;
@@ -381,7 +381,7 @@ function checkFlow(built, ancestors, opts = {}) {
                 prevPortSource = s;
                 const registered = registeredKind(s.spec);
                 if (registered) {
-                    const { placed, checked } = checkRegisteredStep(registered, s, exprs, errorSource, opts, diags, typeOf, triggerId);
+                    const { placed, checked } = checkRegisteredStep(registered, s, exprs, errorSource, opts, diags, typeOf, triggerId, carriedLookup([built, ...ancestors]));
                     checkedSteps.set(s.name, checked);
                     if (placed)
                         registeredSteps.set(s.name, checked);
@@ -3977,6 +3977,11 @@ const LOOP_FIELDS = new Set(['currentItem', 'currentIteration', 'collection', 'o
  * before the 2.4 default (#868); its own fields are not audited here.
  */
 const LOOP_FIELDS_1_0_0 = new Set(['currentItem', 'currentIndex', 'collection', 'output', 'error']);
+/** The {@link CarriedLookup} over `scopes` — the flow being checked first, then its ancestors. */
+function carriedLookup(scopes) {
+    const all = scopes.flatMap((b) => b.definitions ?? []);
+    return Object.assign((typeName, version) => all.find((d) => d.nodeType === typeName && d.version === version), { versions: (typeName) => [...new Set(all.filter((d) => d.nodeType === typeName).map((d) => String(d.version)))] });
+}
 /** The registered node type for a spec's kind, or undefined (a custom FlowAction has no kind). */
 function registeredKind(spec) {
     const kind = spec?.kind;
@@ -3994,14 +3999,15 @@ function registeredKind(spec) {
  * which serialize enforces (#942) and the type's tests pin; an author cannot
  * cause the gap, so there is no author diagnostic to report.
  */
-function checkRegisteredStep(entry, s, exprs, errorSource, opts, diags, typeOf, triggerId) {
+function checkRegisteredStep(entry, s, exprs, errorSource, opts, diags, typeOf, triggerId, carried) {
     const spec = s.spec;
     /** The step's node-local rules and expressions, as `impl` defines them. */
-    const runRules = (impl) => {
+    const runRules = (impl, version = impl.version, carriedDef) => {
         const ctx = {
             step: s.name,
-            version: impl.version,
-            definition: () => bundledDefinition(impl.typeName, impl.version),
+            // At a carried version, the version and definition serialize emits.
+            version,
+            definition: () => carriedDef ?? bundledDefinition(impl.typeName, impl.version),
             report: (code, message, suggestion) => diags.push(catalogued(entry, s.name, code, message, suggestion)),
             declaredRef: (js) => {
                 const name = declaredRefName(js, triggerId);
@@ -4024,8 +4030,14 @@ function checkRegisteredStep(entry, s, exprs, errorSource, opts, diags, typeOf,
         return ctx;
     };
     let impl;
+    let version;
+    let carriedDef;
     try {
-        impl = resolveVersion(entry.type, spec, s.options?.version, `step "${s.name}"`);
+        // A pin the registry lacks but the flow carries resolves (#1128), as in serialize.
+        const resolved = resolveVersionCarried(entry.type, spec, s.options?.version, `step "${s.name}"`, carried);
+        impl = resolved.impl;
+        version = resolved.version;
+        carriedDef = resolved.carried;
     }
     catch (e) {
         // A select() that picks an unregistered version is the node type's bug, not the author's pin.
@@ -4043,8 +4055,14 @@ function checkRegisteredStep(entry, s, exprs, errorSource, opts, diags, typeOf,
             checked: { entry, impl: fallback, spec, placement: { step: s.name, kind: fallback.kind, spec, version: fallback.version }, ctx: fallbackCtx },
         };
     }
-    const ctx = runRules(impl);
-    return { placed: true, checked: { entry, impl, spec, placement: { step: s.name, kind: impl.kind, spec, version: impl.version }, ctx } };
+    const ctx = runRules(impl, version, carriedDef);
+    return {
+        placed: true,
+        checked: {
+            entry, impl, spec, placement: { step: s.name, kind: impl.kind, spec, version }, ctx,
+            ...(carriedDef !== undefined ? { carried: carriedDef } : {}),
+        },
+    };
 }
 /** Every non-literal Expr reachable in `value`, as expressions to check. */
 function pushDeepExprs(value, step, errorSource, out) {
@@ -4171,7 +4189,7 @@ const ERROR_ENVELOPE_FIELDS = ['code', 'message', 'detail', 'category', 'status'
  */
 function checkOnError(_handler, step, diags, 
 /** The step's registry record, when its kind is registered and its version resolved. */
-placed) {
+placed, carried) {
     // The builder refuses a handler with no eligible step before it, so a missing
     // source here means a hand-built `BuiltFlow`; there is nothing to say about it.
     if (!step)
@@ -4243,7 +4261,7 @@ placed) {
             }
         }
         else {
-            const def = bundledDefinition(impl.typeName, impl.version);
+            const def = placed.carried ?? bundledDefinition(impl.typeName, impl.version);
             if (def !== undefined && !definitionHasErrorPort(def)) {
                 diags.push({ level: 'error', code: 'ONERROR_NO_ERROR_PORT', message: typedNoErrorPortMessage(step.name, impl.kind, def), step: step.name });
                 return;
@@ -4262,7 +4280,12 @@ placed) {
     // A version the SDK does not bundle (an inline agent's registry version) has
     // no definition here to ask; version resolution reports that, not this check.
     const bundledType = bundledActionNodeType(spec);
-    const bundledDef = bundledType ? bundledDefinition(bundledType, actionVersion(spec, step.options?.version)) : undefined;
+    // A version the flow CARRIES (`.definitions()`, #1128) answers the same way
+    // a bundled one does: it is the definition serialize will emit.
+    const pinned = step.options?.version;
+    const bundledDef = bundledType
+        ? bundledDefinition(bundledType, actionVersion(spec, pinned)) ?? (pinned !== undefined ? carried?.(bundledType, pinned) : undefined)
+        : undefined;
     // A per-tenant family: ask the definition serialize synthesizes for it (#1040).
     let perCallDef;
     if (!bundledType) {

package/dist/core/carried-definitions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Node definitions a flow CARRIES — the third source a pinned `{ version }`
+ * resolves from, after the SDK's bundle (#1128).
+ *
+ * Every `.flow` file holds the exact definition of every node it uses, in
+ * `definitions[]`. The SDK bundles only the versions it was released with, so
+ * a version the registry served later (`node add` writes
+ * `uipath.human-in-the-loop.quick-form@1.6`; the SDK ships 1.0 and 1.1) used
+ * to be refused, and the source decompile wrote for an untouched product flow
+ * did not compile. A carried definition closes that: decompile copies the
+ * file's own entry into `.definitions([...])`, and compile resolves the pin
+ * against it.
+ *
+ * A carried definition is an exact copy of a real one, never a way to invent a
+ * version. So it is validated the way a `rawNode` snapshot manifest is: it
+ * names its own `nodeType` and `version`, and it has the `display.label` every
+ * node manifest has.
+ */
+/** A carried definition, by its `<nodeType>@<version>` key. */
+export type CarriedDefinitions = ReadonlyMap<string, Record<string, unknown>>;
+/**
+ * Why `manifest` cannot be carried, or `undefined` when it can.
+ *
+ * For instance `{ nodeType: 'x', version: '1.0' }` is refused for lacking
+ * `display.label`.
+ */
+export declare function carriedDefinitionRefusal(manifest: unknown, where: string): string | undefined;
+/**
+ * Index `manifests` by `<nodeType>@<version>`. Throws on an invalid manifest,
+ * or on two different manifests for one pair (which one compiles would be a
+ * guess).
+ */
+export declare function indexCarriedDefinitions(manifests: readonly unknown[], where: string, into?: Map<string, Record<string, unknown>>): Map<string, Record<string, unknown>>;

package/dist/core/carried-definitions.js

@@ -0,0 +1,63 @@
+/**
+ * Node definitions a flow CARRIES — the third source a pinned `{ version }`
+ * resolves from, after the SDK's bundle (#1128).
+ *
+ * Every `.flow` file holds the exact definition of every node it uses, in
+ * `definitions[]`. The SDK bundles only the versions it was released with, so
+ * a version the registry served later (`node add` writes
+ * `uipath.human-in-the-loop.quick-form@1.6`; the SDK ships 1.0 and 1.1) used
+ * to be refused, and the source decompile wrote for an untouched product flow
+ * did not compile. A carried definition closes that: decompile copies the
+ * file's own entry into `.definitions([...])`, and compile resolves the pin
+ * against it.
+ *
+ * A carried definition is an exact copy of a real one, never a way to invent a
+ * version. So it is validated the way a `rawNode` snapshot manifest is: it
+ * names its own `nodeType` and `version`, and it has the `display.label` every
+ * node manifest has.
+ */
+/**
+ * Why `manifest` cannot be carried, or `undefined` when it can.
+ *
+ * For instance `{ nodeType: 'x', version: '1.0' }` is refused for lacking
+ * `display.label`.
+ */
+export function carriedDefinitionRefusal(manifest, where) {
+    if (!manifest || typeof manifest !== 'object' || Array.isArray(manifest)) {
+        return `${where}: a carried definition must be a node manifest object.`;
+    }
+    const m = manifest;
+    if (typeof m.nodeType !== 'string' || !m.nodeType || typeof m.version !== 'string' || !m.version) {
+        return `${where}: a carried definition must name its exact nodeType and version.`;
+    }
+    if (typeof m.display?.label !== 'string' || !m.display.label) {
+        return `${where}: the carried definition ${m.nodeType}@${m.version} lacks display.label — not a valid node manifest.`;
+    }
+    return undefined;
+}
+/**
+ * Index `manifests` by `<nodeType>@<version>`. Throws on an invalid manifest,
+ * or on two different manifests for one pair (which one compiles would be a
+ * guess).
+ */
+export function indexCarriedDefinitions(manifests, where, into = new Map()) {
+    for (const m of manifests) {
+        const refusal = carriedDefinitionRefusal(m, where);
+        if (refusal)
+            throw new Error(refusal);
+        const def = m;
+        const key = `${def.nodeType}@${def.version}`;
+        const prior = into.get(key);
+        if (prior !== undefined && stableJson(prior) !== stableJson(def)) {
+            throw new Error(`${where}: two different carried definitions for ${key}. Keep the one the file holds.`);
+        }
+        into.set(key, def);
+    }
+    return into;
+}
+/** `JSON.stringify` with object keys sorted, so two copies of one manifest compare equal whatever their key order. */
+function stableJson(value) {
+    return JSON.stringify(value, (_key, v) => (v && typeof v === 'object' && !Array.isArray(v)
+        ? Object.fromEntries(Object.keys(v).sort().map((k) => [k, v[k]]))
+        : v));
+}