@uipath/maestro-builder-sdk 6.9.5 → 6.10.1

package/README.md

@@ -102,7 +102,7 @@ the question. Now `check` has something to say:
 ⚠ [LOOKUP_UNRESOLVED] Connector step "announce": input "channel" is an unresolved
   lookup (profile.email="ada@example.com"). Compile does not make network calls, so
   the value has to be resolved first:
-    npx flow-sdk registry prepare uipath-salesforce-slack send-message-to-user \
+    npx flow-sdk registry prepare uipath-salesforce-slack --action send-message-to-user \
       --resolve channel:profile.email=ada@example.com
   Compile will fail until this is recorded.
 
@@ -117,7 +117,7 @@ to the tenant. Run what `check` named, both fields at once:
 ```bash
 npx flow-sdk registry pull    # once per machine: the connector library
 
-npx flow-sdk registry prepare uipath-salesforce-slack send-message-to-user \
+npx flow-sdk registry prepare uipath-salesforce-slack --action send-message-to-user \
   --resolve channel:profile.email=ada@example.com \
   --resolve send_as:name=bot
 ```
@@ -181,10 +181,24 @@ authoring verbs.
 
 The UiPath CLI resolves `@uipath/maestro-builder-sdk/package.json` from the caller's current
 directory, checks the installed version, and spawns
-`node <package>/dist/cli/index.js <family> <verb> …` with inherited cwd, environment,
-and stdio. It never imports or bundles the SDK. This preserves the runtime class
+`node <package>/dist/cli/index.js <family> <verb> …` with inherited cwd and
+environment. It captures stdout and wraps it in its own `{ Result, Code, Data }`
+envelope, and streams stderr through. It never imports or bundles the SDK. This preserves the runtime class
 identity shared by the authored TypeScript and serializer.
 
+**Machine-readable results.** Every verb takes `--json`: stdout then carries exactly
+one JSON object, `ok` (the exit code was 0) plus that verb's fields, and the human
+lines move to stderr. For instance:
+
+```bash
+$ npx flow-sdk flow compile Hello -o Hello.flow --json
+{"ok":true,"path":"/work/Hello.flow","nodes":3,"edges":2,"sidecars":[],"errors":0,"warnings":0,"diagnostics":[]}
+```
+
+`check` reports `errors`, `warnings` and `diagnostics`; `compile`, `decompile`,
+`merge` and `tidy` report the `path` they wrote. `package.json` lists the optional
+surface a caller may probe for in `cliCapabilities` (`json-result`).
+
 The stable argv grammar is family first: `flow|case|bpmn`, then the SDK verb and
 its documented options. The process exit contract is `0` for success, `1` for
 diagnostics, and `2` for usage errors or a blocked mode. Changes to the spawn path,

package/dist/api-index.md

@@ -70,8 +70,8 @@ could hand you spans for a version you do not have.
 | `CaseValue` | type | `dist/flow-sdk.d.ts:287-288` | Supporting types | A value a `.switch` case compares the discriminant against. |
 | `ChildFlow` | type | `dist/flow-sdk.d.ts:43-46` | Supporting types | Anything `subflow()` accepts as the child: a builder, or an already-built flow. |
 | `ClientSideToolRef` | interface | `dist/core/actions.d.ts:1686-1701` | Supporting types | A CLIENT-side tool: the agent asks the CALLING application to run it and hand the answer back… |
-| `connector` | function | `dist/core/actions.d.ts:3266-3289` | Actions | Declare an Integration Service connector action — the typed form, where a generated descriptor supplies the nodeType and… |
-| `connector` | function | `dist/core/actions.d.ts:3290-3306` | Actions | Stringly form, for a connector with no prepared module — `connector('uipath-salesforce-slack',… |
+| `connector` | function | `dist/core/actions.d.ts:3265-3288` | Actions | Declare an Integration Service connector action — the typed form, where a generated descriptor supplies the nodeType and… |
+| `connector` | function | `dist/core/actions.d.ts:3289-3305` | Actions | Stringly form, for a connector with no prepared module — `connector('uipath-salesforce-slack',… |
 | `ConnectorDescriptor` | type | `dist/core/connectors.d.ts:89-97` | Generated descriptors | A generated, typed connector descriptor: ConnectorMeta branded with phantom input/output types. |
 | `ConnectorLookupValue` | type | `dist/core/connectors.d.ts:50-59` | Generated descriptors | ConnectorValue for a field that also accepts an unresolved lookup. |
 | `ConnectorMeta` | interface | `dist/core/connectors.d.ts:60-88` | Generated descriptors | Runtime metadata a generated descriptor carries. |
@@ -90,17 +90,17 @@ could hand you spans for a version you do not have.
 | `createOutgoingCall` | function | `dist/core/actions.d.ts:2881-2897` | Actions | Place an outgoing phone call (`uipath.conversational.voice.create-outgoing-call`) and get back the `callContext` every… |
 | `CreateOutgoingCallInputs` | interface | `dist/core/actions.d.ts:710-718` | Option shapes | 2 field(s) |
 | `CustomGuardrail` | interface | `dist/core/actions.d.ts:1313-1325` | Supporting types | A rule-based guardrail you author in place. |
-| `dataFabricCreate` | function | `dist/core/actions.d.ts:3168-3185` | Actions | Create an entity record in Data Fabric (`core.datafabric.create`). |
+| `dataFabricCreate` | function | `dist/core/actions.d.ts:3167-3184` | Actions | Create an entity record in Data Fabric (`core.datafabric.create`). |
 | `DataFabricCreateInputs` | interface | `dist/core/actions.d.ts:2161-2191` | Option shapes | 4 field(s) |
-| `dataFabricDelete` | function | `dist/core/actions.d.ts:3202-3219` | Actions | Delete an entity record from Data Fabric (`core.datafabric.delete`). |
+| `dataFabricDelete` | function | `dist/core/actions.d.ts:3201-3218` | Actions | Delete an entity record from Data Fabric (`core.datafabric.delete`). |
 | `DataFabricDeleteInputs` | interface | `dist/core/actions.d.ts:2224-2250` | Option shapes | 4 field(s) |
 | `DataFabricFilter` | interface | `dist/core/actions.d.ts:2052-2083` | Supporting types | One filter row on a Data Fabric query — rows AND together unless `or` is set. |
 | `DataFabricOperator` | type | `dist/core/actions.d.ts:2041-2051` | Supporting types | The comparison operators the Data Fabric query serializer can emit, spelled exactly as the file carries them. |
-| `dataFabricRead` | function | `dist/core/actions.d.ts:3128-3167` | Actions | Query entity records from Data Fabric (`core.datafabric.read`). |
+| `dataFabricRead` | function | `dist/core/actions.d.ts:3128-3166` | Actions | Query entity records from Data Fabric (`core.datafabric.read`). |
 | `DataFabricReadInputs` | interface | `dist/core/actions.d.ts:2108-2160` | Option shapes | 9 field(s) |
 | `DataFabricRecordRef` | type | `dist/core/actions.d.ts:2091-2107` | Supporting types | Which record a Data Fabric write targets — exactly ONE of the two forms. |
 | `DataFabricSort` | interface | `dist/core/actions.d.ts:2084-2090` | Supporting types | How a multi-record query orders its rows before the limit is applied. |
-| `dataFabricUpdate` | function | `dist/core/actions.d.ts:3186-3201` | Actions | Update an entity record in Data Fabric (`core.datafabric.update`). |
+| `dataFabricUpdate` | function | `dist/core/actions.d.ts:3185-3200` | Actions | Update an entity record in Data Fabric (`core.datafabric.update`). |
 | `DataFabricUpdateInputs` | interface | `dist/core/actions.d.ts:2192-2223` | Option shapes | 5 field(s) |
 | `DEFAULT_TRIGGER_ID` | const | `dist/core/expr.d.ts:36-37` | Expressions and types | The manual trigger node's default id. |
 | `DefinitionReference` | type | `dist/core/node-classes.d.ts:30-63` | Supporting types | An exact reference to the node definition a contribution compiles against. |
@@ -121,8 +121,8 @@ could hand you spans for a version you do not have.
 | `err` | function | `dist/core/expr.d.ts:148-235` | Expressions and types | Reference a FAILED step's error → `$vars.<step>.error[.<field>]`. |
 | `ErrorEnvelopeField` | type | `dist/core/expr.d.ts:137-147` | Supporting types | The fields a failure envelope carries. |
 | `EscalationRef` | interface | `dist/core/actions.d.ts:1880-1934` | Supporting types | One escalation an inline agent may raise — an Action Center app task a human completes (the `coded-action-app` variant,… |
-| `EventFilter` | type | `dist/core/actions.d.ts:3307-3348` | Supporting types | One filter condition on the event payload. |
-| `EventSubscription` | interface | `dist/core/actions.d.ts:3394-3432` | Option shapes | What a connector event subscribes to. |
+| `EventFilter` | type | `dist/core/actions.d.ts:3306-3347` | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts:3393-3431` | Option shapes | What a connector event subscribes to. |
 | `Expr` | class | `dist/core/expr.d.ts:11-21` | Supporting types | A Flow expression. |
 | `FieldMapping` | interface | `dist/core/actions.d.ts:237-244` | Supporting types | 3 field(s) |
 | `FilterCondition` | type | `dist/core/actions.d.ts:220-221` | Supporting types | Comparison a filter rule applies to a field. |
@@ -197,7 +197,7 @@ could hand you spans for a version you do not have.
 | `ProcessToolRef` | interface | `dist/core/actions.d.ts:1811-1840` | Supporting types | A deployed tenant resource the agent may invoke. |
 | `publishedFunction` | function | `dist/core/actions.d.ts:2805-2829` | Actions | Invoke a published Orchestrator **Function** — a deployed unit of code run as one step (`uipath.core.function.<key>`,… |
 | `PublishedFunctionInputs` | interface | `dist/core/actions.d.ts:1029-1063` | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
-| `queueItem` | function | `dist/core/actions.d.ts:3220-3265` | Actions | Declare an Orchestrator QUEUE ITEM step. |
+| `queueItem` | function | `dist/core/actions.d.ts:3219-3264` | Actions | Declare an Orchestrator QUEUE ITEM step. |
 | `QueueItemInputs` | interface | `dist/core/actions.d.ts:1972-2040` | Option shapes | 10 field(s) |
 | `QueuePriority` | type | `dist/core/actions.d.ts:1970-1971` | Supporting types | The three priorities an Orchestrator queue item can carry. |
 | `ran` | function | `dist/core/expr.d.ts:90-136` | Expressions and types | Did this step run? |
@@ -242,7 +242,7 @@ could hand you spans for a version you do not have.
 | `triggerDescriptor` | function | `dist/core/connectors.d.ts:139-151` | Generated descriptors | Brand a trigger descriptor literal with its where/output types. |
 | `TriggerDescriptor` | type | `dist/core/connectors.d.ts:130-138` | Generated descriptors | A generated, typed connector-trigger descriptor: TriggerMeta branded with phantom `where`/output types. |
 | `TriggerMeta` | interface | `dist/core/connectors.d.ts:120-129` | Generated descriptors | Runtime metadata a generated trigger descriptor carries. |
-| `TriggerOptions` | interface | `dist/core/actions.d.ts:3349-3393` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts:3348-3392` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
 | `TriggerSpec` | type | `dist/flow-sdk.d.ts:111-129` | Supporting types | What starts the flow. |
 | `TypeDesc` | type | `dist/core/expr.d.ts:323` | Supporting types |  |
 | `types` | const | `dist/core/expr.d.ts:307-322` | Expressions and types | Variable type descriptors (map to Flow variable `type` values). |
@@ -254,8 +254,8 @@ could hand you spans for a version you do not have.
 | `VoiceAgentInputs` | interface | `dist/core/actions.d.ts:750-783` | Option shapes | 6 field(s) |
 | `VoiceSettings` | interface | `dist/core/actions.d.ts:727-749` | Supporting types | The audio settings a voice agent speaks with. |
 | `voiceTrigger` | function | `dist/flow-sdk.d.ts:262-286` | Flow construction | Start the flow when a phone call comes IN (`core.trigger.voice`). |
-| `waitForEvent` | function | `dist/core/actions.d.ts:3442-3476` | Actions | Wait mid-flow until a connector event fires, then continue with its payload — the typed form, where a generated trigger… |
-| `waitForEvent` | function | `dist/core/actions.d.ts:3477-3484` | Actions | Stringly form, for an event with no prepared module. |
+| `waitForEvent` | function | `dist/core/actions.d.ts:3441-3475` | Actions | Wait mid-flow until a connector event fires, then continue with its payload — the typed form, where a generated trigger… |
+| `waitForEvent` | function | `dist/core/actions.d.ts:3476-3483` | Actions | Stringly form, for an event with no prepared module. |
 | `waitForMessage` | function | `dist/core/actions.d.ts:2849-2865` | Actions | PAUSE until the person sends their next message (`uipath.conversational.wait-for-message`) — a catch event, like… |
 | `WaitForMessageInputs` | interface | `dist/core/actions.d.ts:631-639` | Option shapes | 2 field(s) |
 
@@ -299,8 +299,8 @@ could hand you spans for a version you do not have.
 | `EscalationOpts` | interface | `dist/case/case-sdk.d.ts:127-139` | Option shapes | 4 field(s) |
 | `EscalationRecipient` | interface | `dist/case/case-sdk.d.ts:119-126` | Supporting types | Who an escalation notifies. |
 | `EscalationTrigger` | type | `dist/case/case-sdk.d.ts:117-118` | Supporting types | When an escalation fires: as the deadline approaches (`at-risk`) or once it passes (`sla-breached`). |
-| `EventFilter` | type | `dist/core/actions.d.ts:3307-3348` | Supporting types | One filter condition on the event payload. |
-| `EventSubscription` | interface | `dist/core/actions.d.ts:3394-3432` | Option shapes | What a connector event subscribes to. |
+| `EventFilter` | type | `dist/core/actions.d.ts:3306-3347` | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts:3393-3431` | Option shapes | What a connector event subscribes to. |
 | `eventTrigger` | function | `dist/case/case-sdk.d.ts:276-286` | Case authoring | An Integration Service **event** trigger — an external event (a new row, an email, a webhook) starts the case. |
 | `eventTrigger` | function | `dist/case/case-sdk.d.ts:287-293` | Case authoring | An Integration Service event trigger in placeholder or stringly-resolved form. |
 | `EventTriggerOpts` | interface | `dist/case/case-sdk.d.ts:239-263` | Option shapes | 4 field(s) |
@@ -336,7 +336,7 @@ could hand you spans for a version you do not have.
 | `toUser` | function | `dist/case/case-sdk.d.ts:150-157` | Case authoring | An escalation recipient that is a single user. |
 | `TriggerDescriptor` | type | `dist/core/connectors.d.ts:130-138` | Supporting types | A generated, typed connector-trigger descriptor: TriggerMeta branded with phantom `where`/output types. |
 | `TriggerMeta` | interface | `dist/core/connectors.d.ts:120-129` | Supporting types | Runtime metadata a generated trigger descriptor carries. |
-| `TriggerOptions` | interface | `dist/core/actions.d.ts:3349-3393` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts:3348-3392` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
 | `TypeDesc` | type | `dist/core/expr.d.ts:323` | Supporting types |  |
 | `UnresolvedReferenceTaskKind` | type | `dist/case/case-sdk.d.ts:358-359` | Supporting types | Published-resource task kinds that the Case schema permits as unresolved skeletons. |
 | `WaitConnectorPlaceholderSpec` | interface | `dist/case/case-sdk.d.ts:360-370` | Supporting types | A `wait-for-connector` subscription: suspend on an Integration Service event. |

package/dist/api-members.md

@@ -128,14 +128,14 @@ not find it either.
 | `condition` | property | `HttpBranch` | `dist/core/actions.d.ts:23-28` |
 | `connection` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1088-1089` |
 | `connection` | property | `ConnectorOpts` | `dist/core/actions.d.ts:180-181` |
-| `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3427-3428` |
+| `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3426-3427` |
 | `connection` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:393-394` |
 | `connection` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1127-1128` |
-| `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3387-3388` |
+| `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3386-3387` |
 | `connections` | property | `HitlRecipient` | `dist/core/actions.d.ts:425-429` |
 | `connector` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:506` |
 | `connector` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1786-1787` |
-| `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3396-3397` |
+| `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3395-3396` |
 | `connector` | property | `ExternalTaskSpecData` | `dist/case/case-sdk.d.ts:406-407` |
 | `connector` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:56-62` |
 | `connector` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1460-1479` |
@@ -264,7 +264,7 @@ not find it either.
 | `escalation` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:69-74` |
 | `escalations` | property | `BuiltSla` | `dist/case/case-sdk.d.ts:193` |
 | `escalations` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:183-184` |
-| `event` | property | `EventSubscription` | `dist/core/actions.d.ts:3398-3399` |
+| `event` | property | `EventSubscription` | `dist/core/actions.d.ts:3397-3398` |
 | `event` | property | `TriggerMeta` | `dist/core/connectors.d.ts:124-125` |
 | `eventBasedGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1405-1414` |
 | `eventOutputs` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:203-204` |
@@ -311,19 +311,19 @@ not find it either.
 | `fileRef` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:897-911` |
 | `filter` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1096-1102` |
 | `filters` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2111-2112` |
-| `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3425-3426` |
-| `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3385-3386` |
+| `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3424-3425` |
+| `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3384-3385` |
 | `flavour` | property | `AgentInputs` | `dist/core/actions.d.ts:1225-1239` |
 | `flowProcess` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:783-792` |
 | `flows` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:413-414` |
 | `folder` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1090-1091` |
 | `folder` | property | `ConnectorOpts` | `dist/core/actions.d.ts:182-183` |
-| `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3429-3430` |
+| `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3428-3429` |
 | `folder` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:395-396` |
 | `folder` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1129-1130` |
 | `folder` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:915-916` |
 | `folder` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:959-960` |
-| `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3389-3390` |
+| `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3388-3389` |
 | `folderKey` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1746-1747` |
 | `folderKey` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1953-1954` |
 | `folderKey` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2170-2178` |
@@ -594,8 +594,8 @@ not find it either.
 | `numExchanges` | property | `WaitForMessageInputs` | `dist/core/actions.d.ts:634-638` |
 | `object` | property | `ConnectorOpts` | `dist/core/actions.d.ts:184-216` |
 | `object` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1792-1793` |
-| `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3419-3424` |
-| `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3374-3384` |
+| `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3418-3423` |
+| `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3373-3383` |
 | `objectName` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:66-75` |
 | `objectName` | property | `LookupSpec` | `dist/core/lookups.d.ts:23-24` |
 | `objectName` | property | `SelectNextStageSpec` | `dist/case/case-sdk.d.ts:302-303` |
@@ -960,12 +960,12 @@ not find it either.
 | `version` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:63` |
 | `version` | property | `ConnectorOpts` | `dist/core/actions.d.ts:178-179` |
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1790-1791` |
-| `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3431` |
+| `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3430` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1131-1132` |
 | `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1260-1273` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:314-321` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
-| `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3391-3392` |
+| `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3390-3391` |
 | `versionTag` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:914-915` |
 | `versionTag` | property | `IxpToolRef` | `dist/core/actions.d.ts:1868-1869` |
 | `voice` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:769-770` |
@@ -978,8 +978,8 @@ not find it either.
 | `waitForTimer` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:877-883` |
 | `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:547-552` |
 | `when` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:176-182` |
-| `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3400-3418` |
-| `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3356-3373` |
+| `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3399-3417` |
+| `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3355-3372` |
 | `width` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:604-605` |
 | `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:602-603` |
 | `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:598-599` |

package/dist/bpmn/check-cli.js

@@ -7,6 +7,7 @@
  *
  * Exit 0 = clean; exit 1 = at least one error. Warnings print but do not fail.
  */
+import { reportDiagnostics } from '../cli-result.js';
 import { resolveBpmnFile, loadBuiltBpmn } from './load.js';
 import { check } from './check.js';
 import { runWhenInvokedDirectly } from '../cli-run.js';
@@ -19,6 +20,7 @@ export async function run(argv) {
     ensureTypeScriptRuntime();
     const built = await loadBuiltBpmn(resolveBpmnFile(argv[0]));
     const diags = check(built);
+    reportDiagnostics(diags);
     for (const d of diags)
         console.error(`  ${d.level === 'error' ? '✗' : '⚠'} [${d.code}] ${d.message}`);
     const errors = diags.filter((d) => d.level === 'error').length;

package/dist/bpmn/compile-cli.js

@@ -9,8 +9,9 @@
  * XML (semantic-only — no diagram). The authoritative deploy gate is
  * `uip maestro bpmn validate`; a separate "tidy" step lays the diagram out.
  */
+import { reportResult } from '../cli-result.js';
 import { writeFileSync, existsSync } from 'node:fs';
-import { basename, join } from 'node:path';
+import { basename, join, resolve } from 'node:path';
 import { resolveBpmnFile, loadBuiltBpmn } from './load.js';
 import { serialize } from './serialize.js';
 import { check } from './check.js';
@@ -55,6 +56,7 @@ export async function run(argv) {
     const out = opt(argv, '-o') ?? `${base}.bpmn`;
     writeFileSync(out, xml);
     console.log(`compile: wrote ${out} (${built.nodes.length} element(s))`);
+    reportResult({ path: resolve(out), elements: built.nodes.length });
     return 0;
 }
 runWhenInvokedDirectly(import.meta.url, 'compile', run);

package/dist/bpmn/decompile-cli.js

@@ -16,8 +16,9 @@
  * `tidy` regenerates `bpmndi`. Run `tidy` on the recompiled artifact when a canvas
  * needs one.
  */
+import { reportResult } from '../cli-result.js';
 import { readFileSync, writeFileSync } from 'node:fs';
-import { basename } from 'node:path';
+import { basename, resolve } from 'node:path';
 import { runWhenInvokedDirectly } from '../cli-run.js';
 import { decompile } from './decompile.js';
 import { BPMN_IMPORT } from '../package-name.js';
@@ -49,6 +50,7 @@ export async function run(argv) {
     const out = opt(argv, '-o') ?? `${base}.bpmn.ts`;
     writeFileSync(out, source);
     console.log(`decompile: wrote ${out}`);
+    reportResult({ path: resolve(out) });
     return 0;
 }
 runWhenInvokedDirectly(import.meta.url, 'decompile', run);

package/dist/bpmn/merge-cli.js

@@ -10,8 +10,9 @@
  * every element you did not touch is emitted from the original byte for byte. Omit it for
  * a two-way merge (take the edited process, keep the original diagram). See merge.ts.
  */
+import { reportResult } from '../cli-result.js';
 import { readFileSync, writeFileSync } from 'node:fs';
-import { basename } from 'node:path';
+import { basename, resolve } from 'node:path';
 import { mergeBpmn } from './merge.js';
 import { runWhenInvokedDirectly } from '../cli-run.js';
 function opt(argv, name) {
@@ -36,6 +37,7 @@ export function run(argv) {
     });
     const out = opt(argv, '-o') ?? 'merged.bpmn';
     writeFileSync(out, result.xml);
+    reportResult({ path: resolve(out), preserved: result.preserved.length, authored: result.authored.length, removed: result.removed.length });
     // Say what was kept and what was rewritten: on a surgical edit the preserved count
     // should dwarf the authored one, and a reader who sees otherwise has learned something.
     console.log(`bpmn-merge: wrote ${basename(out)} (${result.preserved.length} preserved, ` +

package/dist/bpmn/tidy-cli.js

@@ -10,6 +10,8 @@
  * the file imports into a visual canvas. The `uipath:*` extension payloads are
  * preserved. Overwrites the input unless `-o` is given.
  */
+import { resolve } from 'node:path';
+import { reportResult } from '../cli-result.js';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { layoutProcess } from 'bpmn-auto-layout';
 import { finalizeBpmnXml } from './serialize.js';
@@ -34,6 +36,7 @@ export async function run(argv) {
     writeFileSync(out, laidOut.endsWith('\n') ? laidOut : laidOut + '\n');
     const shapes = (laidOut.match(/BPMNShape/g) ?? []).length;
     console.log(`tidy: laid out ${out} (${shapes} shape(s))`);
+    reportResult({ path: resolve(out), shapes });
     return 0;
 }
 runWhenInvokedDirectly(import.meta.url, 'tidy', run);

package/dist/case/check-cli.js

@@ -5,6 +5,7 @@
  * Usage: node --experimental-strip-types check-cli.js <case.ts | BaseName>
  * Exits 0 when clean (warnings allowed), 1 on any error.
  */
+import { reportDiagnostics } from '../cli-result.js';
 import { resolveCaseFile, loadBuiltCase } from './load.js';
 import { check } from './check.js';
 import { runWhenInvokedDirectly } from '../cli-run.js';
@@ -18,6 +19,7 @@ export async function run(argv) {
     ensureTypeScriptRuntime();
     const built = await loadBuiltCase(file);
     const diags = check(built);
+    reportDiagnostics(diags);
     for (const d of diags)
         console.error(`  ${d.level === 'error' ? '✗' : '⚠'} [${d.code}] ${d.message}`);
     const errors = diags.filter((d) => d.level === 'error');

package/dist/case/compile-cli.js

@@ -9,8 +9,9 @@
  * caseplan.json. The authoritative deploy gate is `uip maestro case validate`.
  * Output defaults to `caseplan.json` (the platform's canonical file name).
  */
+import { reportResult } from '../cli-result.js';
 import { writeFileSync, readFileSync, existsSync } from 'node:fs';
-import { join, dirname, basename } from 'node:path';
+import { join, dirname, basename, resolve } from 'node:path';
 import { createHash } from 'node:crypto';
 import { resolveCaseFile, loadBuiltCase } from './load.js';
 import { serialize } from './serialize.js';
@@ -69,6 +70,7 @@ export async function run(argv) {
     const resources = syncBindingsV2(caseplan, out);
     const bindingsNote = resources >= 0 ? `, synced bindings_v2.json (${resources} resource(s))` : '';
     console.log(`compile: wrote ${out} (${stages} stage(s))${epNote}${bindingsNote}`);
+    reportResult({ path: resolve(out), stages, ...(triggers >= 0 ? { triggers } : {}), ...(resources >= 0 ? { resources } : {}) });
     return 0;
 }
 /**

package/dist/case/decompile-cli.js

@@ -15,6 +15,7 @@
  * command also emits a `<Name>.pipeline.mjs` helper that recompiles edits
  * through the public Case CLI. Pass `--no-pipeline` to skip it.
  */
+import { reportResult } from '../cli-result.js';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { resolveLibraryDir } from '../registry/cache.js';
 import { basename, resolve } from 'node:path';
@@ -66,6 +67,7 @@ export function run(argv) {
     const out = opt(argv, '-o') ?? `${baseName(plan)}.case.ts`;
     writeFileSync(out, result.source);
     console.log(`decompile: wrote ${basename(out)}`);
+    reportResult({ path: resolve(out), diagnostics: result.diagnostics.map((d) => ({ code: d.code, location: d.location, message: d.message })) });
     for (const diagnostic of result.diagnostics) {
         console.error(`decompile: [${diagnostic.code}] ${diagnostic.location}: ${diagnostic.message}`);
     }
@@ -73,6 +75,7 @@ export function run(argv) {
         const pipelinePath = out.replace(/\.case\.ts$|\.ts$/, '') + '.pipeline.mjs';
         writeFileSync(pipelinePath, pipelineScript(resolve(pos), resolve(out), importSpecifier, bestEffort, libraryDir ? resolve(libraryDir) : undefined));
         console.log(`decompile: wrote ${basename(pipelinePath)}`);
+        reportResult({ pipeline: resolve(pipelinePath) });
     }
     return 0;
 }

package/dist/case/merge-cli.js

@@ -9,8 +9,9 @@
  * `edited.json` is compile(decompile(original)) after your edits. See merge.ts
  * for what each side decides and why the join is by label rather than by id.
  */
+import { reportResult } from '../cli-result.js';
 import { readFileSync, writeFileSync } from 'node:fs';
-import { basename } from 'node:path';
+import { basename, resolve } from 'node:path';
 import { mergeCase } from './merge.js';
 import { runWhenInvokedDirectly } from '../cli-run.js';
 function opt(argv, name) {
@@ -39,6 +40,7 @@ export function run(argv) {
     const stages = (merged.nodes ?? [])
         .filter((node) => String(node.type ?? '').endsWith('Stage')).length;
     console.log(`case-merge: wrote ${basename(out)} (${stages} stage(s))`);
+    reportResult({ path: resolve(out), stages });
     return 0;
 }
 runWhenInvokedDirectly(import.meta.url, 'case-merge', run);

package/dist/check-cli.js

@@ -5,6 +5,7 @@
  * Usage: node --experimental-strip-types check-cli.js <flow.ts | BaseName>
  * Prints diagnostics; exits non-zero if any errors.
  */
+import { reportDiagnostics } from './cli-result.js';
 import { existsSync } from 'node:fs';
 import { resolveFlowFile, loadBuiltFlow } from './load.js';
 import { check } from './check.js';
@@ -102,6 +103,7 @@ export async function run(argv) {
     ensureTypeScriptRuntime();
     const built = await loadBuiltFlow(file);
     const diags = check(built, checkOpts(argv));
+    reportDiagnostics(diags);
     if (diags.length === 0) {
         console.log('✓ no issues');
         return 0;

package/dist/check.js

@@ -1364,8 +1364,8 @@ function checkConnectorLookups(step, spec, opts, diags) {
                 + `connection: it resolves to nothing there, or to something else, and neither `
                 + `compile nor deploy can tell. Write what you mean and resolve it late:\n`
                 + `  ${call}\n`
-                + `then record the value once with \`${prepareCommand(spec.key)} `
-                + `${spec.action} --resolve ${resolveFlagArg(field, lookup.by[0] ?? 'id', '<value>')}\`.`,
+                + `then record the value once with \`${prepareCommand(spec.key, spec.action)} `
+                + `--resolve ${resolveFlagArg(field, lookup.by[0] ?? 'id', '<value>')}\`.`,
             step,
         });
     };

package/dist/cli/commands/bpmn.js

@@ -1,4 +1,4 @@
-import { addValue, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
+import { addValue, inferCheckMode, invoke, loadTool, namedOrLegacySecond, retiredCompiledOption, refuse } from '../common.js';
 export function registerBpmnCommands(program) {
     const family = program.command('bpmn').description('Build, inspect, and merge BPMN artifacts.');
     family.command('compile')
@@ -25,13 +25,11 @@ export function registerBpmnCommands(program) {
             mode = inferCheckMode('bpmn', input, options.source === true, options.compiled === true);
         }
         catch (error) {
-            console.error(`flow-sdk bpmn check: ${error instanceof Error ? error.message : String(error)}`);
-            process.exitCode = 2;
+            refuse(`flow-sdk bpmn check: ${error instanceof Error ? error.message : String(error)}`);
             return;
         }
         if (mode === 'compiled') {
-            console.error('flow-sdk bpmn check --compiled: use `uip maestro bpmn validate <file.bpmn>`');
-            process.exitCode = 2;
+            refuse('flow-sdk bpmn check --compiled: use `uip maestro bpmn validate <file.bpmn>`');
             return;
         }
         await invoke('bpmn check', () => loadTool(import.meta.url, '../../bpmn/check-cli.js'), [input]);
@@ -60,11 +58,19 @@ export function registerBpmnCommands(program) {
     family
         .command('merge')
         .description('Merge an edited process with its original BPMN artifact.')
-        .argument('<original>', 'original .bpmn path')
         .argument('<edited>', 'edited .bpmn path')
+        .option('--original <file>', '(required) original .bpmn path, the artifact to merge into')
         .option('-o, --output <file>', 'merged output path')
         .option('--baseline <file>', 'compiled pristine decompile')
-        .action(async (original, edited, options) => {
+        .allowExcessArguments()
+        .action(async (_edited, options, command) => {
+        const pair = namedOrLegacySecond(command, {
+            label: 'bpmn merge', flag: '--original', named: options.original, legacyNamedFirst: true,
+            usage: 'bpmn merge <edited> --original <file>',
+        });
+        if (!pair)
+            return;
+        const [edited, original] = pair;
         const argv = [original, edited];
         addValue(argv, '-o', options.output);
         addValue(argv, '--baseline', options.baseline);

package/dist/cli/commands/case.js

@@ -1,4 +1,4 @@
-import { addValue, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
+import { addValue, inferCheckMode, invoke, loadTool, namedOrLegacySecond, retiredCompiledOption, refuse } from '../common.js';
 export function registerCaseCommands(program) {
     const family = program.command('case').description('Build, check, and merge Case artifacts.');
     family.command('compile')
@@ -27,13 +27,11 @@ export function registerCaseCommands(program) {
             mode = inferCheckMode('case', input, options.source === true, options.compiled === true);
         }
         catch (error) {
-            console.error(`flow-sdk case check: ${error instanceof Error ? error.message : String(error)}`);
-            process.exitCode = 2;
+            refuse(`flow-sdk case check: ${error instanceof Error ? error.message : String(error)}`);
             return;
         }
         if (mode === 'compiled') {
-            console.error('flow-sdk case check --compiled: use `uip maestro case validate caseplan.json`');
-            process.exitCode = 2;
+            refuse('flow-sdk case check --compiled: use `uip maestro case validate caseplan.json`');
             return;
         }
         await invoke('case check', () => loadTool(import.meta.url, '../../case/check-cli.js'), [input]);
@@ -59,10 +57,18 @@ export function registerCaseCommands(program) {
     });
     family.command('merge')
         .description('Merge an edited case plan with its original caseplan.json.')
-        .argument('<original>', 'original caseplan.json path')
         .argument('<edited>', 'edited caseplan.json path')
+        .option('--original <file>', '(required) original caseplan.json path, the plan to merge into')
         .option('-o, --output <file>', 'merged output path')
-        .action(async (original, edited, options) => {
+        .allowExcessArguments()
+        .action(async (_edited, options, command) => {
+        const pair = namedOrLegacySecond(command, {
+            label: 'case merge', flag: '--original', named: options.original, legacyNamedFirst: true,
+            usage: 'case merge <edited> --original <file>',
+        });
+        if (!pair)
+            return;
+        const [edited, original] = pair;
         const argv = [original, edited];
         addValue(argv, '-o', options.output);
         await invoke('case merge', () => loadTool(import.meta.url, '../../case/merge-cli.js'), argv);

package/dist/cli/commands/flow.js

@@ -1,8 +1,7 @@
 import { Option } from 'commander';
-import { addValue, emitOnlyEnabled, inferCheckMode, invoke, loadTool, retiredCompiledOption } from '../common.js';
+import { addValue, emitOnlyEnabled, inferCheckMode, invoke, loadTool, namedOrLegacySecond, retiredCompiledOption, refuse } from '../common.js';
 /** The retired compiled check's flags: `[commander flags, option key, description]`. One table, so hiding and warning cannot drift. */
 const RETIRED_COMPILED_CHECK_FLAGS = [
-    ['--json', 'json', 'retired: compiled-check diagnostics as JSON'],
     ['--uip', 'uip', 'retired: resolve missing schemas with the UiPath CLI'],
     ['--max-errors <count>', 'maxErrors', 'retired: stop after this many compiled-check errors'],
     ['--script-determinism', 'scriptDeterminism', 'retired: check script blocks for non-deterministic calls'],
@@ -49,8 +48,7 @@ export function registerFlowCommands(program) {
     check
         .action(async (input, options) => {
         if (emitOnlyEnabled()) {
-            console.error('flow-sdk flow check: disabled by emit-only mode; use `uip maestro flow validate` or `uip maestro flow debug`');
-            process.exitCode = 2;
+            refuse('flow-sdk flow check: disabled by emit-only mode; use `uip maestro flow validate` or `uip maestro flow debug`');
             return;
         }
         let mode;
@@ -58,8 +56,7 @@ export function registerFlowCommands(program) {
             mode = inferCheckMode('flow', input, options.source === true, options.compiled === true);
         }
         catch (error) {
-            console.error(`flow-sdk flow check: ${error instanceof Error ? error.message : String(error)}`);
-            process.exitCode = 2;
+            refuse(`flow-sdk flow check: ${error instanceof Error ? error.message : String(error)}`);
             return;
         }
         if (mode === 'source') {
@@ -83,11 +80,10 @@ export function registerFlowCommands(program) {
         // and every current authoring flow uses — this path already refused, with the same two
         // suggestions repeated here. What is checked at author time is `check.ts`, reached above by
         // the `source` arm, and that is untouched.
-        console.error('flow-sdk flow check: checking a COMPILED .flow is no longer supported here. ' +
+        refuse('flow-sdk flow check: checking a COMPILED .flow is no longer supported here. ' +
             'Use `uip maestro flow validate <file.flow>` for the product static check, or ' +
             '`uip maestro flow debug` / `flow-debug <file.flow>` to run it. ' +
             'Authoring-time checks still work on a .flow.ts source (--source).');
-        process.exitCode = 2;
     });
     flow.command('decompile')
         .description('Convert a .flow artifact to authored TypeScript.')
@@ -108,11 +104,19 @@ export function registerFlowCommands(program) {
     });
     flow.command('merge')
         .description('Merge an edited flow with its original artifact.')
-        .argument('<original>', 'original .flow path')
         .argument('<edited>', 'edited .flow path')
+        .option('--original <file>', '(required) original .flow path, the artifact to merge into')
         .option('-o, --output <file>', 'merged output path')
         .option('--baseline <file>', 'compiled pristine decompile')
-        .action(async (original, edited, options) => {
+        .allowExcessArguments()
+        .action(async (_edited, options, command) => {
+        const pair = namedOrLegacySecond(command, {
+            label: 'flow merge', flag: '--original', named: options.original, legacyNamedFirst: true,
+            usage: 'flow merge <edited> --original <file>',
+        });
+        if (!pair)
+            return;
+        const [edited, original] = pair;
         const argv = [original, edited];
         addValue(argv, '-o', options.output);
         addValue(argv, '--baseline', options.baseline);

package/dist/cli/commands/registry.js

@@ -1,4 +1,4 @@
-import { addValue, invoke, loadTool } from '../common.js';
+import { addValue, invoke, loadTool, namedOrLegacySecond } from '../common.js';
 /** Commander hands a repeatable option one value at a time. */
 function collect(value, previous) {
     return [...previous, value];
@@ -124,7 +124,8 @@ export function registerRegistryCommands(program) {
     family.command('prepare')
         .description("Resolve one operation's schema against a live connection into ./connectors-local.")
         .argument('<connector-key>', 'connector key, e.g. uipath-salesforce')
-        .argument('<action>', 'operation to resolve, e.g. InsertRecord')
+        .option('--action <name>', '(required) operation to resolve, e.g. InsertRecord')
+        .allowExcessArguments()
         // Optional: without one the command discovers the connection itself from
         // `uip is connections list` and writes both keys into bindings.json.
         .option('--connection-id <id>', 'connection to read the schema through')
@@ -158,7 +159,14 @@ export function registerRegistryCommands(program) {
         .option('--refresh-lookups', 're-resolve lookups already recorded in resolutions.json')
         .option('--source <flow.ts>', 'the flow whose import to repoint at the prepared descriptor')
         .option('--no-source-rewrite', 'print the import line instead of editing the source')
-        .action(async (connectorKey, action, options) => {
+        .action(async (_connectorKey, options, command) => {
+        const pair = namedOrLegacySecond(command, {
+            label: 'registry prepare', flag: '--action', named: options.action, legacyNamedFirst: false,
+            usage: 'registry prepare <connector-key> --action <name>',
+        });
+        if (!pair)
+            return;
+        const [connectorKey, action] = pair;
         const argv = [connectorKey, action];
         addValue(argv, '--connection-id', options.connectionId);
         addValue(argv, '--connection', options.connection);