@uipath/packager-tool-bpmn 1.201.0 → 1.202.0-preview.136

package/dist/bpmn-tool.d.ts

@@ -6,9 +6,11 @@ import { type IFileSystem, type IToolLogger, ProjectTool, ToolResult } from "@ui
 export declare class BpmnTool extends ProjectTool {
     private readonly _temporaryStorage;
     private readonly _validateService;
+    private readonly _packValidateService;
     constructor(fileSystem: IFileSystem, logger: IToolLogger);
     restoreAsync(_options: IProjectRestoreOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
     validateAsync(options: IProjectValidateOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
+    private runValidation;
     buildAsync(options: IProjectBuildOptions, _cancellationToken?: AbortSignal): Promise<ToolResult>;
     packAsync(options: IProjectPackOptions, cancellationToken?: AbortSignal): Promise<ToolResult>;
     dispose(): Promise<void>;

package/dist/index.js

@@ -17,19 +17,19 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 // ../../maestro-sdk/dist/bpmn-packaging/index.js
 var exports_bpmn_packaging = {};
 __export(exports_bpmn_packaging, {
-  required: () => required,
-  parseOptionalJson: () => parseOptionalJson,
-  parseJson: () => parseJson,
-  parseBpmnProcesses: () => parseBpmnProcesses,
-  isJsonObject: () => isJsonObject,
-  formatBpmnPackageFile: () => formatBpmnPackageFile,
-  extensionValues: () => extensionValues,
-  entryPointDisplayName: () => entryPointDisplayName,
-  deriveBpmnEntryPoints: () => deriveBpmnEntryPoints,
-  childNodes: () => childNodes,
-  buildConnectionResources: () => buildConnectionResources,
+  BPMN_PACKAGE_FILES: () => BPMN_PACKAGE_FILES,
   buildBpmnPackageMetadata: () => buildBpmnPackageMetadata,
-  BPMN_PACKAGE_FILES: () => BPMN_PACKAGE_FILES
+  buildConnectionResources: () => buildConnectionResources,
+  childNodes: () => childNodes,
+  deriveBpmnEntryPoints: () => deriveBpmnEntryPoints,
+  entryPointDisplayName: () => entryPointDisplayName,
+  extensionValues: () => extensionValues,
+  formatBpmnPackageFile: () => formatBpmnPackageFile,
+  isJsonObject: () => isJsonObject,
+  parseBpmnProcesses: () => parseBpmnProcesses,
+  parseJson: () => parseJson,
+  parseOptionalJson: () => parseOptionalJson,
+  required: () => required
 });
 function isGuid2(value) {
   return GUID_REGEX2.test(value);
@@ -57,26 +57,34 @@ function buildConnectionResources(processes, existingResources) {
     const connectionBindings = childNodes(extensionValues(process).find((node) => node.$type === "uipath:bindings")).filter((node) => node.$type === "uipath:binding" && node.resource === "Connection" && node.propertyAttribute === "ConnectionId").map(toConnectionBinding);
     const bindingById = new Map(connectionBindings.map((binding) => [binding.id, binding]));
     for (const element of allFlowElements(process)) {
-      const activity = extensionValues(element).find((node) => node.$type === "uipath:activity");
-      const type = childNodes(activity).find((node) => node.$type === "uipath:type");
-      if (type?.value !== "Intsvc.ActivityExecution") {
+      const payload = extensionValues(element).find((node) => node.$type === "uipath:activity" || node.$type === "uipath:event");
+      const extensionType = childNodes(payload).find((node) => node.$type === "uipath:type")?.value;
+      if (extensionType === undefined || !CONNECTION_CONNECTOR_TYPES.has(extensionType)) {
         continue;
       }
-      const context = childNodes(activity).find((node) => node.$type === "uipath:context");
-      const values = new Map(childNodes(context).filter((node) => node.$type === "uipath:input" && node.name).map((node) => [
+      const context = childNodes(payload).find((node) => node.$type === "uipath:context");
+      const values = new Map([...childNodes(context), ...childNodes(payload)].filter((node) => node.$type === "uipath:input" && node.name).map((node) => [
         node.name,
         node.value ?? node.$body
       ]));
-      if (!isIntsvcActivityExecutionV12(values.get("activityConfigurationVersion"), workflowActivityConfigurationVersion)) {
+      if (extensionType === "Intsvc.ActivityExecution" && !isIntsvcActivityExecutionV12(values.get("activityConfigurationVersion"), workflowActivityConfigurationVersion)) {
         continue;
       }
-      const activityId = required(element.id, "Integration Service activity id");
+      const connectionRef = [
+        values.get("connection"),
+        values.get("connectionId")
+      ].find((value) => value?.trim());
+      if (connectionRef === undefined && extensionType !== "Intsvc.ActivityExecution") {
+        continue;
+      }
+      const nodeLabel = extensionType === "Intsvc.EventTrigger" ? "Trigger" : extensionType === "Intsvc.WaitForEvent" ? "Wait" : "Activity";
+      const activityId = required(element.id, `Integration Service ${nodeLabel.toLowerCase()} id`);
       const activityDisplayName = element.name?.trim() || activityId;
-      const connector = required(values.get("connectorKey"), `Activity "${activityDisplayName}" connectorKey`);
-      const bindingId = bindingReference(values.get("connection"), activityDisplayName);
+      const connector = required(values.get("connectorKey"), `${nodeLabel} "${activityDisplayName}" connectorKey`);
+      const bindingId = bindingReference(connectionRef, activityDisplayName, nodeLabel);
       const binding = bindingById.get(bindingId);
       if (!binding) {
-        throw new Error(`Activity "${activityDisplayName}" references missing Connection binding "${bindingId}".`);
+        throw new Error(`${nodeLabel} "${activityDisplayName}" references missing Connection binding "${bindingId}".`);
       }
       const current = connectionResource({
         activityId,
@@ -87,7 +95,7 @@ function buildConnectionResources(processes, existingResources) {
       const prior = generated.get(binding.resourceKey);
       if (prior) {
         if (prior.metadata.Connector !== connector || prior.value.ConnectionId.defaultValue !== binding.connectionId) {
-          throw new Error(`Connection resource "${binding.resourceKey}" is used by Integration Service activities with different connectors or connections.`);
+          throw new Error(`Connection resource "${binding.resourceKey}" is used by Integration Service nodes with different connectors or connections.`);
         }
         continue;
       }
@@ -146,10 +154,10 @@ function allFlowElements(element) {
   }
   return result;
 }
-function bindingReference(value, activity) {
+function bindingReference(value, nodeName, nodeLabel) {
   const match = /^=bindings\.([A-Za-z_][\w.-]*)$/.exec(value ?? "");
   if (!match) {
-    throw new Error(`Activity "${activity}" connection must reference a root binding as "=bindings.<id>".`);
+    throw new Error(`${nodeLabel} "${nodeName}" connection must reference a root binding as "=bindings.<id>".`);
   }
   return match[1];
 }
@@ -1451,7 +1459,7 @@ function parseJson(raw, label) {
   }
   return value;
 }
-var GUID_REGEX2, bpmn_spec_default2, BPMN_SPEC2, STATIC_UIPATH_EXTENSION_TAG_NAMES2, SUPPORTED_UIPATH_EXTENSION_TAG_NAMES2, SUPPORTED_UIPATH_EXTENSION_TAGS2, KNOWN_UIPATH_TAGS2, ACTIVITY_CONFIGURATION_V12 = "v1", nativeToString, nativeHasOwnProperty, BUILTINS, TYPE_CONVERTERS, fromCharCode, hasOwnProperty, ENTITY_PATTERN, ENTITY_MAPPING, NON_WHITESPACE_OUTSIDE_ROOT_NODE = "non-whitespace outside of root node", DEFAULT_NS_MAP, SERIALIZE_PROPERTY = "property", XML_PREAMBLE = `<?xml version="1.0" encoding="UTF-8"?>
+var GUID_REGEX2, bpmn_spec_default2, BPMN_SPEC2, STATIC_UIPATH_EXTENSION_TAG_NAMES2, SUPPORTED_UIPATH_EXTENSION_TAG_NAMES2, SUPPORTED_UIPATH_EXTENSION_TAGS2, KNOWN_UIPATH_TAGS2, CALL_ACTIVITY_TYPES2, CALL_ACTIVITY_PAYLOAD_TAGS2, ACTIVITY_CONFIGURATION_V12 = "v1", FREE_TEXT_ELEMENTS2, CONNECTION_CONNECTOR_TYPES, nativeToString, nativeHasOwnProperty, BUILTINS, TYPE_CONVERTERS, fromCharCode, hasOwnProperty, ENTITY_PATTERN, ENTITY_MAPPING, NON_WHITESPACE_OUTSIDE_ROOT_NODE = "non-whitespace outside of root node", DEFAULT_NS_MAP, SERIALIZE_PROPERTY = "property", XML_PREAMBLE = `<?xml version="1.0" encoding="UTF-8"?>
 `, ESCAPE_ATTR_CHARS, ESCAPE_CHARS, ESCAPE_ATTR_MAP, ESCAPE_MAP, name$5 = "BPMN20", uri$5 = "http://www.omg.org/spec/BPMN/20100524/MODEL", prefix$5 = "bpmn", associations$5, types$5, enumerations$3, xml$1, BpmnPackage, name$4 = "BPMNDI", uri$4 = "http://www.omg.org/spec/BPMN/20100524/DI", prefix$4 = "bpmndi", types$4, enumerations$2, associations$4, BpmnDiPackage, name$3 = "DC", uri$3 = "http://www.omg.org/spec/DD/20100524/DC", prefix$3 = "dc", types$3, associations$3, DcPackage, name$2 = "DI", uri$2 = "http://www.omg.org/spec/DD/20100524/DI", prefix$2 = "di", types$2, associations$2, xml, DiPackage, name$1 = "bpmn.io colors for BPMN", uri$1 = "http://bpmn.io/schema/bpmn/biocolor/1.0", prefix$1 = "bioc", types$1, enumerations$1, associations$1, BiocPackage, name = "BPMN in Color", uri = "http://www.omg.org/spec/BPMN/non-normative/color/1.0", prefix = "color", types, enumerations, associations, BpmnInColorPackage, packages, BPMN_PACKAGE_FILES, SCHEMA_ANNOTATIONS;
 var init_bpmn_packaging = __esm(() => {
   GUID_REGEX2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -2237,6 +2245,15 @@ var init_bpmn_packaging = __esm(() => {
   <bpmn:extensionElements>
     <uipath:event version="v1">
       <uipath:type value="Intsvc.WaitForEvent" version="v1" />
+      <uipath:context>
+        <uipath:input name="connectorKey" type="string" value="{connectorKey}" />
+        <uipath:input name="connectionId" type="string" value="=bindings.{connectionBindingId}" />
+        <uipath:input name="folderId" type="string" value="{folderId}" />
+        <uipath:input name="folderPath" type="string" value="{folderPath}" />
+        <uipath:input name="folderKey" type="string" value="{folderKey}" />
+        <uipath:input name="operation" type="string" value="{operation}" />
+        <uipath:input name="objectName" type="string" value="{objectName}" />
+      </uipath:context>
       <uipath:output name="result" type="custom" source="." var="{varId}" />
     </uipath:event>
   </bpmn:extensionElements>
@@ -2257,7 +2274,12 @@ var init_bpmn_packaging = __esm(() => {
             isPrimaryKey: false,
             binding: true,
             defaultValue: null,
-            description: "Connection ID for the IS connector (bindable)"
+            description: "Connection ID for the IS connector (bindable)",
+            bindingInfo: {
+              resource: "Connection",
+              resourceKeyPattern: "${resourceKey}",
+              propertyAttribute: "ConnectionId"
+            }
           },
           {
             name: "connectorKey",
@@ -2375,6 +2397,15 @@ var init_bpmn_packaging = __esm(() => {
   <bpmn:extensionElements>
     <uipath:event version="v1">
       <uipath:type value="Intsvc.EventTrigger" version="v1" />
+      <uipath:context>
+        <uipath:input name="connectorKey" type="string" value="{connectorKey}" />
+        <uipath:input name="connectionId" type="string" value="=bindings.{connectionBindingId}" />
+        <uipath:input name="folderId" type="string" value="{folderId}" />
+        <uipath:input name="folderPath" type="string" value="{folderPath}" />
+        <uipath:input name="folderKey" type="string" value="{folderKey}" />
+        <uipath:input name="operation" type="string" value="{operation}" />
+        <uipath:input name="objectName" type="string" value="{objectName}" />
+      </uipath:context>
       <uipath:output name="result" type="custom" source="." var="{varId}" />
     </uipath:event>
   </bpmn:extensionElements>
@@ -2396,7 +2427,12 @@ var init_bpmn_packaging = __esm(() => {
             isPrimaryKey: false,
             binding: true,
             defaultValue: null,
-            description: "Connection ID for the IS connector (bindable)"
+            description: "Connection ID for the IS connector (bindable)",
+            bindingInfo: {
+              resource: "Connection",
+              resourceKeyPattern: "${resourceKey}",
+              propertyAttribute: "ConnectionId"
+            }
           },
           {
             name: "connectorKey",
@@ -4455,6 +4491,14 @@ var init_bpmn_packaging = __esm(() => {
   ].sort());
   SUPPORTED_UIPATH_EXTENSION_TAGS2 = Object.freeze(SUPPORTED_UIPATH_EXTENSION_TAG_NAMES2.map((tag) => `uipath:${tag}`));
   KNOWN_UIPATH_TAGS2 = new Set(SUPPORTED_UIPATH_EXTENSION_TAGS2);
+  CALL_ACTIVITY_TYPES2 = Object.entries(BPMN_SPEC2.extensionTypes).filter(([, contract]) => contract.bpmnElement === "bpmn:CallActivity").map(([type]) => type).sort((a, b) => a.localeCompare(b));
+  CALL_ACTIVITY_PAYLOAD_TAGS2 = new Set(Object.values(BPMN_SPEC2.extensionTypes).filter((contract) => contract.bpmnElement === "bpmn:CallActivity").map((contract) => contract.extensionTag).filter((tag) => typeof tag === "string"));
+  FREE_TEXT_ELEMENTS2 = new Set(["documentation", "text"]);
+  CONNECTION_CONNECTOR_TYPES = new Set([
+    "Intsvc.ActivityExecution",
+    "Intsvc.EventTrigger",
+    "Intsvc.WaitForEvent"
+  ]);
   nativeToString = Object.prototype.toString;
   nativeHasOwnProperty = Object.prototype.hasOwnProperty;
   Base.prototype.get = function(name) {
@@ -9304,6 +9348,14 @@ import {
 
 // ../../maestro-sdk/dist/bpmn-validation/project-validator.js
 var {createRequire} = (() => ({}));
+var __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+function isGuid(value) {
+  return GUID_REGEX.test(value);
+}
+var GUID_REGEX;
+var init_guid = __esm2(() => {
+  GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+});
 var bpmn_spec_default = {
   version: "1.0.0",
   source: "PO.Frontend registry generator (2026-04-14) + CLI notes",
@@ -10086,6 +10138,15 @@ var bpmn_spec_default = {
   <bpmn:extensionElements>
     <uipath:event version="v1">
       <uipath:type value="Intsvc.WaitForEvent" version="v1" />
+      <uipath:context>
+        <uipath:input name="connectorKey" type="string" value="{connectorKey}" />
+        <uipath:input name="connectionId" type="string" value="=bindings.{connectionBindingId}" />
+        <uipath:input name="folderId" type="string" value="{folderId}" />
+        <uipath:input name="folderPath" type="string" value="{folderPath}" />
+        <uipath:input name="folderKey" type="string" value="{folderKey}" />
+        <uipath:input name="operation" type="string" value="{operation}" />
+        <uipath:input name="objectName" type="string" value="{objectName}" />
+      </uipath:context>
       <uipath:output name="result" type="custom" source="." var="{varId}" />
     </uipath:event>
   </bpmn:extensionElements>
@@ -10106,7 +10167,12 @@ var bpmn_spec_default = {
           isPrimaryKey: false,
           binding: true,
           defaultValue: null,
-          description: "Connection ID for the IS connector (bindable)"
+          description: "Connection ID for the IS connector (bindable)",
+          bindingInfo: {
+            resource: "Connection",
+            resourceKeyPattern: "${resourceKey}",
+            propertyAttribute: "ConnectionId"
+          }
         },
         {
           name: "connectorKey",
@@ -10224,6 +10290,15 @@ var bpmn_spec_default = {
   <bpmn:extensionElements>
     <uipath:event version="v1">
       <uipath:type value="Intsvc.EventTrigger" version="v1" />
+      <uipath:context>
+        <uipath:input name="connectorKey" type="string" value="{connectorKey}" />
+        <uipath:input name="connectionId" type="string" value="=bindings.{connectionBindingId}" />
+        <uipath:input name="folderId" type="string" value="{folderId}" />
+        <uipath:input name="folderPath" type="string" value="{folderPath}" />
+        <uipath:input name="folderKey" type="string" value="{folderKey}" />
+        <uipath:input name="operation" type="string" value="{operation}" />
+        <uipath:input name="objectName" type="string" value="{objectName}" />
+      </uipath:context>
       <uipath:output name="result" type="custom" source="." var="{varId}" />
     </uipath:event>
   </bpmn:extensionElements>
@@ -10245,7 +10320,12 @@ var bpmn_spec_default = {
           isPrimaryKey: false,
           binding: true,
           defaultValue: null,
-          description: "Connection ID for the IS connector (bindable)"
+          description: "Connection ID for the IS connector (bindable)",
+          bindingInfo: {
+            resource: "Connection",
+            resourceKeyPattern: "${resourceKey}",
+            propertyAttribute: "ConnectionId"
+          }
         },
         {
           name: "connectorKey",
@@ -12303,11 +12383,10 @@ var SUPPORTED_UIPATH_EXTENSION_TAG_NAMES = Object.freeze([
   ])
 ].sort());
 var SUPPORTED_UIPATH_EXTENSION_TAGS = Object.freeze(SUPPORTED_UIPATH_EXTENSION_TAG_NAMES.map((tag) => `uipath:${tag}`));
-var GUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isGuid(value) {
-  return GUID_REGEX.test(value);
-}
+init_guid();
 var KNOWN_UIPATH_TAGS = new Set(SUPPORTED_UIPATH_EXTENSION_TAGS);
+var CALL_ACTIVITY_TYPES = Object.entries(BPMN_SPEC.extensionTypes).filter(([, contract]) => contract.bpmnElement === "bpmn:CallActivity").map(([type]) => type).sort((a, b) => a.localeCompare(b));
+var CALL_ACTIVITY_PAYLOAD_TAGS = new Set(Object.values(BPMN_SPEC.extensionTypes).filter((contract) => contract.bpmnElement === "bpmn:CallActivity").map((contract) => contract.extensionTag).filter((tag) => typeof tag === "string"));
 var SEMANTIC_VALIDATION_ERROR = "BPMN_VALIDATION_ERROR";
 var BPMN_MODEL_NAMESPACE = "http://www.omg.org/spec/BPMN/20100524/MODEL";
 var ACTIVITY_CONFIGURATION_VERSION = "activityConfigurationVersion";
@@ -12420,6 +12499,84 @@ class BpmnValidateService {
     const availableBindings = new Map(bindings);
     collectInlineBindings(definitions, availableBindings);
     this.validateUiPathTags(file, definitions, availableBindings, diagnostics);
+    this.validateUnassignedVariables(file, definitions, diagnostics);
+    this.validateCallActivityReferences(file, definitions, diagnostics);
+  }
+  validateUnassignedVariables(file, definitions, diagnostics) {
+    for (const process of findChildren(definitions, (node) => hasLocalName(node, "process"))) {
+      this.reportUnassignedVariables(file, process, diagnostics);
+    }
+  }
+  reportUnassignedVariables(file, process, diagnostics) {
+    const startEventIds = new Set(findChildren(process, (node) => hasLocalName(node, "startEvent")).filter(isManualStartEvent).map((node) => node.attributes.id).filter((id) => Boolean(id)));
+    const declaredById = new Map;
+    for (const block of findDescendants(process, (node) => hasLocalName(node, "variables"))) {
+      for (const decl of block.children) {
+        const declKind = getLocalName(decl.name);
+        if (declKind !== "input" && declKind !== "inputoutput" && declKind !== "output") {
+          continue;
+        }
+        const id = decl.attributes.id;
+        if (!id) {
+          continue;
+        }
+        const elementId = decl.attributes.elementId?.trim() ?? "";
+        const callerCanSupply = declKind === "input" && !!decl.attributes.name?.trim() && startEventIds.has(elementId);
+        declaredById.set(id, {
+          hasValueSource: !!decl.attributes.default?.trim() || callerCanSupply,
+          declKind,
+          element: describeElement(decl)
+        });
+      }
+    }
+    if (declaredById.size === 0) {
+      return;
+    }
+    const assigned = new Set;
+    for (const output of findDescendants(process, (node) => hasLocalName(node, "output"))) {
+      const target = output.attributes.var;
+      const isDeclaration = output.parent !== undefined && hasLocalName(output.parent, "variables");
+      if (target && !isDeclaration) {
+        assigned.add(target);
+      }
+    }
+    for (const id of collectVariableReads(process)) {
+      const declared = declaredById.get(id);
+      if (!declared || declared.hasValueSource || assigned.has(id)) {
+        continue;
+      }
+      diagnostics.push({
+        file,
+        element: declared.element,
+        message: `Variable "vars.${id}" is read but never assigned; it will be empty at run time.`,
+        instruction: declared.declKind === "input" ? "Give the variable a default, assign it through a uipath:output mapping, or bind it to an entry-point start event by giving it both a name and an elementId." : "Give the variable a default, or assign it through a uipath:output mapping before it is read.",
+        severity: "warning"
+      });
+    }
+  }
+  validateCallActivityReferences(file, definitions, diagnostics) {
+    for (const callActivity of findDescendants(definitions, (node) => hasLocalName(node, "callActivity"))) {
+      const hasUiPathPayload = findDescendants(callActivity, (node) => CALL_ACTIVITY_PAYLOAD_TAGS.has(node.name)).length > 0;
+      const calledElement = callActivity.attributes.calledElement?.trim() ?? "";
+      if (!hasUiPathPayload) {
+        diagnostics.push({
+          file,
+          element: describeElement(callActivity),
+          message: "Call activity has no uipath:activity payload, so it invokes nothing at run time.",
+          instruction: `Add a payload naming one of the call-activity types (${CALL_ACTIVITY_TYPES.join(", ")}), with a process resource binding.`
+        });
+        continue;
+      }
+      if (calledElement) {
+        diagnostics.push({
+          file,
+          element: describeElement(callActivity),
+          message: `Call activity attribute calledElement="${calledElement}" is ignored; the invoked process comes from the uipath:activity payload and its process binding.`,
+          instruction: "Remove calledElement, or ensure the uipath:activity payload names the process you intend to invoke.",
+          severity: "warning"
+        });
+      }
+    }
   }
   validateRootEntryPointIds(file, process, diagnostics) {
     const rootStartEvents = findChildren(process, (node) => hasLocalName(node, "startEvent"));
@@ -12522,12 +12679,13 @@ class BpmnValidateService {
     }
     const contract = BPMN_SPEC.extensionTypes[extensionType];
     if (!contract) {
+      const severity = this.options.unsupportedExtensionTypeSeverity ?? "warning";
       diagnostics.push({
         file,
         element: describeElement(typeNode ?? payload),
         message: `Unsupported UiPath extension type "${extensionType}".`,
-        instruction: "Use an extension type present in the UiPath BPMN contract, or update the contract before packaging this project.",
-        severity: "warning"
+        instruction: severity === "error" ? `"${extensionType}" is not in this CLI's BPMN contract, so Orchestrator will reject the package at deploy (Error 1654). Use a supported extension type, remove the node, or upgrade the CLI to a version whose contract includes it.` : "Use an extension type present in the UiPath BPMN contract, or update the contract before packaging this project.",
+        severity
       });
       return;
     }
@@ -12540,6 +12698,9 @@ class BpmnValidateService {
     if (contract.extensionType === "Orchestrator.StartAgentJob") {
       this.validateStartAgentJobBindings(file, payload, owner, bindings, diagnostics);
     }
+    if (contract.extensionType === "Intsvc.EventTrigger" || contract.extensionType === "Intsvc.WaitForEvent") {
+      this.validateTriggerConnectionBinding(file, payload, owner, bindings, contract.extensionType === "Intsvc.WaitForEvent" ? "wait" : "trigger", diagnostics);
+    }
     this.validateInputs(file, payload, owner, contract, diagnostics);
     this.validateOutput(file, payload, owner, contract, diagnostics);
     this.validateBindingReferences(file, payload, bindings, diagnostics);
@@ -12613,23 +12774,44 @@ class BpmnValidateService {
     }
   }
   validateActivityExecutionV1Bindings(file, payload, owner, bindings, diagnostics) {
-    const contextByName = new Map(getContextInputs(payload).map((input) => [
-      input.attributes.name,
-      input
-    ]));
-    const bindingFields = [
+    const resourceKeys = this.validateConnectionBindings(file, payload, owner, bindings, diagnostics, "activity", [
+      {
+        contextName: "connection",
+        propertyAttribute: "ConnectionId"
+      },
+      { contextName: "folderKey", propertyAttribute: "folderKey" }
+    ]);
+    const connectionResourceKey = resourceKeys.get("connection");
+    const folderResourceKey = resourceKeys.get("folderKey");
+    if (connectionResourceKey && folderResourceKey && connectionResourceKey !== folderResourceKey) {
+      diagnostics.push({
+        file,
+        element: describeElement(owner),
+        message: "Integration Service activity connection and folder bindings refer to different connection resources.",
+        instruction: "Set the same resourceKey on both root bindings."
+      });
+    }
+  }
+  validateTriggerConnectionBinding(file, payload, owner, bindings, nodeLabel, diagnostics) {
+    this.validateConnectionBindings(file, payload, owner, bindings, diagnostics, nodeLabel, [
       {
         contextName: "connection",
         propertyAttribute: "ConnectionId"
       },
       {
-        contextName: "folderKey",
-        propertyAttribute: "folderKey"
+        contextName: "connectionId",
+        propertyAttribute: "ConnectionId"
       }
-    ];
+    ]);
+  }
+  validateConnectionBindings(file, payload, owner, bindings, diagnostics, nodeLabel, bindingFields) {
+    const inputByName = new Map(getConnectorInputs(payload).map((input) => [
+      input.attributes.name,
+      input
+    ]));
     const resourceKeys = new Map;
     for (const field of bindingFields) {
-      const contextInput = contextByName.get(field.contextName);
+      const contextInput = inputByName.get(field.contextName);
       if (!contextInput) {
         continue;
       }
@@ -12641,7 +12823,7 @@ class BpmnValidateService {
         diagnostics.push({
           file,
           element: describeElement(owner),
-          message: `Integration Service activity context input "${field.contextName}" must reference a root binding.`,
+          message: `Integration Service ${nodeLabel} context input "${field.contextName}" must reference a root binding.`,
           instruction: `Set ${field.contextName} to =bindings.<bindingId> and declare that binding with resource="Connection" and propertyAttribute="${field.propertyAttribute}".`
         });
         continue;
@@ -12656,7 +12838,7 @@ class BpmnValidateService {
         diagnostics.push({
           file,
           element: describeElement(owner),
-          message: `Integration Service activity ${field.contextName} binding "${bindingId}" must use resource="Connection" and propertyAttribute="${field.propertyAttribute}".`,
+          message: `Integration Service ${nodeLabel} ${field.contextName} binding "${bindingId}" must use resource="Connection" and propertyAttribute="${field.propertyAttribute}".`,
           instruction: `Set resource="Connection" and propertyAttribute="${field.propertyAttribute}" on that binding.`
         });
       }
@@ -12665,23 +12847,14 @@ class BpmnValidateService {
         diagnostics.push({
           file,
           element: describeElement(owner),
-          message: `Integration Service activity ${field.contextName} binding "${bindingId}" is missing resourceKey.`,
+          message: `Integration Service ${nodeLabel} ${field.contextName} binding "${bindingId}" is missing resourceKey.`,
           instruction: "Set resourceKey on that root binding."
         });
       } else if (!hasInvalidBindingShape) {
         resourceKeys.set(field.contextName, resourceKey);
       }
     }
-    const connectionResourceKey = resourceKeys.get("connection");
-    const folderResourceKey = resourceKeys.get("folderKey");
-    if (connectionResourceKey && folderResourceKey && connectionResourceKey !== folderResourceKey) {
-      diagnostics.push({
-        file,
-        element: describeElement(owner),
-        message: "Integration Service activity connection and folder bindings refer to different connection resources.",
-        instruction: "Set the same resourceKey on both root bindings."
-      });
-    }
+    return resourceKeys;
   }
   validateInputs(file, payload, owner, contract, diagnostics) {
     const directInputs = childElements(payload, "uipath:input");
@@ -13102,6 +13275,38 @@ function findFirst(node, predicate) {
   }
   return;
 }
+function isManualStartEvent(startEvent) {
+  const hasEventDefinition = startEvent.children.some((child) => getLocalName(child.name).endsWith("eventdefinition"));
+  const hasUiPathEvent = findDescendants(startEvent, (node) => hasLocalName(node, "event")).length > 0;
+  return !hasEventDefinition && !hasUiPathEvent;
+}
+var VARIABLE_READ = /vars(?:\.([A-Za-z_$][\w$]*)|\[\s*["']([^"']+)["']\s*\])/g;
+var FREE_TEXT_ELEMENTS = new Set(["documentation", "text"]);
+function collectVariableReads(node, into = new Set) {
+  for (const value of Object.values(node.attributes)) {
+    if (!value.trimStart().startsWith("=")) {
+      continue;
+    }
+    for (const match of value.matchAll(VARIABLE_READ)) {
+      const id = match[1] ?? match[2];
+      if (id) {
+        into.add(id);
+      }
+    }
+  }
+  if (node.text && !FREE_TEXT_ELEMENTS.has(getLocalName(node.name))) {
+    for (const match of node.text.matchAll(VARIABLE_READ)) {
+      const id = match[1] ?? match[2];
+      if (id) {
+        into.add(id);
+      }
+    }
+  }
+  for (const child of node.children) {
+    collectVariableReads(child, into);
+  }
+  return into;
+}
 function hasLocalName(node, localName) {
   return getLocalName(node.name) === localName.toLowerCase();
 }
@@ -13134,6 +13339,12 @@ function findBpmnOwner(payload) {
 function getContextInputs(payload) {
   return childElements(payload, "uipath:context").flatMap((context) => childElements(context, "uipath:input"));
 }
+function getConnectorInputs(payload) {
+  return [
+    ...getContextInputs(payload),
+    ...childElements(payload, "uipath:input")
+  ];
+}
 function isIntsvcActivityExecutionV1(nodeVersion, workflowVersion) {
   const version = nodeVersion ?? workflowVersion;
   return version === undefined || version === ACTIVITY_CONFIGURATION_V1;
@@ -13354,18 +13565,24 @@ function createBpmnValidationFileSystem(fileSystem) {
 class BpmnTool extends ProjectTool {
   _temporaryStorage;
   _validateService;
+  _packValidateService;
   constructor(fileSystem, logger) {
     super(fileSystem, logger);
     this._temporaryStorage = new TemporaryStorageService(fileSystem);
-    this._validateService = new BpmnValidateService(createBpmnValidationFileSystem(fileSystem));
+    const validationFileSystem = createBpmnValidationFileSystem(fileSystem);
+    this._validateService = new BpmnValidateService(validationFileSystem);
+    this._packValidateService = new BpmnValidateService(validationFileSystem, { unsupportedExtensionTypeSeverity: "error" });
   }
   async restoreAsync(_options, _cancellationToken) {
     this.logger.info("Restore operation is not required for ProcessOrchestration projects");
     return ToolResult.success();
   }
   async validateAsync(options, _cancellationToken) {
+    return this.runValidation(this._validateService, options.projectPath);
+  }
+  async runValidation(service, projectPath) {
     this.logger.info("Validating ProcessOrchestration BPMN project...");
-    const result = await this._validateService.validateProject(options.projectPath);
+    const result = await service.validateProject(projectPath);
     if (!result.isValid) {
       if (result.message) {
         this.logger.error(result.message);
@@ -13384,16 +13601,7 @@ class BpmnTool extends ProjectTool {
     const contentFolder = Path.join(localBuildFolder, NugetConstants.ContentFolderName);
     try {
       if (!options.skipValidate) {
-        const validationResult = await this.validateAsync({
-          projectPath: options.projectPath,
-          excludeConfiguredSources: options.excludeConfiguredSources,
-          skipAnalyze: options.skipAnalyze,
-          skipValidate: options.skipValidate,
-          detailedLogPath: options.detailedLogPath,
-          policyFilePath: options.policyFilePath,
-          logLevel: options.logLevel,
-          nuGetSourcesConfigPath: options.nuGetSourcesConfigPath
-        });
+        const validationResult = await this.runValidation(this._packValidateService, options.projectPath);
         if (!validationResult.isSuccess) {
           return validationResult;
         }
@@ -13515,11 +13723,18 @@ class BpmnTool extends ProjectTool {
     const existing = await this.readExistingArtifacts(contentFolder, parseOptionalJson2);
     const existingBindings = existing["bindings_v2.json"];
     const existingResources = Array.isArray(existingBindings?.resources) ? existingBindings.resources.filter(isJsonObject2) : [];
+    let resources;
+    try {
+      resources = buildConnectionResources2(processes, existingResources);
+    } catch (error3) {
+      const message = error3 instanceof Error ? error3.message : String(error3);
+      return `${bpmnFile} has an Integration Service connection binding that cannot be resolved — ${message}`;
+    }
     const metadata = buildBpmnPackageMetadata2({
       bpmnFile,
       entryPoints,
       projectId: options.projectStorageId ?? crypto.randomUUID(),
-      resources: buildConnectionResources2(processes, existingResources),
+      resources,
       existing
     });
     for (const name2 of [
@@ -13630,4 +13845,4 @@ export {
   BpmnToolFactory
 };
 
-//# debugId=3BC19C27ABE50E1864756E2164756E21
+//# debugId=63A8A4C6F0F0836164756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uipath/packager-tool-bpmn",
-    "version": "1.201.0",
+    "version": "1.202.0-preview.136",
     "description": "UiPath ProcessOrchestration (BPMN) tool implementation",
     "type": "module",
     "exports": {
@@ -25,10 +25,10 @@
     "author": "",
     "license": "ISC",
     "peerDependencies": {
-        "@uipath/solutionpackager-tool-core": "1.201.0"
+        "@uipath/solutionpackager-tool-core": "1.202.0"
     },
     "dependencies": {
-        "@uipath/maestro-sdk": "1.201.0"
+        "@uipath/maestro-sdk": "1.202.0"
     },
-    "gitHead": "7933378ad5276ac369900293a1447474dcec6826"
+    "gitHead": "f6270de2c7c04f4c43b2f5187b0c3d3c314c2610"
 }

package/src/bpmn-tool.ts

@@ -51,13 +51,23 @@ function createBpmnValidationFileSystem(
  */
 export class BpmnTool extends ProjectTool {
     private readonly _temporaryStorage: TemporaryStorageService;
+    // Standalone `validate` keeps an extension type absent from the contract a
+    // warning, so authoring against a type newer than the CLI's bundled contract
+    // is not blocked.
     private readonly _validateService: BpmnValidateService;
+    // Packaging must fail fast on such a type rather than ship a package
+    // Orchestrator rejects at deploy (Error 1654), so the build path validates
+    // with error severity.
+    private readonly _packValidateService: BpmnValidateService;
 
     constructor(fileSystem: IFileSystem, logger: IToolLogger) {
         super(fileSystem, logger);
         this._temporaryStorage = new TemporaryStorageService(fileSystem);
-        this._validateService = new BpmnValidateService(
-            createBpmnValidationFileSystem(fileSystem),
+        const validationFileSystem = createBpmnValidationFileSystem(fileSystem);
+        this._validateService = new BpmnValidateService(validationFileSystem);
+        this._packValidateService = new BpmnValidateService(
+            validationFileSystem,
+            { unsupportedExtensionTypeSeverity: "error" },
         );
     }
 
@@ -74,11 +84,16 @@ export class BpmnTool extends ProjectTool {
     override async validateAsync(
         options: IProjectValidateOptions,
         _cancellationToken?: AbortSignal,
+    ): Promise<ToolResult> {
+        return this.runValidation(this._validateService, options.projectPath);
+    }
+
+    private async runValidation(
+        service: BpmnValidateService,
+        projectPath: string,
     ): Promise<ToolResult> {
         this.logger.info("Validating ProcessOrchestration BPMN project...");
-        const result = await this._validateService.validateProject(
-            options.projectPath,
-        );
+        const result = await service.validateProject(projectPath);
         if (!result.isValid) {
             if (result.message) {
                 this.logger.error(result.message);
@@ -111,16 +126,13 @@ export class BpmnTool extends ProjectTool {
 
         try {
             if (!options.skipValidate) {
-                const validationResult = await this.validateAsync({
-                    projectPath: options.projectPath,
-                    excludeConfiguredSources: options.excludeConfiguredSources,
-                    skipAnalyze: options.skipAnalyze,
-                    skipValidate: options.skipValidate,
-                    detailedLogPath: options.detailedLogPath,
-                    policyFilePath: options.policyFilePath,
-                    logLevel: options.logLevel,
-                    nuGetSourcesConfigPath: options.nuGetSourcesConfigPath,
-                });
+                // Error severity here: the build/pack path fails fast on an
+                // extension type absent from the contract, unlike standalone
+                // `validate`.
+                const validationResult = await this.runValidation(
+                    this._packValidateService,
+                    options.projectPath,
+                );
                 if (!validationResult.isSuccess) {
                     return validationResult;
                 }
@@ -348,9 +360,8 @@ export class BpmnTool extends ProjectTool {
         // Deferred, not a top-level import: the derivation carries bpmn-moddle,
         // and a static import lands it in a chunk that `maestro-tool`'s eager
         // startup graph also touches — it is only needed when a BPMN project is
-        // actually built. Same reason `bpmn-validate-service.ts:470` defers
-        // `@uipath/maestro-sdk/bpmn-validation/canvas` and `refresh.ts` defers
-        // `BpmnRefreshService`.
+        // actually built. The BPMN validate service and refresh command defer
+        // their own heavy code for the same reason.
         const {
             buildBpmnPackageMetadata,
             buildConnectionResources,
@@ -381,6 +392,19 @@ export class BpmnTool extends ProjectTool {
             ? existingBindings.resources.filter(isJsonObject)
             : [];
 
+        // buildConnectionResources throws when an Integration Service node's
+        // connection binding cannot be resolved (missing, literal, or malformed).
+        // Turn that into a specific reason here so `uip solution pack` reports
+        // the real cause instead of buildAsync's generic InternalError.
+        let resources: ReturnType<typeof buildConnectionResources>;
+        try {
+            resources = buildConnectionResources(processes, existingResources);
+        } catch (error) {
+            const message =
+                error instanceof Error ? error.message : String(error);
+            return `${bpmnFile} has an Integration Service connection binding that cannot be resolved — ${message}`;
+        }
+
         const metadata = buildBpmnPackageMetadata({
             bpmnFile,
             entryPoints,
@@ -388,7 +412,7 @@ export class BpmnTool extends ProjectTool {
             // so this id is inert: operate.json stays owned by
             // `ensureContentOperateFile`, which backfills the stable project id.
             projectId: options.projectStorageId ?? crypto.randomUUID(),
-            resources: buildConnectionResources(processes, existingResources),
+            resources,
             existing,
         });