@uipath/maestro-builder-sdk 6.20.4 → 6.20.5

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, perCallDefinition, resolveContributionDefinition } from './serialize.js';
+import { actionVersion, 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';
@@ -5087,13 +5087,15 @@ placed) {
         return;
     }
     // A typed family with a bundled definition: ask the definition serialize will
-    // emit, at the version it will emit (#1011). For instance `voiceAgent()`
-    // defaults to uipath.agent.voice@1.0 (no error port) and `{ version: '1.1' }`
-    // selects @1.1 (which has one).
+    // emit, at the version it will emit (#1011), chosen by the same selector
+    // serialize uses (#1041). For instance `voiceAgent()` defaults to
+    // uipath.agent.voice@1.0 (no error port) and `{ version: '1.1' }` selects @1.1
+    // (which has one); `hitl({ exposeError: true })` selects uipath.human-in-the-loop@1.2
+    // with no `{ version }` at all.
     // A version the SDK does not bundle (an inline agent's registry version) has
     // 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 bundledDef = bundledType ? bundledDefinition(bundledType, actionVersion(spec, step.options?.version)) : undefined;
     // A per-tenant family: ask the definition serialize synthesizes for it (#1040).
     let perCallDef;
     if (!bundledType) {

package/dist/serialize.d.ts

@@ -122,6 +122,26 @@ export declare function perCallDefinition(spec: {
     kind?: string;
     inputs?: any;
 } | undefined): any | undefined;
+/**
+ * The definition version serialize emits for a typed action step that is not
+ * yet on the node-type registry: the author's `{ version }` when given,
+ * otherwise the version the step's inputs select, otherwise `undefined` (the
+ * pinned default). Two such families pick a version themselves:
+ *
+ *  - `hitl`: `exposeError` selects `@1.2`, per-outcome routing selects `@1.1`;
+ *  - `inlineAgent`: the newest bundled version, not the first bundled entry.
+ *
+ * The emit paths read their version here, and `check` resolves the definition
+ * it asks about with this same version (#1041), so the two cannot pick
+ * different definitions. For instance `inlineAgent({ ... })` gives the newest
+ * bundled version in both. A registered family (e.g. `dataFabricRead`, whose
+ * `resultMode` selects `core.datafabric.read@1.4`) gets the same guarantee from
+ * the registry's `resolveVersion`, which check and serialize both call.
+ */
+export declare function actionVersion(spec: {
+    kind?: string;
+    inputs?: any;
+} | undefined, explicit: string | undefined): string | 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

@@ -3836,6 +3836,45 @@ export function perCallDefinition(spec) {
         default: return undefined;
     }
 }
+/**
+ * The definition version serialize emits for a typed action step that is not
+ * yet on the node-type registry: the author's `{ version }` when given,
+ * otherwise the version the step's inputs select, otherwise `undefined` (the
+ * pinned default). Two such families pick a version themselves:
+ *
+ *  - `hitl`: `exposeError` selects `@1.2`, per-outcome routing selects `@1.1`;
+ *  - `inlineAgent`: the newest bundled version, not the first bundled entry.
+ *
+ * The emit paths read their version here, and `check` resolves the definition
+ * it asks about with this same version (#1041), so the two cannot pick
+ * different definitions. For instance `inlineAgent({ ... })` gives the newest
+ * bundled version in both. A registered family (e.g. `dataFabricRead`, whose
+ * `resultMode` selects `core.datafabric.read@1.4`) gets the same guarantee from
+ * the registry's `resolveVersion`, which check and serialize both call.
+ */
+export function actionVersion(spec, explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    // Keyed by the node type `bundledActionNodeType` already picks, so the
+    // version rule adds no second dispatch on the step's kind.
+    const type = bundledActionNodeType(spec);
+    if (type === NODE_TYPE.hitl)
+        return hitlNeededVersion(spec?.inputs);
+    if (type === INLINE_AGENT_TYPE)
+        return INLINE_AGENT_DEFAULT_VERSION;
+    return undefined;
+}
+/**
+ * The base human task version a task's inputs need when nothing is pinned:
+ * `exposeError` needs 1.2 (it adds the `error` output), and a task that
+ * routes per outcome needs 1.1. Only the base task reaches here: a variant
+ * (quick-form, app task) has its own node type and one definition.
+ */
+function hitlNeededVersion(inputs) {
+    if (inputs?.exposeError)
+        return '1.2';
+    return hitlExitModel(inputs, undefined).shape === 'per-outcome' ? '1.1' : undefined;
+}
 /**
  * The bundled definition of `nodeType` that `makeNode` resolves: the author's
  * exact `{ version }` when given, otherwise the pinned default (the first
@@ -5356,7 +5395,7 @@ export function serialize(built, opts = {}) {
             // the node to another version as a side effect (#956). Both now live in
             // the sidecar and on edges; neither selects a definition. An explicit
             // `{ version }` (what decompile writes back) resolves exactly.
-            const version = step.options?.version ?? INLINE_AGENT_DEFAULT_VERSION;
+            const version = actionVersion(spec, step.options?.version);
             // `definitions[]` holds one entry per type@version, so a flow where any
             // agent attaches memory keeps the handle for all of them.
             const withMemory = s.memory !== undefined
@@ -6278,13 +6317,12 @@ export function serialize(built, opts = {}) {
                 throw new Error(`"${step.name}": outcomePorts: true, but the '${spec.inputs?.variant}' variant reads its outcomes `
                     + `from its app and leaves on its single 'completed' exit. Route on out('${step.name}', 'Action') downstream.`);
             }
-            const neededVersion = hitlType !== NODE_TYPE.hitl ? undefined
-                : spec.inputs?.exposeError ? '1.2' : exitModel.shape === 'per-outcome' ? '1.1' : undefined;
             if (spec.inputs?.exposeError === true && pinned !== undefined && pinned !== '1.2') {
                 throw new Error(`"${step.name}": exposeError needs the task's 1.2 definition, but { version: '${pinned}' } pins it. `
                     + `Drop the pin or match it.`);
             }
-            const node = makeNode(hitlType, id, step.name, { parentId, requestedVersion: pinned ?? neededVersion });
+            // The same version `check` resolves the definition at (#1041).
+            const node = makeNode(hitlType, id, step.name, { parentId, requestedVersion: actionVersion(spec, pinned) });
             const { inputs, outputs } = hitlInputs(spec.inputs, id, built.id, step.name, scope.rename);
             node.inputs = inputs;
             // The definition's `outputDefinition` gives the two output SLOTS; the form

package/package.json

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