@uipath/maestro-builder-sdk 6.68.4 → 6.68.6

package/dist/case/serialize.js

@@ -19,7 +19,7 @@ import { bindingLabelRefusal } from '../core/binding-messages.js';
 import { resolveEventWhere } from '../core/lookups.js';
 import { resolveCaseSubscription } from './subscription.js';
 import { dedupeConditionNames } from './rule-names.js';
-import { EXTERNAL_TASK_DESCRIPTOR_CONTRACT, EXTERNAL_TASK_HYBRID_UNSUPPORTED, externalDescriptorRefusal, externalHybridRefusal, externalServiceType, isExternalExecutionMode, } from './external.js';
+import { EXTERNAL_TASK_DESCRIPTOR_CONTRACT, EXTERNAL_TASK_EVENT, externalDescriptorRefusal, externalEventRefusal, externalServiceType, isExternalExecutionMode, } from './external.js';
 import { CASE_FORMAT_PROFILE, CASE_SCHEMA_VERSIONS, caseVersionMismatch } from './format-profile.js';
 import { isResourceLabelRefusal, resolveResourceRef, resourceIdentity } from './resource-identity.js';
 import { ownEntry } from '../core/own-entry.js';
@@ -31,6 +31,7 @@ import { readEventFilterLeaf, eventFilterTreeLeaf } from '../core/event-filters.
 import { responseJsonSchema } from '../core/connector-response-schema.js';
 import { ruleShapeProblems } from './rule-options.js';
 import { CompileRefusal } from '../core/compile-refusal.js';
+import { implicitInArgBuiltTrigger, unboundInArgMessage } from './in-arg-binding.js';
 import { taskShapeProblems } from './task-shape.js';
 import { connectorPlaceholderData, isConnectorPlaceholder } from './connector-placeholder.js';
 /** The ids a serialize pass hashed from element ids, by the document it returned. */
@@ -258,7 +259,7 @@ export function serialize(built, opts = {}) {
     // outputs bound (collected during stage emission above). A declared var wins
     // on a name clash. An own-name output (`id == var`) writes no root entry: like
     // the Designer, the output row is itself the variable `=vars.<id>` reads.
-    const variables = emitVariables(built.vars, ids, triggerNodeByRef);
+    const variables = emitVariables(built.vars, ids, triggerNodeByRef, triggerNodes, built.triggers);
     const inputOutputs = variables.inputOutputs;
     const declared = new Set(inputOutputs.map((e) => e.id));
     for (const [name, companion] of resolver.varCompanions)
@@ -960,7 +961,8 @@ function reseed(value, ids) {
             value[key] = next;
     }
 }
-function emitVariables(vars, ids, triggerNodeByRef) {
+function emitVariables(vars, ids, triggerNodeByRef, triggerNodes, triggers) {
+    const implicit = implicitInArgBuiltTrigger(triggers);
     const inputs = [];
     const outputs = [];
     const inputOutputs = [];
@@ -1002,26 +1004,38 @@ function emitVariables(vars, ids, triggerNodeByRef) {
             id: slotId,
             name: vd.name,
             type: vd.type,
-            ...encodedDefault(vd),
+            // A trigger-bound In-arg always carries a default, `""` when none was
+            // authored. It is written here, ahead of a structured var's schema, so
+            // `{ type }` and `{ type, default: "" }` emit the same bytes and a
+            // decompile (which reads the `""` back) recompiles byte-identically.
+            ...(vd.direction === 'in' ? { default: encodedDefault(vd).default ?? '' } : encodedDefault(vd)),
+            ...jsonSchemaFields(vd),
         };
-        Object.assign(entry, jsonSchemaFields(vd));
-        if (vd.direction === 'in' && vd.sourceTrigger) {
-            // Trigger-bound In-arg: formal slot + companion + a bridge on the trigger
-            // node that copies the slot into the companion at fire (see the skill's
-            // variables/io-binding + global-vars § In argument). Its companion is keyed
-            // to the trigger node, so it does not also take a root companion.
-            const node = triggerNodeByRef.get(vd.sourceTrigger);
-            if (!node)
-                throw new CompileRefusal('CASE_IN_ARG_TRIGGER_NOT_ADDED', `In-arg "${vd.name}" is bound via { from } to a trigger that was not added with .trigger(...).`);
-            entry.default = vd.default === undefined ? '' : encodedDefault(vd).default;
+        if (vd.direction === 'in') {
+            // An In-arg is always trigger-bound: formal slot + companion + a bridge on
+            // the trigger node that copies the slot into the companion at fire (see the
+            // skill's variables/io-binding + global-vars § In argument). Its companion
+            // is keyed to the trigger node, so it does not also take a root companion.
+            // The Designer writes no other In-arg shape, and `uip maestro case validate
+            // --strict` refuses an In-arg without its companion
+            // (STRICT_INPUTOUTPUTS_COMPANION). Without `{ from }` the arg binds to the
+            // primary trigger (in-arg-binding.ts); when there is none it is refused
+            // (`check` reports the same code first).
+            let node;
+            if (vd.sourceTrigger) {
+                node = triggerNodeByRef.get(vd.sourceTrigger);
+                if (!node)
+                    throw new CompileRefusal('CASE_IN_ARG_TRIGGER_NOT_ADDED', `In-arg "${vd.name}" is bound via { from } to a trigger that was not added with .trigger(...).`);
+            }
+            else if (implicit !== undefined)
+                node = triggerNodes[implicit];
+            else
+                throw new CompileRefusal('CASE_IN_ARG_UNBOUND', unboundInArgMessage(vd.name, triggers));
             entry.elementId = node.id;
             inputs.push(entry);
             inputOutputs.push({ id: vd.name, name: vd.name, type: vd.type, elementId: node.id, ...jsonSchemaFields(vd) });
             appendTriggerBridge(node, { name: vd.name, type: vd.type, source: `=vars.${slotId}`, var: vd.name });
         }
-        else if (vd.direction === 'in') {
-            inputs.push(entry); // bare declaration (unbound In-arg; readable only via a trigger)
-        }
         else if (vd.direction === 'out') {
             outputs.push(entry); // formal declaration
             inputOutputs.push(readableCompanion(vd)); // …made readable as `vars.<name>`
@@ -1739,7 +1753,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, executionType) {
+function connectorTaskData(spec, resolver, elementId, where, executionType, event) {
     if (!resolver.library)
         throw new CompileRefusal('LIBRARY_REQUIRED', `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);
@@ -1787,7 +1801,7 @@ function connectorTaskData(spec, resolver, elementId, where, executionType) {
     // from the `body` slot. This used to drop the whole wire and push a filled
     // file part into the body, where the runtime does not look for it (#1420).
     const fileParts = (slots.multipartParameters ?? []).filter((part) => part.dataType.toLowerCase() === 'file');
-    context.push(io('metadata', 'json', { body: connectorMetadata(rc, op, slots, elementId, executionType) }));
+    context.push(io('metadata', 'json', { body: connectorMetadata(rc, op, slots, elementId, executionType, event) }));
     const inputs = [
         ioSlot('pathParameters', pathParameters, `${elementId}`),
         ioSlot('queryParameters', queryParameters, `${elementId}`),
@@ -1816,14 +1830,20 @@ function externalTaskData(kind, spec, resolver, elementId, where) {
         throw new CompileRefusal(EXTERNAL_TASK_DESCRIPTOR_CONTRACT, refused);
     if (!isExternalExecutionMode(spec.mode))
         throw new CompileRefusal('EXTERNAL_TASK_MODE', `${kind} task mode must be the connector object's executionType: "sync", "async" or "hybrid".`);
-    if (spec.mode === 'hybrid')
-        throw new CompileRefusal(EXTERNAL_TASK_HYBRID_UNSUPPORTED, externalHybridRefusal(where));
+    const eventRefused = externalEventRefusal(where, spec.mode, spec.event);
+    if (eventRefused)
+        throw new CompileRefusal(EXTERNAL_TASK_EVENT, eventRefused);
     if (!spec.connector.connection || !spec.connector.folder)
         throw new CompileRefusal(spec.connector.connection ? 'EXTERNAL_TASK_FOLDER' : 'EXTERNAL_TASK_CONNECTION', `${kind} task requires non-empty connection and folder binding names.`);
-    const data = connectorTaskData(spec.connector, resolver, elementId, where, spec.mode);
+    const data = connectorTaskData(spec.connector, resolver, elementId, where, spec.mode, spec.event);
     const context = data.context;
     const metadataAt = context.findIndex((row) => row.name === 'metadata');
-    context.splice(metadataAt, 0, io('executionType', 'string', { value: spec.mode }));
+    // The Designer's order: the event pair (when the object answers through one),
+    // then the execution type, just before `metadata`.
+    context.splice(metadataAt, 0, ...(spec.event ? [
+        io('operation', 'string', { value: spec.event.operation }),
+        io('eventMode', 'string', { value: spec.event.mode }),
+    ] : []), io('executionType', 'string', { value: spec.mode }));
     context.push(io('activityConfigurationVersion', 'string', { value: 'v2' }));
     return { ...data, serviceType: externalServiceType(kind, spec.mode) };
 }
@@ -1957,7 +1977,7 @@ function folderBindingRef(resolver, name, connection, site) {
  * Generic activity, and the library version where the platform writes
  * `packageVersion: "1.0.0"` (#1420).
  */
-function connectorMetadata(rc, op, slots, seed, executionType) {
+function connectorMetadata(rc, op, slots, seed, executionType, event) {
     // The part DECLARATIONS only: a file part's value rides on its `file` input.
     const multipartParameters = (slots.multipartParameters ?? []).map(({ name, dataType }) => ({ name, dataType }));
     // The configuration replays the authored values (a schema action's parent
@@ -1973,6 +1993,9 @@ function connectorMetadata(rc, op, slots, seed, executionType) {
             uiPathActivityTypeId: rc.activityTypeId ?? '',
             errorState: { issues: [] },
             ...(executionType ? { executionType } : {}),
+            // The event an async / hybrid object answers with, named as the Designer
+            // names it here (`eventType`, where the context row is `operation`).
+            ...(event ? { eventType: event.operation, eventMode: event.mode } : {}),
         },
         activityMetadata: {
             activity: {

package/dist/core/refusals.d.ts

@@ -151,6 +151,7 @@ export declare const REFUSALS: {
     readonly CASE_APP_DETAILS_TYPE: "lint";
     readonly CASE_EXPORT_NOT_BUILT: "lowering";
     readonly CASE_IN_ARG_TRIGGER_NOT_ADDED: "lowering";
+    readonly CASE_IN_ARG_UNBOUND: "lowering";
     readonly CASE_LAYOUT_NODE_MATCH: "lowering";
     readonly CASE_LAYOUT_UNKNOWN_FIELD: "lowering";
     readonly CASE_NO_DEFAULT_EXPORT: "lowering";
@@ -274,8 +275,8 @@ export declare const REFUSALS: {
     readonly EXTERNAL_TASK_DESCRIPTOR: "lint";
     readonly EXTERNAL_TASK_DESCRIPTOR_CONTRACT: "lowering";
     readonly EXTERNAL_TASK_EMPTY_DATA: "lint";
+    readonly EXTERNAL_TASK_EVENT: "lowering";
     readonly EXTERNAL_TASK_FOLDER: "lowering";
-    readonly EXTERNAL_TASK_HYBRID_UNSUPPORTED: "lowering";
     readonly EXTERNAL_TASK_MODE: "lowering";
     readonly EXTRACT_SCHEMA_SHAPE: "lint";
     readonly FAKE_JOIN: "lint";

package/dist/core/refusals.js

@@ -199,6 +199,7 @@ export const REFUSALS = {
     CASE_APP_DETAILS_TYPE: 'lint',
     CASE_EXPORT_NOT_BUILT: 'lowering',
     CASE_IN_ARG_TRIGGER_NOT_ADDED: 'lowering',
+    CASE_IN_ARG_UNBOUND: 'lowering',
     CASE_LAYOUT_NODE_MATCH: 'lowering',
     CASE_LAYOUT_UNKNOWN_FIELD: 'lowering',
     CASE_NO_DEFAULT_EXPORT: 'lowering',
@@ -325,8 +326,8 @@ export const REFUSALS = {
     EXTERNAL_TASK_DESCRIPTOR: 'lint',
     EXTERNAL_TASK_DESCRIPTOR_CONTRACT: 'lowering',
     EXTERNAL_TASK_EMPTY_DATA: 'lint',
+    EXTERNAL_TASK_EVENT: 'lowering',
     EXTERNAL_TASK_FOLDER: 'lowering',
-    EXTERNAL_TASK_HYBRID_UNSUPPORTED: 'lowering',
     EXTERNAL_TASK_MODE: 'lowering',
     EXTRACT_SCHEMA_SHAPE: 'lint',
     FAKE_JOIN: 'lint',

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export { Bindings } from './bindings.js';
 export { check } from './check.js';
 export type { Diagnostic } from './check.js';
 export { casePlan, preserveCaseJson, rule, when } from './case/case-sdk.js';
-export type { CaseRule, CaseRuleInput, CaseRuleGrid, WhenExpression, CaseJsonPreservation, CaseLayout, CaseNodeLayout, PreservedCaseNode, PreservedTaskFields, PreservedVariableLane, CaseRuleType, RuleOpts, BuiltCase, BuiltStage, BuiltTask, TaskKind, UnresolvedReferenceTaskKind, ExternalExecutionMode, ExternalTaskOptions, } from './case/case-sdk.js';
+export type { CaseRule, CaseRuleInput, CaseRuleGrid, WhenExpression, CaseJsonPreservation, CaseLayout, CaseNodeLayout, PreservedCaseNode, PreservedTaskFields, PreservedVariableLane, CaseRuleType, RuleOpts, BuiltCase, BuiltStage, BuiltTask, TaskKind, UnresolvedReferenceTaskKind, ExternalEventPair, ExternalExecutionMode, ExternalTaskOptions, } from './case/case-sdk.js';
 export { serialize as serializeCase } from './case/serialize.js';
 export { decompile as decompileCase, decompileWithDiagnostics as decompileCaseWithDiagnostics } from './case/decompile.js';
 export { bpmn } from './bpmn/bpmn-sdk.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.68.4",
+  "version": "6.68.6",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -100,5 +100,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "f879560df189ceab42f899123d36f0add5b0a562"
+  "gitref": "7e50034dc8a8317fe205d355859bc80f047174b3"
 }