@uipath/maestro-builder-sdk 6.18.3 → 6.18.5

package/dist/api-index.md

@@ -204,9 +204,9 @@ could hand you spans for a version you do not have.
 | `ran` | function | `dist/core/expr.d.ts:95-141` | Expressions and types | Did this step run? |
 | `rawNode` | function | `dist/core/node-classes.d.ts:180-242` | Supporting types | Place a node this SDK has no factory for, carrying its definition verbatim (`uipath.exotic.thing@2.1` and the manifest… |
 | `RawReference` | type | `dist/core/lookups.d.ts:190-198` | Supporting types |  |
-| `refuseLookupToken` | function | `dist/core/lookups.d.ts:207-223` | Generated descriptors | Refuse a lookup token where the family cannot resolve one. |
 | `RemoteA2aToolRef` | interface | `dist/core/actions.d.ts:1745-1765` | Supporting types | A remote A2A (agent-to-agent) endpoint the agent may delegate to. |
 | `resolvedValue` | function | `dist/core/lookups.d.ts:172-179` | Generated descriptors | The recorded id for a token, or `undefined`. |
+| `resolveEventWhere` | function | `dist/core/lookups.d.ts:207-224` | Generated descriptors | An event subscription's `where` with every lookup token swapped for the id `registry prepare --resolve` recorded, or a… |
 | `ReturnFieldType` | type | `dist/core/actions.d.ts:1317-1334` | Supporting types | A JSON-schema-ish type for one field of a step's declared `returns`. |
 | `ReturnOptions` | interface | `dist/flow-sdk.d.ts:397-428` | Option shapes | `.return(...)`-specific options. |
 | `rpaWorkflow` | function | `dist/core/actions.d.ts:2841-2885` | Actions | Invoke a deployed RPA (robotic process automation) workflow — a classic UI-automation process, published to… |

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

@@ -3,6 +3,8 @@ import { authoredCaseVersion, CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS } from '
 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
@@ -269,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.
@@ -288,6 +293,9 @@ function checkLibraryConnectors(built, opts, diags) {
         const refused = opts.subscriptionError?.(kind, sub);
         if (refused !== undefined)
             diags.push({ level: 'error', code: refused.code, message: `${where}: ${refused.message}`, where: at });
+        // A `where` lookup nobody recorded: Flow's LOOKUP_UNRESOLVED warning, from the
+        // shared event rules. Only `resolutions` is passed, so nothing else in them fires.
+        checkEventResolution(sub, where, kind, { resolutions: opts.resolutions ?? {} }, (code, message) => diags.push({ level: 'error', code, message, where: at }), (code, message) => diags.push({ level: 'warning', code, message, where: at }));
     };
     const rules = (conditions, where) => {
         for (const c of conditions)
@@ -317,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

@@ -11,8 +11,9 @@
 import { IdGen } from './ids.js';
 import { buildConnectorInputs, nestConnectorBody, transportHttpMethod } from '../core/connector-inputs.js';
 import { EQUALS_EXPR_DIALECT } from '../core/connector-checks.js';
-import { refuseLookupToken } from '../core/lookups.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';
@@ -902,16 +903,13 @@ function resolvedSubscriptionBag(kind, spec, resolver, elementId) {
     return {
         serviceType: kind === 'trigger' ? CASE_FORMAT_PROFILE.eventServiceType : CASE_FORMAT_PROFILE.waitConnectorServiceType,
         context,
-        inputs: [eventInput(spec.where ?? {}, elementId)],
+        inputs: [eventInput(resolveEventWhere(spec.where, resolver.library.lookupResolutions, `${kind === 'trigger' ? 'event trigger' : 'wait-for-connector'} "${elementId}"`), elementId)],
         outputs: connectorOutputs(rc, elementId, resolver),
         bindings: [],
     };
 }
+/** The subscription's `body` input; `where` has its lookups already resolved (`resolveEventWhere`). */
 function eventInput(where, elementId) {
-    // Case compile does not read resolutions.json (Flow does); a token here
-    // would be emitted raw where the connector expects an id.
-    for (const [field, value] of Object.entries(where))
-        refuseLookupToken(value, 'case', field);
     return Object.keys(where).length
         ? { name: 'body', type: 'json', target: 'body', body: { queryParams: where }, var: 'vbody', id: 'vbody', elementId }
         : { name: 'body', type: 'json', target: 'body', value: '', var: 'vbody', id: 'vbody', elementId };
@@ -1134,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`);
@@ -1153,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,
@@ -1175,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/dist/core/lookups.d.ts

@@ -205,20 +205,21 @@ type RawReference = {
  */
 export declare function lookupSpecOf(reference: RawReference, invariant?: ReadonlySet<string>): LookupSpec | undefined;
 /**
- * Refuse a lookup token where the family cannot resolve one.
- *
- * Connector-activity inputs resolve their lookups in every family through
- * `buildConnectorInputs` (`core/connector-inputs.ts`), which reads
- * `connectors-local/resolutions.json`. This guard is for the sites that do not
- * go through it yet: a Case event subscription's `where`, whose values Case
- * copies into its emitted payload verbatim. A token reaching one would be
- * embedded as `{"__lookup": {…}}` where the connector expects an id, which is
- * silent wrongness, so it is refused instead.
- *
- * @param value - A connector input value.
- * @param family - The authoring family, for the message.
- * @param field - The input name, for the message.
- * @throws If `value` is an unresolved {@link LookupToken}.
+ * An event subscription's `where` with every lookup token swapped for the id
+ * `registry prepare --resolve` recorded, or a throw naming the first one nobody
+ * recorded.
+ *
+ * The id is looked up under the token's own node type, which for an event
+ * lookup is the EVENT form `prepare` stores it under. Emitting a placeholder for
+ * a value nobody resolved would subscribe the trigger to the wrong folder,
+ * channel or queue, so an unrecorded token is refused, never passed through.
+ * Shared by Flow's and Case's serializers, so both resolve and refuse alike.
+ *
+ * @param where - The authored `where`.
+ * @param resolutions - The library's recorded resolutions (`library.lookupResolutions`).
+ * @param site - How the caller names the subscription, prefixed to the refusal.
+ * @returns The `where` with ids in place of tokens.
+ * @throws If a token has no recorded resolution.
  */
-export declare function refuseLookupToken(value: unknown, family: string, field: string): void;
+export declare function resolveEventWhere(where: Record<string, unknown> | undefined, resolutions: LookupResolutions, site: string): Record<string, unknown>;
 export {};

package/dist/core/lookups.js

@@ -259,30 +259,33 @@ function byAlias(lookupName) {
     return 'by' + words.map((w) => w[0].toUpperCase() + w.slice(1)).join('');
 }
 /**
- * Refuse a lookup token where the family cannot resolve one.
+ * An event subscription's `where` with every lookup token swapped for the id
+ * `registry prepare --resolve` recorded, or a throw naming the first one nobody
+ * recorded.
  *
- * Connector-activity inputs resolve their lookups in every family through
- * `buildConnectorInputs` (`core/connector-inputs.ts`), which reads
- * `connectors-local/resolutions.json`. This guard is for the sites that do not
- * go through it yet: a Case event subscription's `where`, whose values Case
- * copies into its emitted payload verbatim. A token reaching one would be
- * embedded as `{"__lookup": {…}}` where the connector expects an id, which is
- * silent wrongness, so it is refused instead.
+ * The id is looked up under the token's own node type, which for an event
+ * lookup is the EVENT form `prepare` stores it under. Emitting a placeholder for
+ * a value nobody resolved would subscribe the trigger to the wrong folder,
+ * channel or queue, so an unrecorded token is refused, never passed through.
+ * Shared by Flow's and Case's serializers, so both resolve and refuse alike.
  *
- * @param value - A connector input value.
- * @param family - The authoring family, for the message.
- * @param field - The input name, for the message.
- * @throws If `value` is an unresolved {@link LookupToken}.
+ * @param where - The authored `where`.
+ * @param resolutions - The library's recorded resolutions (`library.lookupResolutions`).
+ * @param site - How the caller names the subscription, prefixed to the refusal.
+ * @returns The `where` with ids in place of tokens.
+ * @throws If a token has no recorded resolution.
  */
-export function refuseLookupToken(value, family, field) {
-    if (!isLookupToken(value))
-        return;
-    const { nodeType, by, value: wanted } = value.__lookup;
-    throw new Error(`${family}: input "${field}" is a lookup(), which ${family} cannot resolve — ` +
-        `only Flow reads connectors-local/resolutions.json today, so this would be ` +
-        `emitted as a raw token where the connector expects an id.\n` +
-        `Resolve it first and pass the value:\n` +
-        `  ${prepareCommand()} ${nodeType.replace(/^uipath\.connector\.(?:trigger\.|event\.)?/, '').replace(/\.([^.]+)$/, ' --action $1')} \\\n` +
-        `    --resolve ${field}:${by}=${String(wanted)}\n` +
-        `then read the id out of connectors-local/resolutions.json.`);
+export function resolveEventWhere(where, resolutions, site) {
+    const out = {};
+    for (const [key, value] of Object.entries(where ?? {})) {
+        if (!isLookupToken(value)) {
+            out[key] = value;
+            continue;
+        }
+        const resolved = resolvedValue(value, resolutions);
+        if (resolved === undefined)
+            throw new Error(`${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
+        out[key] = resolved;
+    }
+    return out;
 }

package/dist/serialize.js

@@ -44,7 +44,7 @@ export function connectorInputErrors(rc, inputs, resolutions = {}, lookups = {})
         render: (value) => renderDeep(value, NO_RENAME),
     });
 }
-import { isLookupToken, resolvedValue, unresolvedLookupMessage, } from './core/lookups.js';
+import { isLookupToken, resolveEventWhere, } from './core/lookups.js';
 import { declaredScriptShape, inferScriptShape } from './core/script-return.js';
 import { migrateToSchemaVersion } from './migrate.js';
 import { FLOW_SCHEMA_VERSIONS } from './format-profile.js';
@@ -4127,19 +4127,7 @@ function eventDetail(rc, sub, nodeId, opts, site) {
     // `prepare --resolve` stored under the EVENT-form node type — or refused.
     // Same rule as connector inputs: emitting a placeholder for a value nobody
     // resolved would subscribe the trigger to the wrong folder/channel/queue.
-    const eventResolutions = opts.library?.lookupResolutions ?? {};
-    const where = {};
-    for (const [k, v] of Object.entries(sub.where ?? {})) {
-        if (!isLookupToken(v)) {
-            where[k] = v;
-            continue;
-        }
-        const resolved = resolvedValue(v, eventResolutions);
-        if (resolved === undefined) {
-            throw new Error(`event node "${nodeId}": \`where.${k}\` ` + unresolvedLookupMessage(v));
-        }
-        where[k] = resolved;
-    }
+    const where = resolveEventWhere(sub.where, opts.library?.lookupResolutions ?? {}, `event node "${nodeId}"`);
     // A subscription's parameters do not all travel in the same slot. The
     // connector declares which, and the library bakes it per field as `bucket`:
     // measured against designer-authored triggers, Jira's `project`/`issuetype`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.18.3",
+  "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": "e2e0a41da39b08bb97a105483f436232f0e36c2e"
+  "gitref": "714298df601bba1d5d278525ba354d670cec21aa"
 }