@uipath/maestro-builder-sdk 6.18.4 → 6.18.5

package/dist/case/check.d.ts

@@ -38,6 +38,18 @@ export type CaseCheckOpts = Pick<ConnectorCheckOpts, 'connectorResolveError' | '
      * refuses the `object`) or `EVENT_GENERIC_NO_OBJECT` (a GENERIC event with no
      * `object`). Built on `resolveCaseSubscription`, the call compile makes.
      */
+    /**
+     * What Case `compile` would refuse an External Agent / External Workflow
+     * task's resolved descriptor with (`externalDescriptorRefusal`), or
+     * `undefined`: also `undefined` when the descriptor does not resolve, which
+     * `connectorResolveError` reports.
+     */
+    externalDescriptorError?: (kind: 'external-agent' | 'external-workflow', descriptor: {
+        key: string;
+        action: string;
+        version?: string;
+        object?: string;
+    }) => string | undefined;
     subscriptionError?: (kind: 'trigger' | 'event', subscription: EventSubscription) => {
         code: string;
         message: string;

package/dist/case/check.js

@@ -4,6 +4,7 @@ import { schemaVersionRefusal } from '../schema-version.js';
 import { caseJsonPreservation, caseJsonPreservationErrors } from './preserve.js';
 import { EQUALS_EXPR_DIALECT, checkConnectorContract, checkConnectorLookups, checkConnectorSchema, } from '../core/connector-checks.js';
 import { checkEventResolution } from '../core/event-checks.js';
+import { EXTERNAL_TASK_DESCRIPTOR_CONTRACT } from './external.js';
 const TYPE_NAMES = new Set(Object.values(types));
 // audit-case-coverage: rule-slot table start
 // This runtime table must equal the committed matrix's rejected cells. The audit
@@ -270,7 +271,10 @@ export function check(built, opts = {}) {
  *
  * - a connector task and an External Agent / External Workflow task resolve
  *   their operation (`library.resolve`): CONNECTOR_NOT_IN_LIBRARY,
- *   CONNECTOR_OBJECT_REQUIRED, CONNECTOR_OBJECT_NOT_GENERIC;
+ *   CONNECTOR_OBJECT_REQUIRED, CONNECTOR_OBJECT_NOT_GENERIC; then their inputs
+ *   (`buildConnectorInputs`): CONNECTOR_INPUT, LOOKUP_UNRESOLVED;
+ * - an external task's resolved descriptor (`externalDescriptorRefusal`):
+ *   EXTERNAL_TASK_DESCRIPTOR_CONTRACT;
  * - an event trigger, a wait-for-connector task and a wait-for-connector rule
  *   resolve their subscription (`resolveCaseSubscription`): EVENT_UNKNOWN,
  *   EVENT_GENERIC_NO_OBJECT.
@@ -321,7 +325,12 @@ function checkLibraryConnectors(built, opts, diags) {
             if ((t.kind === 'external-agent' || t.kind === 'external-workflow')
                 && t.external?.connector?.key?.trim() && t.external.connector.action?.trim()) {
                 const where = `${t.kind === 'external-agent' ? 'External Agent' : 'External Workflow'} task "${t.name}"`;
-                checkConnectorContract(where, t.external.connector, opts, reporter(where, t.name));
+                const spec = t.external.connector;
+                checkConnectorLookups(where, spec, opts, EQUALS_EXPR_DIALECT, reporter(where, t.name));
+                checkConnectorContract(where, spec, opts, reporter(where, t.name));
+                const refused = opts.externalDescriptorError?.(t.kind, spec);
+                if (refused !== undefined)
+                    diags.push({ level: 'error', code: EXTERNAL_TASK_DESCRIPTOR_CONTRACT, message: `${where}: ${refused}`, where: t.name });
             }
             if (t.kind === 'wait-for-connector' && isSubscription(t.waitConnector))
                 subscription('event', t.waitConnector, `Wait-for-connector task "${t.name}"`, t.name);

package/dist/case/cli-library.js

@@ -8,6 +8,7 @@
  * both `case check` and `case compile`'s check pass call.
  */
 import { connectorCheckOpts } from '../core/cli-library.js';
+import { externalDescriptorRefusal } from './external.js';
 import { EVENT_GENERIC_NO_OBJECT, GenericEventNoObjectError, resolveCaseSubscription } from './subscription.js';
 /**
  * Case's check options from a library the CLI already opened, or `{}` without one.
@@ -32,6 +33,16 @@ export function caseCheckOpts(library) {
         lookups: shared.lookups,
         resolutions: shared.resolutions,
         schemaReadiness: shared.schemaReadiness,
+        externalDescriptorError: (kind, d) => {
+            let rc;
+            try {
+                rc = library.resolve(d.key, d.action, d.version, d.object);
+            }
+            catch {
+                return undefined; // connectorResolveError's to report
+            }
+            return externalDescriptorRefusal(kind, rc);
+        },
         subscriptionError: (kind, sub) => {
             try {
                 resolveCaseSubscription(library, kind, sub);

package/dist/case/external.d.ts

@@ -0,0 +1,27 @@
+/**
+ * case/external — the descriptor contract of an External Agent / External
+ * Workflow task, shared by Case `serialize` (which throws it) and Case `check`
+ * (which reports it as EXTERNAL_TASK_DESCRIPTOR_CONTRACT), so the two refuse the
+ * same descriptors with the same text (#1035).
+ *
+ * The task's inputs are not here: they go through the shared
+ * `buildConnectorInputs`, which `check` already runs as `connectorInputs`.
+ */
+import type { ResolvedConnector } from '../core/library.js';
+/** Check's code for {@link externalDescriptorRefusal}. */
+export declare const EXTERNAL_TASK_DESCRIPTOR_CONTRACT = "EXTERNAL_TASK_DESCRIPTOR_CONTRACT";
+/**
+ * Why a resolved descriptor cannot back this external task, or `undefined`.
+ *
+ * An External Agent task needs an `AgentExecution` operation and an External
+ * Workflow task a `ProcessExecution` one: the service type the task emits
+ * (`Intsvc.SyncAgentExecution`, …) is chosen by the family, and a descriptor of
+ * the other kind (or a plain connector action) would run the wrong contract.
+ * Both need the operation's `uiPathActivityTypeId`, which the task emits as its
+ * `activity` context.
+ *
+ * @param kind - The task kind.
+ * @param rc - What `library.resolve` returned for the task's descriptor.
+ * @returns The refusal, or `undefined`.
+ */
+export declare function externalDescriptorRefusal(kind: 'external-agent' | 'external-workflow', rc: Pick<ResolvedConnector, 'nodeType' | 'version' | 'activityTypeId' | 'entry'>): string | undefined;

package/dist/case/external.js

@@ -0,0 +1,25 @@
+/** Check's code for {@link externalDescriptorRefusal}. */
+export const EXTERNAL_TASK_DESCRIPTOR_CONTRACT = 'EXTERNAL_TASK_DESCRIPTOR_CONTRACT';
+/**
+ * Why a resolved descriptor cannot back this external task, or `undefined`.
+ *
+ * An External Agent task needs an `AgentExecution` operation and an External
+ * Workflow task a `ProcessExecution` one: the service type the task emits
+ * (`Intsvc.SyncAgentExecution`, …) is chosen by the family, and a descriptor of
+ * the other kind (or a plain connector action) would run the wrong contract.
+ * Both need the operation's `uiPathActivityTypeId`, which the task emits as its
+ * `activity` context.
+ *
+ * @param kind - The task kind.
+ * @param rc - What `library.resolve` returned for the task's descriptor.
+ * @returns The refusal, or `undefined`.
+ */
+export function externalDescriptorRefusal(kind, rc) {
+    const op = rc.entry?.operation ?? {};
+    const expectedSubType = kind === 'external-agent' ? 'AgentExecution' : 'ProcessExecution';
+    if (op.subType !== expectedSubType)
+        return `${kind} task requires a ${expectedSubType} descriptor; resolved ${String(op.subType ?? 'no subtype')}.`;
+    if (!rc.activityTypeId)
+        return `${kind} task descriptor ${rc.nodeType}@${rc.version} has no uiPathActivityTypeId.`;
+    return undefined;
+}

package/dist/case/serialize.js

@@ -13,6 +13,7 @@ import { buildConnectorInputs, nestConnectorBody, transportHttpMethod } from '..
 import { EQUALS_EXPR_DIALECT } from '../core/connector-checks.js';
 import { resolveEventWhere } from '../core/lookups.js';
 import { resolveCaseSubscription } from './subscription.js';
+import { externalDescriptorRefusal } from './external.js';
 import { CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from './format-profile.js';
 import { resolveSchemaVersion } from '../schema-version.js';
 import { caseJsonPreservation, caseJsonPreservationErrors, } from './preserve.js';
@@ -1131,12 +1132,9 @@ function externalTaskData(kind, spec, resolver) {
     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 op = rc.entry.operation ?? {};
-    const expectedSubType = kind === 'external-agent' ? 'AgentExecution' : 'ProcessExecution';
-    if (op.subType !== expectedSubType)
-        throw new Error(`${kind} task requires a ${expectedSubType} descriptor; resolved ${String(op.subType ?? 'no subtype')}.`);
-    if (!rc.activityTypeId)
-        throw new Error(`${kind} task descriptor ${rc.nodeType}@${rc.version} has no uiPathActivityTypeId.`);
+    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 connection = bindingRef(resolver, spec.connector.connection, 'Connection', 'ConnectionId', `${rc.connectorKey} connection`);
@@ -1150,13 +1148,18 @@ function externalTaskData(kind, spec, resolver) {
         : (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 unknown = Object.keys(spec.connector.inputs).find((name) => !fields.has(name));
-    if (unknown)
-        throw new Error(`${kind} task has unknown input "${unknown}" for ${rc.nodeType}@${rc.version}.`);
-    const missing = rc.fields.find((field) => field.required && !(field.name in spec.connector.inputs));
-    if (missing)
-        throw new Error(`${kind} task is missing required input "${missing.name}".`);
+    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,
@@ -1172,7 +1175,7 @@ function externalTaskData(kind, spec, resolver) {
             id: name,
             name,
             type: jsonType(fields.get(name)?.type),
-            value,
+            value: name in resolved ? resolved[name] : value,
             target: name,
         })),
         outputs: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.18.4",
+  "version": "6.18.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": "35ff6e86b7aecb0b5c76663b6650a0924a8b7f6e"
+  "gitref": "714298df601bba1d5d278525ba354d670cec21aa"
 }