@uipath/maestro-builder-sdk 6.20.2 → 6.20.4

package/dist/api-index.md

@@ -128,11 +128,11 @@ could hand you spans for a version you do not have.
 | `FilterCondition` | type | `dist/nodes/transform/flow/spec.d.ts:10-11` | Supporting types | Comparison a filter rule applies to a field. |
 | `FilterMatch` | type | `dist/nodes/transform/flow/spec.d.ts:8-9` | Supporting types | How a filter combines its rules: every rule must match, or any one. |
 | `FilterRule` | interface | `dist/nodes/transform/flow/spec.d.ts:12-24` | Supporting types | 3 field(s) |
-| `flow` | function | `dist/flow-sdk.d.ts:1473-1488` | Flow construction | Start building a flow with the given id. |
+| `flow` | function | `dist/flow-sdk.d.ts:1475-1490` | Flow construction | Start building a flow with the given id. |
 | `FlowAction` | class | `dist/core/node-classes.d.ts:162-168` | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
 | `FlowActionSpec` | type | `dist/flow-sdk.d.ts:48-49` | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
 | `FlowActionSpecs` | interface | `dist/core/actions.d.ts:1995-2104` | Supporting types | Every action kind, keyed by kind, to the body of its spec — the arm's fields other than `kind`. |
-| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1203-1472` | Builders | 13 member(s) |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts:1203-1474` | Builders | 13 member(s) |
 | `FlowLayout` | interface | `dist/flow-sdk.d.ts:671-684` | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
 | `FlowNode` | class | `dist/core/node-classes.d.ts:126-161` | Supporting types | The abstract root of every definition-backed node the builder can place. |
 | `FlowResource` | class | `dist/core/node-classes.d.ts:176-183` | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
@@ -229,7 +229,7 @@ could hand you spans for a version you do not have.
 | `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts:624-629` | Flow construction | The designer's sticky-note palette. |
 | `StickyNote` | interface | `dist/flow-sdk.d.ts:636-670` | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
 | `StickyNoteColor` | type | `dist/flow-sdk.d.ts:630-635` | Supporting types | A sticky note's swatch. |
-| `subflow` | function | `dist/flow-sdk.d.ts:1489-1528` | Flow construction | Run another flow as one step, and read back what it returns. |
+| `subflow` | function | `dist/flow-sdk.d.ts:1491-1530` | Flow construction | Run another flow as one step, and read back what it returns. |
 | `SubflowSpec` | interface | `dist/flow-sdk.d.ts:40-47` | Supporting types | A step that runs a child flow. |
 | `summarize` | function | `dist/core/actions.d.ts:2202-2242` | Actions | Summarize a document with citations — the platform's **Summarize** node. |
 | `SummarizeInputs` | interface | `dist/core/actions.d.ts:674-706` | Option shapes | 3 field(s) |

package/dist/api-members.md

@@ -104,7 +104,7 @@ not find it either.
 | `breakEnabled` | property | `LoopOptions` | `dist/flow-sdk.d.ts:458-462` |
 | `build` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3483-3488` |
 | `build` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1269-1274` |
-| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1465-1471` |
+| `build` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1467-1473` |
 | `businessRule` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2527-2573` |
 | `by` | property | `LookupResolution` | `dist/core/lookups.d.ts:164` |
 | `by` | property | `LookupSpec` | `dist/core/lookups.d.ts:27-28` |
@@ -289,7 +289,7 @@ not find it either.
 | `entity` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1090-1091` |
 | `entry` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:528` |
 | `entry` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:520` |
-| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1291-1341` |
+| `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1293-1343` |
 | `entryPointId` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:534-539` |
 | `entryPoints` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:724-725` |
 | `entryWhen` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:1004-1011` |
@@ -459,7 +459,7 @@ not find it either.
 | `inclusiveGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2266-2273` |
 | `inlineAgent` | property | `FlowActionSpecs` | `dist/core/actions.d.ts:2063-2066` |
 | `input` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1160-1185` |
-| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1416-1428` |
+| `input` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1418-1430` |
 | `input` | property | `HumanTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1355-1356` |
 | `input` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1241-1242` |
 | `input` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3068-3076` |
@@ -725,7 +725,7 @@ not find it either.
 | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1871-1876` |
 | `outcomes` | property | `HitlInputs` | `dist/core/actions.d.ts:445-459` |
 | `output` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1186-1198` |
-| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1429-1454` |
+| `output` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1431-1456` |
 | `output` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:90` |
 | `output` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3077-3085` |
 | `outputColumns` | property | `BatchTransformInputs` | `dist/core/actions.d.ts:722-726` |
@@ -901,7 +901,7 @@ not find it either.
 | `schemaVersion` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3375-3404` |
 | `schemaVersion` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:704-710` |
 | `schemaVersion` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1068-1094` |
-| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1376-1415` |
+| `schemaVersion` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1378-1417` |
 | `scope` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:121` |
 | `scopes` | property | `GuardrailSelector` | `dist/core/actions.d.ts:1177` |
 | `script` | property | `FlowActionSpecs` | `dist/nodes/script/flow/spec.d.ts:47-50` |
@@ -1044,11 +1044,11 @@ not find it either.
 | `trigger` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:715-717` |
 | `trigger` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1224-1232` |
 | `trigger` | property | `EscalationOpts` | `dist/case/case-sdk.d.ts:128-129` |
-| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1272-1290` |
+| `trigger` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1272-1292` |
 | `trigger` | property | `StartOpts` | `dist/bpmn/bpmn-sdk.d.ts:624-671` |
 | `triggeredByEvent` | property | `SubProcessOpts` | `dist/bpmn/bpmn-sdk.d.ts:976-977` |
 | `triggerId` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:726-732` |
-| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1342-1361` |
+| `triggerId` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1344-1363` |
 | `triggerOptions` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:718-719` |
 | `triggers` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:644-645` |
 | `triggers` | property | `CaseLayout` | `dist/case/case-sdk.d.ts:620-621` |
@@ -1104,7 +1104,7 @@ not find it either.
 | `value` | property | `TypedInputRow` | `dist/bpmn/typed-node.d.ts:205-206` |
 | `values` | property | `DataFabricCreateInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:132-137` |
 | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1199-1223` |
-| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1455-1464` |
+| `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1457-1466` |
 | `var` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3059-3067` |
 | `var` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:494-495` |
 | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:251-252` |
@@ -1127,7 +1127,7 @@ not find it either.
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1708-1709` |
 | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:2933` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
-| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1362-1375` |
+| `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1364-1377` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:368-375` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
 | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:2890-2891` |

package/dist/check.js

@@ -9,7 +9,7 @@ import { Expr, SCHEDULE_PRESETS, parseIxpProjectType, flatNameOf, flatNameSegmen
 import { FlowNode } from './core/node-classes.js';
 import { planContributionBindings } from './core/contribution-bindings.js';
 import { definitionHasErrorPort, errorPortRefusal } from './core/error-port.js';
-import { bundledActionNodeType, bundledDefinition, resolveContributionDefinition } from './serialize.js';
+import { bundledActionNodeType, bundledDefinition, perCallDefinition, resolveContributionDefinition } from './serialize.js';
 import { sdkFormFieldType } from './core/form-field-type.js';
 import { QUEUE_ITEM_RECORD_SCHEMA } from './core/queue-record.js';
 import { AGENTIC_PROCESS_FORMS } from './core/agentic-process-forms.js';
@@ -1512,10 +1512,14 @@ function checkSubflow(step, child, inputs, parent, ancestors, diags) {
         return;
     }
     // A subflow always starts manually — its caller is what starts it. Nothing
-    // schedules a subflow, so a schedule here is silently ignored.
-    if (child.trigger !== undefined) {
+    // schedules a subflow, so a schedule here is silently ignored. `manual()` is
+    // what the child gets anyway, so `.trigger(manual(), { label, version })` is
+    // allowed: it is how the child's start node is labelled (#1050), and the
+    // form decompile writes for a renamed one.
+    if (child.trigger !== undefined && child.trigger.kind !== 'manual') {
         at('SUBFLOW_CHILD_TRIGGER', `Subflow "${step}" runs a flow with its own \`.trigger(…)\`. A subflow is started by its caller, never by a `
-            + `trigger of its own — the schedule would be dropped. Remove the .trigger() from "${child.id}".`);
+            + `trigger of its own — the schedule would be dropped. Remove the .trigger() from "${child.id}" `
+            + `(\`.trigger(manual(), { label })\` is allowed, to name the child's start node).`);
     }
     // `{ shared }` merges one input across a flow's ROOTS (#924). A subflow has
     // one root, its caller, so there is nothing to merge; serialize refuses it.
@@ -4952,25 +4956,31 @@ function collectActionExprs(s, out, errorSource) {
     }
 }
 /**
- * The families whose definition is built per tenant or per call, so there is no
- * bundled definition to ask, and whose definitions all have
- * an error port (the SDK's own `rpaWorkflowDef` / `apiWorkflowDef` /
- * `agenticProcessDef` / `agentDef` / `ixpExtractDef` set
- * `supportsErrorHandling: true`; Integration Service connector activities
- * declare the `error` handle).
+ * The families with no definition this SDK can ask, and an error port anyway:
+ * an Integration Service connector activity's definition comes from the
+ * connector library, and every connector activity declares the `error` handle.
  *
- * Every family with a bundled definition is NOT listed: its answer comes from
- * that definition (`bundledActionNodeType` + `definitionHasErrorPort`), so a
- * family cannot drift from its definition again (#1011: `documentClassify` was
- * missing here although `uipath.document.classify@1.0` sets the flag).
+ * Every other family is decided by a definition, never by a list:
  *
- * Not listed, deliberately: `publishedFunction` (its synthesized definition sets
- * the flag, but no run has measured a function failure routing; it stays
- * refused until one does) and `waitEvent` (an event wait resumes or does not).
+ *  - a bundled family by its bundled definition (`bundledActionNodeType` +
+ *    `bundledDefinition`, #1011: `documentClassify` was missing from the old
+ *    list although `uipath.document.classify@1.0` sets the flag);
+ *  - a per-tenant family (`rpaWorkflow`, `apiWorkflow`, `agenticProcess`,
+ *    `publishedFunction`, `agent`, `ixpExtract`) by the definition serialize
+ *    synthesizes for it (`perCallDefinition`, #1040: `publishedFunction` was
+ *    refused here although `publishedFunctionDef` sets the flag).
+ *
+ * `publishedFunction`'s flag is measured, not assumed: on 2026-10-08 four
+ * `flow debug` jobs on alpha/codereval called `acme-echo` with a non-string
+ * `message` (null, object, number, array). In each, the function job failed
+ * (`Python.FUNCTION_EXECUTION_ERROR`, category User, status 502), the node's
+ * error boundary fired, and the handler's `err('message')` read
+ * "Failure in the Orchestrator Job".
+ *
+ * A kind in none of these (`waitEvent`) has no error port: an event wait
+ * resumes or does not.
  */
-const PER_TENANT_ERROR_PORT_KINDS = new Set([
-    'connector', 'rpaWorkflow', 'apiWorkflow', 'agenticProcess', 'agent', 'ixpExtract',
-]);
+const NO_DEFINITION_ERROR_PORT_KINDS = new Set(['connector']);
 /**
  * The ONERROR_NO_ERROR_PORT sentence for a typed step — a built-in family or a
  * registered node type — whose node type has no error port. One spelling for
@@ -5084,9 +5094,30 @@ placed) {
     // no definition here to ask; version resolution reports that, not this check.
     const bundledType = bundledActionNodeType(spec);
     const bundledDef = bundledType ? bundledDefinition(bundledType, step.options?.version) : undefined;
-    const noPort = bundledType
-        ? bundledDef !== undefined && !definitionHasErrorPort(bundledDef)
-        : !PER_TENANT_ERROR_PORT_KINDS.has(spec.kind);
+    // A per-tenant family: ask the definition serialize synthesizes for it (#1040).
+    let perCallDef;
+    if (!bundledType) {
+        try {
+            perCallDef = perCallDefinition(spec);
+        }
+        catch {
+            // The family's own checks report a spec its builder cannot lower.
+            return;
+        }
+    }
+    const def = bundledType ? bundledDef : perCallDef;
+    const noPort = def !== undefined
+        ? !definitionHasErrorPort(def)
+        : !bundledType && !NO_DEFINITION_ERROR_PORT_KINDS.has(spec.kind);
+    if (noPort && perCallDef !== undefined) {
+        diags.push({
+            level: 'error',
+            code: 'ONERROR_NO_ERROR_PORT',
+            message: errorPortRefusal(step.name, perCallDef, { bundled: true }),
+            step: step.name,
+        });
+        return;
+    }
     if (noPort) {
         diags.push({
             level: 'error',

package/dist/core/subflow-start.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A subflow child's start-node label when the author sets none: `Start`, what
+ * Studio Web writes (the vendored golden `shared/sample-flows/new.flow`,
+ * `subflow1Start`). It is not the manual trigger definition's `Manual trigger`.
+ */
+export declare const SUBFLOW_START_LABEL = "Start";

package/dist/core/subflow-start.js

@@ -0,0 +1,6 @@
+/**
+ * A subflow child's start-node label when the author sets none: `Start`, what
+ * Studio Web writes (the vendored golden `shared/sample-flows/new.flow`,
+ * `subflow1Start`). It is not the manual trigger definition's `Manual trigger`.
+ */
+export const SUBFLOW_START_LABEL = 'Start';

package/dist/decompile.js

@@ -33,6 +33,7 @@ import { preserveSchemaVersion } from './schema-version.js';
 import { BUNDLED_DEFINITIONS, bundledVersions } from './flow-definitions.js';
 import { DEFAULT_TRIGGER_ID, Expr } from './core/expr.js';
 import { FLOW_NODE_TYPES } from './flow-node-registry.js';
+import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { commentText } from './core/comment-text.js';
 import { tsLiteral, tsNumber, tsText } from './core/ts-literal.js';
 import { contextIndexSlug, parseContextIndexType } from './core/context-index.js';
@@ -163,18 +164,22 @@ function verArg(node) {
 }
 /**
  * A trigger node's option clauses: its exact `version`, and its canvas `label`
- * when that differs from the definition's label (`definitionLabel`).
+ * when that differs from `defaultLabel` (the label serialize writes when the
+ * author sets none).
  */
-function triggerOptParts(node) {
+function triggerOptParts(node, defaultLabel = definitionLabel(node)) {
     const parts = [];
     const ver = verClause(node);
     if (ver)
         parts.push(ver);
-    const label = node.display?.label;
-    if (typeof label === 'string' && label !== definitionLabel(node))
-        parts.push(`label: ${tsLiteral(label)}`);
+    if (hasRenamedLabel(node, defaultLabel))
+        parts.push(`label: ${tsLiteral(node.display.label)}`);
     return parts;
 }
+function hasRenamedLabel(node, defaultLabel) {
+    const label = node.display?.label;
+    return typeof label === 'string' && label !== defaultLabel;
+}
 /** `triggerOptParts` as the `.trigger(spec, { ... })` options argument. */
 function triggerOptsArg(node) {
     const parts = triggerOptParts(node);
@@ -3073,7 +3078,8 @@ function emitSubflow(node, ctx) {
 /**
  * Render a child (sub)flow body as a nested `flow(name)…` builder expression
  * (parenthesized, no `.build()`). Reuses the same region machinery on the child's
- * own scope; the child's trigger is its `<caller>Start` node.
+ * own scope; the child's trigger is its `<caller>Start` node, written as
+ * `.trigger(manual(), { label })` only when its label is not `SUBFLOW_START_LABEL`.
  */
 function emitChildFlow(name, child, ctx) {
     const globals = readFlowGlobals(child.variables, runStrict);
@@ -3098,6 +3104,9 @@ function emitChildFlow(name, child, ctx) {
     }
     // Body: the child's trigger is its own manual Start; walk from its successor.
     const trigger = (child.nodes ?? []).find((n) => isTrigger(n.type) && !(child.edges ?? []).some((e) => e.targetNodeId === n.id));
+    if (trigger?.type === T.triggerManual && hasRenamedLabel(trigger, SUBFLOW_START_LABEL)) {
+        parts.push(`.trigger(${ctx.imp.use('manual')}(), { ${triggerOptParts(trigger, SUBFLOW_START_LABEL).join(', ')} })`);
+    }
     const scope = scopeIds(child.nodes ?? [], undefined);
     const entries = trigger ? scopeSuccEdges(childCtx.graph, trigger.id, scope) : [];
     const ipdom = entries.length

package/dist/flow-sdk.d.ts

@@ -1284,6 +1284,8 @@ declare class FlowBuilder extends StepList {
      * @param options - Node options; `version` selects the exact definition
      * version and `label` sets what the canvas shows on the trigger node
      * (default: the trigger definition's label, e.g. `Scheduled trigger`). See {@link NodeOptions}.
+     * On a flow run as a `subflow(...)`, only `manual()` is allowed — its caller
+     * starts it — and `label` names the child's start node (default: `Start`).
      * @returns This builder, so calls chain.
      * @defaultValue the manual trigger
      */

package/dist/flow-sdk.js

@@ -976,6 +976,8 @@ class FlowBuilder extends StepList {
      * @param options - Node options; `version` selects the exact definition
      * version and `label` sets what the canvas shows on the trigger node
      * (default: the trigger definition's label, e.g. `Scheduled trigger`). See {@link NodeOptions}.
+     * On a flow run as a `subflow(...)`, only `manual()` is allowed — its caller
+     * starts it — and `label` names the child's start node (default: `Start`).
      * @returns This builder, so calls chain.
      * @defaultValue the manual trigger
      */

package/dist/serialize.d.ts

@@ -102,6 +102,26 @@ export declare function bundledActionNodeType(spec: {
     kind?: string;
     inputs?: any;
 } | undefined): string | undefined;
+/**
+ * The definition serialize synthesizes for a family that has no bundled one:
+ * a published process resource (`rpaWorkflow`, `apiWorkflow`,
+ * `agenticProcess`, `publishedFunction`, `agent`) or an `ixpExtract` step.
+ * Their node type carries a tenant's key, so the SDK builds the definition
+ * per call, transcribed from what `registry get` returns. `undefined` for
+ * every other kind (a bundled family, a connector, a container).
+ *
+ * The emit path builds its definition here, and `check` asks this same
+ * definition whether the node has an error port (#1040), so the two cannot
+ * disagree. For instance `publishedFunction(...)` yields
+ * `uipath.core.function.<key>@1.0.0` with `supportsErrorHandling: true`.
+ *
+ * Throws what the family's builder throws for an unusable spec (an
+ * `ixpExtract` project that is not a node type).
+ */
+export declare function perCallDefinition(spec: {
+    kind?: string;
+    inputs?: any;
+} | undefined): any | undefined;
 /**
  * The bundled definition of `nodeType` that `makeNode` resolves: the author's
  * exact `{ version }` when given, otherwise the pinned default (the first

package/dist/serialize.js

@@ -60,6 +60,7 @@ import { QUEUE_ITEM_RECORD_SCHEMA } from './core/queue-record.js';
 import { AGENTIC_PROCESS_FORMS } from './core/agentic-process-forms.js';
 import { resourceNodeSortOrder } from './core/process-resource-sort-order.js';
 import { types } from './core/expr.js';
+import { SUBFLOW_START_LABEL } from './core/subflow-start.js';
 import { ownEntry } from './core/own-entry.js';
 import { jsonClone } from './core/json-file.js';
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -3793,6 +3794,48 @@ export function bundledActionNodeType(spec) {
         default: return undefined;
     }
 }
+/**
+ * The definition serialize synthesizes for a family that has no bundled one:
+ * a published process resource (`rpaWorkflow`, `apiWorkflow`,
+ * `agenticProcess`, `publishedFunction`, `agent`) or an `ixpExtract` step.
+ * Their node type carries a tenant's key, so the SDK builds the definition
+ * per call, transcribed from what `registry get` returns. `undefined` for
+ * every other kind (a bundled family, a connector, a container).
+ *
+ * The emit path builds its definition here, and `check` asks this same
+ * definition whether the node has an error port (#1040), so the two cannot
+ * disagree. For instance `publishedFunction(...)` yields
+ * `uipath.core.function.<key>@1.0.0` with `supportsErrorHandling: true`.
+ *
+ * Throws what the family's builder throws for an unusable spec (an
+ * `ixpExtract` project that is not a node type).
+ */
+export function perCallDefinition(spec) {
+    const s = spec?.inputs ?? {};
+    switch (spec?.kind) {
+        case 'publishedFunction':
+            return publishedFunctionDef({ key: s.key, name: s.name, folderPath: s.folderPath, inputs: s.inputs ?? {}, returns: s.returns });
+        case 'apiWorkflow':
+            return apiWorkflowDef({ key: s.key, name: s.name, folderPath: s.folderPath, inputs: s.inputs ?? {}, returns: s.returns });
+        case 'agenticProcess':
+            return agenticProcessDef({
+                key: s.key, name: s.name, folderPath: s.folderPath, location: s.location, projectId: s.projectId,
+                inputs: s.inputs ?? {}, returns: s.returns, form: s.form,
+            });
+        case 'rpaWorkflow':
+            return rpaWorkflowDef({
+                key: s.key, name: s.name, folderPath: s.folderPath, location: s.location, projectId: s.projectId,
+                inputs: s.inputs ?? {}, returns: s.returns,
+            });
+        case 'agent':
+            return agentDef({
+                key: s.key, name: s.name, folderPath: s.folderPath, location: s.location, projectId: s.projectId,
+                inputs: s.inputs ?? {}, returns: s.returns, flavour: s.flavour,
+            });
+        case 'ixpExtract': return ixpExtractDef(s);
+        default: return undefined;
+    }
+}
 /**
  * The bundled definition of `nodeType` that `makeNode` resolves: the author's
  * exact `{ version }` when given, otherwise the pinned default (the first
@@ -4829,7 +4872,9 @@ export function serialize(built, opts = {}) {
      *
      * The child gets its own manual Start node (a subflow always starts manually
      * — nothing schedules a subflow; its caller is the trigger) and its own
-     * variables. Every `in` variable carries `triggerNodeId` pointing at that
+     * variables. A child's `.trigger(manual(), { label, version })` sets that
+     * node's canvas label and exact version; `check` refuses any other kind.
+     * Every `in` variable carries `triggerNodeId` pointing at that
      * Start: it is what binds the caller's value, and omitting it is the single
      * defect that makes a subflow validate clean and then fault at run time with
      * a null. It is emitted here, always, so it cannot be forgotten.
@@ -4858,7 +4903,10 @@ export function serialize(built, opts = {}) {
         // Without this a child that reads its own input points at a node that does
         // not exist in its scope.
         scope.rename.nodeIds.set('start', [startId]);
-        const start = makeNode(NODE_TYPE.trigger, startId, 'Start', { requestedVersion: child.triggerOptions?.version });
+        // The child's `.trigger(manual(), { label })`, else `SUBFLOW_START_LABEL`.
+        const start = makeNode(NODE_TYPE.trigger, startId, child.triggerOptions?.label ?? SUBFLOW_START_LABEL, {
+            requestedVersion: child.triggerOptions?.version,
+        });
         start.inputs = {};
         scope.nodes.push(start);
         const tails = emit(child.steps, [{ node: startId, port: 'output' }], scope);
@@ -5267,10 +5315,7 @@ export function serialize(built, opts = {}) {
             // because `inputs` is required here (the empty-input floor — see
             // `AgentInputs.inputs`) and because the emitted binding subtype is `Agent`.
             const s = spec.inputs;
-            const def = agentDef({
-                key: s.key, name: s.name, folderPath: s.folderPath, location: s.location, projectId: s.projectId,
-                inputs: s.inputs, returns: s.returns, flavour: s.flavour,
-            });
+            const def = perCallDefinition(spec);
             // The pair's key and folder come off the definition, as for rpa / agentic
             // steps: one place decides the in-solution shape.
             const pairFolder = def.model.bindings.values.find((v) => v.name === 'folderPath').default;
@@ -5842,19 +5887,8 @@ export function serialize(built, opts = {}) {
             const s = spec.inputs;
             const nodeInputs = s.inputs ?? {};
             const fireAndForget = spec.kind === 'agenticProcess' && spec.inputs.completion === 'fire-and-forget';
-            const def = spec.kind === 'publishedFunction'
-                ? publishedFunctionDef({ key: spec.inputs.key, name: s.name, folderPath: spec.inputs.folderPath, inputs: nodeInputs, returns: spec.inputs.returns })
-                : spec.kind === 'apiWorkflow'
-                    ? apiWorkflowDef({ key: spec.inputs.key, name: s.name, folderPath: spec.inputs.folderPath, inputs: nodeInputs, returns: spec.inputs.returns })
-                    : spec.kind === 'agenticProcess'
-                        ? agenticProcessDef({
-                            key: spec.inputs.key, name: s.name, folderPath: s.folderPath, location: spec.inputs.location,
-                            projectId: spec.inputs.projectId, inputs: nodeInputs, returns: spec.inputs.returns, form: spec.inputs.form,
-                        })
-                        : rpaWorkflowDef({
-                            key: spec.inputs.key, name: s.name, folderPath: s.folderPath, location: spec.inputs.location,
-                            projectId: spec.inputs.projectId, inputs: nodeInputs, returns: spec.inputs.returns,
-                        });
+            // The same definition `check` asks about the error port.
+            const def = perCallDefinition(spec);
             // The bindings first: two steps on the same process share ONE pair, and the
             // definition's `model.context` names ids that have to exist.
             // Read off the definition: one kind carries several subtypes (agenticProcess by `form`).
@@ -6155,7 +6189,7 @@ export function serialize(built, opts = {}) {
         }
         if (spec.kind === 'ixpExtract') {
             const s = spec.inputs;
-            const def = ixpExtractDef(s);
+            const def = perCallDefinition(spec); // ixpExtractDef: throws on an unparseable project
             const { versionId } = parseIxpProjectType(s.project); // ixpExtractDef threw if it could not parse
             // The bindings first: two steps on the same project share ONE pair, and
             // the definition's `model.bindings.resourceKey` names the key they hang off.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.20.2",
+  "version": "6.20.4",
   "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": "b82dedf06e578750e6cb85ed825d25cec1745b09"
+  "gitref": "7dcc7ebc0420e1fca8be0368269c8f20ff60eff6"
 }