@uipath/skills 1.201.0-preview.621 → 1.202.0-preview.635

package/skills/uipath-maestro-bpmn/references/shared/local-metadata-regeneration-guide.md

@@ -10,20 +10,38 @@ Use this guide when BPMN source changed and local package metadata must be refre
 
 ## Local Synthetic Project Contract
 
-When no CLI generator is available and you must author a local-only synthetic
-BPMN project, make the project executable and package-shaped before packing:
+> **Use `uip maestro bpmn refresh <project-path>` for any project with an
+> Integration Service connector node.** `refresh` regenerates all four package
+> files *and* materializes `Intsvc.*` connection bindings (activities, and
+> `Intsvc.EventTrigger` / `Intsvc.WaitForEvent` triggers) into `bindings_v2.json`
+> `Connection` resources — the trigger connection field is `connectionId`
+> (activities use `connection`). `update-metadata` is **deprecated** and never
+> materializes connection bindings, so a trigger regenerated with it passes
+> `validate` but faults at runtime with a null connection (error 102010). The
+> file-shape contract below is identical for both commands.
+
+`uip maestro bpmn update-metadata <file.bpmn>` writes the
+same shape `uip maestro bpmn init` scaffolds, and `uip maestro bpmn pack`
+consumes it as written:
 
 - The root process must be `<bpmn:process ... isExecutable="true">`.
-- `project.uiproj` must use lowercase `"main"` pointing at the BPMN file.
-- `operate.json` must use `"main"` with the bare BPMN filename, not a
-  `/content/<file>.bpmn#<start-event-id>` entry-point path, plus
-  `"contentType": "ProcessOrchestration"`.
-- `package-descriptor.json` must use a top-level `"content"` array with
-  `content/<file>` entries. Do not use `contentFiles` or a CLI scaffold
-  `"files"` mapping for synthetic local metadata.
-
-The minimal placeholder-safe JSON shape is shown below; keep it exact apart
-from project, file, and start event names.
+- `project.uiproj` carries `"Name"` and `"ProjectType":
+  "ProcessOrchestration"`. The CLI does not write `"main"` here; it preserves a
+  hand-authored one, so do not add one expecting it to be required.
+- `operate.json` uses `"main"` with the entry-point path
+  `/content/<file>.bpmn#<start-event-id>` plus `"contentType":
+  "ProcessOrchestration"`. `update-metadata` rewrites this field every run — a
+  bare filename does not survive.
+- `package-descriptor.json` uses a top-level `"files"` map of name to path,
+  including the BPMN file, `operate.json`, `entry-points.json`, and
+  `"bindings.json": "bindings_v2.json"`. Do not use `contentFiles`.
+
+`pack` also accepts a hand-authored top-level `"content"` array of
+`content/<file>` paths, so pre-existing synthetic metadata in that shape stays
+valid. Prefer the CLI shape for anything new.
+
+The placeholder-safe JSON shape for a CLI-unavailable fallback is shown below;
+keep it exact apart from project, file, and start event names.
 
 ## Regeneration Inputs
 
@@ -44,10 +62,15 @@ Do not derive metadata from stale package files first. Use existing generated fi
 3. Regenerate package metadata from the BPMN source:
 
    ```bash
-   uip maestro bpmn update-metadata <file.bpmn> --dry-run   # check drift
-   uip maestro bpmn update-metadata <file.bpmn>             # regenerate
+   uip maestro bpmn refresh <project-path>                  # regenerate + materialize IS connection bindings
    ```
 
+   Use `refresh` — it materializes `Intsvc.*` connection bindings (including
+   triggers) and validates before writing. The deprecated
+   `uip maestro bpmn update-metadata <file.bpmn>` (with `--dry-run` for a
+   drift check) only rewrites the BPMN-derived fields and does **not** materialize
+   connection bindings.
+
    If CLI unavailable for a local-only synthetic project, write the minimal
    placeholder-safe shape (see below) before continuing.
 
@@ -74,18 +97,15 @@ Packaging is local and authoring-safe. Upload, publish, deploy, debug, and run a
 ## Minimal Local Metadata Shape
 
 When a local-only synthetic project needs package files and the CLI cannot
-regenerate them in place, use this placeholder-safe shape before running
-`uip maestro bpmn pack`. Replace only the BPMN file name and start event id;
-do not invent `contentFiles` as a substitute for `content`.
+regenerate them in place, mirror what `update-metadata` would have written.
+Replace only the BPMN file name and start event id.
 
 `project.uiproj`:
 
 ```json
 {
-  "projectVersion": "1.0.0",
-  "ProjectType": "ProcessOrchestration",
   "Name": "SyntheticProject",
-  "main": "SyntheticProject.bpmn"
+  "ProjectType": "ProcessOrchestration"
 }
 ```
 
@@ -93,7 +113,7 @@ do not invent `contentFiles` as a substitute for `content`.
 
 ```json
 {
-  "main": "SyntheticProject.bpmn",
+  "main": "/content/SyntheticProject.bpmn#Start_Manual",
   "contentType": "ProcessOrchestration"
 }
 ```
@@ -104,15 +124,19 @@ do not invent `contentFiles` as a substitute for `content`.
 {
   "entryPoints": [
     {
-      "id": "Entry_ManualStart",
       "filePath": "/content/SyntheticProject.bpmn#Start_Manual",
-      "inputSchema": { "type": "object", "properties": {} },
-      "outputSchema": { "type": "object", "properties": {} }
+      "uniqueId": "00000000-0000-0000-0000-000000000000",
+      "type": "ProcessOrchestration",
+      "input": { "type": "object", "properties": {} },
+      "output": { "type": "object", "properties": {} }
     }
   ]
 }
 ```
 
+Set each `uniqueId` to the start event's own `uipath:entryPointId` value, not to
+the placeholder above.
+
 `bindings_v2.json`:
 
 ```json
@@ -130,23 +154,30 @@ imported an external process, queue, connector, or agent.
 
 ```json
 {
-  "content": [
-    "content/SyntheticProject.bpmn",
-    "content/bindings_v2.json",
-    "content/entry-points.json",
-    "content/operate.json"
-  ]
+  "files": {
+    "operate.json": "operate.json",
+    "entry-points.json": "entry-points.json",
+    "bindings.json": "bindings_v2.json",
+    "SyntheticProject.bpmn": "SyntheticProject.bpmn"
+  }
 }
 ```
 
 ## Entry Point Rules
 
-For each root start event with `uipath:entryPointId`, generated `entry-points.json` must include:
+For each root start event with a
+`<uipath:entryPointId value="<uuid>" />` child in its `extensionElements`,
+generated `entry-points.json` must include:
 
-- `id` equal to the `uipath:entryPointId` value.
 - `filePath` equal to `/content/<bpmn-file>#<start-event-id>`.
-- `inputSchema` from root input variables whose `elementId` matches the start event.
-- `outputSchema` from root output variables.
+- `uniqueId` equal to the `uipath:entryPointId` value.
+- `type` equal to `ProcessOrchestration`.
+- `input` from root input variables whose `elementId` matches the start event.
+- `output` from root output variables.
+
+A start event without that element yields no entry point at all —
+`update-metadata` reports `EntryPointCount: 0` and writes an empty
+`entryPoints` array rather than inventing an id.
 
 JSON schema variables use their CDATA body as the property schema. Strip `$schema` from generated package schemas. Other primitive variables map by type, such as `string`, `integer`, `number`, `boolean`, `array`, `object`, or `json`.
 
@@ -188,8 +219,8 @@ If multiple BPMN elements share a connector connection binding, regenerate or va
 
 Before a connector element is executable, enrichment must make these fields agree:
 
-- Every `Intsvc.*` `connection`, `trigger`, object/property, or resource context value references an existing root binding with `=bindings.<id>`.
-- The referenced package resource exists in `bindings_v2.json`.
+- Every `Intsvc.*` connection, `trigger`, object/property, or resource context value references an existing root binding with `=bindings.<id>`. The connection context field is `connection` for activities and `connectionId` for triggers/waits (`Intsvc.EventTrigger`, `Intsvc.WaitForEvent`).
+- The referenced package resource exists in `bindings_v2.json` — for connection bindings this `Connection` resource is materialized by `uip maestro bpmn refresh` (and `pack`), including for triggers. If it is missing, the process passes `validate` but faults at runtime with a null connection (error 102010).
 - Connector-specific package metadata agrees with the `connectorKey` in the enriched payload.
 - Trigger property resources carry the parent trigger resource key when required by the connector shape.
 - Activity payloads include required operation context and generated request/input schema data when the selected operation requires it.

package/skills/uipath-maestro-bpmn/references/shared/project-layout.md

@@ -61,10 +61,11 @@ For the regeneration and drift-check contract, see [local-metadata-regeneration-
 
 A synthetic local project authored without a CLI generator must still match the
 executable and metadata contract before packing: the BPMN root process includes
-`isExecutable="true"`, `project.uiproj` has lowercase `"main"`,
-`operate.json` has `"main"` plus `"contentType": "ProcessOrchestration"`, and
-`package-descriptor.json` has top-level `"content"` entries under `content/`.
-For the exact minimal JSON, see
+`isExecutable="true"`, each root start event carries
+`<uipath:entryPointId value="<uuid>" />`, `operate.json` has `"main"` plus
+`"contentType": "ProcessOrchestration"`, and `package-descriptor.json` maps the
+BPMN file and generated JSON. `uip maestro bpmn update-metadata <file.bpmn>`
+produces that shape; for the exact JSON, see
 [local-metadata-regeneration-guide.md](local-metadata-regeneration-guide.md#minimal-local-metadata-shape).
 
 A Process Orchestration package content folder contains:
@@ -75,7 +76,7 @@ A Process Orchestration package content folder contains:
 - `operate.json`.
 - `package-descriptor.json`.
 
-The package descriptor maps BPMN and generated JSON files under `content/`. The entry point file path references the BPMN file and start event, using the root start event's unique entry point ID.
+The package descriptor maps the BPMN file and generated JSON by name. The entry point file path references the BPMN file and start event as `/content/<bpmn-file>#<start-event-id>`, using the root start event's unique entry point ID.
 
 ## Authoring boundary
 

package/skills/uipath-maestro-bpmn/references/structural-bpmn.md

@@ -275,11 +275,11 @@ Payload shapes the canvas serializes:
   Maestro internal-message events (`Maestro.ReceiveMessageEvent` /
   `Maestro.SendMessageEvent`) carry the `uipath:event` payload **and** a bare
   `<bpmn:messageEventDefinition />` (see their registry templates).
-  A mid-flow wait for an inbound message is a
+  A mid-process wait for an inbound message is a
   `<bpmn:intermediateCatchEvent>` with incoming and outgoing sequence flows,
   the registry-provided `Maestro.ReceiveMessageEvent` payload under
   `bpmn:extensionElements`, and a sibling `<bpmn:messageEventDefinition />`.
-  Do not model a mid-flow receive as `bpmn:receiveTask`, `bpmn:serviceTask`, a
+  Do not model a mid-process receive as `bpmn:receiveTask`, `bpmn:serviceTask`, a
   start event, or the PascalCase `bpmn:IntermediateCatchEvent`.
 - **Error**: `<bpmn:errorEventDefinition errorRef="Error_1" />` with a
   `<bpmn:error id="Error_1" name="…" errorCode="…"/>` at definitions level. An
@@ -337,19 +337,37 @@ UiPath-specific retry and error-mapping metadata live inside an activity's
 </uipath:retry>
 <uipath:errorMapping version="v1">
   <uipath:error id="Mapped_ServiceUnavailable" errorRef="Error_ServiceUnavailable"
-                priority="1" condition="=vars.error.code == &quot;SERVICE_UNAVAILABLE&quot;"
+                priority="1" condition="=vars.Error.code == &quot;SERVICE_UNAVAILABLE&quot;"
                 detail="Service unavailable" retryable="true" />
 </uipath:errorMapping>
 ```
 
 - `uipath:retry` attributes: `maxRetryCount`, `retryBackoff`, `retryBackoffType`,
   `maxDuration`, `exponentialBase`, `retryAllErrors`. Do not use stale aliases
-  (`maxAttempts`, `interval`).
+  (`maxAttempts`, `interval`). `retryAllErrors="false"` with no
+  `uipath:errorDefinition` children retries nothing at all.
 - `uipath:error` (mapping) fields: `id`, `errorRef`, `priority`, `condition`,
   `detail`, `retryable` (`true`/`false`). Conditions read the runtime error via
-  `vars.error` and contain no assignments. Do not put `code=` on `uipath:error`;
+  `vars.Error` (capital `E`, lowercase fields — see
+  [expression-authoring.md](expression-authoring.md#stored-expression-shape))
+  and contain no assignments. Do not put `code=` on `uipath:error`;
   model the code on `bpmn:error errorCode` and reference via `errorRef`.
 
+### Choosing an error-handling construct
+
+Three constructs catch failures at different scopes. A failure tries them in
+order, so pick by intent:
+
+- **`uipath:retry` on the activity** — transient failures, resolved in place.
+- **Error boundary event on the activity** — recover and continue. The token
+  leaves the failed step onto a branch that rejoins the main path.
+- **Error event subprocess in the container** — escalate and terminate.
+  Code-specific nets match before a catch-all.
+
+Unhandled failures propagate outward container by container, so one net at
+process level covers every nested subprocess. Do not author a net per
+container.
+
 ## Subprocess, call activity, event subprocess (REGISTRY GAP for structure)
 
 - **SubProcess** (`bpmn:SubProcess`): a container with its own nested

package/skills/uipath-maestro-bpmn/validator/bpmn-spec.json

@@ -165,46 +165,33 @@
       "extensionTag": "uipath:activity",
       "contextFields": [
         {
-          "name": "releaseKey",
-          "displayName": "Process",
+          "name": "name",
+          "displayName": "Agent",
           "type": "string",
-          "required": false,
+          "required": true,
           "hidden": true,
           "isPrimaryKey": false,
-          "binding": false,
+          "binding": true,
           "defaultValue": null,
           "bindingInfo": {
             "resource": "process",
             "resourceKeyPattern": "${metadata.key}",
-            "propertyAttribute": "Key"
+            "propertyAttribute": "name"
           }
         },
-        {
-          "name": "folderId",
-          "type": "string",
-          "required": false,
-          "hidden": true,
-          "isPrimaryKey": false,
-          "binding": false,
-          "defaultValue": null
-        },
         {
           "name": "folderPath",
           "type": "string",
-          "required": false,
-          "hidden": true,
-          "isPrimaryKey": false,
-          "binding": false,
-          "defaultValue": null
-        },
-        {
-          "name": "name",
-          "type": "string",
-          "required": false,
+          "required": true,
           "hidden": true,
           "isPrimaryKey": false,
-          "binding": false,
-          "defaultValue": null
+          "binding": true,
+          "defaultValue": null,
+          "bindingInfo": {
+            "resource": "process",
+            "resourceKeyPattern": "${metadata.key}",
+            "propertyAttribute": "folderPath"
+          }
         }
       ],
       "inputPattern": "mergedBody",
@@ -218,12 +205,12 @@
       "bindingInfo": {
         "resource": "process",
         "resourceKeyPattern": "${metadata.key}",
-        "propertyAttribute": "Key",
-        "contextField": "releaseKey"
+        "propertyAttribute": "name",
+        "contextField": "name"
       },
       "requiresDiscovery": true,
       "isDynamic": true,
-      "xmlTemplate": "<bpmn:ServiceTask id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:activity version=\"v1\">\n      <uipath:type value=\"Orchestrator.StartAgentJob\" version=\"v1\" />\n      <uipath:context>\n        <uipath:input name=\"releaseKey\" value=\"{releaseKey}\" />\n        <uipath:input name=\"folderId\" value=\"{folderId}\" />\n        <uipath:input name=\"folderPath\" value=\"{folderPath}\" />\n        <uipath:input name=\"name\" value=\"{name}\" />\n      </uipath:context>\n      <uipath:input name=\"JobArguments\" type=\"json\" target=\"bodyField\"><![CDATA[{}]]></uipath:input>\n      <uipath:output name=\"Process response\" type=\"Orchestrator.RunJob\" var=\"{varId}\" />\n    </uipath:activity>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:ServiceTask>",
+      "xmlTemplate": "<bpmn:ServiceTask id=\"{id}\" name=\"{name}\">\n  <uipath:activity type=\"Orchestrator.StartAgentJob\" version=\"v1\">\n    <uipath:context>\n      <uipath:input name=\"name\" value=\"=bindings.{nameBindingId}\" />\n      <uipath:input name=\"folderPath\" value=\"=bindings.{folderPathBindingId}\" />\n    </uipath:context>\n    <uipath:input name=\"JobArguments\" type=\"json\" target=\"bodyField\"><![CDATA[{}]]></uipath:input>\n    <uipath:output name=\"Process response\" type=\"Orchestrator.RunJob\" var=\"{varId}\" />\n  </uipath:activity>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:ServiceTask>",
       "discoveryNotes": "Uses getSupportedOrchestratorTasks('agent', search) to list available agents"
     },
     "Orchestrator.BusinessRules": {
@@ -323,20 +310,24 @@
       "extensionTag": "uipath:activity",
       "contextFields": [
         {
-          "name": "activity",
-          "displayName": "Activity",
+          "name": "activityConfigurationVersion",
+          "displayName": "Activity configuration version",
           "type": "string",
-          "required": true,
-          "hidden": false,
-          "isPrimaryKey": true,
+          "required": false,
+          "hidden": true,
+          "isPrimaryKey": false,
           "binding": false,
-          "defaultValue": null
+          "defaultValue": "v1",
+          "enum": [
+            "v1"
+          ],
+          "description": "Marks the Integration Service activity format used by this template"
         },
         {
           "name": "connectorKey",
           "displayName": "Connector key",
           "type": "string",
-          "required": false,
+          "required": true,
           "hidden": true,
           "isPrimaryKey": false,
           "binding": false,
@@ -350,7 +341,12 @@
           "hidden": true,
           "isPrimaryKey": false,
           "binding": true,
-          "defaultValue": null
+          "defaultValue": null,
+          "bindingInfo": {
+            "resource": "Connection",
+            "resourceKeyPattern": "${resourceKey}",
+            "propertyAttribute": "ConnectionId"
+          }
         },
         {
           "name": "folderKey",
@@ -359,43 +355,85 @@
           "required": false,
           "hidden": true,
           "isPrimaryKey": false,
+          "binding": true,
+          "defaultValue": null,
+          "bindingInfo": {
+            "resource": "Connection",
+            "resourceKeyPattern": "${resourceKey}",
+            "propertyAttribute": "folderKey"
+          }
+        },
+        {
+          "name": "operation",
+          "displayName": "Operation",
+          "type": "string",
+          "required": true,
+          "hidden": true,
+          "isPrimaryKey": true,
           "binding": false,
-          "defaultValue": null
+          "defaultValue": null,
+          "description": "Activity catalog Name used as the runtime operation"
+        },
+        {
+          "name": "objectName",
+          "displayName": "Object name",
+          "type": "string",
+          "required": true,
+          "hidden": true,
+          "isPrimaryKey": false,
+          "binding": false,
+          "defaultValue": null,
+          "description": "Activity catalog ObjectName"
         },
         {
           "name": "method",
           "displayName": "Method",
           "type": "string",
-          "required": false,
+          "required": true,
           "hidden": true,
           "isPrimaryKey": false,
           "binding": false,
-          "defaultValue": null
+          "defaultValue": null,
+          "description": "Activity catalog MethodName"
         },
         {
           "name": "path",
           "displayName": "Path",
           "type": "string",
+          "required": true,
+          "hidden": true,
+          "isPrimaryKey": false,
+          "binding": false,
+          "defaultValue": null,
+          "description": "Request path returned by resource metadata"
+        },
+        {
+          "name": "metadata",
+          "displayName": "Metadata",
+          "type": "json",
           "required": false,
           "hidden": true,
           "isPrimaryKey": false,
           "binding": false,
-          "defaultValue": null
+          "defaultValue": {},
+          "description": "Optional activity metadata"
         }
       ],
+      "inputFields": [],
       "inputPattern": "separateInputs",
       "inputName": "body",
       "inputTarget": "body",
-      "outputSource": ".",
-      "outputType": "custom",
-      "outputName": "result",
+      "outputSource": "=response",
+      "outputType": "jsonSchema",
+      "outputName": "response",
       "useRelativeSource": false,
       "bindingPattern": "connection",
       "requiresDiscovery": true,
       "isDynamic": true,
-      "xmlTemplate": "<bpmn:SendTask id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:activity version=\"v1\">\n      <uipath:type value=\"Intsvc.ActivityExecution\" version=\"v1\" />\n      <uipath:context>\n        <uipath:input name=\"activity\" value=\"{activity}\" />\n        <uipath:input name=\"connectorKey\" value=\"{connectorKey}\" />\n        <uipath:input name=\"connection\" value=\"=bindings.{bindingId}\" />\n        <uipath:input name=\"folderKey\" value=\"{folderKey}\" />\n        <uipath:input name=\"method\" value=\"{method}\" />\n        <uipath:input name=\"path\" value=\"{path}\" />\n      </uipath:context>\n      <uipath:input name=\"body\" type=\"json\" target=\"body\"><![CDATA[{}]]></uipath:input>\n      <uipath:output name=\"result\" type=\"custom\" source=\".\" var=\"{varId}\" />\n    </uipath:activity>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:SendTask>",
-      "discoveryNotes": "Uses getConnectorConnections(connectorKey) to list available connections. Activity/connector metadata comes from Integration Service catalog.",
-      "inputNotes": "isSplitInputs=false in design schema; inputs are sent as separate <uipath:input> elements, not merged into a single JSON body",
+      "xmlTemplate": "<bpmn:sendTask id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:activity version=\"v1\">\n      <uipath:type value=\"Intsvc.ActivityExecution\" version=\"v1\" />\n      <uipath:context>\n        <uipath:input name=\"connectorKey\" type=\"string\" value=\"{connectorKey}\" />\n        <uipath:input name=\"connection\" type=\"string\" value=\"=bindings.{connectionBindingId}\" />\n        <uipath:input name=\"folderKey\" type=\"string\" value=\"=bindings.{folderBindingId}\" />\n        <uipath:input name=\"operation\" type=\"string\" value=\"{operation}\" />\n        <uipath:input name=\"objectName\" type=\"string\" value=\"{objectName}\" />\n        <uipath:input name=\"method\" type=\"string\" value=\"{method}\" />\n        <uipath:input name=\"path\" type=\"string\" value=\"{path}\" />\n        <uipath:input name=\"activityConfigurationVersion\" type=\"string\" value=\"v1\" />\n        <uipath:input name=\"metadata\" type=\"json\"><![CDATA[{}]]></uipath:input>\n      </uipath:context>\n      <uipath:output name=\"response\" type=\"jsonSchema\" source=\"=response\" var=\"{varId}\" />\n    </uipath:activity>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:sendTask>",
+      "discoveryNotes": "Use `uip is activities list <connector-key> --output json` to select an activity. Set operation from Name, then describe ObjectName to get its current path, parameters, and fields.",
+      "inputNotes": "Add each request field from the selected operation as its own uipath:input. Keep the field's type and target: path, query, body, or file.",
+      "contextFieldNotes": "connection points to a root binding for a Connection resource. When folder scoping is required, folderKey points to a second binding for the same resourceKey. Use propertyAttribute ConnectionId for connection and folderKey for folderKey. Omit folderKey when the selected activity has no folder scoping, and omit both fields only when it does not use a connection.",
       "extensionTagNotes": "In isExecution array, NOT in isEvents array, so uses uipath:activity"
     },
     "Intsvc.HttpExecution": {
@@ -598,7 +636,7 @@
       "bindingPattern": "connection",
       "requiresDiscovery": true,
       "isDynamic": false,
-      "xmlTemplate": "<bpmn:ReceiveTask id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:event version=\"v1\">\n      <uipath:type value=\"Intsvc.WaitForEvent\" version=\"v1\" />\n      <uipath:output name=\"result\" type=\"custom\" source=\".\" var=\"{varId}\" />\n    </uipath:event>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:ReceiveTask>",
+      "xmlTemplate": "<bpmn:ReceiveTask id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:event version=\"v1\">\n      <uipath:type value=\"Intsvc.WaitForEvent\" version=\"v1\" />\n      <uipath:context>\n        <uipath:input name=\"connectorKey\" type=\"string\" value=\"{connectorKey}\" />\n        <uipath:input name=\"connectionId\" type=\"string\" value=\"=bindings.{connectionBindingId}\" />\n        <uipath:input name=\"folderId\" type=\"string\" value=\"{folderId}\" />\n        <uipath:input name=\"folderPath\" type=\"string\" value=\"{folderPath}\" />\n        <uipath:input name=\"folderKey\" type=\"string\" value=\"{folderKey}\" />\n        <uipath:input name=\"operation\" type=\"string\" value=\"{operation}\" />\n        <uipath:input name=\"objectName\" type=\"string\" value=\"{objectName}\" />\n      </uipath:context>\n      <uipath:output name=\"result\" type=\"custom\" source=\".\" var=\"{varId}\" />\n    </uipath:event>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:ReceiveTask>",
       "discoveryNotes": "Uses getConnectorConnections(connectorKey) to list available connections",
       "inputNotes": "isSplitInputs=false; inputs are defined in input.fields (not jsonBody). Sent as separate <uipath:input> elements.",
       "contextFieldNotes": "Context fields are empty in design schema; all field definitions are in inputFields below",
@@ -613,7 +651,12 @@
           "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",
@@ -727,7 +770,7 @@
       "bindingPattern": "connection",
       "requiresDiscovery": true,
       "isDynamic": false,
-      "xmlTemplate": "<bpmn:StartEvent id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:event version=\"v1\">\n      <uipath:type value=\"Intsvc.EventTrigger\" version=\"v1\" />\n      <uipath:output name=\"result\" type=\"custom\" source=\".\" var=\"{varId}\" />\n    </uipath:event>\n  </bpmn:extensionElements>\n  <bpmn:messageEventDefinition />\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:StartEvent>",
+      "xmlTemplate": "<bpmn:StartEvent id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:event version=\"v1\">\n      <uipath:type value=\"Intsvc.EventTrigger\" version=\"v1\" />\n      <uipath:context>\n        <uipath:input name=\"connectorKey\" type=\"string\" value=\"{connectorKey}\" />\n        <uipath:input name=\"connectionId\" type=\"string\" value=\"=bindings.{connectionBindingId}\" />\n        <uipath:input name=\"folderId\" type=\"string\" value=\"{folderId}\" />\n        <uipath:input name=\"folderPath\" type=\"string\" value=\"{folderPath}\" />\n        <uipath:input name=\"folderKey\" type=\"string\" value=\"{folderKey}\" />\n        <uipath:input name=\"operation\" type=\"string\" value=\"{operation}\" />\n        <uipath:input name=\"objectName\" type=\"string\" value=\"{objectName}\" />\n      </uipath:context>\n      <uipath:output name=\"result\" type=\"custom\" source=\".\" var=\"{varId}\" />\n    </uipath:event>\n  </bpmn:extensionElements>\n  <bpmn:messageEventDefinition />\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:StartEvent>",
       "discoveryNotes": "Uses getConnectorConnections(connectorKey) to list available connections",
       "inputNotes": "isSplitInputs=false; inputs defined in input.fields. Sent as separate <uipath:input> elements.",
       "contextFieldNotes": "Context fields are empty in design schema; all field definitions are in inputFields below",
@@ -742,7 +785,12 @@
           "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",
@@ -1840,8 +1888,8 @@
       "isDynamic": false,
       "xmlTemplate": "<bpmn:Task id=\"{id}\" name=\"{name}\">\n  <bpmn:extensionElements>\n    <uipath:mapping version=\"v1\">\n      <uipath:type value=\"BPMN.Variables\" version=\"v1\" />\n    </uipath:mapping>\n  </bpmn:extensionElements>\n  <bpmn:incoming>{incomingEdge}</bpmn:incoming>\n  <bpmn:outgoing>{outgoingEdge}</bpmn:outgoing>\n</bpmn:Task>",
       "inputNotes": "Variable mappings use uipath:mapping with direct input/output elements, not a jsonBody pattern",
-      "bpmnElementNotes": "Also used on bpmn:StartEvent and bpmn:EndEvent for variable mappings. On bpmn:Task with no serviceType, defaults to BPMN.Variables.",
-      "extensionTagNotes": "Uses uipath:mapping (not uipath:activity). createExtensionTask checks for serviceType=BPMN.Variables on StartEvent/EndEvent/Task and routes to createModdleExtensionVariableMapping."
+      "bpmnElementNotes": "Also used on bpmn:StartEvent, bpmn:EndEvent, bpmn:ScriptTask, and bpmn:SubProcess for variable mappings. On bpmn:Task with no serviceType, defaults to BPMN.Variables.",
+      "extensionTagNotes": "Uses uipath:mapping (not uipath:activity). BPMN.Variables mappings are supported on StartEvent, EndEvent, Task, ScriptTask, and SubProcess owners."
     },
     "BPMN.ScriptTask": {
       "extensionType": "BPMN.ScriptTask",