@uipath/maestro-builder-sdk 6.16.12 → 6.16.13

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:327-328` | 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:1717-1732` | 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:3327-3350` | 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:3351-3367` | Actions | Stringly form, for a connector with no prepared module — `connector('uipath-salesforce-slack',… |
+| `connector` | function | `dist/core/actions.d.ts:3341-3364` | 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:3365-3381` | 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:2943-2959` | 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:732-740` | Option shapes | 2 field(s) |
 | `CustomGuardrail` | interface | `dist/core/actions.d.ts:1338-1350` | Supporting types | A rule-based guardrail you author in place. |
-| `dataFabricCreate` | function | `dist/core/actions.d.ts:3229-3246` | Actions | Create an entity record in Data Fabric (`core.datafabric.create`). |
+| `dataFabricCreate` | function | `dist/core/actions.d.ts:3237-3260` | Actions | Create an entity record in Data Fabric (`core.datafabric.create`). |
 | `DataFabricCreateInputs` | interface | `dist/core/actions.d.ts:2223-2253` | Option shapes | 4 field(s) |
-| `dataFabricDelete` | function | `dist/core/actions.d.ts:3263-3280` | Actions | Delete an entity record from Data Fabric (`core.datafabric.delete`). |
+| `dataFabricDelete` | function | `dist/core/actions.d.ts:3277-3294` | Actions | Delete an entity record from Data Fabric (`core.datafabric.delete`). |
 | `DataFabricDeleteInputs` | interface | `dist/core/actions.d.ts:2286-2312` | Option shapes | 4 field(s) |
 | `DataFabricFilter` | interface | `dist/core/actions.d.ts:2114-2145` | Supporting types | One filter row on a Data Fabric query — rows AND together unless `or` is set. |
 | `DataFabricOperator` | type | `dist/core/actions.d.ts:2103-2113` | 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:3190-3228` | Actions | Query entity records from Data Fabric (`core.datafabric.read`). |
+| `dataFabricRead` | function | `dist/core/actions.d.ts:3190-3236` | Actions | Query entity records from Data Fabric (`core.datafabric.read`). |
 | `DataFabricReadInputs` | interface | `dist/core/actions.d.ts:2170-2222` | Option shapes | 9 field(s) |
 | `DataFabricRecordRef` | type | `dist/core/actions.d.ts:2153-2169` | Supporting types | Which record a Data Fabric write targets — exactly ONE of the two forms. |
 | `DataFabricSort` | interface | `dist/core/actions.d.ts:2146-2152` | Supporting types | How a multi-record query orders its rows before the limit is applied. |
-| `dataFabricUpdate` | function | `dist/core/actions.d.ts:3247-3262` | Actions | Update an entity record in Data Fabric (`core.datafabric.update`). |
+| `dataFabricUpdate` | function | `dist/core/actions.d.ts:3261-3276` | Actions | Update an entity record in Data Fabric (`core.datafabric.update`). |
 | `DataFabricUpdateInputs` | interface | `dist/core/actions.d.ts:2254-2285` | Option shapes | 5 field(s) |
 | `DEFAULT_TRIGGER_ID` | const | `dist/core/expr.d.ts:42-43` | 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:153-240` | Expressions and types | Reference a FAILED step's error → `$vars.<step>.error[.<field>]`. |
 | `ErrorEnvelopeField` | type | `dist/core/expr.d.ts:142-152` | Supporting types | The fields a failure envelope carries. |
 | `EscalationRef` | interface | `dist/core/actions.d.ts:1930-1991` | 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:3368-3409` | Supporting types | One filter condition on the event payload. |
-| `EventSubscription` | interface | `dist/core/actions.d.ts:3458-3499` | Option shapes | What a connector event subscribes to. |
+| `EventFilter` | type | `dist/core/actions.d.ts:3382-3423` | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts:3472-3513` | 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:250-257` | Supporting types | 3 field(s) |
 | `FilterCondition` | type | `dist/core/actions.d.ts:233-234` | 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:1861-1890` | Supporting types | A deployed tenant resource the agent may invoke. |
 | `publishedFunction` | function | `dist/core/actions.d.ts:2867-2891` | 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:1054-1088` | 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:3281-3326` | Actions | Declare an Orchestrator QUEUE ITEM step. |
+| `queueItem` | function | `dist/core/actions.d.ts:3295-3340` | Actions | Declare an Orchestrator QUEUE ITEM step. |
 | `QueueItemInputs` | interface | `dist/core/actions.d.ts:2029-2102` | Option shapes | 10 field(s) |
 | `QueuePriority` | type | `dist/core/actions.d.ts:2027-2028` | Supporting types | The three priorities an Orchestrator queue item can carry. |
 | `ran` | function | `dist/core/expr.d.ts:95-141` | 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:3410-3457` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts:3424-3471` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
 | `TriggerSpec` | type | `dist/flow-sdk.d.ts:150-168` | Supporting types | What starts the flow. |
 | `TypeDesc` | type | `dist/core/expr.d.ts:379` | Supporting types |  |
 | `types` | const | `dist/core/expr.d.ts:363-378` | 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:772-805` | Option shapes | 6 field(s) |
 | `VoiceSettings` | interface | `dist/core/actions.d.ts:749-771` | Supporting types | The audio settings a voice agent speaks with. |
 | `voiceTrigger` | function | `dist/flow-sdk.d.ts:302-326` | Flow construction | Start the flow when a phone call comes IN (`core.trigger.voice`). |
-| `waitForEvent` | function | `dist/core/actions.d.ts:3509-3544` | 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:3545-3552` | Actions | Stringly form, for an event with no prepared module. |
+| `waitForEvent` | function | `dist/core/actions.d.ts:3523-3558` | 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:3559-3566` | Actions | Stringly form, for an event with no prepared module. |
 | `waitForMessage` | function | `dist/core/actions.d.ts:2911-2927` | 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:644-652` | 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:3368-3409` | Supporting types | One filter condition on the event payload. |
-| `EventSubscription` | interface | `dist/core/actions.d.ts:3458-3499` | Option shapes | What a connector event subscribes to. |
+| `EventFilter` | type | `dist/core/actions.d.ts:3382-3423` | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts:3472-3513` | 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:3410-3457` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts:3424-3471` | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
 | `TypeDesc` | type | `dist/core/expr.d.ts:379` | 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. |
@@ -387,7 +387,7 @@ could hand you spans for a version you do not have.
 | `errorSchema` | const | `dist/bpmn/bpmn-sdk.d.ts:3490-3531` | BPMN authoring | The `Error` variable's shape — the platform's own error envelope. |
 | `errorSchemaWithResponse` | const | `dist/bpmn/bpmn-sdk.d.ts:3532-3564` | BPMN authoring | The same envelope plus `response` — what a node whose failure carries a payload writes, and what the same source calls… |
 | `EventDef` | type | `dist/bpmn/bpmn-sdk.d.ts:54-72` | Supporting types | The resolved event definition attached to an event node. |
-| `EventFilter` | type | `dist/core/actions.d.ts:3368-3409` | Supporting types | One filter condition on the event payload. |
+| `EventFilter` | type | `dist/core/actions.d.ts:3382-3423` | Supporting types | One filter condition on the event payload. |
 | `EventKind` | type | `dist/bpmn/bpmn-sdk.d.ts:75-76` | Supporting types | The four non-boundary event element kinds a BpmnNode can be. |
 | `EventSubProcessOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts:1835-1895` | Option shapes | Options for ScopeBuilder.eventSubProcess. |
 | `ExtensionPayload` | interface | `dist/bpmn/bpmn-sdk.d.ts:557-593` | Supporting types | An extension payload carried by an element the payload does not describe. |

package/dist/api-members.md

@@ -139,15 +139,15 @@ not find it either.
 | `connection` | property | `ConnectorOpts` | `dist/core/actions.d.ts:190-194` |
 | `connection` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1832-1839` |
 | `connection` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1092-1098` |
-| `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3491-3495` |
+| `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3505-3509` |
 | `connection` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:393-394` |
 | `connection` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1503-1504` |
 | `connection` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1156-1181` |
-| `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3448-3452` |
+| `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3462-3466` |
 | `connections` | property | `HitlRecipient` | `dist/core/actions.d.ts:438-442` |
 | `connector` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:506` |
 | `connector` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1817-1818` |
-| `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3460-3461` |
+| `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3474-3475` |
 | `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:2332-2352` |
@@ -293,7 +293,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:3462-3463` |
+| `event` | property | `EventSubscription` | `dist/core/actions.d.ts:3476-3477` |
 | `event` | property | `TriggerMeta` | `dist/core/connectors.d.ts:124-125` |
 | `eventBasedGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2274-2283` |
 | `eventDefinition` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:91-92` |
@@ -343,8 +343,8 @@ not find it either.
 | `filter` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1447-1462` |
 | `filters` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1463-1478` |
 | `filters` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2173-2174` |
-| `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3489-3490` |
-| `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3446-3447` |
+| `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3503-3504` |
+| `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3460-3461` |
 | `flavour` | property | `AgentInputs` | `dist/core/actions.d.ts:1250-1264` |
 | `flowIds` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3006-3049` |
 | `flowMode` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2078-2117` |
@@ -355,13 +355,13 @@ not find it either.
 | `folder` | property | `ConnectorOpts` | `dist/core/actions.d.ts:195-196` |
 | `folder` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1840-1845` |
 | `folder` | property | `DataServiceOpts` | `dist/bpmn/bpmn-sdk.d.ts:1099-1111` |
-| `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3496-3497` |
+| `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3510-3511` |
 | `folder` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:395-396` |
 | `folder` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1505-1506` |
 | `folder` | property | `HttpOpts` | `dist/bpmn/bpmn-sdk.d.ts:1182-1183` |
 | `folder` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1239-1240` |
 | `folder` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1300-1301` |
-| `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3453-3454` |
+| `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3467-3468` |
 | `folderKey` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1777-1778` |
 | `folderKey` | property | `ContextIndexRef` | `dist/core/actions.d.ts:2010-2011` |
 | `folderKey` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2232-2240` |
@@ -674,8 +674,8 @@ not find it either.
 | `object` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1437-1446` |
 | `object` | property | `ConnectorOpts` | `dist/core/actions.d.ts:197-229` |
 | `object` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1823-1824` |
-| `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3483-3488` |
-| `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3435-3445` |
+| `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3497-3502` |
+| `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3449-3459` |
 | `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` |
@@ -1091,12 +1091,12 @@ not find it either.
 | `version` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:63` |
 | `version` | property | `ConnectorOpts` | `dist/core/actions.d.ts:188-189` |
 | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1821-1822` |
-| `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3498` |
+| `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3512` |
 | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1507-1508` |
 | `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1313-1326` |
 | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:354-361` |
 | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
-| `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3455-3456` |
+| `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3469-3470` |
 | `versionTag` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:936-937` |
 | `versionTag` | property | `IxpToolRef` | `dist/core/actions.d.ts:1918-1919` |
 | `voice` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:791-792` |
@@ -1109,8 +1109,8 @@ not find it either.
 | `waitForTimer` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:877-883` |
 | `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:586-591` |
 | `when` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:176-182` |
-| `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3464-3482` |
-| `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3417-3434` |
+| `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3478-3496` |
+| `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3431-3448` |
 | `width` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:604-605` |
 | `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:641-642` |
 | `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:637-638` |

package/dist/config.d.ts

@@ -1,14 +1,43 @@
 /**
  * config — build a connector node's `inputs.detail.configuration` envelope.
  *
- * `uip maestro flow validate` requires connector configuration to be a
- * `=jsonString:`-wrapped `{ essentialConfiguration, optionalConfiguration }`
- * envelope. This mirrors the platform's own rehydrateConfiguration (Tier-A defaults
- * + library-derived per-connector statics), minus the fieldsContainer sidecar.
+ * The node stores Studio Web's ESSENTIAL-ONLY form,
+ * `=jsonString:{ "essentialConfiguration": { … } }`, with no
+ * `optionalConfiguration` section. That is the form Studio Web itself writes for
+ * an activity whose field metadata is not loaded, and the one `uip maestro flow`
+ * node configuration, the managed HTTP node, triggers, Case and BPMN connector
+ * nodes already store. See {@link buildConfiguration} for why the split form
+ * broke the designer (flow-builder-sdk#936).
  */
 /**
  * Compose the `=jsonString:`-wrapped configuration for a connector library entry.
  *
+ * ## Essential-only, because the split form needs a fieldsContainer
+ *
+ * Studio Web reads this string with `normalizeConfiguration`
+ * (StudioWeb `connector-activity/is-activities/runtime/models/configuration-classification.ts`
+ * @ 8724d739). It knows two stored forms:
+ *
+ * - **Split** — `{ essentialConfiguration, optionalConfiguration }` with a
+ *   non-empty optional half. Studio Web treats the activity as fully configured
+ *   and renders its fields from `optionalConfiguration.fieldsContainer`.
+ * - **Essential-only** — no `optionalConfiguration` (or an empty one). Studio
+ *   Web sets `isEssentialOnly`, re-fetches the field metadata from the
+ *   connection, and applies the node's `bodyParameters` / `queryParameters` /
+ *   `pathParameters` to the rebuilt fields.
+ *
+ * This builder used to write the split form with Tier-A defaults in the
+ * optional half and no `fieldsContainer`. Studio Web then took the "fully
+ * configured" path, found no fields, showed every value empty (required ones
+ * flagged), and a designer save wrote the node back without its
+ * `bodyParameters`. The run was unaffected: the runtime reads the node's
+ * parameter buckets, not this string (flow-builder-sdk#936).
+ *
+ * The essential keys are Studio Web's `CONNECTOR_ACTIVITY_ESSENTIAL_PROPERTIES`
+ * plus the transient `savedFilterTrees` it keeps on the essential-only path.
+ * `uip maestro flow validate` and `pack` accept this form; the CLI's own
+ * connector configure writes it (`activityClient.getEssentialConfiguration()`).
+ *
  * ## Two things here are measured, not chosen
  *
  * Census over **every** connector node in the deployed corpus — 4,026 `.flow`

package/dist/config.js

@@ -1,32 +1,25 @@
 /**
  * config — build a connector node's `inputs.detail.configuration` envelope.
  *
- * `uip maestro flow validate` requires connector configuration to be a
- * `=jsonString:`-wrapped `{ essentialConfiguration, optionalConfiguration }`
- * envelope. This mirrors the platform's own rehydrateConfiguration (Tier-A defaults
- * + library-derived per-connector statics), minus the fieldsContainer sidecar.
+ * The node stores Studio Web's ESSENTIAL-ONLY form,
+ * `=jsonString:{ "essentialConfiguration": { … } }`, with no
+ * `optionalConfiguration` section. That is the form Studio Web itself writes for
+ * an activity whose field metadata is not loaded, and the one `uip maestro flow`
+ * node configuration, the managed HTTP node, triggers, Case and BPMN connector
+ * nodes already store. See {@link buildConfiguration} for why the split form
+ * broke the designer (flow-builder-sdk#936).
  */
 import { parseCeql } from './core/ceql.js';
 import { transportHttpMethod } from './core/connector-inputs.js';
-const TIER_A_DEFAULTS = {
-    additionalHeaders: null,
-    baseObject: null,
-    cachedBrowserItems: [],
-    cachedLookupValues: [],
-    cachedPropertyMappings: [],
+/**
+ * Defaults for the essential keys a library entry does not set. These are the
+ * values Studio Web's own constructors give a new connector activity.
+ */
+const ESSENTIAL_DEFAULTS = {
     customFieldsRequestDetails: null,
-    eventMode: null,
-    eventOperation: null,
     executionType: null,
-    hasBreakingChanges: false,
-    isAutopilotInvalidConfig: false,
-    jobArguments: null,
-    language: 'en-US',
-    maxPageSize: 1000,
-    objectActions: [],
     operation: 'create',
     packageVersion: '1.0.0',
-    primaryKeys: [],
 };
 /**
  * Which of an operation's parameters carries a CEQL filter.
@@ -105,20 +98,44 @@ function schemaReplayDetails(operation, inputValues) {
     }
     return { objectActionName: action.name, parameterValues };
 }
+/** Keep the essential keys; everything else is re-derived by Studio Web on open. */
 function envelope(flat) {
     const essential = {};
-    const optional = {};
     for (const [k, v] of Object.entries(flat)) {
         if (ESSENTIAL_KEYS.has(k))
             essential[k] = v;
-        else
-            optional[k] = v;
     }
-    return { essentialConfiguration: essential, optionalConfiguration: optional };
+    return { essentialConfiguration: essential };
 }
 /**
  * Compose the `=jsonString:`-wrapped configuration for a connector library entry.
  *
+ * ## Essential-only, because the split form needs a fieldsContainer
+ *
+ * Studio Web reads this string with `normalizeConfiguration`
+ * (StudioWeb `connector-activity/is-activities/runtime/models/configuration-classification.ts`
+ * @ 8724d739). It knows two stored forms:
+ *
+ * - **Split** — `{ essentialConfiguration, optionalConfiguration }` with a
+ *   non-empty optional half. Studio Web treats the activity as fully configured
+ *   and renders its fields from `optionalConfiguration.fieldsContainer`.
+ * - **Essential-only** — no `optionalConfiguration` (or an empty one). Studio
+ *   Web sets `isEssentialOnly`, re-fetches the field metadata from the
+ *   connection, and applies the node's `bodyParameters` / `queryParameters` /
+ *   `pathParameters` to the rebuilt fields.
+ *
+ * This builder used to write the split form with Tier-A defaults in the
+ * optional half and no `fieldsContainer`. Studio Web then took the "fully
+ * configured" path, found no fields, showed every value empty (required ones
+ * flagged), and a designer save wrote the node back without its
+ * `bodyParameters`. The run was unaffected: the runtime reads the node's
+ * parameter buckets, not this string (flow-builder-sdk#936).
+ *
+ * The essential keys are Studio Web's `CONNECTOR_ACTIVITY_ESSENTIAL_PROPERTIES`
+ * plus the transient `savedFilterTrees` it keeps on the essential-only path.
+ * `uip maestro flow validate` and `pack` accept this form; the CLI's own
+ * connector configure writes it (`activityClient.getEssentialConfiguration()`).
+ *
  * ## Two things here are measured, not chosen
  *
  * Census over **every** connector node in the deployed corpus — 4,026 `.flow`
@@ -153,17 +170,16 @@ export function buildConfiguration(entry, version, inputValues, seed = 'node') {
     const isGeneric = at === 'Generic' || at === 'GenericExpanded';
     const v1ActivityType = isGeneric ? 'Generic' : 'Curated';
     // `operation.name` is the verb (`List`, `Create`, …); the platform stores it
-    // lower-cased. Falls back to the Tier-A default for an entry that declares no
+    // lower-cased. Falls back to the default `create` for an entry that declares no
     // name, which keeps such an entry's emission exactly as it was.
     const verb = typeof op.name === 'string' && op.name
         ? op.name.toLowerCase()
-        : TIER_A_DEFAULTS.operation;
+        : ESSENTIAL_DEFAULTS.operation;
     const composed = {
-        ...TIER_A_DEFAULTS,
+        ...ESSENTIAL_DEFAULTS,
         operation: verb,
         customFieldsRequestDetails: schemaReplayDetails(op, inputValues),
         savedFilterTrees: savedFilterTrees(op, inputValues, seed),
-        connectorKey: conn.key,
         objectName: op.objectName,
         httpMethod: transportHttpMethod(op.httpMethod),
         instanceParameters: isGeneric
@@ -184,8 +200,6 @@ export function buildConfiguration(entry, version, inputValues, seed = 'node') {
                 supportsStreaming: op.supportsStreaming,
                 subType: op.subType,
             },
-        ...(conn.name ? { connectorName: conn.name } : {}),
-        ...(op.objectDisplayName ? { objectDisplayName: op.objectDisplayName } : {}),
         ...(op.pathTemplate || op.path ? { path: op.pathTemplate || op.path } : {}),
     };
     return '=jsonString:' + JSON.stringify(envelope(composed));

package/dist/core/actions.d.ts

@@ -3213,6 +3213,14 @@ export declare function dynamicExtract(inputs: DynamicExtractInputs): ActionSpec
  *   { entityName: 'Contracts', recordId: input('id') }, { connection: 'df' }))
  * ```
  *
+ * Get-by-id matters for long text. This node is a query even when it reads one
+ * record by an `Id` filter, and a Data Service query returns a PREVIEW of a
+ * long-text (`MULTILINE_MAX`) field: the first 10,000 characters plus
+ * `...[Truncated]`, with no flag in the output. A 15,551-character value comes
+ * back as 10,014 characters. When a field may exceed 10,000 characters, read
+ * it with `get-entity-record-by-id`, which returns the whole value
+ * (flow-builder-sdk#954).
+ *
  * A connector operation's body fields come from the entity, so the library
  * cannot carry them: run `uip maestro registry prepare uipath-uipath-dataservice
  * get-entity-record-by-id -f entityName=<Entity>` first.
@@ -3237,6 +3245,12 @@ export declare function dataFabricRead(inputs: DataFabricReadInputs): ActionSpec
  * platform does. Field names are the ENTITY's, so copy them from the scenario
  * or the tenant; nothing offline can tell a real column from a typo.
  *
+ * The published `output` is the record as a query returns it, so a long-text
+ * (`MULTILINE_MAX`) field longer than 10,000 characters comes back cut, with
+ * `...[Truncated]` appended, even though the whole value was stored. Use the
+ * value you passed in, or re-read the record with the connector's
+ * `get-entity-record-by-id`, when the whole text is needed (flow-builder-sdk#954).
+ *
  * See {@link dataFabricRead} for what the native family still does not cover
  * and which connector operation covers it.
  *

package/dist/core/actions.js

@@ -916,6 +916,14 @@ export function dynamicExtract(inputs) {
  *   { entityName: 'Contracts', recordId: input('id') }, { connection: 'df' }))
  * ```
  *
+ * Get-by-id matters for long text. This node is a query even when it reads one
+ * record by an `Id` filter, and a Data Service query returns a PREVIEW of a
+ * long-text (`MULTILINE_MAX`) field: the first 10,000 characters plus
+ * `...[Truncated]`, with no flag in the output. A 15,551-character value comes
+ * back as 10,014 characters. When a field may exceed 10,000 characters, read
+ * it with `get-entity-record-by-id`, which returns the whole value
+ * (flow-builder-sdk#954).
+ *
  * A connector operation's body fields come from the entity, so the library
  * cannot carry them: run `uip maestro registry prepare uipath-uipath-dataservice
  * get-entity-record-by-id -f entityName=<Entity>` first.
@@ -942,6 +950,12 @@ export function dataFabricRead(inputs) {
  * platform does. Field names are the ENTITY's, so copy them from the scenario
  * or the tenant; nothing offline can tell a real column from a typo.
  *
+ * The published `output` is the record as a query returns it, so a long-text
+ * (`MULTILINE_MAX`) field longer than 10,000 characters comes back cut, with
+ * `...[Truncated]` appended, even though the whole value was stored. Use the
+ * value you passed in, or re-read the record with the connector's
+ * `get-entity-record-by-id`, when the whole text is needed (flow-builder-sdk#954).
+ *
  * See {@link dataFabricRead} for what the native family still does not cover
  * and which connector operation covers it.
  *

package/dist/serialize.d.ts

@@ -88,6 +88,23 @@ export declare function serializeWithSidecars(built: BuiltFlow, opts?: Serialize
     }>;
 };
 export declare function serialize(built: BuiltFlow, opts?: SerializeOpts): any;
+/**
+ * Every node `configuration` that carries Studio Web's split envelope must be
+ * one Studio Web can restore: either essential-only (no, or an empty,
+ * `optionalConfiguration`), or a full form whose optional half holds a
+ * `fieldsContainer`.
+ *
+ * Studio Web's `normalizeConfiguration` treats a non-empty optional half as
+ * "fully configured" and renders the fields from its `fieldsContainer`. With no
+ * container, every field shows empty and a designer save drops the node's
+ * `bodyParameters`; validate, pack and the run all pass
+ * (flow-builder-sdk#936). `buildConfiguration` writes essential-only; this
+ * check covers every emitter, root and subflows, so a new one cannot bring the
+ * broken shape back unnoticed.
+ *
+ * @throws Error naming each node whose configuration Studio Web would show empty.
+ */
+export declare function assertConnectorConfigurationRestorable(flow: any): void;
 /**
  * Node ids and edge ids are each one namespace over the WHOLE file: the root
  * and every `subflows` entry. Pack flattens subflows into one BPMN document, so

package/dist/serialize.js

@@ -7023,9 +7023,56 @@ export function serialize(built, opts = {}) {
     // each call site remembering it (flow-builder-sdk#865/#866).
     assertBindingPlaceholdersResolve(flow);
     assertFileWideIdsUnique(flow);
+    assertConnectorConfigurationRestorable(flow);
     connectionConnectors(flow);
     return flow;
 }
+/**
+ * Every node `configuration` that carries Studio Web's split envelope must be
+ * one Studio Web can restore: either essential-only (no, or an empty,
+ * `optionalConfiguration`), or a full form whose optional half holds a
+ * `fieldsContainer`.
+ *
+ * Studio Web's `normalizeConfiguration` treats a non-empty optional half as
+ * "fully configured" and renders the fields from its `fieldsContainer`. With no
+ * container, every field shows empty and a designer save drops the node's
+ * `bodyParameters`; validate, pack and the run all pass
+ * (flow-builder-sdk#936). `buildConfiguration` writes essential-only; this
+ * check covers every emitter, root and subflows, so a new one cannot bring the
+ * broken shape back unnoticed.
+ *
+ * @throws Error naming each node whose configuration Studio Web would show empty.
+ */
+export function assertConnectorConfigurationRestorable(flow) {
+    const nodes = [...(Array.isArray(flow?.nodes) ? flow.nodes : [])];
+    for (const sub of Object.values(flow?.subflows ?? {})) {
+        if (Array.isArray(sub?.nodes))
+            nodes.push(...sub.nodes);
+    }
+    const broken = [];
+    for (const node of nodes) {
+        const raw = node?.inputs?.detail?.configuration;
+        if (typeof raw !== 'string' || !raw.startsWith('=jsonString:'))
+            continue;
+        let envelope;
+        try {
+            envelope = JSON.parse(raw.slice('=jsonString:'.length));
+        }
+        catch {
+            continue;
+        }
+        const optional = envelope?.optionalConfiguration;
+        if (!envelope?.essentialConfiguration || !optional || typeof optional !== 'object')
+            continue;
+        if (Object.keys(optional).length > 0 && optional.fieldsContainer === undefined)
+            broken.push(node.id);
+    }
+    if (broken.length) {
+        throw new Error(`serialize: connector configuration on ${broken.map((id) => `"${id}"`).join(', ')} has a non-empty `
+            + `optionalConfiguration without a fieldsContainer. Studio Web shows such a node's fields empty and a `
+            + `save drops its bodyParameters (flow-builder-sdk#936). Emit { essentialConfiguration } only.`);
+    }
+}
 /**
  * Node ids and edge ids are each one namespace over the WHOLE file: the root
  * and every `subflows` entry. Pack flattens subflows into one BPMN document, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.16.12",
+  "version": "6.16.13",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -92,5 +92,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "a17e4a3af0cefe7881625c5888b282c4ea4a0546"
+  "gitref": "fdace5d45a9d598a8e452bbf9f48bc50943b6688"
 }