@uipath/skills 1.196.0 → 1.197.0

package/skills/uipath-maestro-bpmn/fixtures/validation/wrapper-family-contract/operate.json

@@ -1,9 +0,0 @@
-{
-  "projectId": "Fixture.WrapperFamilyContract",
-  "main": "wrapper-family-contract.bpmn",
-  "contentType": "ProcessOrchestration",
-  "targetFramework": "Portable",
-  "runtimeOptions": {
-    "requiresUserInteraction": false
-  }
-}

package/skills/uipath-maestro-bpmn/fixtures/validation/wrapper-family-contract/package-descriptor.json

@@ -1,10 +0,0 @@
-{
-  "id": "Fixture.WrapperFamilyContract",
-  "version": "1.0.0",
-  "content": [
-    "content/wrapper-family-contract.bpmn",
-    "content/bindings_v2.json",
-    "content/entry-points.json",
-    "content/operate.json"
-  ]
-}

package/skills/uipath-maestro-bpmn/fixtures/validation/wrapper-family-contract/project.uiproj

@@ -1,7 +0,0 @@
-{
-  "projectVersion": "1.0.0",
-  "ProjectType": "ProcessOrchestration",
-  "Name": "WrapperFamilyContract",
-  "description": "Synthetic wrapper-family contract validation fixture.",
-  "main": "wrapper-family-contract.bpmn"
-}

package/skills/uipath-maestro-bpmn/fixtures/validation/wrapper-family-contract/wrapper-family-contract.bpmn

@@ -1,151 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:uipath="http://uipath.org/schema/bpmn" id="Definitions_WrapperFamilyContract" targetNamespace="http://uipath.com/synthetic/maestro-bpmn/wrapper-family-contract">
-  <bpmn:process id="Process_WrapperFamilyContract" name="Wrapper Family Contract" isExecutable="true">
-    <bpmn:extensionElements>
-      <uipath:variables version="v1">
-        <uipath:input id="Var_Request" name="request" type="json" elementId="Start_Manual"><![CDATA[{"type":"object","properties":{"caseId":{"type":"string"}}}]]></uipath:input>
-        <uipath:inputOutput id="Var_AgentResult" name="agentResult" type="json" />
-        <uipath:inputOutput id="Var_ApiResult" name="apiResult" type="json" />
-        <uipath:inputOutput id="Var_RuleResult" name="ruleResult" type="string" />
-        <uipath:inputOutput id="Var_QueueState" name="queueState" type="string" />
-        <uipath:output id="Var_FinalStatus" name="finalStatus" type="string" />
-      </uipath:variables>
-      <uipath:bindings version="v1">
-        <uipath:binding id="Binding_AgentName" name="Synthetic Agent" type="process" elementId="Task_RunAgent" resource="process" resourceSubType="Agent" resourceKey="synthetic-agent" propertyAttribute="name" />
-        <uipath:binding id="Binding_AgentFolderPath" name="Synthetic Agent" type="process" elementId="Task_RunAgent" resource="process" resourceSubType="Agent" resourceKey="synthetic-agent" propertyAttribute="folderPath" />
-        <uipath:binding id="Binding_ApiWorkflow" name="Synthetic API Workflow" type="process" elementId="Task_RunApiWorkflow" resource="SyntheticApiWorkflow" resourceSubType="apiWorkflow" resourceKey="synthetic-api-workflow" />
-        <uipath:binding id="Binding_BusinessRule" name="Synthetic Business Rule" type="process" elementId="Task_RunBusinessRule" resource="SyntheticBusinessRule" resourceSubType="businessRules" resourceKey="synthetic-business-rule" />
-        <uipath:binding id="Binding_Queue" name="Synthetic Queue" type="queue" elementId="Task_QueueAndWait" resource="SyntheticQueue" resourceSubType="queue" resourceKey="synthetic-queue" />
-        <uipath:binding id="Binding_CaseProcess" name="Synthetic Case Process" type="process" elementId="Task_StartCaseProcess" resource="SyntheticCaseProcess" resourceSubType="caseManagement" resourceKey="synthetic-case-process" />
-        <uipath:binding id="Binding_WaitConnection" name="Synthetic Connector Connection" type="connection" elementId="Task_WaitForConnectorEvent" resource="SyntheticConnector" resourceSubType="connection" resourceKey="synthetic-connector-connection" />
-        <uipath:binding id="Binding_WaitTrigger" name="Synthetic Connector Trigger" type="eventTrigger" elementId="Task_WaitForConnectorEvent" resource="SyntheticConnector.CaseUpdated" resourceSubType="eventTrigger" resourceKey="synthetic-connector-trigger" />
-      </uipath:bindings>
-    </bpmn:extensionElements>
-    <bpmn:startEvent id="Start_Manual" name="Start">
-      <bpmn:extensionElements>
-        <uipath:entryPointId value="Entry_WrapperFamilyContract" />
-      </bpmn:extensionElements>
-      <bpmn:outgoing>Flow_Start_To_Agent</bpmn:outgoing>
-    </bpmn:startEvent>
-    <bpmn:serviceTask id="Task_RunAgent" name="Run Agent">
-      <bpmn:extensionElements>
-        <uipath:activity version="v1">
-          <uipath:type value="Orchestrator.StartAgentJob" version="v1" />
-          <uipath:context>
-            <uipath:input name="name" type="string" value="=bindings.Binding_AgentName" />
-            <uipath:input name="folderPath" type="string" value="=bindings.Binding_AgentFolderPath" />
-          </uipath:context>
-          <uipath:input name="JobArguments" type="json" target="bodyField"><![CDATA[{"request":"=vars.Var_Request"}]]></uipath:input>
-          <uipath:output name="Process response" type="Orchestrator.RunJob" var="Var_AgentResult" />
-        </uipath:activity>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Start_To_Agent</bpmn:incoming>
-      <bpmn:outgoing>Flow_Agent_To_Api</bpmn:outgoing>
-    </bpmn:serviceTask>
-    <bpmn:serviceTask id="Task_RunApiWorkflow" name="Run API Workflow">
-      <bpmn:extensionElements>
-        <uipath:activity version="v1">
-          <uipath:type value="Orchestrator.ExecuteApiWorkflowAsync" version="v1" />
-          <uipath:context>
-            <uipath:input name="process" type="resource" value="=bindings.Binding_ApiWorkflow" />
-          </uipath:context>
-          <uipath:input name="JobArguments" type="json" target="bodyField"><![CDATA[{"agentResult":"=vars.Var_AgentResult"}]]></uipath:input>
-          <uipath:output name="JobResult" type="json" var="Var_ApiResult" source="result" />
-        </uipath:activity>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Agent_To_Api</bpmn:incoming>
-      <bpmn:outgoing>Flow_Api_To_BusinessRule</bpmn:outgoing>
-    </bpmn:serviceTask>
-    <bpmn:businessRuleTask id="Task_RunBusinessRule" name="Run Business Rule">
-      <bpmn:extensionElements>
-        <uipath:activity version="v1">
-          <uipath:type value="Orchestrator.BusinessRules" version="v1" />
-          <uipath:context>
-            <uipath:input name="process" type="resource" value="=bindings.Binding_BusinessRule" />
-          </uipath:context>
-          <uipath:input name="JobArguments" type="json" target="bodyField"><![CDATA[{"apiResult":"=vars.Var_ApiResult"}]]></uipath:input>
-          <uipath:output name="RuleDecision" type="string" var="Var_RuleResult" source="decision" />
-        </uipath:activity>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Api_To_BusinessRule</bpmn:incoming>
-      <bpmn:outgoing>Flow_BusinessRule_To_Queue</bpmn:outgoing>
-    </bpmn:businessRuleTask>
-    <bpmn:serviceTask id="Task_QueueAndWait" name="Queue And Wait">
-      <bpmn:extensionElements>
-        <uipath:activity version="v1">
-          <uipath:type value="Orchestrator.CreateAndWaitForQueueItem" version="v1" />
-          <uipath:context>
-            <uipath:input name="queue" type="resource" value="=bindings.Binding_Queue" />
-          </uipath:context>
-          <uipath:input name="ItemData" type="json" target="bodyField"><![CDATA[{"ruleResult":"=vars.Var_RuleResult"}]]></uipath:input>
-          <uipath:output name="QueueStatus" type="string" var="Var_QueueState" source="status" />
-        </uipath:activity>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_BusinessRule_To_Queue</bpmn:incoming>
-      <bpmn:outgoing>Flow_Queue_To_Case</bpmn:outgoing>
-    </bpmn:serviceTask>
-    <bpmn:callActivity id="Task_StartCaseProcess" name="Start Case Process">
-      <bpmn:extensionElements>
-        <uipath:activity version="v1">
-          <uipath:type value="Orchestrator.StartCaseMgmtProcess" version="v1" />
-          <uipath:context>
-            <uipath:input name="process" type="resource" value="=bindings.Binding_CaseProcess" />
-          </uipath:context>
-          <uipath:input name="caseManagerInput" type="json" target="bodyField"><![CDATA[{"queueState":"=vars.Var_QueueState"}]]></uipath:input>
-        </uipath:activity>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Queue_To_Case</bpmn:incoming>
-      <bpmn:outgoing>Flow_Case_To_Wait</bpmn:outgoing>
-    </bpmn:callActivity>
-    <bpmn:receiveTask id="Task_WaitForConnectorEvent" name="Wait For Connector Event">
-      <bpmn:extensionElements>
-        <uipath:event version="v1">
-          <uipath:type value="Intsvc.WaitForEvent" version="v1" />
-          <uipath:context>
-            <uipath:input name="connection" type="resource" value="=bindings.Binding_WaitConnection" />
-            <uipath:input name="trigger" type="resource" value="=bindings.Binding_WaitTrigger" />
-            <uipath:input name="connectorKey" type="string" value="synthetic-connector" />
-            <uipath:input name="eventName" type="string" value="CaseUpdated" />
-          </uipath:context>
-        </uipath:event>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Case_To_Wait</bpmn:incoming>
-      <bpmn:outgoing>Flow_Wait_To_End</bpmn:outgoing>
-    </bpmn:receiveTask>
-    <bpmn:endEvent id="End_Done" name="Done">
-      <bpmn:extensionElements>
-        <uipath:mapping version="v1">
-          <uipath:type value="BPMN.Variables" version="v1" />
-          <uipath:output name="finalStatus" type="string" var="Var_FinalStatus" source="done" />
-        </uipath:mapping>
-      </bpmn:extensionElements>
-      <bpmn:incoming>Flow_Wait_To_End</bpmn:incoming>
-    </bpmn:endEvent>
-    <bpmn:sequenceFlow id="Flow_Start_To_Agent" sourceRef="Start_Manual" targetRef="Task_RunAgent" />
-    <bpmn:sequenceFlow id="Flow_Agent_To_Api" sourceRef="Task_RunAgent" targetRef="Task_RunApiWorkflow" />
-    <bpmn:sequenceFlow id="Flow_Api_To_BusinessRule" sourceRef="Task_RunApiWorkflow" targetRef="Task_RunBusinessRule" />
-    <bpmn:sequenceFlow id="Flow_BusinessRule_To_Queue" sourceRef="Task_RunBusinessRule" targetRef="Task_QueueAndWait" />
-    <bpmn:sequenceFlow id="Flow_Queue_To_Case" sourceRef="Task_QueueAndWait" targetRef="Task_StartCaseProcess" />
-    <bpmn:sequenceFlow id="Flow_Case_To_Wait" sourceRef="Task_StartCaseProcess" targetRef="Task_WaitForConnectorEvent" />
-    <bpmn:sequenceFlow id="Flow_Wait_To_End" sourceRef="Task_WaitForConnectorEvent" targetRef="End_Done" />
-  </bpmn:process>
-  <bpmndi:BPMNDiagram id="Diagram_WrapperFamilyContract">
-    <bpmndi:BPMNPlane id="Plane_WrapperFamilyContract" bpmnElement="Process_WrapperFamilyContract">
-      <bpmndi:BPMNShape id="Shape_Start_Manual" bpmnElement="Start_Manual"><dc:Bounds x="80" y="160" width="36" height="36" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_RunAgent" bpmnElement="Task_RunAgent"><dc:Bounds x="170" y="138" width="130" height="80" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_RunApiWorkflow" bpmnElement="Task_RunApiWorkflow"><dc:Bounds x="350" y="138" width="130" height="80" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_RunBusinessRule" bpmnElement="Task_RunBusinessRule"><dc:Bounds x="530" y="138" width="130" height="80" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_QueueAndWait" bpmnElement="Task_QueueAndWait"><dc:Bounds x="710" y="138" width="130" height="80" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_StartCaseProcess" bpmnElement="Task_StartCaseProcess"><dc:Bounds x="890" y="138" width="130" height="80" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_Task_WaitForConnectorEvent" bpmnElement="Task_WaitForConnectorEvent"><dc:Bounds x="1070" y="150" width="100" height="56" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNShape id="Shape_End_Done" bpmnElement="End_Done"><dc:Bounds x="1230" y="160" width="36" height="36" /></bpmndi:BPMNShape>
-      <bpmndi:BPMNEdge id="Edge_Flow_Start_To_Agent" bpmnElement="Flow_Start_To_Agent"><di:waypoint x="116" y="178" /><di:waypoint x="170" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_Agent_To_Api" bpmnElement="Flow_Agent_To_Api"><di:waypoint x="300" y="178" /><di:waypoint x="350" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_Api_To_BusinessRule" bpmnElement="Flow_Api_To_BusinessRule"><di:waypoint x="480" y="178" /><di:waypoint x="530" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_BusinessRule_To_Queue" bpmnElement="Flow_BusinessRule_To_Queue"><di:waypoint x="660" y="178" /><di:waypoint x="710" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_Queue_To_Case" bpmnElement="Flow_Queue_To_Case"><di:waypoint x="840" y="178" /><di:waypoint x="890" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_Case_To_Wait" bpmnElement="Flow_Case_To_Wait"><di:waypoint x="1020" y="178" /><di:waypoint x="1070" y="178" /></bpmndi:BPMNEdge>
-      <bpmndi:BPMNEdge id="Edge_Flow_Wait_To_End" bpmnElement="Flow_Wait_To_End"><di:waypoint x="1170" y="178" /><di:waypoint x="1230" y="178" /></bpmndi:BPMNEdge>
-    </bpmndi:BPMNPlane>
-  </bpmndi:BPMNDiagram>
-</bpmn:definitions>

package/skills/uipath-maestro-bpmn/references/author/CAPABILITY.md

@@ -1,141 +0,0 @@
-# Author - Create and edit BPMN Process Orchestration projects
-
-Capability index for local BPMN project authoring. Author owns source edits, local inspection, validation, and CLI enrichment planning. It does not upload, publish, debug, or run cloud instances.
-
-> Inherits universal rules from [SKILL.md](../../SKILL.md). Read [shared/bpmn-xml-contract.md](../shared/bpmn-xml-contract.md) before changing XML boundaries.
-
-## When to use this capability
-
-- Create a Maestro BPMN project scaffold.
-- Edit `.bpmn` XML for process structure, diagrams, variables, bindings, entry points, scripts, timers, messages, gateways, subprocesses, boundary errors, and documented non-Integration-Service UiPath extensions.
-- Inspect an existing BPMN project and identify source versus generated files.
-- Run the two-pass authoring workflow: standard BPMN skeleton first, operator shape confirmation second, UiPath extension fill last.
-- Plan Integration Service nodes/triggers that must be CLI-enriched.
-- Run local validation before handing off to Operate.
-
-## Context budget
-
-For greenfield authoring, read only the files needed for the current step:
-
-1. This capability file.
-2. [shared/project-layout.md](../shared/project-layout.md).
-3. [shared/bpmn-xml-contract.md](../shared/bpmn-xml-contract.md).
-4. [references/planning-arch.md](references/planning-arch.md) for pass 1.
-5. [references/planning-impl.md](references/planning-impl.md) and only the specific plugin or task recipe needed for pass 2.
-6. [references/validation.md](references/validation.md) before reporting done.
-
-Do not bulk-read the full skill tree or validation fixtures during normal
-authoring. Validation fixtures are coverage examples, not greenfield authoring
-templates. Open fixtures only after a validation failure or a directly linked
-guide requires a concrete example, and then read the smallest relevant fixture.
-
-## Critical rules
-
-1. **Use the two-pass workflow for non-trivial authoring** - first generate or edit a pure BPMN skeleton with readable IDs and diagram geometry, then ask the operator to confirm the process shape, then add UiPath variables, bindings, mappings, entry points, and documented non-Integration-Service extensions.
-2. **Keep pass 1 standard BPMN-first** - pass 1 may include placeholders and annotations for resource intent, but it must not invent `uipath:activity`, `uipath:event`, connector bindings, generated schemas, or package metadata.
-3. **Read the BPMN XML contract before editing** - the Maestro BPMN contract defines which XML the model may author and which pieces require CLI generation or enrichment.
-4. **Default to reviewable file edits for BPMN source** - edit `.bpmn` directly for model-owned XML so diffs stay inspectable.
-5. **Choose BPMN element class before resource recipe** - RPA, agents, and API workflows are service tasks; queue create is a send task; business rules are business rule tasks; HITL is a user task. Task recipes are pass-2 implementation references and assume the skeleton has already been chosen. See [supported-elements.md](references/supported-elements.md).
-6. **Do not hand-author Integration Service details** - use [plugins/integration-service/](references/plugins/integration-service/) for the planning and implementation boundary.
-7. **Keep generated package files derived** - if `bindings_v2.json`, `entry-points.json`, `operate.json`, or `package-descriptor.json` is stale, prefer regeneration or validation over manual patching.
-8. **Every Studio Web-visible element needs diagram geometry** - ensure diagrams, planes, shapes, bounds, edges, and waypoints exist for rendered nodes and flows.
-9. **Validate once the full local edit is coherent** - intermediate BPMN edits may be invalid while IDs, flows, and diagrams are being reconciled.
-10. **Preserve unknown imported extensions** - do not delete extension elements the skill cannot interpret unless the user explicitly asks for normalization.
-11. **Use synthetic examples only** - never copy private exported BPMN into local fixtures, docs, or comments.
-
-## Two-pass workflow
-
-Use this workflow for greenfield projects and for brownfield edits that change topology, entry points, service calls, subprocess boundaries, or variable contracts.
-
-1. **Plan the process shape** - identify starts, human/system steps, gateways, subprocesses, timers/messages, error paths, end states, variables, resources, and Integration Service enrichment needs. See [planning-arch.md](references/planning-arch.md).
-2. **Pass 1: author the BPMN skeleton** - create or edit standard BPMN elements, sequence flows, event definitions, diagram planes, shapes, edges, and placeholder labels. Keep this pass mostly free of UiPath extension XML except preserving existing extensions in brownfield files.
-3. **Operator shape confirmation** - summarize the skeleton in process terms and explicitly confirm starts, branches, joins, subprocess boundaries, error paths, and external-system placeholders before filling execution metadata.
-4. **Pass 2: fill model-owned UiPath XML** - add root variables, entry point IDs, mappings, bindings, scripts, retry/error metadata, and documented non-Integration-Service `uipath:activity` or `uipath:event` shells. See [planning-impl.md](references/planning-impl.md).
-5. **CLI enrichment handoff** - run or request registry-backed enrichment for Integration Service activities/triggers and generated package metadata. If tooling is unavailable, leave draft intent documented and keep the project in Author state.
-6. **Validate and summarize** - run local validation after the source is coherent, then report validation status, generated-file status, and unresolved enrichment blockers.
-
-## Workflow
-
-| Journey | Read |
-| --- | --- |
-| Create a new BPMN project | [references/greenfield.md](references/greenfield.md) |
-| Edit an existing BPMN project | [references/brownfield.md](references/brownfield.md) |
-| Plan the process topology and enrichment boundary | [references/planning-arch.md](references/planning-arch.md) |
-| Fill variables, bindings, expressions, and UiPath extensions | [references/planning-impl.md](references/planning-impl.md) |
-| Choose an editing operation | [references/editing-operations.md](references/editing-operations.md) |
-| Choose what the model may write | [shared/bpmn-xml-contract.md](../shared/bpmn-xml-contract.md) |
-| Choose supported BPMN elements and extension wrappers | [references/supported-elements.md](references/supported-elements.md) |
-| Copy a minimal XML shell for a wrapper | [shared/wrapper-shells.md](../shared/wrapper-shells.md) |
-| Add resource-backed task recipes | [references/task-recipes/](references/task-recipes/) |
-| Work with Integration Service nodes/triggers | [references/plugins/integration-service/](references/plugins/integration-service/) |
-
-## Common tasks
-
-| I need to... | Read these |
-| --- | --- |
-| Understand project files | [shared/project-layout.md](../shared/project-layout.md) |
-| Create a confirmed BPMN skeleton | [references/planning-arch.md](references/planning-arch.md) + [references/greenfield.md](references/greenfield.md) |
-| Add or revise BPMN structure | [references/brownfield.md](references/brownfield.md) + [references/editing-operations.md](references/editing-operations.md) + [shared/bpmn-xml-contract.md](../shared/bpmn-xml-contract.md) |
-| Add variables, mappings, bindings, or expressions | [references/planning-impl.md](references/planning-impl.md) + [shared/variables-bindings-expressions.md](../shared/variables-bindings-expressions.md) |
-| Add lint-compatible runtime expressions | [shared/expression-authoring.md](../shared/expression-authoring.md) |
-| Add retry, boundary errors, or error mappings | [shared/error-handling.md](../shared/error-handling.md) |
-| Select the right BPMN wrapper for RPA, agent, API workflow, queue, HITL, business rule, or call activity work | [references/supported-elements.md](references/supported-elements.md) + [references/task-recipes/](references/task-recipes/) |
-| Add an Integration Service activity or trigger | [references/plugins/integration-service/](references/plugins/integration-service/) |
-| Add a specific BPMN or UiPath extension element | [Plugin references](#plugin-references) |
-| Prepare for upload or run | [references/validation.md](references/validation.md) then [operate/CAPABILITY.md](../operate/CAPABILITY.md) |
-| Keep authored content public-safe | [shared/public-safety.md](../shared/public-safety.md) |
-
-## Anti-patterns
-
-- **Never omit BPMN DI for a process intended for Studio Web.**
-- **Never skip operator shape confirmation for a substantial topology change.**
-- **Never mix skeleton design and executable connector enrichment in one opaque rewrite.**
-- **Never patch generated JSON to hide a BPMN source problem.**
-- **Never paste a real connection ID, folder key, tenant URL, or exported XML snippet into the project.**
-- **Never downgrade an Integration Service node to a generic task just because enrichment is unavailable** - keep the node as a draft intent and report the blocker.
-- **Never assume imported extension XML is disposable** - preserve first, normalize only on explicit request.
-
-## References
-
-### Author-scoped
-
-- [greenfield.md](references/greenfield.md) - create-new-project journey
-- [brownfield.md](references/brownfield.md) - edit-existing-project journey
-- [planning-arch.md](references/planning-arch.md) - pass 1 BPMN skeleton planning
-- [planning-impl.md](references/planning-impl.md) - pass 2 UiPath extension fill
-- [editing-operations.md](references/editing-operations.md) - safe edit operations for BPMN XML
-- [supported-elements.md](references/supported-elements.md) - supported BPMN elements and UiPath extension wrappers
-- [task-recipes/](references/task-recipes/) - BPMN-first recipes for resource-backed tasks
-- [validation.md](references/validation.md) - local validation checklist
-- [plugins/integration-service/](references/plugins/integration-service/) - Integration Service planning and CLI enrichment boundary
-
-### Plugin references
-
-Each plugin reference has a `planning.md` for pass 1 shape/resource decisions and an `impl.md` for pass 2 XML ownership and validation boundaries.
-
-- [plugins/start-end-events/](references/plugins/start-end-events/) - start events, end events, intermediate events, and boundary events
-- [plugins/gateways/](references/plugins/gateways/) - exclusive, inclusive, parallel, and event-based gateways
-- [plugins/sequence-flows/](references/plugins/sequence-flows/) - control-flow edges, conditions, defaults, and diagram waypoints
-- [plugins/service-tasks/](references/plugins/service-tasks/) - base service task boundary; use [task-recipes/](references/task-recipes/) for concrete resource-backed tasks
-- [plugins/connectors/](references/plugins/connectors/) - connector-backed activities, triggers, waits, and dynamic schemas
-- [plugins/waits-triggers/](references/plugins/waits-triggers/) - timers, waits, triggers, receives, and timeout behavior
-- [plugins/script/](references/plugins/script/) - script tasks, script metadata, inputs, outputs, and error paths
-- [plugins/hitl/](references/plugins/hitl/) - user task representation for Action Center work
-- [plugins/queues/](references/plugins/queues/) - send task or service task representation for queue work
-- [plugins/call-activity-subprocess/](references/plugins/call-activity-subprocess/) - call activities, subprocesses, event subprocesses, and scoped mappings
-- [plugins/multi-instance/](references/plugins/multi-instance/) - sequential or parallel collection processing
-- [plugins/agents/](references/plugins/agents/) - service task recipes for agent job and A2A execution shells
-- [plugins/rpa-jobs/](references/plugins/rpa-jobs/) - service task recipe for Orchestrator RPA process execution
-- [plugins/api-workflows/](references/plugins/api-workflows/) - service task recipe for API workflow invocation
-- [plugins/signals/](references/plugins/signals/) - preserve-only signal guidance for imported files
-- [plugins/business-rules/](references/plugins/business-rules/) - business rule task invocation and result routing
-
-### Cross-capability
-
-- [shared/bpmn-xml-contract.md](../shared/bpmn-xml-contract.md) - model-owned versus CLI-owned XML
-- [shared/project-layout.md](../shared/project-layout.md) - source and generated files
-- [shared/variables-bindings-expressions.md](../shared/variables-bindings-expressions.md) - variables, bindings, mappings, expressions
-- [shared/expression-authoring.md](../shared/expression-authoring.md) - lint-compatible runtime expressions
-- [shared/error-handling.md](../shared/error-handling.md) - Maestro retry, boundary error, event subprocess, and error mapping behavior
-- [shared/cli-conventions.md](../shared/cli-conventions.md) - CLI and side-effect conventions
-- [shared/public-safety.md](../shared/public-safety.md) - sanitization rules

package/skills/uipath-maestro-bpmn/references/author/references/brownfield.md

@@ -1,48 +0,0 @@
-# Brownfield Authoring
-
-Use this journey when inspecting or editing an existing Maestro BPMN Process Orchestration project.
-
-## Steps
-
-1. Inventory local files: BPMN source, project metadata, generated JSON, and any package output.
-2. Identify the primary `.bpmn` source file and preserve imported extension XML.
-3. Parse the BPMN mentally before editing: definitions, root process, diagrams, IDs, variables, bindings, entry points, and service extensions.
-4. Classify requested edits as model-owned XML, CLI-owned enrichment, generated package metadata, or cloud lifecycle.
-5. If topology changes, run **pass 1** from [planning-arch.md](planning-arch.md): edit the standard BPMN skeleton first, including IDs, flows, events, gateways, subprocess scopes, and diagram geometry.
-6. Summarize the changed shape and ask for operator confirmation when the edit changes the process path, entry points, subprocess boundaries, or error handling.
-7. Run **pass 2** from [planning-impl.md](planning-impl.md): update model-owned variables, bindings, mappings, entry point IDs, scripts, and non-Integration-Service extension XML.
-8. For Integration Service changes, follow [plugins/integration-service/impl.md](plugins/integration-service/impl.md) and use CLI enrichment where available.
-9. Reconcile IDs, sequence flows, gateway defaults, boundary attachments, scoped variables, binding references, and diagram geometry.
-10. Run local validation from [validation.md](validation.md).
-11. Summarize whether generated JSON needs regeneration before Operate.
-
-## Preservation rules
-
-- Preserve unknown `uipath:*` extension elements.
-- Preserve existing `uipath:migrationVersion` values.
-- Preserve tags unless the user asks to remove them.
-- Preserve generated JSON for comparison, but do not treat it as authoritative over BPMN.
-- Preserve Integration Service payloads as imported unless CLI enrichment is explicitly updating them.
-- Preserve stable element IDs when possible; ID churn makes generated JSON and runtime diagnostics harder to compare.
-
-## Editing operation guide
-
-Use [editing-operations.md](editing-operations.md) for common source mutations:
-
-- Add, delete, or reconnect nodes.
-- Insert gateways.
-- Move logic into a subprocess.
-- Add entry points.
-- Add variables and mappings.
-- Add Integration Service placeholders.
-
-## Red flags
-
-- BPMN imports without any diagram.
-- A diagram plane references a missing process, collaboration, or subprocess.
-- Rendered elements lack shapes or waypoints.
-- Entry point variables reference the wrong start event.
-- Context values reference missing bindings.
-- Integration Service elements contain hand-authored connection details.
-- Generated JSON contains private tenant data in a file intended for commit.
-- A topology edit rewrites UiPath extension XML that was unrelated to the request.

package/skills/uipath-maestro-bpmn/references/author/references/editing-operations.md

@@ -1,75 +0,0 @@
-# Editing Operations
-
-Use this reference to choose how to change existing BPMN projects while preserving source clarity and imported extension XML.
-
-## Tool selection ladder
-
-1. **Reviewable XML edit** - default for `.bpmn` source changes: elements, flows, diagrams, variables, mappings, scripts, and documented non-Integration-Service extensions.
-2. **CLI enrichment or generation** - use for Integration Service activities/triggers, generated schemas, bindings resources, entry points, packaging metadata, and project scaffolding when commands are available.
-3. **Advisory placeholder** - use when the requested executable metadata is CLI-owned but enrichment tooling or user resource selection is unavailable.
-4. **Bulk rewrite** - use only when most of the BPMN source is being replaced, and preserve or explicitly account for existing extension payloads first.
-
-Do not patch generated JSON files as the primary way to fix source behavior.
-
-## Add a task or event
-
-1. Add the BPMN element with a stable ID and public-safe name.
-2. Add incoming and outgoing sequence flow references on the element.
-3. Add sequence flow elements in the owning process or subprocess scope.
-4. Add or update BPMN DI shape and edge waypoints.
-5. Add pass 2 extension XML only after the shape is confirmed.
-
-## Delete a node
-
-1. Identify incoming and outgoing flows, attached boundary events, data associations, mappings, and diagram shapes.
-2. Decide whether neighboring nodes should reconnect or whether the branch should be removed.
-3. Remove orphaned sequence flows and BPMN DI edges.
-4. Remove or preserve extension data intentionally; do not delete unknown `uipath:*` payloads unless normalizing explicitly.
-5. Recheck entry point variables, output mappings, and binding references.
-
-## Insert a gateway
-
-1. Split the existing sequence flow into incoming and outgoing flows.
-2. Add gateway conditions to outgoing flows when it is a decision split.
-3. Set a default flow when a fallthrough route exists.
-4. Add a matching join only when branches actually need synchronization.
-5. Add gateway shape and all edge waypoints.
-
-## Move logic into a subprocess
-
-1. Move only elements that share a valid scope.
-2. Recreate incoming/outgoing flow boundaries with legal subprocess connections.
-3. Add a subprocess shape and, when nested content must render in Studio Web, a second diagram plane for the subprocess.
-4. Move variables into subprocess scope only when every mapping and expression remains valid.
-5. Preserve existing extension payloads and migration metadata.
-
-## Add an entry point
-
-1. Use a root-level start event.
-2. Add `uipath:entryPointId` with a generated stable unique value.
-3. Add input variables with `elementId` matching the start event.
-4. Ensure outputs are declared as root output variables and mapped by reachable end events.
-5. Validate generated `entry-points.json` when package files exist.
-
-## Add a variable or mapping
-
-1. Choose root or subprocess scope deliberately.
-2. Add the variable before adding mappings or expressions that reference it.
-3. Use CDATA for JSON schema bodies.
-4. Add `uipath:mapping` or service outputs that reference declared variables.
-5. Validate all output targets and entry point schema extraction.
-
-## Add an Integration Service activity or trigger
-
-1. Add the standard BPMN wrapper and diagram geometry in pass 1.
-2. Record connector, operation/event, object, filters, required inputs, connection selection, and outputs.
-3. Use CLI enrichment for `uipath:activity` or `uipath:event` payloads, bindings, and schemas.
-4. Treat missing enrichment as a blocker for upload/debug/publish/run.
-
-## Brownfield preservation checklist
-
-- Preserve unknown `uipath:*` extension elements.
-- Preserve `uipath:migrationVersion` and tags.
-- Preserve generated JSON for comparison unless regeneration is requested.
-- Preserve private values already present locally, but never copy them into docs, fixtures, or commit messages.
-- Report suspected private values in files intended for commit.

package/skills/uipath-maestro-bpmn/references/author/references/greenfield.md

@@ -1,41 +0,0 @@
-# Greenfield Authoring
-
-Use this journey when creating a new Maestro BPMN Process Orchestration project.
-
-## Steps
-
-1. Confirm the requested process goal, trigger, major steps, external systems, and resources that already exist.
-2. Create the canonical project scaffold using the available Maestro BPMN scaffolding command or the repository's current Maestro project template.
-3. Create or edit the primary `.bpmn` file as the source of record.
-4. **Pass 1: build the standard BPMN skeleton** from [planning-arch.md](planning-arch.md): root process, starts, tasks, gateways, subprocesses, events, error paths, sequence flows, and BPMN DI.
-5. Summarize the process shape and ask the operator to confirm it before filling executable UiPath metadata when the process is non-trivial.
-6. **Pass 2: fill model-owned UiPath XML** from [planning-impl.md](planning-impl.md): root variables, entry point IDs, mappings, bindings, scripts, retry/error metadata, and documented non-Integration-Service service shells.
-7. For Integration Service activities/triggers, follow [plugins/integration-service/planning.md](plugins/integration-service/planning.md) and leave CLI-owned details to enrichment.
-8. Run local validation from [validation.md](validation.md).
-9. Hand off to Operate only after validation is clean or the remaining issues are explicit user-approved warnings.
-
-## Design defaults
-
-- Prefer a simple root process before adding pools or collaborations.
-- Prefer readable deterministic element IDs.
-- Keep diagram layout simple and inspectable.
-- Use placeholder-safe resource names until discovery/enrichment resolves real resources.
-- Keep pass 1 skeleton diffs separate from pass 2 execution metadata when practical.
-- Keep all examples and fixtures synthetic.
-
-## Shape confirmation prompt
-
-For non-trivial processes, summarize:
-
-- Trigger and entry point.
-- Ordered happy path.
-- Branches, joins, and default paths.
-- Error, timeout, and terminate behavior.
-- Subprocess boundaries.
-- External-system placeholders and enrichment blockers.
-
-Proceed to pass 2 only after the operator confirms the shape or the edit is small enough to summarize without a formal stop.
-
-## Done state
-
-Authoring is done when BPMN source is coherent, generated or CLI-managed files are up to date or intentionally absent, validation has been run, and any Integration Service enrichment blockers are documented.

package/skills/uipath-maestro-bpmn/references/author/references/planning-arch.md

@@ -1,82 +0,0 @@
-# Planning Architecture
-
-Use this reference for pass 1 of BPMN authoring: create a standard BPMN skeleton that the operator can understand and confirm before execution-specific UiPath XML is filled.
-
-## Pass 1 goal
-
-Pass 1 produces a reviewable process shape:
-
-- Root process or collaboration choice.
-- Start events and intended entry points.
-- Tasks, subprocesses, gateways, events, error boundaries, and end states.
-- Sequence flows, conditions in plain process terms, and default routes.
-- Diagram plane, shapes, bounds, edges, and waypoints.
-- Placeholder labels or annotations for external resources that need pass 2 or CLI enrichment.
-
-Pass 1 does not need runnable UiPath service metadata. It should be valid enough to inspect as BPMN, but it may intentionally leave executable service details unresolved.
-
-## Intake checklist
-
-Before drafting the skeleton, identify:
-
-- Process trigger: manual start, schedule, message, Integration Service trigger, timer, or another process.
-- Happy path steps and the owner of each step: human, BPMN script, Orchestrator process, agent, API workflow, queue, business rule, message, or connector.
-- Branching conditions and whether each gateway needs a default route.
-- Parallel work and join behavior.
-- Subprocess boundaries and whether nested content must render in Studio Web.
-- Retry and error-handling intent: boundary error, event subprocess, terminate end, or normal compensation path.
-- Variables crossing entry points, subprocesses, service tasks, and end events.
-- Resources that already exist versus placeholders that need discovery or CLI enrichment.
-
-## Skeleton authoring rules
-
-- Use one executable root `bpmn:process` by default.
-- Use collaboration and pools only when the user explicitly requests cross-participant modeling.
-- Prefer stable, readable IDs such as `Start_RequestReceived`, `Task_CheckEligibility`, `Gateway_Approved`, and `Flow_Check_To_Approve`.
-- Keep labels public-safe and user-readable.
-- Create BPMN DI while creating elements; do not leave layout as a later afterthought.
-- Put conditions on outgoing sequence flows from exclusive or inclusive gateway splits.
-- Keep pass 1 conditions in business-readable terms. Do not use
-  Maestro runtime expressions such as `=vars.<variableId>` until pass 2 has
-  declared the variables and mappings those expressions reference.
-- Keep script tasks structural in pass 1. A pass 1 `bpmn:scriptTask` may have a
-  readable name or documentation, but executable script bodies and
-  UiPath script mappings belong in pass 2.
-- Set a `default` sequence flow when the business process has a fallthrough route.
-- Model errors with boundary events or event subprocesses instead of unlabeled failure branches when the runtime should handle failures structurally.
-- Keep sequence flows inside their owning process or subprocess scope.
-
-## Operator confirmation
-
-After pass 1, summarize the shape in business terms and wait for confirmation when the change is non-trivial.
-
-Confirmation should cover:
-
-- Entry points and trigger type.
-- Step order and major branches.
-- Join semantics for parallel branches.
-- Subprocess boundaries.
-- Error and timeout behavior.
-- Which placeholders represent Integration Service, Orchestrator, HITL, agent, queue, API workflow, or other resources.
-- Any intentionally unresolved resource selection.
-
-For small edits, confirmation can be a concise statement such as: "I changed only the timeout branch from Task_A to Event_Timeout and kept all existing variables and service metadata unchanged."
-
-## Integration Service placeholders
-
-When a connector activity or trigger is needed in pass 1:
-
-- Add the surrounding BPMN element with a stable ID and public-safe label.
-- Record connector intent: connector, operation/event, object, filters, required parameters, and desired outputs.
-- Do not author `Intsvc.*` context, connection binding IDs, connector metadata, dynamic schemas, or generated outputs by hand.
-- Mark enrichment as required before upload, debug, publish, or deploy.
-
-For plain connectionless HTTP where the workflow owns the URL, method, payload,
-and parsing, record the node as a plain HTTP candidate in pass 1 instead of
-treating it as connector enrichment. After the operator confirms the skeleton,
-use [task-recipes/http-request.md](task-recipes/http-request.md) only for the
-pass-2 executable wrapper.
-
-## Done state
-
-Pass 1 is done when the operator can review the BPMN diagram and answer: "Is this the process shape we want?" without needing to inspect UiPath extension XML.