@uipath/maestro-builder-sdk 6.70.9 → 6.71.1

package/dist/api-index.md

@@ -47,20 +47,20 @@ could hand you spans for a version you do not have.
 | `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. |
+| `AgentFlavour` | type | `dist/nodes/process/flow/spec.d.ts:286-290` | Supporting types | Which KIND of agent project was published behind a `uipath.core.agent.<key>` resource. |
 | `AgentGuardrail` | type | `dist/core/actions.d.ts:393` | Supporting types |  |
 | `agenticProcess` | function | `dist/nodes/process/flow/factories.d.ts:113-158` | Actions | Invoke a deployed AGENTIC PROCESS — a Maestro process orchestration published to Orchestrator: a BPMN process that… |
-| `AgenticProcessCompletion` | type | `dist/nodes/process/flow/spec.d.ts:219-257` | Supporting types | Whether an Agentic Process step waits for the process's result. |
-| `AgenticProcessInputs` | type | `dist/nodes/process/flow/spec.d.ts:258-259` | Option shapes | What `agenticProcess()` takes: the shared fields plus the completion policy. |
-| `AgenticProcessInputsBase` | interface | `dist/nodes/process/flow/spec.d.ts:162-218` | Option shapes | 7 field(s) |
-| `AgentInputs` | interface | `dist/nodes/process/flow/spec.d.ts:267-362` | Option shapes | What `agent()` takes: the agent resource to start, its arguments, and the output fields a read may name. |
-| `AgentLocation` | type | `dist/nodes/process/flow/spec.d.ts:265-266` | Supporting types | Where a published agent lives: deployed to a folder (`'published'`) or a sibling project of the same solution… |
+| `AgenticProcessCompletion` | type | `dist/nodes/process/flow/spec.d.ts:245-283` | Supporting types | Whether an Agentic Process step waits for the process's result. |
+| `AgenticProcessInputs` | type | `dist/nodes/process/flow/spec.d.ts:284-285` | Option shapes | What `agenticProcess()` takes: the shared fields plus the completion policy. |
+| `AgenticProcessInputsBase` | interface | `dist/nodes/process/flow/spec.d.ts:188-244` | Option shapes | 7 field(s) |
+| `AgentInputs` | interface | `dist/nodes/process/flow/spec.d.ts:293-388` | Option shapes | What `agent()` takes: the agent resource to start, its arguments, and the output fields a read may name. |
+| `AgentLocation` | type | `dist/nodes/process/flow/spec.d.ts:291-292` | Supporting types | Where a published agent lives: deployed to a folder (`'published'`) or a sibling project of the same solution… |
 | `AgentMemoryRef` | interface | `dist/core/actions.d.ts:538-562` | Supporting types | An episodic memory the agent learns from across runs, wired to the agent's own `memory` handle. |
 | `AgentResourcePlacement` | interface | `dist/core/actions.d.ts:406-441` | Supporting types | Where one of an inline agent's resources (a context index, a tool, an escalation) sits in the `.flow`: the id of its own… |
 | `Aggregation` | interface | `dist/nodes/transform/flow/spec.d.ts:36-42` | Supporting types | 3 field(s) |
 | `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) |
+| `ApiWorkflowInputs` | interface | `dist/nodes/process/flow/spec.d.ts:70-127` | Option shapes | 7 field(s) |
 | `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:1387-1410` | 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>')`. |
@@ -216,7 +216,7 @@ could hand you spans for a version you do not have.
 | `ProcessToolKind` | type | `dist/core/actions.d.ts:622-635` | Supporting types | The tool kinds that wrap a DEPLOYED tenant resource. |
 | `ProcessToolRef` | interface | `dist/core/actions.d.ts:636-665` | Supporting types | A deployed tenant resource the agent may invoke. |
 | `publishedFunction` | function | `dist/nodes/process/flow/factories.d.ts:88-112` | Actions | Invoke a published Orchestrator **Function** — a deployed unit of code run as one step (`uipath.core.function.<key>`,… |
-| `PublishedFunctionInputs` | interface | `dist/nodes/process/flow/spec.d.ts:102-161` | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
+| `PublishedFunctionInputs` | interface | `dist/nodes/process/flow/spec.d.ts:128-187` | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
 | `queueItem` | function | `dist/nodes/queue/flow/factories.d.ts:4-49` | Actions | Declare an Orchestrator QUEUE ITEM step. |
 | `QueueItemInputs` | interface | `dist/nodes/queue/flow/spec.d.ts:11-84` | Option shapes | 10 field(s) |
 | `QueuePriority` | type | `dist/nodes/queue/flow/spec.d.ts:9-10` | Supporting types | The three priorities an Orchestrator queue item can carry. |

package/dist/api-members.md

@@ -5,12 +5,12 @@
 
 # Maestro Builder SDK — member index
 
-**A lookup table of 1236 rows — match one name in it, do not read it.**
+**A lookup table of 1238 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 — 1236 across
+Every field and method of every exported shape — 1238 across
 228 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 1236 rows here.
+which is why its span is not repeated on all 1238 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
@@ -53,15 +53,15 @@ not find it either.
 | `actionSchema` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:220-244` |
 | `activity` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2998-3031` |
 | `additionalOutputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:98-102` |
-| `agent` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:381-384` |
+| `agent` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:407-410` |
 | `agent` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:997-1006` |
-| `agenticProcess` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:377-380` |
+| `agenticProcess` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:403-406` |
 | `alias` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:38-39` |
 | `aliases` | property | `LookupSpec` | `dist/core/lookups.d.ts:31-32` |
 | `allErrors` | property | `RetrySpec` | `dist/bpmn/bpmn-sdk.d.ts:837-838` |
 | `allowAdhocOptionalStageTasks` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:875-876` |
 | `allowAdhocTasks` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1509-1516` |
-| `apiWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:369-372` |
+| `apiWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:395-398` |
 | `apiWorkflow` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:1017-1026` |
 | `app` | property | `EscalationRef` | `dist/core/actions.d.ts:729-756` |
 | `app` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:326-330` |
@@ -395,7 +395,7 @@ not find it either.
 | `filters` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:79-80` |
 | `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:1046-1047` |
 | `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:1003-1004` |
-| `flavour` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:347-361` |
+| `flavour` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:373-387` |
 | `flowIds` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3195-3238` |
 | `flowMode` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2181-2220` |
 | `flowProcess` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:1039-1048` |
@@ -425,9 +425,9 @@ not find it either.
 | `folderKey` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1300-1308` |
 | `folderKey` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:489` |
 | `folderName` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:108-114` |
-| `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 | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:214-221` |
+| `folderPath` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:317-328` |
+| `folderPath` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:92-99` |
 | `folderPath` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:198-204` |
 | `folderPath` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1515-1516` |
 | `folderPath` | property | `ContextIndexRef` | `dist/core/actions.d.ts:789-790` |
@@ -435,14 +435,14 @@ not find it either.
 | `folderPath` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:134-140` |
 | `folderPath` | property | `McpToolRef` | `dist/core/actions.d.ts:455-456` |
 | `folderPath` | property | `ProcessToolRef` | `dist/core/actions.d.ts:653-654` |
-| `folderPath` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:130-140` |
+| `folderPath` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:156-166` |
 | `folderPath` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:14-15` |
 | `folderPath` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:488` |
 | `folderPath` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:31-38` |
 | `folderPath` | property | `TaskRef` | `dist/case/case-sdk.d.ts:568` |
 | `fork` | property | `ParallelOptions` | `dist/flow-sdk.d.ts:475-492` |
 | `fork` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3138-3163` |
-| `form` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:210-217` |
+| `form` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:236-243` |
 | `form` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1406-1407` |
 | `form` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1440-1441` |
 | `format` | property | `ActionSchemaProperty` | `dist/nodes/hitl/flow/spec.d.ts:267-268` |
@@ -518,9 +518,9 @@ not find it either.
 | `inputs` | property | `ActionSchemaFile` | `dist/nodes/hitl/flow/spec.d.ts:283-284` |
 | `inputs` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:665-666` |
 | `inputs` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1623-1624` |
-| `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 | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:230-235` |
+| `inputs` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:335-352` |
+| `inputs` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:109-113` |
 | `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:211-219` |
 | `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:852-853` |
 | `inputs` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:870` |
@@ -531,7 +531,7 @@ not find it either.
 | `inputs` | property | `NodeContribution` | `dist/core/node-classes.d.ts:113-117` |
 | `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 | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:176-177` |
 | `inputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:95-96` |
 | `inputs` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:47-52` |
 | `inputs` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:913-927` |
@@ -564,15 +564,15 @@ not find it either.
 | `join` | property | `ChooseOpts` | `dist/bpmn/bpmn-sdk.d.ts:1918-1919` |
 | `join` | property | `SplitOpts` | `dist/bpmn/bpmn-sdk.d.ts:1925-1926` |
 | `js` | property | `Expr` | `dist/core/expr.d.ts:17` |
-| `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 | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:189-200` |
+| `key` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:295-308` |
+| `key` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:71-82` |
 | `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:1420-1421` |
 | `key` | property | `McpToolRef` | `dist/core/actions.d.ts:452-453` |
 | `key` | property | `ProcessToolRef` | `dist/core/actions.d.ts:645-650` |
-| `key` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:109-119` |
+| `key` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:135-145` |
 | `key` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:16-25` |
 | `key` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:480-481` |
 | `key` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:12-22` |
@@ -614,11 +614,12 @@ not find it either.
 | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
 | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:575-576` |
 | `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 | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:203-213` |
+| `location` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:311-316` |
+| `location` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:85-91` |
 | `location` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:186-197` |
 | `location` | property | `CarriedConnectorField` | `dist/core/carried-connector-fields.d.ts:43-44` |
-| `location` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:122-129` |
+| `location` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:148-155` |
 | `location` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:25-30` |
 | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
 | `loop` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:353-354` |
@@ -681,10 +682,10 @@ not find it either.
 | `name` | property | `ActionAppRef` | `dist/case/case-sdk.d.ts:642-643` |
 | `name` | property | `ActionField` | `dist/case/case-sdk.d.ts:615-616` |
 | `name` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1611-1612` |
-| `name` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:175-176` |
-| `name` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:283-284` |
+| `name` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:201-202` |
+| `name` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:309-310` |
 | `name` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:547-548` |
-| `name` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:79-80` |
+| `name` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:83-84` |
 | `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` |
@@ -740,7 +741,7 @@ not find it either.
 | `name` | property | `PlainTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1710-1711` |
 | `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 | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:146-147` |
 | `name` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1343-1344` |
 | `name` | property | `ReceiveMessageOpts` | `dist/bpmn/bpmn-sdk.d.ts:1466-1467` |
 | `name` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:22` |
@@ -883,10 +884,11 @@ not find it either.
 | `process` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:959-968` |
 | `processId` | property | `SugarRegistry` | `dist/bpmn/bpmn-sdk.d.ts:2060-2065` |
 | `project` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:76-89` |
-| `projectId` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:196-203` |
-| `projectId` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:303-308` |
+| `projectId` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:222-229` |
+| `projectId` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:329-334` |
+| `projectId` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:100-108` |
 | `projectId` | property | `IxpToolRef` | `dist/core/actions.d.ts:678-688` |
-| `projectId` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:141-149` |
+| `projectId` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:167-175` |
 | `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` |
@@ -895,7 +897,7 @@ not find it either.
 | `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` |
-| `publishedFunction` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:373-376` |
+| `publishedFunction` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:399-402` |
 | `query` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:573-578` |
 | `query` | property | `ContextIndexRef` | `dist/core/actions.d.ts:793-798` |
 | `query` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:34` |
@@ -964,13 +966,13 @@ not find it either.
 | `retryCount` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:109-123` |
 | `return` | method | `StepList` | `dist/flow-sdk.d.ts:1376-1385` |
 | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
-| `returns` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:327-346` |
-| `returns` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:88-100` |
+| `returns` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:353-372` |
+| `returns` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:114-126` |
 | `returns` | property | `ClientSideToolRef` | `dist/core/actions.d.ts:505-506` |
 | `returns` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:68-90` |
 | `returns` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:259-272` |
 | `returns` | property | `ProcessToolRef` | `dist/core/actions.d.ts:663-664` |
-| `returns` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:152-160` |
+| `returns` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:178-186` |
 | `returns` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:63-83` |
 | `returns` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:53-68` |
 | `returns` | property | `ScriptInputs` | `dist/nodes/script/flow/spec.d.ts:10-43` |
@@ -980,7 +982,7 @@ not find it either.
 | `role` | property | `FlowTrigger` | `dist/core/node-classes.d.ts:173-174` |
 | `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:776-781` |
 | `rpa` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:1007-1016` |
-| `rpaWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:365-368` |
+| `rpaWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:391-394` |
 | `rule` | property | `CaseRule` | `dist/case/case-sdk.d.ts:90` |
 | `rules` | property | `BuiltCaseExitCondition` | `dist/case/case-sdk.d.ts:412` |
 | `rules` | property | `BuiltEntryCondition` | `dist/case/case-sdk.d.ts:354` |

package/dist/check.js

@@ -571,17 +571,6 @@ function checkFlow(built, ancestors, opts = {}) {
                         outputReaders.set(stepName, (field, rest, at, d) => rule(stepName, field, rest, inputs, at, d));
                     }
                 }
-                if (s.spec.kind === 'waitEvent') {
-                    const stepName = s.name;
-                    const push = (level) => (code, message, suggestion) => diags.push({
-                        level, code, message, step: stepName,
-                        ...(suggestion ? { suggestion } : {}),
-                    });
-                    // What compile refuses (the event itself, its filters, its binding
-                    // labels) is the serializer's, reported from its run.
-                    checkEventSubscription(s.spec.subscription, `waitForEvent "${stepName}"`, push('error'), push('warning'), eventParamsFor(s.spec.subscription, opts), false);
-                    checkEventResolution(s.spec.subscription, `waitForEvent "${stepName}"`, 'event', opts, push('error'), push('warning'), eventParamsFor(s.spec.subscription, opts), false);
-                }
                 if (s.spec.kind === 'subflow') {
                     // Only a real child goes in the map: a missing one is reported by
                     // checkSubflow, and recursing into `undefined` would crash the check
@@ -2419,6 +2408,17 @@ function checkRegisteredStep(entry, s, exprs, errorSource, opts, diags, typeOf,
             options: opts,
             bindingLabels: (where, labels, _use, target) => checkBindingLabels(where, labels, opts, (code, message) => diags.push({ level: 'error', code, step: s.name, message }), target),
             resources: { derivedNodeId: () => { }, claimNodeId: () => undefined, claimFolder: () => undefined },
+            eventSubscription: (subscription, where) => {
+                const push = (level) => (code, message, suggestion) => diags.push({
+                    level, code, message, step: s.name,
+                    ...(suggestion ? { suggestion } : {}),
+                });
+                // What compile refuses (the event itself, its filters, its binding
+                // labels) is the serializer's, reported from its run.
+                const params = eventParamsFor(subscription, opts);
+                checkEventSubscription(subscription, where, push('error'), push('warning'), params, false);
+                checkEventResolution(subscription, where, 'event', opts, push('error'), push('warning'), params, false);
+            },
             // The operation, its field contract and its binding labels are the
             // serializer's (CONNECTOR_*, BINDING_*), reported from its run.
             connector: (c) => {

package/dist/core/event-subscription.d.ts

@@ -0,0 +1,113 @@
+/**
+ * An Integration Service event subscription as Flow emits it — the node body an
+ * event trigger (`onEvent`, `.entryPoint()`), and a mid-flow wait
+ * (`waitForEvent`), share: `inputs.detail`, the library's resolution of the
+ * event, and the refusals compile makes before and without a library.
+ *
+ * Moved from serialize.ts in Phase 4 of docs/NODE_TYPE_ARCHITECTURE_DESIGN.md,
+ * so the connector family's event wait and the triggers that serialize still
+ * places read one copy. What serialize held in `SerializeOpts` comes in as an
+ * {@link EventEmitEnv}: the library, the bindings, and how a binding label
+ * resolves.
+ */
+import type { EventSubscription } from './actions.js';
+import { type BindingsView, type PrepareTarget } from './binding-messages.js';
+import { CompileRefusal } from './compile-refusal.js';
+import { readEventFilter } from './event-filters.js';
+import type { Library, ResolvedConnector } from './library.js';
+/** What an event subscription's emission needs from the compile: the library, the bindings, and how a label resolves. */
+export interface EventEmitEnv {
+    readonly library?: Library;
+    readonly bindings?: BindingsView;
+    /** A connection or folder label to the key the node carries, with compile's refusals and warnings. */
+    resolveBinding(name: string | undefined, attribute: 'connection' | 'folder', where: string, target?: PrepareTarget): string | undefined;
+}
+/** What `registry prepare` takes for an event subscription: its connector key and curated event name. */
+export declare function eventTarget(sub: {
+    connector?: unknown;
+    event?: unknown;
+}): PrepareTarget | undefined;
+/**
+ * Throw `check`'s EVENT_BYOA_UNVERIFIED for a subscription whose event only
+ * fires on a BYOA connection and whose bound connection `prepare` never checked
+ * — the one condition in `core/byoa.ts`, fed from the same library and
+ * bindings, so a flow check refuses never compiles.
+ *
+ * `where` is check's spelling of the site (`trigger` for `onEvent`, entry points
+ * included; `waitForEvent "<step>"`), so the two print the same sentence.
+ */
+export declare function refuseUnverifiedByoa(env: EventEmitEnv, where: string, sub: {
+    connector: string;
+    event: string;
+    object?: string;
+    connection?: unknown;
+}): void;
+/**
+ * Refuse a connector-bound node (connector step, event trigger, `.entryPoint`
+ * onEvent, `waitForEvent`) that names no `connection` or no `folder` label.
+ * (An inline agent's connector tool is #875's: `check` refuses it as
+ * INLINE_AGENT_TOOL_CONNECTOR_NO_CONNECTION, and serialize leaves it unbound.)
+ * `resolveBinding` returns `undefined` for an absent label, which used to reach
+ * the node as `detail.connectionId: null` with no binding — valid to compile,
+ * refused by `flow validate` (flow-builder-sdk#890): BINDING_MISSING.
+ */
+export declare function requireBindingPair(where: string, labels: {
+    connection?: unknown;
+    folder?: unknown;
+}, target?: PrepareTarget): void;
+/**
+ * `library.resolveEvent` for one subscription, or EVENT_UNKNOWN: whatever it
+ * throws (a connector or event the library does not carry, a version or object
+ * it does not resolve) is that one condition, an event compile cannot place.
+ * `where` names the site as `check` always has (`trigger`, `waitForEvent "x"`).
+ */
+export declare function resolveEvent(library: Library, kind: 'trigger' | 'event', sub: EventSubscription, where: string): ReturnType<Library['resolveEvent']>;
+/**
+ * LIBRARY_REQUIRED for an event subscription at `site`, after the refusals that
+ * need no library: its binding labels, judged as `eventDetail` judges them, so a
+ * run without a library (`check`'s inner loop) still hears about them. The
+ * refusal carries the connection the node is bound to, so its collect-mode
+ * stand-in still takes part in the file-wide connection rule (`connectionConnectors`).
+ */
+export declare function libraryRequiredForEvent(env: EventEmitEnv, sub: EventSubscription, nodeId: string, site: string, call: string): CompileRefusal;
+/**
+ * Flatten a nested `where` onto the DOTTED parameter names the wire uses.
+ *
+ * The generated `…Where` interface splits a dotted event parameter into an
+ * object — `channelData.channel.id` becomes
+ * `channelData: ConnectorValue<ChannelDataInput>` — so an author following the
+ * types writes the nested shape, while `bucketOf` and the `filterExpression`
+ * clause both key on the declared dotted name. Without this the nested shape
+ * missed the bucket lookup and then stringified, emitting
+ * `channelData == '[object Object]'`: a subscription matching nothing, from a
+ * document that compiled clean and passed `check`.
+ *
+ * Descent STOPS as soon as a path names a declared parameter, so a parameter
+ * that genuinely takes an object value is passed through whole rather than
+ * shredded. A lookup token is a value, never a branch.
+ */
+export declare function flattenWhere(where: Record<string, unknown>, declared: ReadonlySet<string>): Record<string, unknown>;
+/**
+ * A subscription's `filters`, each leaf read structurally (`readEventFilter`),
+ * or the refusal of the first leaf compile cannot lower: no field, no operator
+ * or two, a value no operator takes, a backslash JMESPath engines read apart.
+ * Needs no library, so a run without one judges the leaves too
+ * (`libraryRequiredForEvent`).
+ */
+export declare function eventFilterReads(filters: readonly unknown[], nodeId: string): Array<NonNullable<ReturnType<typeof readEventFilter>['read']>>;
+/**
+ * The match-expression clauses of a subscription's EVENT parameters, one
+ * `k == '<value>'` per value, or the refusal of the first value compile cannot
+ * write there. The clause compares against a JMESPath string, so the value must
+ * be a string, number or boolean: an object or array would be stringified to
+ * `'[object Object]'` (or a comma list), a subscription that matches nothing
+ * (EVENT_WHERE_NOT_SCALAR). A string with a backslash JMESPath engines read
+ * apart is EVENT_FILTER_BACKSLASH. An absent or empty value (`''` or `[]`, so a
+ * `where` built from a possibly-empty list) writes no clause.
+ *
+ * Only event parameters fold into the expression; a query or path parameter is
+ * sent with the request that registers the subscription and is never read as
+ * JMESPath, so neither rule applies to it.
+ */
+export declare function eventScopeClauses(eventParameters: Record<string, unknown>, nodeId: string): string[];
+export declare function eventDetail(rc: ResolvedConnector, sub: EventSubscription, nodeId: string, env: EventEmitEnv, site: string): Record<string, unknown>;