@uipath/maestro-builder-sdk 6.66.1 → 6.66.2

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: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`. |
+| `ActionSchema` | type | `dist/nodes/hitl/flow/spec.d.ts:318-319` | Supporting types | An Action App's action schema, in either spelling. |
+| `ActionSchemaFile` | interface | `dist/nodes/hitl/flow/spec.d.ts:281-291` | Supporting types | A coded action app's `action-schema.json`. |
+| `ActionSchemaProperty` | interface | `dist/nodes/hitl/flow/spec.d.ts:255-273` | Supporting types | One property of an `action-schema.json` section. |
+| `ActionSchemaSection` | interface | `dist/nodes/hitl/flow/spec.d.ts:274-280` | 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:146-225` | 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-254` | 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:1385-1408` | 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:714-742` | Flow construction | A node's layout at a canvas position — the short form of a NodeLayout for the `nodes` map of FlowBuilder.layout. |
@@ -164,7 +164,7 @@ 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:291-395` | Option shapes | 12 field(s) |
+| `HitlInputs` | interface | `dist/nodes/hitl/flow/spec.d.ts:320-424` | 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. |
@@ -208,8 +208,8 @@ could hand you spans for a version you do not have.
 | `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:468-491` | 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: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. |
+| `PlatformActionSchema` | interface | `dist/nodes/hitl/flow/spec.d.ts:305-317` | Supporting types | The platform's action schema (Apps API, a solution's `spec.actionSchema`). |
+| `PlatformActionSchemaArg` | interface | `dist/nodes/hitl/flow/spec.d.ts:292-304` | 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

@@ -5,12 +5,12 @@
 
 # Maestro Builder SDK — member index
 
-**A lookup table of 1225 rows — match one name in it, do not read it.**
+**A lookup table of 1226 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 — 1225 across
+Every field and method of every exported shape — 1226 across
 224 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 1225 rows here.
+which is why its span is not repeated on all 1226 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
@@ -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:191-215` |
+| `actionSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:220-244` |
 | `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,10 +64,10 @@ 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:297-301` |
+| `app` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:326-330` |
 | `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:176-181` |
+| `appSystemName` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:205-210` |
 | `appVersion` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1401-1402` |
 | `armLabel` | property | `ArmBuilder` | `dist/flow-sdk.d.ts:1397` |
 | `assignee` | property | `HitlRecipient` | `dist/nodes/hitl/flow/spec.d.ts:54-69` |
@@ -226,7 +226,7 @@ not find it either.
 | `definitions` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1642-1682` |
 | `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:236-237` |
+| `description` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:265-266` |
 | `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:858-859` |
@@ -285,7 +285,7 @@ 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:390-394` |
+| `document` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:419-423` |
 | `documentClassify` | property | `FlowActionSpecs` | `dist/nodes/document/flow/spec.d.ts:152-155` |
 | `documentId` | property | `DocValidationInputs` | `dist/nodes/hitl/flow/spec.d.ts:90-91` |
 | `doWhile` | method | `StepList` | `dist/flow-sdk.d.ts:1219-1243` |
@@ -362,7 +362,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:350-356` |
+| `exposeError` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:379-385` |
 | `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` |
@@ -380,7 +380,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:306-315` |
+| `fields` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:335-344` |
 | `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` |
@@ -424,7 +424,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:174-175` |
+| `folderPath` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:198-204` |
 | `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` |
@@ -441,7 +441,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:238-239` |
+| `format` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:267-268` |
 | `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` |
@@ -455,7 +455,7 @@ not find it either.
 | `height` | property | `StickyNote` | `dist/flow-sdk.d.ts:825-826` |
 | `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:398-401` |
+| `hitl` | property | `FlowActionSpecs` | `dist/nodes/hitl/flow/spec.d.ts:427-430` |
 | `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` |
@@ -501,8 +501,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:258-259` |
-| `inOuts` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:282-283` |
+| `inOuts` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:287-288` |
+| `inOuts` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:311-312` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1402-1427` |
 | `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1723-1735` |
 | `input` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1415-1416` |
@@ -511,13 +511,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:254-255` |
+| `inputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:283-284` |
 | `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:182-190` |
+| `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:211-219` |
 | `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:850-851` |
 | `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:868` |
 | `inputs` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:628-629` |
@@ -525,7 +525,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:278-279` |
+| `inputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:307-308` |
 | `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` |
@@ -535,7 +535,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:216-224` |
+| `inputSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:245-253` |
 | `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` |
@@ -550,11 +550,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:271-272` |
+| `isList` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:300-301` |
 | `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:240-241` |
+| `items` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:269-270` |
 | `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` |
@@ -563,7 +563,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:172-173` |
+| `key` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:179-185` |
 | `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` |
@@ -599,19 +599,20 @@ 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:333-334` |
+| `labels` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:362-363` |
 | `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:877-878` |
 | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1381-1401` |
 | `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1443-1469` |
-| `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:357-389` |
+| `legacyCompleted` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:386-418` |
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:573-574` |
 | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
 | `location` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:177-187` |
 | `location` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:285-290` |
+| `location` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:186-197` |
 | `location` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:122-129` |
 | `location` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:25-30` |
 | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
@@ -678,7 +679,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:170-171` |
+| `name` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:177-178` |
 | `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` |
@@ -729,7 +730,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:265-266` |
+| `name` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:294-295` |
 | `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` |
@@ -794,12 +795,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:335-349` |
-| `outcomes` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:260-261` |
+| `outcomePorts` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:364-378` |
+| `outcomes` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:289-290` |
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:759-764` |
-| `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:316-330` |
+| `outcomes` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:345-359` |
 | `outcomes` | property | `HumanTaskForm` | `dist/bpmn/human-task-form.d.ts:87-91` |
-| `outcomes` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:284-285` |
+| `outcomes` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:313-314` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1428-1440` |
 | `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1736-1771` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:97` |
@@ -808,7 +809,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:256-257` |
+| `outputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:285-286` |
 | `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:869` |
@@ -820,7 +821,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:280-281` |
+| `outputs` | property | `PlatformActionSchema` | `dist/nodes/hitl/flow/spec.d.ts:309-310` |
 | `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` |
@@ -866,7 +867,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:304-305` |
+| `priority` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:333-334` |
 | `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` |
@@ -880,8 +881,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:242-243` |
-| `properties` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:249-250` |
+| `properties` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:271-272` |
+| `properties` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:278-279` |
 | `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` |
@@ -896,7 +897,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:331-332` |
+| `recipient` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:360-361` |
 | `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` |
@@ -909,7 +910,7 @@ not find it either.
 | `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:234-235` |
+| `required` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:263-264` |
 | `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` |
@@ -917,7 +918,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:269-270` |
+| `required` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:298-299` |
 | `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` |
@@ -1130,7 +1131,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:302-303` |
+| `title` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:331-332` |
 | `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` |
@@ -1150,8 +1151,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:228-233` |
-| `type` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:247-248` |
+| `type` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:257-262` |
+| `type` | property | `ActionSchemaSection` | `dist/nodes/hitl/flow/spec.d.ts:276-277` |
 | `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` |
@@ -1165,7 +1166,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:267-268` |
+| `type` | property | `PlatformActionSchemaArg` | `dist/nodes/hitl/flow/spec.d.ts:296-297` |
 | `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` |
@@ -1221,7 +1222,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:292-296` |
+| `variant` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:321-325` |
 | `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:870` |

package/dist/core/process-resource.d.ts

@@ -80,7 +80,12 @@ export declare function processResourceLocation(spec: {
 export declare function processResourceBindings(spec: {
     name: string;
     folderPath: string;
-    resourceSubType: ProcessResourceSubType;
+    /**
+     * The binding's resource kind. `'process'` (the default) for a process
+     * reference; `'app'` for an Action App, which carries no subtype.
+     */
+    resource?: 'process' | 'app';
+    resourceSubType?: ProcessResourceSubType;
     resourceKey?: string;
 }, existing: ReadonlyMap<string, any>): {
     ids: {

package/dist/core/process-resource.js

@@ -63,8 +63,9 @@ export function processResourceLocation(spec) {
  * process share one pair.
  */
 export function processResourceBindings(spec, existing) {
+    const resource = spec.resource ?? 'process';
     const resourceKey = spec.resourceKey ?? `${spec.folderPath}.${spec.name}`;
-    const found = (attr) => [...existing.values()].find((b) => b.resource === 'process' && b.resourceKey === resourceKey && b.propertyAttribute === attr)?.id;
+    const found = (attr) => [...existing.values()].find((b) => b.resource === resource && b.resourceKey === resourceKey && b.propertyAttribute === attr)?.id;
     const already = { name: found('name'), folderPath: found('folderPath') };
     if (already.name && already.folderPath) {
         return { ids: { name: already.name, folderPath: already.folderPath }, entries: [] };
@@ -72,7 +73,7 @@ export function processResourceBindings(spec, existing) {
     // A readable, stable id per process. Two processes sharing a NAME across folders
     // would collide, so the id is suffixed until it is free — the queue emitter's
     // shape, which this is a port of.
-    const slug = spec.name.replace(/[^A-Za-z0-9]/g, '') || 'Process';
+    const slug = spec.name.replace(/[^A-Za-z0-9]/g, '') || (resource === 'app' ? 'App' : 'Process');
     let base = `b${slug.charAt(0).toUpperCase()}${slug.slice(1)}`;
     for (let n = 2; existing.has(`${base}Name`) || existing.has(`${base}FolderPath`); n++) {
         base = `b${slug.charAt(0).toUpperCase()}${slug.slice(1)}${n}`;
@@ -83,21 +84,21 @@ export function processResourceBindings(spec, existing) {
                 id: ids.name,
                 name: 'name',
                 type: 'string',
-                resource: 'process',
+                resource,
                 resourceKey,
                 default: spec.name,
                 propertyAttribute: 'name',
-                resourceSubType: spec.resourceSubType,
+                ...(spec.resourceSubType !== undefined ? { resourceSubType: spec.resourceSubType } : {}),
             },
             {
                 id: ids.folderPath,
                 name: 'folderPath',
                 type: 'string',
-                resource: 'process',
+                resource,
                 resourceKey,
                 default: spec.folderPath,
                 propertyAttribute: 'folderPath',
-                resourceSubType: spec.resourceSubType,
+                ...(spec.resourceSubType !== undefined ? { resourceSubType: spec.resourceSubType } : {}),
             },
         ] };
 }

package/dist/core/refusals.d.ts

@@ -306,6 +306,7 @@ export declare const REFUSALS: {
     readonly HITL_APP_INCOMPLETE: "lint";
     readonly HITL_APP_INPUT_REQUIRED: "lint";
     readonly HITL_APP_INPUT_UNKNOWN: "lint";
+    readonly HITL_APP_LOCAL_HAS_FOLDER: "lint";
     readonly HITL_APP_MISSING: "lint";
     readonly HITL_APP_NO_SCHEMA: "lint";
     readonly HITL_APP_OUTCOME_UNKNOWN: "lint";

package/dist/core/refusals.js

@@ -347,6 +347,7 @@ export const REFUSALS = {
     HITL_APP_INCOMPLETE: 'lint',
     HITL_APP_INPUT_REQUIRED: 'lint',
     HITL_APP_INPUT_UNKNOWN: 'lint',
+    HITL_APP_LOCAL_HAS_FOLDER: 'lint',
     HITL_APP_MISSING: 'lint',
     HITL_APP_NO_SCHEMA: 'lint',
     HITL_APP_OUTCOME_UNKNOWN: 'lint',

package/dist/merge.js

@@ -454,6 +454,7 @@ function mergeFlowFindings(original, edited, options) {
     //    not carried (#1133). ──
     result.bindings = mergeBindings(original.bindings, edited.bindings);
     result.bindings = withoutRowsMintedForKeptNodes(result.bindings, original, edited, options.baseline, keptFromOriginal, fieldwise);
+    result.bindings = withoutSupersededAppRows(result.bindings, originalNodes, allNodes);
     // metadata / solutionId / projectId / layout / runtime were carried by the
     // initial clone of `original` and are intentionally left untouched, apart
     // from the `layout.nodes` entries of removed nodes (dropped above) and added
@@ -667,6 +668,36 @@ function mergeBindings(orig, edited) {
     }
     return out;
 }
+/**
+ * The `app` rows a human task's app resolves through: keyed by the app's `key`
+ * once it has a folder, by its `name` while it has none — flow-v1's rule
+ * (`hitl-serialization.ts`, #3910), and `appResourceBindings`'.
+ */
+function appRowKey(node) {
+    const app = node.inputs?.app;
+    if (!app || typeof app !== 'object')
+        return undefined;
+    const k = app.folderPath ? app.key : app.name;
+    return typeof k === 'string' && k !== '' ? k : undefined;
+}
+/**
+ * Drop the original's `app` rows that a human task's app resolved through and
+ * that no merged node resolves through any more. That happens when the edit
+ * moves an app between the two keys — the canvas's `'solution_folder'` folder
+ * (keyed by `key`) re-emitted as an in-solution app (folder `''`, keyed by
+ * `name`): the edit brings the new pair, and the union would keep the old one
+ * beside it, orphaned (builder-sdk#1486 review). Rows no original human task
+ * used (an agent escalation's, say) are not touched.
+ */
+function withoutSupersededAppRows(rows, originalNodes, mergedNodes) {
+    if (!rows)
+        return rows;
+    const keysOf = (nodes) => new Set(nodes.map(appRowKey).filter((k) => k !== undefined));
+    const before = keysOf(originalNodes);
+    const after = keysOf(mergedNodes);
+    return rows.filter((b) => !(b.resource === 'app' && typeof b.resourceKey === 'string'
+        && before.has(b.resourceKey) && !after.has(b.resourceKey)));
+}
 /**
  * Drop each added row that the no-edit recompile minted only for nodes the merge
  * kept from the original (#1133). A row qualifies when the original lacks it, the

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

@@ -25,6 +25,7 @@ export const HITL_DIAGNOSTICS = {
     HITL_APP_INPUT_UNKNOWN: { severity: 'error', summary: 'an app input the action schema does not declare' },
     HITL_APP_INPUT_REQUIRED: { severity: 'error', summary: 'a required app input left unbound' },
     HITL_APP_OUTCOME_UNKNOWN: { severity: 'error', summary: 'an outcome the app has no button for' },
+    HITL_APP_LOCAL_HAS_FOLDER: { severity: 'error', summary: 'an in-solution app with a folderPath' },
     HITL_NO_FIELDS: { severity: 'error', summary: 'no fields array' },
     HITL_FIELD_NO_ID: { severity: 'error', summary: 'a form field with no id' },
     HITL_DUP_FIELD: { severity: 'error', summary: 'a form field id declared twice' },
@@ -185,11 +186,23 @@ export function checkHitl(inputs, ctx) {
                 + `App — but names no app, so nothing tells the platform which form to show.`, `app: { name: 'Expense Review', key: '<guid>', folderPath: 'Shared' }`);
             return;
         }
-        for (const k of ['name', 'key', 'folderPath']) {
+        // An in-solution app has no folder to author. A published one does: with
+        // none it is serialized as an inline app, and on a serializer before
+        // flow-v1 #4076 the task loses its folderPath context and fails at run
+        // time (170004, "Invalid input for the HITL task").
+        const inSolution = app.location === 'in-solution';
+        for (const k of inSolution ? ['name', 'key'] : ['name', 'key', 'folderPath']) {
             if (typeof app[k] !== 'string' || !app[k].trim()) {
-                at('HITL_APP_INCOMPLETE', `Human task "${step}" names an Action App with no ${k}. An app is resolved by its key plus `
-                    + `the folder it is deployed in, with the name shown to the reviewer — all three are needed `
-                    + `for the platform to find it.`, `app: { name: 'Expense Review', key: '<guid>', folderPath: 'Shared' }`);
+                at('HITL_APP_INCOMPLETE', inSolution
+                    ? `Human task "${step}" names an in-solution Action App with no ${k}. An in-solution app is `
+                        + `resolved by its key (\`resource.key\` in resources/solution_folder/app/codedAction/<App>.json), `
+                        + `with the name shown to the reviewer — both are needed for the platform to find it.`
+                    : `Human task "${step}" names an Action App with no ${k}. An app is resolved by its key plus `
+                        + `the folder it is deployed in, with the name shown to the reviewer — all three are needed `
+                        + `for the platform to find it. If the app is in the same solution as the flow, set `
+                        + `\`location: 'in-solution'\` instead of a folder.`, inSolution
+                    ? `app: { name: 'InvoiceReview', key: '<resource.key>', location: 'in-solution' }`
+                    : `app: { name: 'Expense Review', key: '<guid>', folderPath: 'Shared' }`);
                 return;
             }
         }
@@ -235,6 +248,12 @@ export function checkHitl(inputs, ctx) {
                 }
             }
         }
+        if (inSolution && app.folderPath !== undefined && app.folderPath !== '') {
+            at('HITL_APP_LOCAL_HAS_FOLDER', `Human task "${step}" names an in-solution Action App with folderPath ${JSON.stringify(app.folderPath)}. `
+                + `An in-solution app has no folder — it is emitted with the empty folder the platform's app picker `
+                + `writes for an app inline to the solution — so the value would be dropped. Remove it, or drop `
+                + `\`location: 'in-solution'\` to call an app published to that folder.`, `Delete \`folderPath\`.`);
+        }
         // Outcomes still matter for an app task: the flow's own routing and its
         // `Action`/`status` outputs are derived from them, so fall through to the
         // outcome rules below rather than returning here.

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

@@ -22,6 +22,7 @@ import { wireExprBody } from '../../../core/wire-expr.js';
 import { appAnswerSchemas, appInputSchema, liftActionSchema, normalizeActionSchema } from './action-schema.js';
 import { checkHitl, checkHitlRead } from './check.js';
 import { CompileRefusal } from '../../../core/compile-refusal.js';
+import { processResourceBindings } from '../../../core/process-resource.js';
 const BASE = 'uipath.human-in-the-loop';
 const QUICK_FORM = 'uipath.human-in-the-loop.quick-form';
 const ACTION_APP = 'uipath.human-in-the-loop.coded-action-app';
@@ -131,6 +132,14 @@ function hitlInputs(inputs, nodeType, ctx) {
     for (const [name, value] of Object.entries(app?.inputs ?? {})) {
         appInputBindings[name] = appBindingExpr(value, ctx);
     }
+    const emitsApp = (isApp || (nodeType === DOC_VALIDATION && inputs?.document?.render === 'custom')) && app !== undefined;
+    // An in-solution app has no folder: the platform's own picker writes `''`,
+    // and its serializer keeps that `''` in the task context (flow-v1 #4076).
+    const appFolder = app?.location === 'in-solution' ? '' : (app?.folderPath ?? '');
+    if (emitsApp) {
+        for (const b of appResourceBindings({ name: app.name, key: app.key, folderPath: appFolder }, ctx.bindings))
+            ctx.bind(b);
+    }
     // The author's recipient when given; the definition's own default otherwise
     // (unchanged — that default is what 203 of 233 deployed v1 tasks carry).
     // `1.0`: every human-task type's first bundled definition, which is the one
@@ -189,13 +198,13 @@ function hitlInputs(inputs, nodeType, ctx) {
             ...(inputs?.labels !== undefined ? { labels: inputs.labels } : {}),
             recipient,
             ...docvalInputs,
-            ...((isApp || (nodeType === DOC_VALIDATION && doc?.render === 'custom')) && app
+            ...(emitsApp
                 ? {
                     app: {
                         displayName: app.name,
                         name: app.name,
                         key: app.key,
-                        folderPath: app.folderPath,
+                        folderPath: appFolder,
                         ...(app.appSystemName !== undefined ? { appSystemName: app.appSystemName } : {}),
                         // What types the task's arguments (see action-schema.ts): lowered
                         // from the action schema, or the decompiled node's own, verbatim.
@@ -230,6 +239,34 @@ function hitlInputs(inputs, nodeType, ctx) {
         },
     };
 }
+/**
+ * The canvas's legacy placeholder folder for an app inline to the solution. The
+ * platform's own app picker clears it to `''` (flow-v1 `HITLAppPicker.tsx`
+ * `INLINE_APP_FOLDER_TOKEN`, #4076): an inline app has no deploy-time
+ * overwrite, so the token would reach the engine literally and be refused
+ * (170000). Read back as `location: 'in-solution'`, never emitted.
+ */
+const INLINE_APP_FOLDER_TOKEN = 'solution_folder';
+/**
+ * The `app` binding pair for one Action App, through the shared
+ * {@link processResourceBindings}: one pair per app, keyed the way flow-v1's app
+ * picker creates them — by the app's `key` once it has a folder, by its `name`
+ * while it has none (an in-solution app) (`hitl-serialization.ts`,
+ * `HITLAppPicker.tsx`, flow-v1 #3910). The serializer resolves the task's
+ * `<bindings.name>` / `<bindings.folderPath>` context against them; without a
+ * row the placeholder text reaches the engine, and packaging leaves the app out
+ * of `bindings_v2.json`. Serializers before #3910 (flow-converter 0.69) key the
+ * app by name only and fall back to the FIRST row named `name`/`folderPath` of
+ * any resource.
+ */
+function appResourceBindings(spec, existing) {
+    return processResourceBindings({
+        name: spec.name,
+        folderPath: spec.folderPath,
+        resource: 'app',
+        resourceKey: spec.folderPath ? spec.key : spec.name,
+    }, existing).entries;
+}
 /**
  * One `appInputBindings` value: the expression sent to a deployed app's input.
  *
@@ -416,7 +453,10 @@ function liftHitl(node, typeName, ctx) {
         // `displayName` is serialize's echo of `name`; only `name` is authored.
         name: String(app.name ?? ''),
         key: String(app.key ?? ''),
-        ...(typeof app.folderPath === 'string' && app.folderPath !== '' ? { folderPath: app.folderPath } : {}),
+        // No folder (or the canvas's legacy inline placeholder) is how the platform
+        // writes an app inline to the solution.
+        ...(typeof app.folderPath === 'string' && app.folderPath !== '' && app.folderPath !== INLINE_APP_FOLDER_TOKEN
+            ? { folderPath: app.folderPath } : { location: 'in-solution' }),
         ...(app.appSystemName === null ? { appSystemName: null }
             : typeof app.appSystemName === 'string' ? { appSystemName: app.appSystemName } : {}),
         ...(appInputs !== undefined ? { inputs: appInputs } : {}),
@@ -517,6 +557,7 @@ function printHitl({ inputs }, ctx) {
     const app = h.app === undefined ? undefined : obj([
         ['name', ctx.string(h.app.name)],
         ['key', ctx.string(h.app.key)],
+        ['location', h.app.location !== undefined ? ctx.string(h.app.location) : undefined],
         ['folderPath', h.app.folderPath !== undefined ? ctx.string(h.app.folderPath) : undefined],
         ['appSystemName', h.app.appSystemName === null ? 'null'
                 : h.app.appSystemName !== undefined ? ctx.string(h.app.appSystemName) : undefined],

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

@@ -6,7 +6,7 @@
  * `core/actions.ts`: an agent's quick-form escalation shares them.
  */
 import type { Expr } from '../../../core/expr.js';
-import type { FormField } from '../../../core/actions.js';
+import type { FormField, ProcessLocation } from '../../../core/actions.js';
 /**
  * Where the task is delivered. The four ids are the platform's own — including
  * the lowercase `'teams'`, which is how every deployed recipient spells
@@ -164,15 +164,44 @@ export type HitlVariant = 'quick-form' | 'action-app' | 'document-validation';
  *   },
  *   outcomes: ['Approve', 'Reject'],
  * })
+ *
+ * // A coded action app in the same solution as the flow:
+ * hitl({
+ *   variant: 'action-app',
+ *   app: { name: 'InvoiceReview', key: '<resource.key>', location: 'in-solution' },
+ *   outcomes: ['Approve', 'Reject'],
+ * })
  * ```
  */
 export interface AppRef {
     /** The app's display title, e.g. `'Expense Review'`. */
     name: string;
-    /** The app's key (a GUID) — how the platform resolves which app this is. */
+    /**
+     * The app's key (a GUID) — how the platform resolves which app this is.
+     *
+     * For an in-solution app it is `resource.key` from
+     * `resources/solution_folder/app/codedAction/<App>.json`.
+     */
     key: string;
-    /** Fully-qualified folder the app is deployed in, e.g. `'Shared'`. */
-    folderPath: string;
+    /**
+     * Where the app lives. `'published'` (the default) is an app deployed to
+     * `folderPath`. `'in-solution'` is a coded action app in the same solution as
+     * the flow: it takes no `folderPath` — it is emitted with the empty folder
+     * and name-keyed bindings the platform's own app picker writes for an app
+     * inline to the solution. Needs a `uip` CLI with flow-converter 0.100.3 or
+     * later (or a process engine with MST-15436); older ones fail at run time
+     * with 170004.
+     *
+     * @enforcedBy HITL_APP_LOCAL_HAS_FOLDER An in-solution app takes no folderPath.
+     */
+    location?: ProcessLocation;
+    /**
+     * Fully-qualified folder the app is deployed in, e.g. `'Shared'`. Required
+     * for a published app; omit it for an in-solution one.
+     *
+     * @enforcedBy HITL_APP_INCOMPLETE A published app needs its folder.
+     */
+    folderPath?: string;
     /**
      * The app's stable system name. `null` until the app's first deployment
      * assigns one, which is why it is optional and why `null` is a legal value

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.66.1",
+  "version": "6.66.2",
   "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": "02d8fadeacf6db38788390221a4550dffd114a69"
+  "gitref": "f698c1379d7c348671e6bf0df5b211be77e8f1c6"
 }