@uipath/maestro-builder-sdk 6.20.2 → 6.20.3

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';
@@ -4952,25 +4952,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 +5090,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/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

@@ -3793,6 +3793,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
@@ -5267,10 +5309,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 +5881,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 +6183,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.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": "b82dedf06e578750e6cb85ed825d25cec1745b09"
+  "gitref": "15fa01717ebe49d6cf51c9ec11cca4a7ebbf9bb7"
 }