@uipath/maestro-builder-sdk 6.47.0 → 6.47.2

package/dist/case/serialize.js

@@ -16,7 +16,7 @@ import { EQUALS_EXPR_DIALECT } from '../core/connector-checks.js';
 import { bindingLabelRefusal } from '../core/binding-messages.js';
 import { resolveEventWhere } from '../core/lookups.js';
 import { resolveCaseSubscription } from './subscription.js';
-import { externalDescriptorRefusal } from './external.js';
+import { externalDescriptorRefusal, externalHybridRefusal, externalServiceType, isExternalExecutionMode } from './external.js';
 import { CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from './format-profile.js';
 import { isResourceLabelRefusal, resolveResourceRef, resourceIdentity } from './resource-identity.js';
 import { ownEntry } from '../core/own-entry.js';
@@ -914,7 +914,8 @@ function taskData(task, resolver, taskId, stageId, ids) {
         // into the child (`data.inputs[]`) and reading results back (`data.outputs[]`)
         // uses the identical io-binding wire as the other reference tasks (Gap F).
         case 'case-management':
-        case 'flow-process': {
+        case 'flow-process':
+        case 'function': {
             // Reference-mode task, plus optional io-binding: input params and output
             // extractions (`data.inputs[]` / `data.outputs[]`). Each row's `elementId`
             // is "<stageId>-<taskId>"; an output also registers a root `inputOutputs`
@@ -970,7 +971,7 @@ function taskData(task, resolver, taskId, stageId, ids) {
             return connectorTaskData(task.connector, resolver, taskId, `Connector task "${task.name}"`);
         case 'external-agent':
         case 'external-workflow':
-            return externalTaskData(task.kind, task.external, resolver, `${task.kind === 'external-agent' ? 'External Agent' : 'External Workflow'} task "${task.name}"`);
+            return externalTaskData(task.kind, task.external, resolver, taskId, `${task.kind === 'external-agent' ? 'External Agent' : 'External Workflow'} task "${task.name}"`);
         case 'wait-for-timer': {
             if (task.timer?.duration)
                 return { timerType: 'timeDuration', timeDuration: task.timer.duration };
@@ -1258,6 +1259,7 @@ const REFERENCE_BINDING = {
     'api-workflow': { resource: 'process', subType: 'Api' },
     'case-management': { resource: 'process', subType: 'CaseManagement' },
     'flow-process': { resource: 'process' },
+    function: { resource: 'process', subType: 'Function' },
 };
 /**
  * Mint (once per resource + resourceKey + attribute) one root binding row of a
@@ -1358,7 +1360,7 @@ function businessRuleTaskData(task, resolver, elementId, ids) {
  * the op's output schema. Connection/folder resolve through `bindings` and are
  * referenced as `=bindings.<id>`, with the binding entry collected at case root.
  */
-function connectorTaskData(spec, resolver, elementId, where) {
+function connectorTaskData(spec, resolver, elementId, where, executionType) {
     if (!resolver.library)
         throw new Error(`connector task needs the connector library — pass { library } to serialize or use uip maestro case compile --library.`);
     const rc = resolver.library.resolve(spec.key, spec.action, spec.version, spec.object);
@@ -1376,7 +1378,7 @@ function connectorTaskData(spec, resolver, elementId, where) {
     const folderRef = folderBindingRef(resolver, spec.folder, connRef, { attribute: 'folder', where, target });
     if (folderRef)
         context.push(io('folderKey', 'string', { value: `=bindings.${folderRef.id}` }));
-    context.push(io('objectName', 'string', { value: op.objectName ?? spec.action }), io('method', 'string', { value: transportHttpMethod(rc.httpMethod) }), io('path', 'string', { value: rc.endpoint }), io('metadata', 'json', { body: connectorMetadata(rc, op) }));
+    context.push(io('objectName', 'string', { value: op.objectName ?? spec.action }), io('method', 'string', { value: transportHttpMethod(rc.httpMethod) }), io('path', 'string', { value: rc.endpoint }), io('metadata', 'json', { body: connectorMetadata(rc, op, executionType) }));
     // inputs: the shared validator (`core/connector-inputs.ts`), the one Flow's and
     // BPMN's serializers and every family's `check` run. It refuses a missing
     // required field, an unknown or mistyped input, and swaps a `lookup()` token for
@@ -1410,66 +1412,35 @@ function connectorTaskData(spec, resolver, elementId, where) {
     const outputs = connectorOutputs(rc, elementId, resolver);
     return { serviceType: CASE_FORMAT_PROFILE.connectorActivityServiceType, context, inputs, outputs, bindings: [] };
 }
-function externalTaskData(kind, spec, resolver, where) {
+/**
+ * An External Agent / External Workflow task, in the shape the Case Designer
+ * saves one (`uip`'s `tests/fixtures/external-tasks/designer-saved.json`, alpha
+ * 2026-10-16): a connector activity's `data` — `connectorKey`, `connection`,
+ * `resourceKey`, `folderKey`, `objectName`, `method`, `path`, `metadata`
+ * context; `pathParameters` / `queryParameters` / `body` input containers;
+ * `response` + `Error` outputs — plus the object's `executionType` (in the
+ * context and in the metadata's configuration), `activityConfigurationVersion:
+ * "v2"`, and the sync or async service type that execution type gives.
+ */
+function externalTaskData(kind, spec, resolver, elementId, where) {
     if (!resolver.library)
         throw new Error(`${kind} task needs the connector library — pass { library } to serialize or use uip maestro case compile --library.`);
     const rc = resolver.library.resolve(spec.connector.key, spec.connector.action, spec.connector.version, spec.connector.object);
     const refused = externalDescriptorRefusal(kind, rc);
     if (refused)
         throw new Error(refused);
-    if (spec.mode !== 'sync' && spec.mode !== 'async')
-        throw new Error(`${kind} task mode must be "sync" or "async".`);
-    const target = { key: spec.connector.key, action: spec.connector.action };
-    const connection = bindingRef(resolver, spec.connector.connection, 'Connection', 'ConnectionId', `${rc.connectorKey} connection`, { attribute: 'connection', where, target });
-    const folder = folderBindingRef(resolver, spec.connector.folder, connection, { attribute: 'folder', where, target });
-    if (!connection || !folder)
+    if (!isExternalExecutionMode(spec.mode))
+        throw new Error(`${kind} task mode must be the connector object's executionType: "sync", "async" or "hybrid".`);
+    if (spec.mode === 'hybrid')
+        throw new Error(externalHybridRefusal(where));
+    if (!spec.connector.connection || !spec.connector.folder)
         throw new Error(`${kind} task requires non-empty connection and folder binding names.`);
-    const serviceType = kind === 'external-agent'
-        ? (spec.mode === 'sync'
-            ? CASE_FORMAT_PROFILE.externalAgentSyncServiceType
-            : CASE_FORMAT_PROFILE.externalAgentAsyncServiceType)
-        : (spec.mode === 'sync'
-            ? CASE_FORMAT_PROFILE.externalWorkflowSyncServiceType
-            : CASE_FORMAT_PROFILE.externalWorkflowAsyncServiceType);
-    // The inputs: the shared validator every connector activity runs (unknown,
-    // missing required or mistyped input; a `lookup()` swapped for its recorded id,
-    // or refused). Case `check` reports the same through `connectorInputs`.
-    const fields = new Map(rc.fields.map((field) => [field.name, field]));
-    const slots = buildConnectorInputs(rc, spec.connector.inputs, {
-        dialect: EQUALS_EXPR_DIALECT,
-        resolutions: resolver.library.lookupResolutions,
-        lookups: resolver.library.lookupSpecs(spec.connector.key, spec.connector.action, spec.connector.version, spec.connector.object),
-    });
-    const resolved = {
-        ...slots.bodyParameters, ...slots.pathParameters, ...slots.queryParameters,
-    };
-    const responseVar = connectorOutputVar(resolver, 'response');
-    return {
-        serviceType,
-        context: [
-            io('activity', 'string', { value: rc.activityTypeId }),
-            io('connectorKey', 'string', { value: rc.connectorKey }),
-            io('connection', 'string', { value: `=bindings.${connection.id}` }),
-            io('folderKey', 'string', { value: `=bindings.${folder.id}` }),
-            io('method', 'string', { value: transportHttpMethod(rc.httpMethod) }),
-            io('path', 'string', { value: rc.endpoint }),
-        ],
-        inputs: Object.entries(spec.connector.inputs).map(([name, value]) => ({
-            id: name,
-            name,
-            type: jsonType(fields.get(name)?.type),
-            value: name in resolved ? resolved[name] : value,
-            target: name,
-        })),
-        outputs: [{
-                id: responseVar,
-                name: 'response',
-                type: 'json',
-                source: '.',
-                var: responseVar,
-            }],
-        bindings: [],
-    };
+    const data = connectorTaskData(spec.connector, resolver, elementId, where, spec.mode);
+    const context = data.context;
+    const metadataAt = context.findIndex((row) => row.name === 'metadata');
+    context.splice(metadataAt, 0, io('executionType', 'string', { value: spec.mode }));
+    context.push(io('activityConfigurationVersion', 'string', { value: 'v2' }));
+    return { ...data, serviceType: externalServiceType(kind, spec.mode) };
 }
 /** A context/output name/value entry (the caseplan `InputOutput` shape). */
 function io(name, type, extra) {
@@ -1577,7 +1548,7 @@ function folderBindingRef(resolver, name, connection, site) {
 /** The connector `metadata` json blob: the FUNCTIONAL essentialConfiguration +
  * activityTypeId. Designer cosmetics (packageId/activityColor/…) are omitted —
  * the caseplan schema-validates without them (see design §C). */
-function connectorMetadata(rc, op) {
+function connectorMetadata(rc, op, executionType) {
     const instanceParameters = {
         connectorKey: rc.connectorKey,
         objectName: op.objectName ?? rc.nodeType.split('.').pop(),
@@ -1594,6 +1565,9 @@ function connectorMetadata(rc, op) {
             httpMethod: transportHttpMethod(rc.httpMethod),
             path: rc.endpoint,
             packageVersion: rc.version,
+            // An external task's object states how it runs; the Designer saves it here
+            // and beside the configuration. A plain connector activity has none.
+            ...(executionType ? { executionType } : {}),
         },
     };
     return {
@@ -1601,6 +1575,7 @@ function connectorMetadata(rc, op) {
             configuration: `=jsonString:${JSON.stringify(configuration)}`,
             uiPathActivityTypeId: rc.activityTypeId ?? '',
             errorState: { issues: [] },
+            ...(executionType ? { executionType } : {}),
         },
         activityMetadata: {
             activity: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.47.0",
+  "version": "6.47.2",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -93,5 +93,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "e0223e1b46cdf1eb1f4ab072c970824f52b87eeb"
+  "gitref": "16b96902c3da22af8e0fc3cfc8a53edcc832f04c"
 }