@uipath/maestro-builder-sdk 6.16.2 → 6.16.3

package/dist/api-index.md

@@ -128,10 +128,10 @@ could hand you spans for a version you do not have.
 | `FilterCondition` | type | `dist/core/actions.d.ts:233-234` | Supporting types | Comparison a filter rule applies to a field. |
 | `FilterMatch` | type | `dist/core/actions.d.ts:231-232` | Supporting types | How a filter combines its rules: every rule must match, or any one. |
 | `FilterRule` | interface | `dist/core/actions.d.ts:235-247` | Supporting types | 3 field(s) |
-| `flow` | function | `dist/flow-sdk.d.ts:1423-1438` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1424-1439` | Flow construction | Start building a flow with the given id. |
 | `FlowAction` | class | `dist/core/node-classes.d.ts:158-164` | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
 | `FlowActionSpec` | type | `dist/flow-sdk.d.ts:41-42` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
-| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1156-1422` | Builders | 13 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1156-1423` | Builders | 13 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:646-659` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:122-157` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:172-179` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
@@ -227,7 +227,7 @@ could hand you spans for a version you do not have.
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:599-604` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:611-645` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:605-610` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1439-1478` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1440-1479` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:33-40` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/core/actions.d.ts:2580-2620` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/core/actions.d.ts:797-829` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -100,7 +100,7 @@ not find it either.
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:441-445` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3534-3539` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1269-1274` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1415-1421` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1416-1422` |
 | `businessRule` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2526-2572` |
 | `by` | property | `LookupResolution` | `dist/core/lookups.d.ts:164` |
 | `by` | property | `LookupSpec` | `dist/core/lookups.d.ts:27-28` |
@@ -272,7 +272,7 @@ not find it either.
 | `entity` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1089-1090` |
 | `entry` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:528` |
 | `entry` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:520` |
-| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1243-1291` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1243-1292` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:533-538` |
 | `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:699-700` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
@@ -438,7 +438,7 @@ not find it either.
 | `inclusive` | property | `ChooseOpts` | `dist/bpmn/bpmn-sdk.d.ts:1819-1823` |
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2265-2272` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1366-1378` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1367-1379` |
 | `input` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1354-1355` |
 | `input` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1240-1241` |
 | `input` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3067-3075` |
@@ -700,7 +700,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1965-1970` |
 | `outcomes` | property | `HitlInputs` | `dist/core/actions.d.ts:577-591` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1379-1404` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1380-1405` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:90` |
 | `output` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3076-3084` |
 | `outputColumns` | property | `BatchTransformInputs` | `dist/core/actions.d.ts:845-849` |
@@ -871,7 +871,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3426-3455` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:679-685` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1326-1365` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1327-1366` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:1281` |
 | `script` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:845-861` |
@@ -1014,7 +1014,7 @@ not find it either.
 | `trigger` | property | `StartOpts` | `dist/bpmn/bpmn-sdk.d.ts:623-670` |
 | `triggeredByEvent` | property | `SubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:975-976` |
 | `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:701-707` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1292-1311` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1293-1312` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:693-694` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1070,7 +1070,7 @@ not find it either.
 | `value` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:205-206` |
 | `values` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2212-2217` |
 | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1199-1223` |
-| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1405-1414` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1406-1415` |
 | `var` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3058-3066` |
 | `var` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:494-495` |
 | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:251-252` |
@@ -1093,7 +1093,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1807-1808` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3484` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1506-1507` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1312-1325` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1313-1326` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:354-361` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3441-3442` |

package/dist/check.js

@@ -50,9 +50,9 @@ function checkFlow(built, ancestors, opts = {}) {
         checkTrigger(built.trigger, diags, opts);
     if (built.trigger?.kind === 'form' && built.inputs.length === 0) {
         diags.push({
-            level: 'warning', code: 'FORM_TRIGGER_NO_INPUTS', step: 'trigger',
-            message: `formTrigger() renders one field per flow input, and this flow declares none — the person `
-                + `gets an empty form with only a submit button.`,
+            level: 'error', code: 'FORM_TRIGGER_NO_INPUTS', step: 'trigger',
+            message: `formTrigger() renders one field per flow input, and this flow declares none. `
+                + `Publish skips a form with no fields, so the flow would ship with no form.`,
             suggestion: `.input({ amount: types.number })`,
         });
     }
@@ -857,7 +857,22 @@ function checkFlow(built, ancestors, opts = {}) {
             }
         }
         else {
-            checkTrigger(ep.trigger, diags, opts, `onEvent() entry point "${ep.id}"`);
+            checkTrigger(ep.trigger, diags, opts, ep.id);
+        }
+        if (ep.trigger.kind === 'form' && ep.inputs.length === 0) {
+            diags.push({
+                level: 'error', code: 'FORM_TRIGGER_NO_INPUTS', step: ep.id,
+                message: `.entryPoint("${ep.id}", formTrigger()) renders one field per entry-point input, and it declares none. `
+                    + `Publish skips a form with no fields, so this root would ship with no form.`,
+                suggestion: `.entryPoint("${ep.id}", formTrigger(), { inputs: { amount: types.number } })`,
+            });
+        }
+        if ((ep.trigger.kind === 'conversation' || ep.trigger.kind === 'voice') && ep.inputs.length) {
+            diags.push({
+                level: 'warning', code: 'TRIGGER_INPUTS_IGNORED', step: ep.id,
+                message: `.entryPoint("${ep.id}") declares inputs, but a ${ep.trigger.kind} trigger starts with only what the platform `
+                    + `supplies (${ep.trigger.kind === 'voice' ? 'callContext' : 'conversationId'}). Its inputs are never passed.`,
+            });
         }
         for (const inp of ep.inputs) {
             const collides = built.inputs.some((g) => g.name === inp.name)
@@ -879,6 +894,17 @@ function checkFlow(built, ancestors, opts = {}) {
             message: 'Entry points join the shared body, but this flow has no shared step. Add one, or end each prefix terminally.',
         });
     }
+    const conversationRoots = [
+        ...(built.trigger?.kind === 'conversation' ? [triggerId] : []),
+        ...(built.entryPoints ?? []).filter((ep) => ep.trigger.kind === 'conversation').map((ep) => ep.id),
+    ];
+    if (conversationRoots.length > 1) {
+        diags.push({
+            level: 'error', code: 'SINGLE_CONVERSATION_TRIGGER', step: conversationRoots[1],
+            message: `Only one conversationTrigger() is allowed per flow, and ${conversationRoots.length} roots use one: `
+                + `${conversationRoots.map((id) => `"${id}"`).join(', ')}. Keep one and give the others another trigger.`,
+        });
+    }
     checkStepRefs(built, diags);
     checkArmScopedReads(built, diags);
     // A fire-and-forget dispatch publishes no output: any read of it would wait
@@ -1731,9 +1757,11 @@ function checkNodeUpdates(built, diags) {
     };
     visit(built.steps);
 }
-function checkTrigger(spec, diags, opts = {}, where) {
+function checkTrigger(spec, diags, opts = {}, entryPointId) {
+    const where = entryPointId === undefined ? undefined : `onEvent() entry point "${entryPointId}"`;
+    const call = entryPointId === undefined ? '.trigger()' : `.entryPoint("${entryPointId}")`;
     const push = (level) => (code, message, suggestion) => {
-        diags.push({ level, code, message, step: 'trigger', ...(suggestion ? { suggestion } : {}) });
+        diags.push({ level, code, message, step: entryPointId ?? 'trigger', ...(suggestion ? { suggestion } : {}) });
     };
     const at = push('error');
     // Types are stripped at run time, so `.trigger({ every: 'R/PT1H' })` (the spec
@@ -1758,7 +1786,7 @@ function checkTrigger(spec, diags, opts = {}, where) {
     if (spec?.kind === 'conversation' || spec?.kind === 'voice')
         return;
     if (spec?.kind !== 'scheduled') {
-        at('TRIGGER_UNKNOWN_KIND', `.trigger() was given ${JSON.stringify(spec?.kind)}, which is not a trigger. `
+        at('TRIGGER_UNKNOWN_KIND', `${call} was given ${JSON.stringify(spec?.kind)}, which is not a trigger. `
             + `Wrap it in a factory: scheduled({ every: 'R/PT1H' }) for a schedule, `
             + `onEvent({ connector, event, where, connection, folder }) to start on a connector event, formTrigger() to start from a `
             + `submitted form, or conversationTrigger() to start on a new conversation. Omit .trigger() entirely `

package/dist/flow-sdk.d.ts

@@ -661,7 +661,7 @@ export interface FlowLayout {
 export interface BuiltEntryPoint {
     /** The trigger node's id — also the root expressions read (`$vars.<id>.output.x`). */
     id: string;
-    /** What fires this root: `manual()`, `scheduled(...)`, or `onEvent(...)`. */
+    /** What fires this root: any built-in trigger factory, or a custom trigger. */
     trigger: TriggerSpec;
     /** Node options for the trigger node — exact `version` selection. */
     options?: NodeOptions;
@@ -1278,8 +1278,9 @@ declare class FlowBuilder extends StepList {
      *
      * @param id - The root's trigger-node id — unique among entry points, steps,
      * and the default trigger id. Expressions read it as `$vars.<id>.output.*`.
-     * @param trigger - What fires this root: `manual()`, `scheduled(...)`, or
-     * `onEvent(...)`.
+     * @param trigger - What fires this root: `manual()`, `scheduled(...)`,
+     * `onEvent(...)`, `formTrigger()` (one field per scoped input),
+     * `conversationTrigger()`, or `voiceTrigger()`.
      * @param options - `version` (exact trigger definition version) and `inputs`
      * — this root's scoped inputs, declared like `.input()`.
      * @param prefixFn - Optional sub-builder for the root's prefix steps.

package/dist/flow-sdk.js

@@ -993,8 +993,9 @@ class FlowBuilder extends StepList {
      *
      * @param id - The root's trigger-node id — unique among entry points, steps,
      * and the default trigger id. Expressions read it as `$vars.<id>.output.*`.
-     * @param trigger - What fires this root: `manual()`, `scheduled(...)`, or
-     * `onEvent(...)`.
+     * @param trigger - What fires this root: `manual()`, `scheduled(...)`,
+     * `onEvent(...)`, `formTrigger()` (one field per scoped input),
+     * `conversationTrigger()`, or `voiceTrigger()`.
      * @param options - `version` (exact trigger definition version) and `inputs`
      * — this root's scoped inputs, declared like `.input()`.
      * @param prefixFn - Optional sub-builder for the root's prefix steps.

package/dist/serialize.js

@@ -4838,9 +4838,9 @@ export function serialize(built, opts = {}) {
                 ? scheduleInputs(built.trigger.inputs, triggerId)
                 : built.trigger?.kind === 'form'
                     ? {
-                        // The definition marks the family an entry point (`model.entryPointId:
-                        // true`); the id is the node's own, the scheduled trigger's convention.
-                        entryPointId: triggerId,
+                        // A GUID: publish keys the form's FormTrigger binding on it and skips
+                        // the form when it is not one.
+                        entryPointId: stableId(`${built.id}:${triggerId}:entryPoint`),
                         schema: { fields: formTriggerFields(built.inputs), outcomes: [] },
                     }
                     : built.trigger?.kind === 'conversation' || built.trigger?.kind === 'voice'
@@ -6842,10 +6842,28 @@ export function serialize(built, opts = {}) {
                     ...scheduleInputs(epSpec.inputs, ep.id),
                 };
             }
-            else {
+            else if (epSpec.kind === 'form') {
+                node = makeNode(NODE_TYPE.formTrigger, ep.id, 'Form trigger', { requestedVersion });
+                node.inputs = {
+                    entryPointId: stableId(`${built.id}:${ep.id}:entryPoint`),
+                    schema: { fields: formTriggerFields(ep.inputs), outcomes: [] },
+                };
+            }
+            else if (epSpec.kind === 'conversation') {
+                node = makeNode(NODE_TYPE.conversationTrigger, ep.id, 'Conversation trigger', { requestedVersion });
+                node.inputs = { entryPointId: stableId(`${built.id}:${ep.id}:entryPoint`) };
+            }
+            else if (epSpec.kind === 'voice') {
+                node = makeNode(NODE_TYPE.voiceTrigger, ep.id, 'Incoming call trigger', { requestedVersion });
+                node.inputs = { entryPointId: stableId(`${built.id}:${ep.id}:entryPoint`) };
+            }
+            else if (epSpec.kind === 'manual') {
                 node = makeNode(NODE_TYPE.trigger, ep.id, 'Manual trigger', { requestedVersion });
                 node.inputs = { entryPointId: stableId(`${built.id}:${ep.id}:entryPoint`) };
             }
+            else {
+                throw new Error(`.entryPoint("${ep.id}"): unsupported trigger kind ${JSON.stringify(epSpec.kind)}.`);
+            }
             root.nodes.push(node);
             const prefixTails = emit(ep.steps, [{ node: ep.id, port: 'output' }], root);
             for (const t of prefixTails) {

package/package.json

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