@uipath/maestro-builder-sdk 6.61.0 → 6.62.0

package/dist/api-index.md

@@ -41,10 +41,10 @@ could hand you spans for a version you do not have.
 
 | Symbol | Kind | Declaration | Area | Summary |
 | --- | --- | --- | --- | --- |
-| `ActionSchema` | type | `dist/nodes/hitl/flow/spec.d.ts:283-284` | Supporting types | An Action App's action schema, in either spelling. |
-| `ActionSchemaFile` | interface | `dist/nodes/hitl/flow/spec.d.ts:246-256` | Supporting types | A coded action app's `action-schema.json`. |
-| `ActionSchemaProperty` | interface | `dist/nodes/hitl/flow/spec.d.ts:220-238` | Supporting types | One property of an `action-schema.json` section. |
-| `ActionSchemaSection` | interface | `dist/nodes/hitl/flow/spec.d.ts:239-245` | Supporting types | One section (`inputs`, `outputs`, `inOuts`, `outcomes`) of an `action-schema.json`. |
+| `ActionSchema` | type | `dist/nodes/hitl/flow/spec.d.ts:289-290` | Supporting types | An Action App's action schema, in either spelling. |
+| `ActionSchemaFile` | interface | `dist/nodes/hitl/flow/spec.d.ts:252-262` | Supporting types | A coded action app's `action-schema.json`. |
+| `ActionSchemaProperty` | interface | `dist/nodes/hitl/flow/spec.d.ts:226-244` | Supporting types | One property of an `action-schema.json` section. |
+| `ActionSchemaSection` | interface | `dist/nodes/hitl/flow/spec.d.ts:245-251` | Supporting types | One section (`inputs`, `outputs`, `inOuts`, `outcomes`) of an `action-schema.json`. |
 | `ActionSpec` | type | `dist/core/actions.d.ts:847-855` | Supporting types | One action step's spec: `{ kind }` plus that kind's body from FlowActionSpecs, for every kind there. |
 | `agent` | function | `dist/nodes/process/flow/factories.d.ts:159-213` | Actions | Invoke an AGENT resource — either one published to Orchestrator or a sibling agent project registered in the same… |
 | `AgentFlavour` | type | `dist/nodes/process/flow/spec.d.ts:260-264` | Supporting types | Which KIND of agent project was published behind a `uipath.core.agent.<key>` resource. |
@@ -61,7 +61,7 @@ could hand you spans for a version you do not have.
 | `AggregationOperation` | type | `dist/nodes/transform/flow/spec.d.ts:35` | Supporting types |  |
 | `apiWorkflow` | function | `dist/nodes/process/flow/factories.d.ts:53-87` | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
 | `ApiWorkflowInputs` | interface | `dist/nodes/process/flow/spec.d.ts:70-101` | Option shapes | 5 field(s) |
-| `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:140-219` | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
+| `AppRef` | interface | `dist/nodes/hitl/flow/spec.d.ts:146-225` | 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:1364-1387` | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
 | `AskedField` | interface | `dist/core/actions.d.ts:221-240` | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
 | `at` | function | `dist/flow-sdk.d.ts:693-721` | Flow construction | A node's layout at a canvas position — the short form of a NodeLayout for the `nodes` map of FlowBuilder.layout. |
@@ -119,7 +119,7 @@ could hand you spans for a version you do not have.
 | `dim` | function | `dist/flow-sdk.d.ts:722-744` | Flow construction | A node's size on the canvas, in pixels — the third argument of at. |
 | `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:10-20` | Option shapes | What `documentClassify()` takes: the document, and how to split and classify it. |
-| `DocValidationInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:70-93` | Option shapes | The Document Validation task's subject — `variant: 'document-validation'` only. |
+| `DocValidationInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:76-99` | Option shapes | The Document Validation task's subject — `variant: 'document-validation'` only. |
 | `DoWhileOptions` | interface | `dist/flow-sdk.d.ts:547-556` | 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:21-56` | Option shapes | What `dynamicExtract()` takes: the document and the fields to extract from it. |
@@ -164,9 +164,9 @@ could hand you spans for a version you do not have.
 | `HitlAssigneeType` | type | `dist/nodes/hitl/flow/spec.d.ts:16-23` | Supporting types | How the task is assigned, the platform's own vocabulary (canvas `HITL_ASSIGNEE_TYPE`): `'user'` a single user, `'group'`… |
 | `HitlChannel` | type | `dist/nodes/hitl/flow/spec.d.ts:10-15` | Supporting types | Where the task is delivered. |
 | `HitlConnection` | interface | `dist/nodes/hitl/flow/spec.d.ts:24-32` | Supporting types | A per-channel Integration Service connection (Slack / Teams delivery). |
-| `HitlInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:285-389` | Option shapes | 12 field(s) |
-| `HitlRecipient` | interface | `dist/nodes/hitl/flow/spec.d.ts:33-69` | Supporting types | Who gets the task and over which channels. |
-| `HitlVariant` | type | `dist/nodes/hitl/flow/spec.d.ts:114-139` | Supporting types | WHICH human-task node type to emit. |
+| `HitlInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:291-395` | Option shapes | 12 field(s) |
+| `HitlRecipient` | interface | `dist/nodes/hitl/flow/spec.d.ts:33-75` | Supporting types | Who gets the task and over which channels. |
+| `HitlVariant` | type | `dist/nodes/hitl/flow/spec.d.ts:120-145` | Supporting types | WHICH human-task node type to emit. |
 | `http` | function | `dist/nodes/http/flow/factories.d.ts:7-14` | Actions | Declare an HTTP request action, explicitly choosing standalone or managed. |
 | `HttpBranch` | interface | `dist/nodes/http/flow/spec.d.ts:8-23` | Supporting types | One conditional response branch on an HTTP node — a designer-visible side exit. |
 | `HttpInputs` | type | `dist/nodes/http/flow/spec.d.ts:125-142` | Option shapes |  |
@@ -205,11 +205,11 @@ could hand you spans for a version you do not have.
 | `onEvent` | function | `dist/flow-sdk.d.ts:193-231` | 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:232-239` | 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. |
+| `Outcome` | type | `dist/nodes/hitl/flow/spec.d.ts:100-119` | 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. |
 | `ParallelOptions` | interface | `dist/flow-sdk.d.ts:447-470` | Option shapes | The options of `.parallel()`: the join's NodeOptions, plus the fork node when the flow has one. |
-| `PlatformActionSchema` | interface | `dist/nodes/hitl/flow/spec.d.ts:270-282` | Supporting types | The platform's action schema (Apps API, a solution's `spec.actionSchema`). |
-| `PlatformActionSchemaArg` | interface | `dist/nodes/hitl/flow/spec.d.ts:257-269` | Supporting types | One argument of the platform's action schema. |
+| `PlatformActionSchema` | interface | `dist/nodes/hitl/flow/spec.d.ts:276-288` | Supporting types | The platform's action schema (Apps API, a solution's `spec.actionSchema`). |
+| `PlatformActionSchemaArg` | interface | `dist/nodes/hitl/flow/spec.d.ts:263-275` | Supporting types | One argument of the platform's action schema. |
 | `PortArm` | interface | `dist/flow-sdk.d.ts:380-392` | 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:260-265` | 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:622-635` | Supporting types | The tool kinds that wrap a DEPLOYED tenant resource. |

package/dist/api-members.md

@@ -50,7 +50,7 @@ not find it either.
 | `action` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:997-1022` |
 | `actionCatalogName` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:558-563` |
 | `actions` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1403-1412` |
-| `actionSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:185-209` |
+| `actionSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:191-215` |
 | `activity` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2966-2999` |
 | `additionalOutputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:98-102` |
 | `agent` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:381-384` |
@@ -64,13 +64,13 @@ not find it either.
 | `apiWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:369-372` |
 | `apiWorkflow` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:903-912` |
 | `app` | property | `EscalationRef` | `dist/core/actions.d.ts:729-756` |
-| `app` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:291-295` |
+| `app` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:297-301` |
 | `app` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1397-1398` |
 | `app` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1435-1436` |
-| `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-175` |
+| `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:176-181` |
 | `appVersion` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1401-1402` |
 | `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1376` |
-| `assignee` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:52-63` |
+| `assignee` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:54-69` |
 | `async` | property | `OrchestratorAsyncOpts` | `dist/bpmn/bpmn-sdk.d.ts:1321-1325` |
 | `atRiskPercentage` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:140-145` |
 | `attachedTo` | property | `BoundaryOpts` | `dist/bpmn/bpmn-sdk.d.ts:776-777` |
@@ -126,7 +126,7 @@ not find it either.
 | `caseExit` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:777` |
 | `caseManagement` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:567-571` |
 | `caseManagement` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:913-924` |
-| `channels` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:50-51` |
+| `channels` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:52-53` |
 | `child` | property | `SubflowSpec` | `dist/flow-sdk.d.ts:50-51` |
 | `choose` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3064-3105` |
 | `citationMode` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:581-582` |
@@ -158,7 +158,7 @@ not find it either.
 | `connection` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1583-1584` |
 | `connection` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1193-1217` |
 | `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:1005-1009` |
-| `connections` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:64-68` |
+| `connections` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:70-74` |
 | `connector` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:618` |
 | `connector` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:592-593` |
 | `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:1017-1018` |
@@ -226,7 +226,7 @@ not find it either.
 | `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1621-1661` |
 | `delay` | property | `FlowActionSpecs` | `dist/nodes/delay/flow/spec.d.ts:38-41` |
 | `dependsOn` | property | `LookupSpec` | `dist/core/lookups.d.ts:34-35` |
-| `description` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:230-231` |
+| `description` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:236-237` |
 | `description` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:551` |
 | `description` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:768` |
 | `description` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:837-838` |
@@ -285,9 +285,9 @@ not find it either.
 | `displayName` | property | `RegistryInputField` | `dist/bpmn/typed-node.d.ts:65` |
 | `displayName` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:178-183` |
 | `displayName` | property | `TriggerMeta` | `dist/core/connectors.d.ts:127-128` |
-| `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:384-388` |
+| `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:390-394` |
 | `documentClassify` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:152-155` |
-| `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:84-85` |
+| `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:90-91` |
 | `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1198-1222` |
 | `dueDate` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:50-51` |
 | `duration` | property | `TimerSpec` | `dist/bpmn/bpmn-sdk.d.ts:35-36` |
@@ -361,7 +361,7 @@ not find it either.
 | `exitToStage` | property | `ExitOpts` | `dist/case/case-sdk.d.ts:816-830` |
 | `exitWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1250-1257` |
 | `exponentialBase` | property | `RetrySpec` | `dist/bpmn/bpmn-sdk.d.ts:835-836` |
-| `exposeError` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:344-350` |
+| `exposeError` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:350-356` |
 | `expression` | property | `BuiltSla` | `dist/case/case-sdk.d.ts:199-200` |
 | `expression` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:83-84` |
 | `expression` | property | `WhenExpression` | `dist/case/case-sdk.d.ts:109-110` |
@@ -370,7 +370,7 @@ not find it either.
 | `externalAgent` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:981-988` |
 | `externalWorkflow` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2947-2963` |
 | `externalWorkflow` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:989-996` |
-| `extractionResult` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:76-81` |
+| `extractionResult` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:82-87` |
 | `field` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:40-41` |
 | `field` | property | `DataFabricFilter` | `dist/nodes/data-fabric/flow/spec.d.ts:22-28` |
 | `field` | property | `DataFabricSort` | `dist/nodes/data-fabric/flow/spec.d.ts:54-55` |
@@ -379,7 +379,7 @@ not find it either.
 | `field` | property | `LookupResolution` | `dist/core/lookups.d.ts:168` |
 | `fields` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:105-106` |
 | `fields` | property | `EscalationRef` | `dist/core/actions.d.ts:724-728` |
-| `fields` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:300-309` |
+| `fields` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:306-315` |
 | `fields` | property | `HumanTaskForm` | `dist/bpmn/human-task-form.d.ts:85-86` |
 | `fileExtension` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:579-580` |
 | `fileExtension` | property | `ContextIndexRef` | `dist/core/actions.d.ts:805-806` |
@@ -423,7 +423,7 @@ not find it either.
 | `folderPath` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:188-195` |
 | `folderPath` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:291-302` |
 | `folderPath` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:81-82` |
-| `folderPath` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:168-169` |
+| `folderPath` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:174-175` |
 | `folderPath` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1508-1509` |
 | `folderPath` | property | `ContextIndexRef` | `dist/core/actions.d.ts:789-790` |
 | `folderPath` | property | `HitlConnection` | `dist/nodes/hitl/flow/spec.d.ts:30-31` |
@@ -440,7 +440,7 @@ not find it either.
 | `form` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:210-217` |
 | `form` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1399-1400` |
 | `form` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1433-1434` |
-| `format` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:232-233` |
+| `format` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:238-239` |
 | `from` | property | `CreateOutgoingCallInputs` | `dist/nodes/agent/flow/spec.d.ts:88-92` |
 | `function` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:935-950` |
 | `goto` | method | `PathBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3374-3398` |
@@ -454,7 +454,7 @@ not find it either.
 | `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:804-805` |
 | `hidden` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:27` |
 | `hidden` | property | `RegistryInputField` | `dist/bpmn/typed-node.d.ts:68` |
-| `hitl` | property | `FlowActionSpecs` | `dist/nodes/hitl/flow/spec.d.ts:392-395` |
+| `hitl` | property | `FlowActionSpecs` | `dist/nodes/hitl/flow/spec.d.ts:398-401` |
 | `http` | property | `FlowActionSpecs` | `dist/nodes/http/flow/spec.d.ts:145-148` |
 | `http` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2462-2496` |
 | `humanTask` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2719-2802` |
@@ -500,8 +500,8 @@ not find it either.
 | `inclusive` | property | `ChooseOpts` | `dist/bpmn/bpmn-sdk.d.ts:1906-1910` |
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2362-2369` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/nodes/agent/flow/spec.d.ts:443-446` |
-| `inOuts` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:252-253` |
-| `inOuts` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:276-277` |
+| `inOuts` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:258-259` |
+| `inOuts` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:282-283` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1402-1427` |
 | `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1702-1714` |
 | `input` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1415-1416` |
@@ -510,13 +510,13 @@ not find it either.
 | `inputName` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:92` |
 | `inputPattern` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:91` |
 | `inputRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1618-1626` |
-| `inputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:248-249` |
+| `inputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:254-255` |
 | `inputs` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:564-565` |
 | `inputs` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1616-1617` |
 | `inputs` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:204-209` |
 | `inputs` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:309-326` |
 | `inputs` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:83-87` |
-| `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:176-184` |
+| `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:182-190` |
 | `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:829-830` |
 | `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:847` |
 | `inputs` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:628-629` |
@@ -524,7 +524,7 @@ not find it either.
 | `inputs` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:455-456` |
 | `inputs` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:228-258` |
 | `inputs` | property | `NodeContribution` | `dist/core/node-classes.d.ts:113-117` |
-| `inputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:272-273` |
+| `inputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:278-279` |
 | `inputs` | property | `ProcessToolRef` | `dist/core/actions.d.ts:661-662` |
 | `inputs` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:150-151` |
 | `inputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:95-96` |
@@ -534,7 +534,7 @@ not find it either.
 | `inputs` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:1112-1124` |
 | `inputs` | property | `VoiceAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:136-141` |
 | `inputSchema` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1669-1677` |
-| `inputSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:210-218` |
+| `inputSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:216-224` |
 | `inputSchema` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:953-964` |
 | `inputTarget` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:93` |
 | `intermediateCatchEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2319-2326` |
@@ -549,11 +549,11 @@ not find it either.
 | `isDynamic` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:107-114` |
 | `isInterrupting` | property | `BuiltEntryCondition` | `dist/case/case-sdk.d.ts:322` |
 | `isInterrupting` | property | `EntryOpts` | `dist/case/case-sdk.d.ts:798` |
-| `isList` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:265-266` |
+| `isList` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:271-272` |
 | `isNot` | property | `FormFieldCondition` | `dist/core/actions.d.ts:123-124` |
 | `item` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:26-31` |
 | `item` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1342-1343` |
-| `items` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:234-235` |
+| `items` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:240-241` |
 | `itemVar` | property | `LoopSpec` | `dist/bpmn/bpmn-sdk.d.ts:83-84` |
 | `ixpExtract` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:160-163` |
 | `join` | property | `ChooseOpts` | `dist/bpmn/bpmn-sdk.d.ts:1911-1912` |
@@ -562,7 +562,7 @@ not find it either.
 | `key` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:163-174` |
 | `key` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:269-282` |
 | `key` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:71-78` |
-| `key` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:166-167` |
+| `key` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:172-173` |
 | `key` | property | `HitlConnection` | `dist/nodes/hitl/flow/spec.d.ts:28-29` |
 | `key` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1413-1414` |
 | `key` | property | `McpToolRef` | `dist/core/actions.d.ts:452-453` |
@@ -598,14 +598,14 @@ not find it either.
 | `label` | property | `SwitchArm` | `dist/flow-sdk.d.ts:370` |
 | `labels` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:556-557` |
 | `labels` | property | `EscalationRef` | `dist/core/actions.d.ts:769-770` |
-| `labels` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:327-328` |
+| `labels` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:333-334` |
 | `labels` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1439-1440` |
 | `lanes` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:639` |
 | `layout` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:783-784` |
 | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:856-857` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1381-1401` |
 | `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1422-1448` |
-| `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:351-383` |
+| `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:357-389` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:552-553` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
@@ -677,7 +677,7 @@ not find it either.
 | `name` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:283-284` |
 | `name` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:547-548` |
 | `name` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:79-80` |
-| `name` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:164-165` |
+| `name` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:170-171` |
 | `name` | property | `BindingContribution` | `dist/core/node-classes.d.ts:87-88` |
 | `name` | property | `BindingDecl` | `dist/bpmn/bpmn-sdk.d.ts:423-424` |
 | `name` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:1042-1043` |
@@ -728,7 +728,7 @@ not find it either.
 | `name` | property | `OutputColumn` | `dist/nodes/ai-patterns/flow/spec.d.ts:43-44` |
 | `name` | property | `PendingExit` | `dist/bpmn/bpmn-sdk.d.ts:2010-2011` |
 | `name` | property | `PlainTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1703-1704` |
-| `name` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:259-260` |
+| `name` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:265-266` |
 | `name` | property | `ProcessToolRef` | `dist/core/actions.d.ts:651-652` |
 | `name` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:120-121` |
 | `name` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1336-1337` |
@@ -793,12 +793,12 @@ not find it either.
 | `options` | property | `FormFieldSettings` | `dist/core/actions.d.ts:192-196` |
 | `or` | property | `DataFabricFilter` | `dist/nodes/data-fabric/flow/spec.d.ts:38-50` |
 | `origin` | property | `PendingExit` | `dist/bpmn/bpmn-sdk.d.ts:2014-2019` |
-| `outcomePorts` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:329-343` |
-| `outcomes` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:254-255` |
+| `outcomePorts` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:335-349` |
+| `outcomes` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:260-261` |
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:759-764` |
-| `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:310-324` |
+| `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:316-330` |
 | `outcomes` | property | `HumanTaskForm` | `dist/bpmn/human-task-form.d.ts:87-91` |
-| `outcomes` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:278-279` |
+| `outcomes` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:284-285` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1428-1440` |
 | `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1715-1750` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:97` |
@@ -807,7 +807,7 @@ not find it either.
 | `outputRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1646-1652` |
 | `outputRows` | property | `ExtensionPayload` | `dist/bpmn/bpmn-sdk.d.ts:616-617` |
 | `outputRows` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:943-952` |
-| `outputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:250-251` |
+| `outputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:256-257` |
 | `outputs` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:566-567` |
 | `outputs` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1644-1645` |
 | `outputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:848` |
@@ -819,7 +819,7 @@ not find it either.
 | `outputs` | property | `HumanTaskCommonOpts` | `dist/bpmn/bpmn-sdk.d.ts:1372-1382` |
 | `outputs` | property | `NodeContribution` | `dist/core/node-classes.d.ts:118-122` |
 | `outputs` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1302-1313` |
-| `outputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:274-275` |
+| `outputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:280-281` |
 | `outputs` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1349-1360` |
 | `outputs` | property | `ReceiveMessageOpts` | `dist/bpmn/bpmn-sdk.d.ts:1475-1490` |
 | `outputs` | property | `ResolvedEventTriggerOpts` | `dist/case/case-sdk.d.ts:296-300` |
@@ -865,7 +865,7 @@ not find it either.
 | `priority` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:551` |
 | `priority` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:330-331` |
 | `priority` | property | `EscalationRef` | `dist/core/actions.d.ts:767-768` |
-| `priority` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:298-299` |
+| `priority` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:304-305` |
 | `priority` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1437-1438` |
 | `priority` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:32-33` |
 | `process` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1260-1278` |
@@ -879,8 +879,8 @@ not find it either.
 | `projectId` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:39-46` |
 | `prompt` | property | `BatchTransformInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:54-55` |
 | `prompt` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:32-33` |
-| `properties` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:236-237` |
-| `properties` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:243-244` |
+| `properties` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:242-243` |
+| `properties` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:249-250` |
 | `propertyAttribute` | property | `BindingContribution` | `dist/core/node-classes.d.ts:97-98` |
 | `propertyAttribute` | property | `BindingDecl` | `dist/bpmn/bpmn-sdk.d.ts:427-428` |
 | `propertyAttribute` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:1069-1070` |
@@ -895,7 +895,7 @@ not find it either.
 | `race` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3132-3162` |
 | `receiveMessage` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2803-2844` |
 | `recipient` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:552-555` |
-| `recipient` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:325-326` |
+| `recipient` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:331-332` |
 | `recipients` | property | `EscalationRef` | `dist/core/actions.d.ts:757-758` |
 | `record` | property | `DataFabricDeleteInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:195-196` |
 | `record` | property | `DataFabricUpdateInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:163-164` |
@@ -905,10 +905,10 @@ not find it either.
 | `relative` | property | `RegistryOutput` | `dist/bpmn/typed-node.d.ts:83` |
 | `releaseKey` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1283-1292` |
 | `renameTo` | property | `FieldMapping` | `dist/nodes/transform/flow/spec.d.ts:32-33` |
-| `render` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:86-90` |
+| `render` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:92-96` |
 | `requestedVersion` | property | `ContributionContext` | `dist/core/node-classes.d.ts:72-78` |
 | `required` | property | `ActionField` | `dist/case/case-sdk.d.ts:531-532` |
-| `required` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:228-229` |
+| `required` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:234-235` |
 | `required` | property | `AskedField` | `dist/core/actions.d.ts:229-230` |
 | `required` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:406-407` |
 | `required` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:638` |
@@ -916,7 +916,7 @@ not find it either.
 | `required` | property | `HumanTaskAskedField` | `dist/bpmn/human-task-form.d.ts:55-56` |
 | `required` | property | `HumanTaskInOutField` | `dist/bpmn/human-task-form.d.ts:71-72` |
 | `required` | property | `InOutField` | `dist/core/actions.d.ts:256-257` |
-| `required` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:263-264` |
+| `required` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:269-270` |
 | `required` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:26` |
 | `required` | property | `RegistryInputField` | `dist/bpmn/typed-node.d.ts:67` |
 | `required` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1209-1215` |
@@ -1079,7 +1079,7 @@ not find it either.
 | `stepToRef` | method | `StepList` | `dist/flow-sdk.d.ts:1332-1352` |
 | `stickyNotes` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:858-859` |
 | `stickyNotes` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1449-1474` |
-| `storageBucket` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:82-83` |
+| `storageBucket` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:88-89` |
 | `strategy` | property | `LookupSpec` | `dist/core/lookups.d.ts:33` |
 | `style` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:709-710` |
 | `subProcess` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3000-3009` |
@@ -1111,7 +1111,7 @@ not find it either.
 | `task` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1216-1241` |
 | `tasks` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:40-55` |
 | `taskTitle` | property | `EscalationRef` | `dist/core/actions.d.ts:765-766` |
-| `taxonomy` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:91-92` |
+| `taxonomy` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:97-98` |
 | `temperature` | property | `ConversationalAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:64-65` |
 | `temperature` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:283-284` |
 | `temperature` | property | `VoiceSettings` | `dist/nodes/agent/flow/spec.d.ts:121-122` |
@@ -1129,7 +1129,7 @@ not find it either.
 | `title` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:550` |
 | `title` | property | `CaseAppSection` | `dist/case/case-sdk.d.ts:690-691` |
 | `title` | property | `GuardrailFieldReference` | `dist/core/actions.d.ts:298` |
-| `title` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:296-297` |
+| `title` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:302-303` |
 | `title` | property | `HumanTaskCommonOpts` | `dist/bpmn/bpmn-sdk.d.ts:1370-1371` |
 | `to` | property | `CreateOutgoingCallInputs` | `dist/nodes/agent/flow/spec.d.ts:93-94` |
 | `tool` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:569-570` |
@@ -1149,8 +1149,8 @@ not find it either.
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:781-782` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:732-733` |
 | `type` | property | `ActionField` | `dist/case/case-sdk.d.ts:516-517` |
-| `type` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:222-227` |
-| `type` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:241-242` |
+| `type` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:228-233` |
+| `type` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:247-248` |
 | `type` | property | `AskedField` | `dist/core/actions.d.ts:227` |
 | `type` | property | `BindingContribution` | `dist/core/node-classes.d.ts:89-90` |
 | `type` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:390-391` |
@@ -1164,7 +1164,7 @@ not find it either.
 | `type` | property | `HumanTaskShownField` | `dist/bpmn/human-task-form.d.ts:37-38` |
 | `type` | property | `InOutField` | `dist/core/actions.d.ts:252` |
 | `type` | property | `JsonSchemaType` | `dist/case/case-sdk.d.ts:650` |
-| `type` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:261-262` |
+| `type` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:267-268` |
 | `type` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:25` |
 | `type` | property | `RegistryInputField` | `dist/bpmn/typed-node.d.ts:66` |
 | `type` | property | `RegistryOutput` | `dist/bpmn/typed-node.d.ts:80` |
@@ -1220,7 +1220,7 @@ not find it either.
 | `variableOrder` | property | `BpmnPreservation` | `dist/bpmn/bpmn-sdk.d.ts:480-502` |
 | `variables` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:513-514` |
 | `variant` | property | `EscalationRef` | `dist/core/actions.d.ts:715-723` |
-| `variant` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:286-290` |
+| `variant` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:292-296` |
 | `variant` | property | `TransformInputs` | `dist/nodes/transform/flow/spec.d.ts:96-105` |
 | `vars` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:775` |
 | `vars` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:849` |

package/dist/core/refusals.d.ts

@@ -220,6 +220,7 @@ export declare const REFUSALS: {
     readonly HITL_READ_NOT_OUTPUT: "lint";
     readonly HITL_READ_STATUS: "lint";
     readonly HITL_READ_UNKNOWN_FIELD: "lint";
+    readonly HITL_RECIPIENT_NO_USER: "lint";
     readonly HITL_RECIPIENT_TYPE: "lint";
     readonly HITL_RECIPIENT_VALUE: "lint";
     readonly HITL_UNREACHABLE_AFTER: "lint";

package/dist/core/refusals.js

@@ -259,6 +259,7 @@ export const REFUSALS = {
     HITL_READ_NOT_OUTPUT: 'lint',
     HITL_READ_STATUS: 'lint',
     HITL_READ_UNKNOWN_FIELD: 'lint',
+    HITL_RECIPIENT_NO_USER: 'lint',
     HITL_RECIPIENT_TYPE: 'lint',
     HITL_RECIPIENT_VALUE: 'lint',
     HITL_UNREACHABLE_AFTER: 'lint',

package/dist/edit-scope.d.ts

@@ -12,6 +12,9 @@
  *
  * For instance, a canvas Slack node with no connection yet that the author did
  * not touch is `kept`; the same node with a new message text is `refused`.
+ * A node the SDK cannot lower is compared by the stand-ins the two collect-mode
+ * compiles emit for it ({@link isStandIn}), and kept only when the original's
+ * own round trip refuses it too ({@link classifyLowering}).
  *
  * Pure: no file access, so a portable entry (`check.ts`, `merge.ts`) can use
  * it. Reading the original and compiling its baseline is merge-compile.ts's.
@@ -70,6 +73,13 @@ export declare function byId(nodes: AnyNode[] | undefined): Map<string, AnyNode>
  * decide "did the user edit this node?" against the baseline.
  */
 export declare function nodeUnchanged(a: AnyNode | undefined, b: AnyNode | undefined): boolean;
+/**
+ * Whether `n` is the opaque node a collect-mode compile emits in place of a
+ * step it could not lower (serialize.ts `standInNode`): the node type, the
+ * step's `{ version }`, and `inputs: { standIn: true, spec }`, the spec as
+ * authored. It is never written: merge restores the original node or refuses.
+ */
+export declare function isStandIn(n: AnyNode | undefined): boolean;
 /**
  * The keys of the subflows `mergeFlow` (merge.ts) takes from `edited` rather than
  * restoring from `original`: every subflow that is new, that the original does
@@ -96,9 +106,15 @@ export declare function isKept(e: AnyNode, origNodes: Map<string, AnyNode>, base
  * Why a finding is an error: `edited`, its node is one the author changed or
  * added; `subflow`, it sits in a subflow the edit changed, which merge takes
  * whole; `unplaced`, it names no node and the original's own round trip does
- * not report it, so the edit introduced it.
+ * not report it, so the edit introduced it. Two more are for a lowering
+ * refusal on a node merge would keep ({@link classifyLowering}):
+ * `introduced`, the original's own round trip does not report it on that node,
+ * so an edit elsewhere broke it; `unrestorable`, restoring the node from the
+ * original would not undo it; `uncompared`, the node is the original's, but
+ * there is no collect-mode compile of the original to compare its stand-in
+ * with (no `--baseline-from`), so merge cannot tell whether the edit touched it.
  */
-export type TakenReason = 'edited' | 'subflow' | 'unplaced';
+export type TakenReason = 'edited' | 'subflow' | 'unplaced' | 'introduced' | 'unrestorable' | 'uncompared';
 /**
  * A finding on a node merge takes from the edited flow, with the reason it
  * takes it: `edited`, the author changed or added the node; `subflow`, the
@@ -135,6 +151,47 @@ export declare function classifyDrafts<T extends {
     refused: Refused<T>[];
     unplaced: T[];
 };
+/** A refusal a compile reported on the node `nodeId` (`''` when it names none). */
+export interface NodeRefusal {
+    nodeId: string;
+    code: string;
+    message: string;
+}
+/**
+ * Sort the lowering refusals of a collect-mode compile of the edited flow
+ * (`SerializeOpts.collect`, design D3) by what merge does with their node, as
+ * {@link classifyDrafts} does for drafts, then hold a kept one to the rest of
+ * what "pre-existing" means (docs/CHECK_COMPILE_CONTRACT_DESIGN.md §3.3). It
+ * stays `kept`, and merge restores the original node, only when:
+ *
+ *   - the ORIGINAL's own round trip (`baselineRefusals`, the baseline compiled
+ *     in collect mode) reports the same code on the same node; else it is
+ *     refused as `introduced`: an edit elsewhere broke a node the author did
+ *     not touch (a deleted node it reads), and restoring it would keep the
+ *     break;
+ *   - restoring the node undoes the refusal; else it is refused as
+ *     `unrestorable`. That holds for a root node the compile stood in for
+ *     ({@link isStandIn}: its own emission failed, and its edges are wired as
+ *     any node's), and for any node of an untouched subflow, which merge
+ *     restores whole. A refusal on a root node that did lower (an edge out of
+ *     it, a join it feeds) is about edges merge takes from the edited flow.
+ *     The {@link NEVER_KEPT_CODES} are `unrestorable` too.
+ *
+ * `baselineRefusals` is `undefined` when the baseline was not compiled in
+ * collect mode (a precompiled `--baseline` file, or none). Then a stand-in has
+ * nothing to equal (a precompiled baseline holds the node lowered, or the file
+ * would not exist), and nothing says how the original's round trip treats the
+ * node, so every refusal on a node the original has is `uncompared`, never
+ * `edited`: the author may not have touched it.
+ *
+ * For instance a canvas Jira node whose input the SDK cannot read, untouched,
+ * is `kept`; the same node with a changed summary is `refused` as `edited`.
+ */
+export declare function classifyLowering<T extends NodeRefusal>(original: any, edited: any, baseline: any, refusals: readonly T[], baselineRefusals: readonly NodeRefusal[] | undefined): {
+    kept: Kept<T>[];
+    refused: Refused<T>[];
+    unplaced: T[];
+};
 /**
  * A `check()` diagnostic, placed on the node its step emitted (`''` when it
  * names no node); `subflow` is the calling step when the finding is inside a

package/dist/edit-scope.js

@@ -15,9 +15,25 @@ export function nodeUnchanged(a, b) {
         return false;
     if (a.type !== b.type)
         return false;
+    // A step that fails to lower has no compiled node on either side, only the
+    // collect-mode stand-in (D5): equal stand-ins mean the edit did not touch the
+    // spec. Its `typeVersion` is the author's `{ version }` pin, so it counts.
+    if (isStandIn(a) || isStandIn(b)) {
+        return isStandIn(a) && isStandIn(b) && a.typeVersion === b.typeVersion
+            && JSON.stringify(a.inputs) === JSON.stringify(b.inputs);
+    }
     return JSON.stringify(a.inputs ?? {}) === JSON.stringify(b.inputs ?? {})
         && JSON.stringify(outputSources(a)) === JSON.stringify(outputSources(b));
 }
+/**
+ * Whether `n` is the opaque node a collect-mode compile emits in place of a
+ * step it could not lower (serialize.ts `standInNode`): the node type, the
+ * step's `{ version }`, and `inputs: { standIn: true, spec }`, the spec as
+ * authored. It is never written: merge restores the original node or refuses.
+ */
+export function isStandIn(n) {
+    return n?.inputs?.standIn === true;
+}
 /** Each output's `source` by output name; outputs without one are left out. */
 function outputSources(n) {
     const sources = {};
@@ -160,6 +176,72 @@ export function classifyDrafts(original, edited, baseline, findings) {
     }
     return { kept, refused, unplaced };
 }
+/**
+ * Lowering codes merge never keeps as saved, even on an untouched node:
+ * `COMPILE_FAILED` is a throw the SDK has no refusal for (a crash, not a
+ * finding to step over), and `LIBRARY_REQUIRED` is about compile's inputs,
+ * not about the node.
+ */
+const NEVER_KEPT_CODES = new Set(['COMPILE_FAILED', 'LIBRARY_REQUIRED']);
+/**
+ * Sort the lowering refusals of a collect-mode compile of the edited flow
+ * (`SerializeOpts.collect`, design D3) by what merge does with their node, as
+ * {@link classifyDrafts} does for drafts, then hold a kept one to the rest of
+ * what "pre-existing" means (docs/CHECK_COMPILE_CONTRACT_DESIGN.md §3.3). It
+ * stays `kept`, and merge restores the original node, only when:
+ *
+ *   - the ORIGINAL's own round trip (`baselineRefusals`, the baseline compiled
+ *     in collect mode) reports the same code on the same node; else it is
+ *     refused as `introduced`: an edit elsewhere broke a node the author did
+ *     not touch (a deleted node it reads), and restoring it would keep the
+ *     break;
+ *   - restoring the node undoes the refusal; else it is refused as
+ *     `unrestorable`. That holds for a root node the compile stood in for
+ *     ({@link isStandIn}: its own emission failed, and its edges are wired as
+ *     any node's), and for any node of an untouched subflow, which merge
+ *     restores whole. A refusal on a root node that did lower (an edge out of
+ *     it, a join it feeds) is about edges merge takes from the edited flow.
+ *     The {@link NEVER_KEPT_CODES} are `unrestorable` too.
+ *
+ * `baselineRefusals` is `undefined` when the baseline was not compiled in
+ * collect mode (a precompiled `--baseline` file, or none). Then a stand-in has
+ * nothing to equal (a precompiled baseline holds the node lowered, or the file
+ * would not exist), and nothing says how the original's round trip treats the
+ * node, so every refusal on a node the original has is `uncompared`, never
+ * `edited`: the author may not have touched it.
+ *
+ * For instance a canvas Jira node whose input the SDK cannot read, untouched,
+ * is `kept`; the same node with a changed summary is `refused` as `edited`.
+ */
+export function classifyLowering(original, edited, baseline, refusals, baselineRefusals) {
+    const sorted = classifyDrafts(original, edited, baseline, refusals);
+    if (baselineRefusals === undefined) {
+        const originalIds = new Set([
+            ...(original?.nodes ?? []).map((n) => n.id),
+            ...Object.values(original?.subflows ?? {}).flatMap((sf) => (sf?.nodes ?? []).map((n) => n.id)),
+        ]);
+        const refused = [...sorted.kept, ...sorted.refused].map((f) => ({
+            ...f,
+            reason: originalIds.has(f.nodeId) ? 'uncompared' : f.reason ?? 'edited',
+        }));
+        return { kept: [], refused, unplaced: sorted.unplaced };
+    }
+    const onNode = (r) => `${r.nodeId}\n${r.code}`;
+    const inBaseline = new Set(baselineRefusals.filter((r) => r.nodeId !== '').map(onNode));
+    const editedNodes = byId(edited?.nodes);
+    const kept = [];
+    const refused = [...sorted.refused];
+    for (const f of sorted.kept) {
+        const restorable = !NEVER_KEPT_CODES.has(f.code) && (f.subflow !== undefined || isStandIn(editedNodes.get(f.nodeId)));
+        if (!restorable)
+            refused.push({ ...f, reason: 'unrestorable' });
+        else if (!inBaseline.has(onNode(f)))
+            refused.push({ ...f, reason: 'introduced' });
+        else
+            kept.push(f);
+    }
+    return { kept, refused, unplaced: sorted.unplaced };
+}
 /**
  * Place each `check()` diagnostic on the node its step emitted in `editedFlow`, so
  * {@link classifyDrafts} can sort it: a root step on its node (by label, then

package/dist/merge-cli.js

@@ -9,8 +9,14 @@
  * `--baseline-from <original.flow>` makes merge build the baseline itself
  * (decompile + compile, nothing written), and an edited `.flow.ts` makes merge
  * compile it: both compiles tolerate DRAFT nodes, and merge refuses a draft
- * only where it would take the node from the edited flow. See merge-compile.ts
- * and edit-scope.ts.
+ * only where it would take the node from the edited flow. Both also run in
+ * collect mode, so a node the SDK cannot lower (#1402) is stood in for: merge
+ * restores it from the original when the edit did not touch it and the
+ * original's own round trip refuses it too (`LOWERING_NODE_KEPT`, printed as a
+ * probable SDK defect), and refuses the write when the edit changed it. See
+ * merge-compile.ts and edit-scope.ts. Neither warning depends on `--strict`:
+ * both nodes are written as the canvas saved them; `--strict` still refuses a
+ * stand-in whose wiring changed the round trip.
  *
  * `edited.flow` is compile(decompile(original) after your edits). `--baseline`
  * is compile(decompile(original)) BEFORE any edit — supplying it enables the
@@ -57,7 +63,7 @@ import { Bindings } from './bindings.js';
 import { defaultBindingsFile } from './workdir.js';
 import { loadNodePackages } from './node-packages.js';
 import { baselineFromOriginal, checkEdited, compileSourceDraftTolerant } from './merge-compile.js';
-import { classifyDrafts, findingCounts, splitUnplaced } from './edit-scope.js';
+import { classifyDrafts, classifyLowering, findingCounts, splitUnplaced } from './edit-scope.js';
 const USAGE = 'usage: flow-merge <original.flow> <edited.flow | Edited.flow.ts> [-o merged.flow] '
     + '[--baseline <baseline.flow> | --baseline-from <original.flow>] [--library <dir>] [--bindings <file>] [--strict]';
 /**
@@ -185,6 +191,7 @@ export async function run(argv) {
     const compileOpts = { library, bindings };
     const original = JSON.parse(readFileSync(originalPath, 'utf8'));
     let drafts = [];
+    let lowering = [];
     let diagnostics = [];
     let edited;
     let editedSidecars;
@@ -198,6 +205,7 @@ export async function run(argv) {
         edited = compiled.flow;
         editedSidecars = compiled.sidecars;
         drafts = compiled.drafts;
+        lowering = compiled.lowering.map(onNode);
         diagnostics = checkEdited(compiled.built, edited, flowCheckOpts(library, bindings));
     }
     else {
@@ -229,6 +237,9 @@ export async function run(argv) {
     // check()'s errors follow the same rule; its warnings are printed as compile prints them.
     const { kept, refused, unplaced } = classifyDrafts(original, edited, baseline, drafts);
     const checked = classifyDrafts(original, edited, baseline, diagnostics.filter((d) => d.level === 'error'));
+    // A node the SDK cannot lower follows the draft rule, held to the baseline:
+    // kept only when the original's own round trip refuses it the same way.
+    const lowered = classifyLowering(original, edited, baseline, lowering, baselineCompile?.lowering.map(onNode));
     for (const d of diagnostics)
         if (d.level === 'warning')
             console.error(`  ⚠ [${d.code}] ${d.message}`);
@@ -237,6 +248,14 @@ export async function run(argv) {
             ? `  ⚠ [DRAFT_NODE_KEPT] "${d.nodeId}" is unfinished in the original (${d.code}); it is inside subflow "${d.subflow}", which the edit did not touch, so the original subflow is kept as is.`
             : `  ⚠ [DRAFT_NODE_KEPT] "${d.nodeId}" is unfinished in the original (${d.code}); it is untouched, so the original node is kept as is.`);
     }
+    for (const d of lowered.kept) {
+        const where = d.subflow !== undefined
+            ? `is inside subflow "${d.subflow}", which the edit did not touch, so the original subflow is kept as is`
+            : 'is untouched, so the original node is kept as is';
+        console.error(`  ⚠ [LOWERING_NODE_KEPT] "${d.nodeId}" ${where}, but the SDK cannot compile it (${d.code}). `
+            + 'This is probably an SDK defect: the SDK cannot read what the designer wrote. Report it: https://github.com/UiPath/builder-sdk/issues');
+        console.error(`      ${d.message}`);
+    }
     // A finding merge cannot place on a node — an unnamed End's `.return`, a
     // flow-level finding — is printed when the ORIGINAL's own round trip reports
     // it too (the designer's file had it; check has already said it), and
@@ -245,16 +264,18 @@ export async function run(argv) {
     // one is refused, as before.
     const baselineFindings = baselineCompile === undefined ? undefined : findingCounts([
         ...baselineCompile.drafts,
+        ...baselineCompile.lowering,
         ...checkEdited(baselineCompile.built, baselineCompile.flow, flowCheckOpts(library, bindings)).filter((d) => d.level === 'error'),
     ]);
     const unplacedDrafts = splitUnplaced(unplaced, baselineFindings);
     const unplacedChecks = splitUnplaced(checked.unplaced, baselineFindings);
-    for (const d of [...unplacedDrafts.known, ...unplacedChecks.known]) {
+    const unplacedLowering = splitUnplaced(lowered.unplaced, baselineFindings);
+    for (const d of [...unplacedDrafts.known, ...unplacedChecks.known, ...unplacedLowering.known]) {
         console.error(`  ⚠ [CHECK_FINDING_UNPLACED] ${d.code} names no node, and the original's own round trip reports it too, so it does not stop the write: ${d.message}`);
     }
     const errors = [
-        ...refused, ...checked.refused,
-        ...[...unplacedDrafts.introduced, ...unplacedChecks.introduced].map((d) => ({ ...d, reason: 'unplaced' })),
+        ...refused, ...checked.refused, ...lowered.refused,
+        ...[...unplacedDrafts.introduced, ...unplacedChecks.introduced, ...unplacedLowering.introduced].map((d) => ({ ...d, reason: 'unplaced' })),
     ];
     if (errors.length) {
         for (const d of errors) {
@@ -262,10 +283,17 @@ export async function run(argv) {
                 ? 'the edited flow (this finding names no node, and the original\'s own round trip does not report it, so the edit introduced it)'
                 : d.reason === 'subflow'
                     ? `"${d.nodeId}" is inside subflow "${d.subflow}", which the edit changed, so merge takes that subflow whole; finish it`
-                    : `"${d.nodeId}" is changed or new in the edited flow`;
+                    : d.reason === 'introduced'
+                        ? `"${d.nodeId}" is untouched, but the original's own round trip does not refuse it, so an edit elsewhere broke it`
+                        : d.reason === 'unrestorable'
+                            ? unrestorable(d.nodeId, d.code)
+                            : d.reason === 'uncompared'
+                                ? `"${d.nodeId}" is the original's, but the SDK cannot compile it, and ${baseline ? 'a precompiled --baseline has no record of' : 'with no baseline merge cannot tell'} `
+                                    + 'whether the edit touched it; pass --baseline-from <original.flow> (instead of --baseline) so merge compiles the original itself and can compare the node'
+                                : `"${d.nodeId}" is changed or new in the edited flow`;
             console.error(`  ✗ [${d.code}] ${where}: ${d.message}`);
         }
-        console.error(`flow-merge: ${errors.length} error(s) in nodes merge takes from the edited flow; finish them or revert the edit. Nothing written.`);
+        console.error(`flow-merge: ${errors.length} error(s) in nodes merge takes from the edited flow; each line says what to do (finish the node, revert the edit, or pass what merge needs). Nothing written.`);
         return 1;
     }
     // Each compile writes `<source>/` beside its own output, so a baseline in the
@@ -345,4 +373,23 @@ export async function run(argv) {
     });
     return 0;
 }
+/**
+ * The error for a refusal on an untouched node that restoring it from the
+ * original would not undo, with the step to take: a crash is an SDK defect;
+ * a missing input to compile (the node library) is the caller's to pass; any
+ * other is about the edges merge takes from the edited flow.
+ */
+function unrestorable(nodeId, code) {
+    const report = 'https://github.com/UiPath/builder-sdk/issues';
+    if (code === 'COMPILE_FAILED')
+        return `"${nodeId}" is untouched, but the SDK failed while compiling it; this is an SDK defect, report it: ${report}`;
+    if (code === 'LIBRARY_REQUIRED')
+        return `"${nodeId}" is untouched, but compiling it needs the node library; pass --library <dir> and merge again`;
+    return `"${nodeId}" is untouched, but restoring it from the original would not undo this: revert the edit's changes to the edges `
+        + `into or out of it; if there are none, this is an SDK defect, report it: ${report}`;
+}
+/** A collect-mode refusal as edit-scope.ts sorts it: on its node, or on none (`''`). */
+function onNode(r) {
+    return { nodeId: r.nodeId ?? '', code: r.code, message: r.message };
+}
 runWhenInvokedDirectly(import.meta.url, 'flow-merge', run);

package/dist/merge-compile.d.ts

@@ -1,34 +1,44 @@
-import { type DraftFinding, type SerializeOpts } from './serialize.js';
+import { type CollectedRefusal, type DraftFinding, type SerializeOpts } from './serialize.js';
 import { type CheckOpts } from './check.js';
 import { type PlacedDiagnostic } from './edit-scope.js';
 import type { BuiltFlow } from './flow-sdk.js';
 /**
- * A compile's flow, the draft refusals it reported instead of throwing, and the
- * agent sidecars (`<source>/agent.json`, resource files) it produced, none written.
+ * A compile's flow, the draft refusals it reported instead of throwing, the
+ * lowering refusals collect mode reported on the steps it stood in for (or on
+ * no step), and the agent sidecars (`<source>/agent.json`, resource files) it
+ * produced, none written.
  */
 export interface DraftTolerantCompile {
     flow: any;
     drafts: DraftFinding[];
+    lowering: CollectedRefusal[];
     sidecars: Array<{
         path: string;
         json: unknown;
     }>;
 }
-/** Compile `built` with draft tolerance. Every other refusal still throws. */
-export declare function compileDraftTolerant(built: BuiltFlow, opts?: Omit<SerializeOpts, 'draft'>): DraftTolerantCompile;
+/**
+ * Compile `built` with draft tolerance, in collect mode: a step whose
+ * emission is refused is reported in `lowering` and stood in for, so the
+ * rest of the flow is still compiled. A scope-level refusal (two steps with
+ * one name, a variable plan) leaves no flow to merge, so it is thrown, as an
+ * ordinary compile throws it.
+ */
+export declare function compileDraftTolerant(built: BuiltFlow, opts?: Omit<SerializeOpts, 'draft' | 'collect'>): DraftTolerantCompile;
 /**
  * Load a `.flow.ts` source and compile it with draft tolerance.
  * The caller has already called `ensureTypeScriptRuntime()`.
  */
-export declare function compileSourceDraftTolerant(file: string, opts?: Omit<SerializeOpts, 'draft'>): Promise<DraftTolerantCompile & {
+export declare function compileSourceDraftTolerant(file: string, opts?: Omit<SerializeOpts, 'draft' | 'collect'>): Promise<DraftTolerantCompile & {
     built: BuiltFlow;
 }>;
 /**
  * The baseline of `originalPath`: decompile it (reading agent sidecars beside
- * it, as `flow decompile` does), then compile the source with draft tolerance.
+ * it, as `flow decompile` does), then compile the source with draft tolerance,
+ * in collect mode ({@link compileDraftTolerant}).
  * The source goes to a temporary directory that is removed afterwards.
  */
-export declare function baselineFromOriginal(originalPath: string, opts?: Omit<SerializeOpts, 'draft'>, warn?: (message: string) => void): Promise<DraftTolerantCompile & {
+export declare function baselineFromOriginal(originalPath: string, opts?: Omit<SerializeOpts, 'draft' | 'collect'>, warn?: (message: string) => void): Promise<DraftTolerantCompile & {
     built: BuiltFlow;
 }>;
 /**

package/dist/merge-compile.js

@@ -1,11 +1,13 @@
 /**
  * merge-compile — the compiles `flow merge --baseline-from` runs itself (#1134).
  *
- * Both compiles tolerate draft nodes (`SerializeOpts.draft`). A draft on a node
- * merge keeps from the original is a warning; a draft or `check()` error on a
- * node merge takes from the edited flow is an error. Nothing draft-tolerant is
- * written to disk. Which nodes count as edited, and how each finding is sorted,
- * is edit-scope.ts's.
+ * Both compiles tolerate draft nodes (`SerializeOpts.draft`) and run in collect
+ * mode (`SerializeOpts.collect`), so a node that fails to lower is reported and
+ * stood in for instead of stopping the compile. A draft or lowering refusal on
+ * a node merge keeps from the original is a warning; one on a node merge takes
+ * from the edited flow, like a `check()` error there, is an error. Nothing
+ * these compiles produce is written to disk. Which nodes count as edited, and
+ * how each finding is sorted, is edit-scope.ts's.
  */
 import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -13,15 +15,28 @@ import { dirname, join, resolve } from 'node:path';
 import { decompile } from './decompile.js';
 import { loadBuiltFlow } from './load.js';
 import { serialize } from './serialize.js';
+import { CompileRefusal } from './core/compile-refusal.js';
 import { PACKAGE_NAME } from './package-name.js';
 import { check } from './check.js';
 import { placeDiagnostics } from './edit-scope.js';
-/** Compile `built` with draft tolerance. Every other refusal still throws. */
+/**
+ * Compile `built` with draft tolerance, in collect mode: a step whose
+ * emission is refused is reported in `lowering` and stood in for, so the
+ * rest of the flow is still compiled. A scope-level refusal (two steps with
+ * one name, a variable plan) leaves no flow to merge, so it is thrown, as an
+ * ordinary compile throws it.
+ */
 export function compileDraftTolerant(built, opts = {}) {
     const drafts = [];
+    const lowering = [];
     const sidecars = [];
-    const flow = serialize(built, { ...opts, draft: (f) => drafts.push(f), sidecars });
-    return { flow, drafts, sidecars };
+    const flow = serialize(built, { ...opts, draft: (f) => drafts.push(f), collect: (r) => lowering.push(r), sidecars });
+    if (flow === undefined) {
+        // Collection stopped: the refusal that stopped it is the last one reported.
+        const stop = lowering[lowering.length - 1];
+        throw new CompileRefusal(stop.code, stop.message, stop.suggestion);
+    }
+    return { flow, drafts, lowering, sidecars };
 }
 /**
  * Load a `.flow.ts` source and compile it with draft tolerance.
@@ -33,7 +48,8 @@ export async function compileSourceDraftTolerant(file, opts = {}) {
 }
 /**
  * The baseline of `originalPath`: decompile it (reading agent sidecars beside
- * it, as `flow decompile` does), then compile the source with draft tolerance.
+ * it, as `flow decompile` does), then compile the source with draft tolerance,
+ * in collect mode ({@link compileDraftTolerant}).
  * The source goes to a temporary directory that is removed afterwards.
  */
 export async function baselineFromOriginal(originalPath, opts = {}, warn) {

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

@@ -47,10 +47,21 @@ export const HITL_DIAGNOSTICS = {
     HITL_CHANNEL_UNKNOWN: { severity: 'error', summary: 'a delivery channel the platform does not recognize' },
     HITL_RECIPIENT_TYPE: { severity: 'error', summary: 'an assignee type the platform does not recognize' },
     HITL_RECIPIENT_VALUE: { severity: 'warning', summary: 'a custom assignment with no value' },
+    HITL_RECIPIENT_NO_USER: { severity: 'warning', summary: 'a single-user assignment that names no user' },
     HITL_READ_STATUS: { severity: 'error', summary: 'a read of the status projection instead of output.Action' },
     HITL_READ_NOT_OUTPUT: { severity: 'error', summary: 'a read of the task outside output' },
     HITL_READ_UNKNOWN_FIELD: { severity: 'error', summary: 'a read of a field the form does not answer' },
 };
+/**
+ * The assignee types that name ONE person, so an authored one with no value is
+ * almost certainly a missing pick. flow-v1's serializer
+ * (`services/src/serialization/hitl-serialization.ts`) writes the `recipient`
+ * context only when a value is present, and PO.BpmnEngine assigns only when
+ * `Recipient` or `CustomAssignees` is set — with neither, ANY assignee type is
+ * created unassigned in its folder. A warning, not an error: an unassigned task
+ * runs; it just waits for someone to pick it up.
+ */
+const HITL_ASSIGNEE_TYPES_NEEDING_VALUE = ['user', 'staticEmail'];
 /** Names the human task's own result already uses — an answer cannot claim one. */
 const RESERVED_ANSWER_IDS = new Set(['output', 'status', 'Action']);
 /**
@@ -380,8 +391,13 @@ export function checkHitl(inputs, ctx) {
                 + `${HITL_ASSIGNEE_TYPES.join(', ')}.`, nearest !== undefined ? `assignee: { type: '${nearest}' }` : undefined);
         }
         else if (at2 === 'custom' && !(typeof rec.assignee?.value === 'string' && rec.assignee.value.trim())) {
-            at('HITL_RECIPIENT_VALUE', `Human task "${step}" uses a custom assignment with no value — the engine gets an `
-                + `empty custom-assignees expression and falls back to the tenant default.`, `assignee: { type: 'custom', value: '<expression>' }`);
+            at('HITL_RECIPIENT_VALUE', `Human task "${step}" uses a custom assignment with no value, so no one is assigned: `
+                + `the task is created unassigned in its folder.`, `assignee: { type: 'custom', value: '<expression>' }`);
+        }
+        else if (HITL_ASSIGNEE_TYPES_NEEDING_VALUE.includes(String(at2))
+            && !(typeof rec.assignee?.value === 'string' && rec.assignee.value.trim())) {
+            at('HITL_RECIPIENT_NO_USER', `Human task "${step}" assigns its recipient to a single user (type '${at2}') but names no `
+                + `user, so no one is assigned: the task is created unassigned in its folder. Name the user.`, `assignee: { type: '${at2}', value: 'reviewer@example.com' }`);
         }
     }
     // A form with nothing to fill in and one outcome is a notification, not a task

package/dist/nodes/hitl/flow/spec.d.ts

@@ -32,9 +32,11 @@ export interface HitlConnection {
 }
 /**
  * Who gets the task and over which channels. Omit the whole object for the
- * definition's default (Email + Action Center, assigned to a group) — which is
- * what 203 of 233 deployed v1 human tasks carry, and what this SDK has always
- * emitted.
+ * definition's default: delivered on its channels (Email + Action Center on the
+ * inline forms — what 203 of 233 deployed v1 human tasks carry — Action Center
+ * alone on `'action-app'` and `'document-validation'`), and unassigned. The
+ * default's assignee carries no value, so the task is created unassigned in its
+ * folder until someone picks it up; name an assignee `value` to assign it.
  *
  * ```ts
  * hitl({
@@ -54,8 +56,12 @@ export interface HitlRecipient {
         type: HitlAssigneeType;
         /**
          * The user email / group name / expression, per `type`. The engine lowers
-         * this to its `{ Value, Type }` recipient contract; without one the task
-         * falls back to the tenant's assignment default.
+         * this to its `{ Value, Type }` recipient contract. Without one, ANY type
+         * leaves the task unassigned in its folder: no `recipient` is written and
+         * the engine makes no assignment. `'user'` and `'staticEmail'` name one
+         * person, so a missing value there is flagged.
+         *
+         * @enforcedBy HITL_RECIPIENT_NO_USER A single-user assignee needs its user.
          */
         value?: string;
         /** Display name the designer shows next to the pick. Cosmetic. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.61.0",
+  "version": "6.62.0",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -100,5 +100,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "1616b860e81b3c9301d0c2e1fe88ae2d795b8774"
+  "gitref": "2a6094aa49f4cbf18cb309ba93c33573f3e1f226"
 }