@uipath/maestro-builder-sdk 6.6.1 → 6.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5,13 +5,13 @@
5
5
 
6
6
  # Maestro Builder SDK — member index
7
7
 
8
- **A lookup table of 927 rows — match one name in it, do not read it.**
8
+ **A lookup table of 944 rows — match one name in it, do not read it.**
9
9
  Grep or search for the member you have; the row it lands on is the whole
10
10
  answer. Reading top to bottom costs ~20x what the one row does and tells you
11
11
  nothing you asked for.
12
12
 
13
- Every field and method of every exported shape — 927 across
14
- 172 interfaces and classes — keyed by the MEMBER's own name.
13
+ Every field and method of every exported shape — 944 across
14
+ 175 interfaces and classes — keyed by the MEMBER's own name.
15
15
 
16
16
  **Use this when the name you have is a field or a method**, which is usually
17
17
  the case: the reference pages are "one line per field", so you arrive holding
@@ -28,7 +28,7 @@ truncated summary would, for less. Read the span.
28
28
  Member names repeat across shapes (`name` is declared on 69 of them), so the
29
29
  `Declared on` column is what makes a match actionable. For the whole shape
30
30
  rather than the one field, look that name up in [`api-index.md`](api-index.md) —
31
- which is why its span is not repeated on all 927 rows here.
31
+ which is why its span is not repeated on all 944 rows here.
32
32
 
33
33
  **A name that misses both indexes is probably not part of the API.** The one
34
34
  that comes up is a RUNTIME output key — a human task's `Action`, a step's
@@ -84,7 +84,7 @@ not find it either.
84
84
  | `body` | property | `JsonSchemaType` | `dist/case/case-sdk.d.ts:539` |
85
85
  | `body` | property | `PortArm` | `dist/flow-sdk.d.ts:305-306` |
86
86
  | `body` | property | `SwitchArm` | `dist/flow-sdk.d.ts:293` |
87
- | `body` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:162-167` |
87
+ | `body` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:173-178` |
88
88
  | `boundaryEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1370-1377` |
89
89
  | `branch` | method | `StepList` | `dist/flow-sdk.d.ts:865-883` |
90
90
  | `branches` | property | `HttpInputsBase` | `dist/core/actions.d.ts:31-36` |
@@ -128,14 +128,14 @@ not find it either.
128
128
  | `condition` | property | `HttpBranch` | `dist/core/actions.d.ts:23-28` |
129
129
  | `connection` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1088-1089` |
130
130
  | `connection` | property | `ConnectorOpts` | `dist/core/actions.d.ts:180-181` |
131
- | `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3196-3197` |
131
+ | `connection` | property | `EventSubscription` | `dist/core/actions.d.ts:3405-3406` |
132
132
  | `connection` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:393-394` |
133
133
  | `connection` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1127-1128` |
134
- | `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3156-3157` |
134
+ | `connection` | property | `TriggerOptions` | `dist/core/actions.d.ts:3365-3366` |
135
135
  | `connections` | property | `HitlRecipient` | `dist/core/actions.d.ts:425-429` |
136
136
  | `connector` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:506` |
137
137
  | `connector` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1770-1771` |
138
- | `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3165-3166` |
138
+ | `connector` | property | `EventSubscription` | `dist/core/actions.d.ts:3374-3375` |
139
139
  | `connector` | property | `ExternalTaskSpecData` | `dist/case/case-sdk.d.ts:406-407` |
140
140
  | `connector` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:56-62` |
141
141
  | `connector` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1460-1479` |
@@ -160,7 +160,7 @@ not find it either.
160
160
  | `conversationId` | property | `WaitForMessageInputs` | `dist/core/actions.d.ts:632-633` |
161
161
  | `count` | property | `BuiltSla` | `dist/case/case-sdk.d.ts:188` |
162
162
  | `count` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:167-168` |
163
- | `custom` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:184-188` |
163
+ | `custom` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:195-199` |
164
164
  | `cycle` | property | `TimerSpec` | `dist/bpmn/bpmn-sdk.d.ts:34-35` |
165
165
  | `date` | property | `TimerSpec` | `dist/bpmn/bpmn-sdk.d.ts:32-33` |
166
166
  | `declare` | method | `BindingsRegistry` | `dist/bpmn/bpmn-sdk.d.ts:1267-1274` |
@@ -200,7 +200,7 @@ not find it either.
200
200
  | `description` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:970-976` |
201
201
  | `description` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:906-912` |
202
202
  | `description` | property | `TimerTriggerOpts` | `dist/case/case-sdk.d.ts:223` |
203
- | `description` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:189-190` |
203
+ | `description` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:200-201` |
204
204
  | `description` | property | `VarDecl` | `dist/flow-sdk.d.ts:51-52` |
205
205
  | `description` | property | `VarSpec` | `dist/flow-sdk.d.ts:68-69` |
206
206
  | `detail` | property | `ErrorMappingRow` | `dist/bpmn/bpmn-sdk.d.ts:298-299` |
@@ -209,6 +209,7 @@ not find it either.
209
209
  | `direction` | property | `AskedField` | `dist/core/actions.d.ts:348` |
210
210
  | `direction` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:343-344` |
211
211
  | `direction` | property | `CaseVarDecl` | `dist/case/case-sdk.d.ts:560` |
212
+ | `direction` | property | `DataFabricSort` | `dist/core/actions.d.ts:2066-2067` |
212
213
  | `direction` | property | `InOutField` | `dist/core/actions.d.ts:364` |
213
214
  | `direction` | property | `ShownField` | `dist/core/actions.d.ts:332` |
214
215
  | `displayName` | property | `ActionField` | `dist/case/case-sdk.d.ts:439-440` |
@@ -238,8 +239,10 @@ not find it either.
238
239
  | `endEvent` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1346-1353` |
239
240
  | `endExchange` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:688-692` |
240
241
  | `endExchange` | property | `SendMessageInputs` | `dist/core/actions.d.ts:625-629` |
241
- | `entity` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2031-2032` |
242
- | `entity` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2039-2040` |
242
+ | `entity` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2140-2141` |
243
+ | `entity` | property | `DataFabricDeleteInputs` | `dist/core/actions.d.ts:2203-2204` |
244
+ | `entity` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2087-2088` |
245
+ | `entity` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2171-2172` |
243
246
  | `entry` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:528` |
244
247
  | `entry` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:520` |
245
248
  | `entryPoint` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1203-1239` |
@@ -260,7 +263,7 @@ not find it either.
260
263
  | `escalation` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:69-74` |
261
264
  | `escalations` | property | `BuiltSla` | `dist/case/case-sdk.d.ts:193` |
262
265
  | `escalations` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:183-184` |
263
- | `event` | property | `EventSubscription` | `dist/core/actions.d.ts:3167-3168` |
266
+ | `event` | property | `EventSubscription` | `dist/core/actions.d.ts:3376-3377` |
264
267
  | `event` | property | `TriggerMeta` | `dist/core/connectors.d.ts:124-125` |
265
268
  | `eventBasedGateway` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1405-1414` |
266
269
  | `eventOutputs` | property | `BuiltTrigger` | `dist/case/case-sdk.d.ts:203-204` |
@@ -292,36 +295,40 @@ not find it either.
292
295
  | `externalWorkflow` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:802-809` |
293
296
  | `extractionResult` | property | `DocValidationInputs` | `dist/core/actions.d.ts:437-442` |
294
297
  | `field` | property | `Aggregation` | `dist/core/actions.d.ts:250-251` |
295
- | `field` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2021-2022` |
298
+ | `field` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2032-2038` |
299
+ | `field` | property | `DataFabricSort` | `dist/core/actions.d.ts:2064-2065` |
296
300
  | `field` | property | `FieldMapping` | `dist/core/actions.d.ts:238-239` |
297
301
  | `field` | property | `FilterRule` | `dist/core/actions.d.ts:223-224` |
298
302
  | `field` | property | `LookupResolution` | `dist/core/lookups.d.ts:163` |
303
+ | `fields` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2115-2116` |
299
304
  | `fields` | property | `EscalationRef` | `dist/core/actions.d.ts:1877-1881` |
300
305
  | `fields` | property | `HitlInputs` | `dist/core/actions.d.ts:554-563` |
301
306
  | `fileExtension` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:1757-1758` |
302
307
  | `fileExtension` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1945-1946` |
303
- | `fileRef` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2061-2062` |
304
- | `fileRef` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2071-2072` |
308
+ | `fileRef` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2230-2231` |
309
+ | `fileRef` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2240-2241` |
305
310
  | `fileRef` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:897-911` |
306
311
  | `filter` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1096-1102` |
307
- | `filters` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2033-2034` |
308
- | `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3194-3195` |
309
- | `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3154-3155` |
312
+ | `filters` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2089-2090` |
313
+ | `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:3403-3404` |
314
+ | `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:3363-3364` |
310
315
  | `flavour` | property | `AgentInputs` | `dist/core/actions.d.ts:1225-1239` |
311
316
  | `flowProcess` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:783-792` |
312
317
  | `flows` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:413-414` |
313
318
  | `folder` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1090-1091` |
314
319
  | `folder` | property | `ConnectorOpts` | `dist/core/actions.d.ts:182-183` |
315
- | `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3198-3199` |
320
+ | `folder` | property | `EventSubscription` | `dist/core/actions.d.ts:3407-3408` |
316
321
  | `folder` | property | `ExternalTaskOptions` | `dist/case/case-sdk.d.ts:395-396` |
317
322
  | `folder` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1129-1130` |
318
323
  | `folder` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:915-916` |
319
324
  | `folder` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:959-960` |
320
- | `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3158-3159` |
325
+ | `folder` | property | `TriggerOptions` | `dist/core/actions.d.ts:3367-3368` |
321
326
  | `folderKey` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:1730-1731` |
322
327
  | `folderKey` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1931-1932` |
323
- | `folderKey` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2035-2036` |
324
- | `folderKey` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2057-2058` |
328
+ | `folderKey` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2148-2156` |
329
+ | `folderKey` | property | `DataFabricDeleteInputs` | `dist/core/actions.d.ts:2207-2215` |
330
+ | `folderKey` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2117-2125` |
331
+ | `folderKey` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2180-2188` |
325
332
  | `folderKey` | property | `McpToolRef` | `dist/core/actions.d.ts:1635-1636` |
326
333
  | `folderKey` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:1667` |
327
334
  | `folderName` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:890-896` |
@@ -452,6 +459,7 @@ not find it either.
452
459
  | `layout` | property | `BuiltFlow` | `dist/flow-sdk.d.ts:656-657` |
453
460
  | `layout` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1139-1159` |
454
461
  | `layout` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1148-1158` |
462
+ | `limit` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2105-2110` |
455
463
  | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:413-414` |
456
464
  | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
457
465
  | `location` | property | `AgentInputs` | `dist/core/actions.d.ts:1163-1168` |
@@ -499,11 +507,11 @@ not find it either.
499
507
  | `mode` | property | `ExternalTaskSpecData` | `dist/case/case-sdk.d.ts:404-405` |
500
508
  | `mode` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1482-1488` |
501
509
  | `model` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:679-680` |
502
- | `model` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2073-2092` |
510
+ | `model` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2242-2261` |
503
511
  | `model` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1370-1377` |
504
512
  | `model` | property | `VoiceSettings` | `dist/core/actions.d.ts:739-740` |
505
- | `modelConfig` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2067-2068` |
506
- | `modelConfig` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2102-2103` |
513
+ | `modelConfig` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2236-2237` |
514
+ | `modelConfig` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2271-2272` |
507
515
  | `modelMaxTokens` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:697-698` |
508
516
  | `modelMaxTokens` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1478-1479` |
509
517
  | `modelMaxTokens` | property | `VoiceSettings` | `dist/core/actions.d.ts:747-748` |
@@ -573,8 +581,8 @@ not find it either.
573
581
  | `name` | property | `TaskRef` | `dist/case/case-sdk.d.ts:410` |
574
582
  | `name` | property | `ThrowOpts` | `dist/bpmn/bpmn-sdk.d.ts:618-619` |
575
583
  | `name` | property | `TimerTriggerOpts` | `dist/case/case-sdk.d.ts:222` |
576
- | `name` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:156-157` |
577
- | `name` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:174-175` |
584
+ | `name` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:167-168` |
585
+ | `name` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:185-186` |
578
586
  | `name` | property | `VarDecl` | `dist/flow-sdk.d.ts:48` |
579
587
  | `name` | property | `VarOpts` | `dist/bpmn/bpmn-sdk.d.ts:1233-1234` |
580
588
  | `nodes` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:411-412` |
@@ -585,8 +593,8 @@ not find it either.
585
593
  | `numExchanges` | property | `WaitForMessageInputs` | `dist/core/actions.d.ts:634-638` |
586
594
  | `object` | property | `ConnectorOpts` | `dist/core/actions.d.ts:184-216` |
587
595
  | `object` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1776-1777` |
588
- | `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3188-3193` |
589
- | `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3143-3153` |
596
+ | `object` | property | `EventSubscription` | `dist/core/actions.d.ts:3397-3402` |
597
+ | `object` | property | `TriggerOptions` | `dist/core/actions.d.ts:3352-3362` |
590
598
  | `objectName` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:66-75` |
591
599
  | `objectName` | property | `LookupSpec` | `dist/core/lookups.d.ts:23-24` |
592
600
  | `objectName` | property | `SelectNextStageSpec` | `dist/case/case-sdk.d.ts:302-303` |
@@ -595,10 +603,10 @@ not find it either.
595
603
  | `operation` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1772-1773` |
596
604
  | `operation` | property | `WaitConnectorPlaceholderSpec` | `dist/case/case-sdk.d.ts:368-369` |
597
605
  | `operations` | property | `TransformInputs` | `dist/core/actions.d.ts:316-317` |
598
- | `operator` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2023-2024` |
606
+ | `operator` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2039-2040` |
599
607
  | `options` | property | `ActionField` | `dist/case/case-sdk.d.ts:445-449` |
600
608
  | `options` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:627-628` |
601
- | `or` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2027-2028` |
609
+ | `or` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2048-2060` |
602
610
  | `outcomePorts` | property | `HitlInputs` | `dist/core/actions.d.ts:583-597` |
603
611
  | `outcomes` | property | `EscalationRef` | `dist/core/actions.d.ts:1900-1905` |
604
612
  | `outcomes` | property | `HitlInputs` | `dist/core/actions.d.ts:564-578` |
@@ -633,8 +641,8 @@ not find it either.
633
641
  | `outputVar` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:933-934` |
634
642
  | `outputVar` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:980-981` |
635
643
  | `outputVar` | property | `ReceiveMessageOpts` | `dist/bpmn/bpmn-sdk.d.ts:1055-1056` |
636
- | `pageRange` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2063-2064` |
637
- | `pageRange` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2100-2101` |
644
+ | `pageRange` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2232-2233` |
645
+ | `pageRange` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2269-2270` |
638
646
  | `pageRange` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:912-913` |
639
647
  | `parallel` | property | `LoopOptions` | `dist/flow-sdk.d.ts:395-396` |
640
648
  | `parallel` | method | `StepList` | `dist/flow-sdk.d.ts:918-953` |
@@ -679,7 +687,8 @@ not find it either.
679
687
  | `recipient` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:454-457` |
680
688
  | `recipient` | property | `HitlInputs` | `dist/core/actions.d.ts:579-580` |
681
689
  | `recipients` | property | `EscalationRef` | `dist/core/actions.d.ts:1898-1899` |
682
- | `record` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2041-2051` |
690
+ | `record` | property | `DataFabricDeleteInputs` | `dist/core/actions.d.ts:2205-2206` |
691
+ | `record` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2173-2174` |
683
692
  | `ref` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:504` |
684
693
  | `reference` | property | `QueueItemInputs` | `dist/core/actions.d.ts:1973-1986` |
685
694
  | `reference` | property | `ReceiveMessageOpts` | `dist/bpmn/bpmn-sdk.d.ts:1047-1054` |
@@ -695,7 +704,7 @@ not find it either.
695
704
  | `required` | property | `InOutField` | `dist/core/actions.d.ts:367-368` |
696
705
  | `required` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:977-983` |
697
706
  | `required` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:884-890` |
698
- | `required` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:170-171` |
707
+ | `required` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:181-182` |
699
708
  | `required` | property | `VarOpts` | `dist/bpmn/bpmn-sdk.d.ts:1253-1254` |
700
709
  | `requiresConnection` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:64` |
701
710
  | `requiresFolderKey` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:65` |
@@ -706,11 +715,16 @@ not find it either.
706
715
  | `resourceKey` | property | `BindingContribution` | `dist/core/node-classes.d.ts:89-90` |
707
716
  | `resourceKey` | property | `BindingDecl` | `dist/bpmn/bpmn-sdk.d.ts:370-371` |
708
717
  | `resourceKey` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:852-853` |
718
+ | `resourceKey` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2157-2168` |
719
+ | `resourceKey` | property | `DataFabricDeleteInputs` | `dist/core/actions.d.ts:2216-2227` |
720
+ | `resourceKey` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2126-2137` |
721
+ | `resourceKey` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2189-2200` |
709
722
  | `resourceSubType` | property | `BindingContribution` | `dist/core/node-classes.d.ts:95-96` |
710
723
  | `resourceSubType` | property | `BindingDecl` | `dist/bpmn/bpmn-sdk.d.ts:372-376` |
711
724
  | `resourceSubType` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:854-861` |
712
725
  | `resourceType` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:1665` |
713
726
  | `resultCount` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1941-1942` |
727
+ | `resultMode` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2091-2104` |
714
728
  | `retrievalMode` | property | `ContextIndexRef` | `dist/core/actions.d.ts:1939-1940` |
715
729
  | `retry` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:310-311` |
716
730
  | `retry` | property | `ActivityOpts` | `dist/bpmn/bpmn-sdk.d.ts:722-723` |
@@ -745,8 +759,8 @@ not find it either.
745
759
  | `runOnReEntry` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:898-905` |
746
760
  | `schema` | method | `BpmnBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2105-2130` |
747
761
  | `schema` | property | `BpmnVarDecl` | `dist/bpmn/bpmn-sdk.d.ts:349-350` |
748
- | `schema` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2093-2099` |
749
- | `schema` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:182-183` |
762
+ | `schema` | property | `DynamicExtractInputs` | `dist/core/actions.d.ts:2262-2268` |
763
+ | `schema` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:193-194` |
750
764
  | `schema` | property | `VarDecl` | `dist/flow-sdk.d.ts:55-56` |
751
765
  | `schema` | property | `VarOpts` | `dist/bpmn/bpmn-sdk.d.ts:1239-1252` |
752
766
  | `schema` | property | `VarSpec` | `dist/flow-sdk.d.ts:72-73` |
@@ -771,12 +785,13 @@ not find it either.
771
785
  | `sequenceFlow` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1917-1925` |
772
786
  | `sequential` | property | `LoopSpec` | `dist/bpmn/bpmn-sdk.d.ts:80-81` |
773
787
  | `serviceName` | property | `McpToolRef` | `dist/core/actions.d.ts:1639` |
774
- | `set` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2052-2056` |
788
+ | `set` | property | `DataFabricUpdateInputs` | `dist/core/actions.d.ts:2175-2179` |
775
789
  | `set` | property | `TaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:808-817` |
776
790
  | `settings` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:681-687` |
777
791
  | `severity` | property | `ContributionDiagnostic` | `dist/core/node-classes.d.ts:27-28` |
778
792
  | `size` | property | `NodeLayout` | `dist/flow-sdk.d.ts:537-541` |
779
793
  | `skip` | property | `BuiltTask` | `dist/case/case-sdk.d.ts:515` |
794
+ | `skip` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2111-2112` |
780
795
  | `skipCondition` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1198-1199` |
781
796
  | `skipCondition` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1118-1119` |
782
797
  | `skipCondition` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1137-1138` |
@@ -793,15 +808,16 @@ not find it either.
793
808
  | `slaRules` | property | `BuiltStage` | `dist/case/case-sdk.d.ts:530` |
794
809
  | `slug` | property | `McpToolRef` | `dist/core/actions.d.ts:1640-1641` |
795
810
  | `slug` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:1660-1661` |
811
+ | `sort` | property | `DataFabricReadInputs` | `dist/core/actions.d.ts:2113-2114` |
796
812
  | `source` | property | `BpmnFlow` | `dist/bpmn/bpmn-sdk.d.ts:321-322` |
797
813
  | `source` | property | `ConversationalAgentInputs` | `dist/core/actions.d.ts:703-708` |
798
814
  | `source` | property | `GuardrailFieldReference` | `dist/core/actions.d.ts:1272` |
799
815
  | `source` | property | `InlineAgentInputs` | `dist/core/actions.d.ts:1464-1473` |
800
816
  | `source` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:496-497` |
801
- | `source` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:180-181` |
817
+ | `source` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:191-192` |
802
818
  | `source` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:777-782` |
803
819
  | `sourceTrigger` | property | `CaseVarDecl` | `dist/case/case-sdk.d.ts:564-570` |
804
- | `splitPages` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2065-2066` |
820
+ | `splitPages` | property | `DocumentClassifyInputs` | `dist/core/actions.d.ts:2234-2235` |
805
821
  | `stage` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1233-1240` |
806
822
  | `stage` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:29-39` |
807
823
  | `stages` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:641` |
@@ -839,8 +855,8 @@ not find it either.
839
855
  | `tags` | property | `ProcessMetadata` | `dist/bpmn/bpmn-sdk.d.ts:442-443` |
840
856
  | `target` | property | `BpmnFlow` | `dist/bpmn/bpmn-sdk.d.ts:323-324` |
841
857
  | `target` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:122-123` |
842
- | `target` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:168-169` |
843
- | `target` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:191-196` |
858
+ | `target` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:179-180` |
859
+ | `target` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:202-207` |
844
860
  | `task` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1423-1430` |
845
861
  | `task` | method | `StageBuilder` | `dist/case/case-sdk.d.ts:984-1003` |
846
862
  | `tasks` | property | `RuleOpts` | `dist/case/case-sdk.d.ts:40-55` |
@@ -894,8 +910,8 @@ not find it either.
894
910
  | `type` | property | `ShownField` | `dist/core/actions.d.ts:331` |
895
911
  | `type` | property | `TaskInputBinding` | `dist/case/case-sdk.d.ts:487` |
896
912
  | `type` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:498` |
897
- | `type` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:158-159` |
898
- | `type` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:176-177` |
913
+ | `type` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:169-170` |
914
+ | `type` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:187-188` |
899
915
  | `type` | property | `VarDecl` | `dist/flow-sdk.d.ts:49` |
900
916
  | `type` | property | `VarSpec` | `dist/flow-sdk.d.ts:66-67` |
901
917
  | `typeVersion` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1173-1188` |
@@ -912,7 +928,7 @@ not find it either.
912
928
  | `validatorType` | property | `BuiltInValidatorGuardrail` | `dist/core/actions.d.ts:1336-1337` |
913
929
  | `value` | property | `ActionField` | `dist/case/case-sdk.d.ts:441-442` |
914
930
  | `value` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:838-842` |
915
- | `value` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2025-2026` |
931
+ | `value` | property | `DataFabricFilter` | `dist/core/actions.d.ts:2041-2047` |
916
932
  | `value` | property | `EscalationRecipient` | `dist/case/case-sdk.d.ts:124-125` |
917
933
  | `value` | property | `Expr` | `dist/core/expr.d.ts:19` |
918
934
  | `value` | property | `FilterRule` | `dist/core/actions.d.ts:226-233` |
@@ -923,12 +939,13 @@ not find it either.
923
939
  | `value` | property | `ShownField` | `dist/core/actions.d.ts:333-339` |
924
940
  | `value` | property | `SwitchArm` | `dist/flow-sdk.d.ts:291` |
925
941
  | `value` | property | `TaskInputBinding` | `dist/case/case-sdk.d.ts:485-486` |
926
- | `value` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:160-161` |
942
+ | `value` | property | `TypedContextRow` | `dist/bpmn/typed-node.d.ts:171-172` |
943
+ | `values` | property | `DataFabricCreateInputs` | `dist/core/actions.d.ts:2142-2147` |
927
944
  | `var` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1199-1223` |
928
945
  | `var` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1329-1338` |
929
946
  | `var` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:1926-1934` |
930
947
  | `var` | property | `TaskOutputBinding` | `dist/case/case-sdk.d.ts:494-495` |
931
- | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:178-179` |
948
+ | `var` | property | `TypedOutputRow` | `dist/bpmn/typed-node.d.ts:189-190` |
932
949
  | `variables` | property | `BuiltBpmn` | `dist/bpmn/bpmn-sdk.d.ts:403-404` |
933
950
  | `variant` | property | `EscalationRef` | `dist/core/actions.d.ts:1868-1876` |
934
951
  | `variant` | property | `HitlInputs` | `dist/core/actions.d.ts:540-544` |
@@ -942,12 +959,12 @@ not find it either.
942
959
  | `version` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:63` |
943
960
  | `version` | property | `ConnectorOpts` | `dist/core/actions.d.ts:178-179` |
944
961
  | `version` | property | `ConnectorToolRef` | `dist/core/actions.d.ts:1774-1775` |
945
- | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3200` |
962
+ | `version` | property | `EventSubscription` | `dist/core/actions.d.ts:3409` |
946
963
  | `version` | property | `ExternalTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1131-1132` |
947
964
  | `version` | method | `FlowBuilder` | `dist/flow-sdk.d.ts:1260-1273` |
948
965
  | `version` | property | `NodeOptions` | `dist/flow-sdk.d.ts:314-321` |
949
966
  | `version` | property | `TriggerMeta` | `dist/core/connectors.d.ts:126` |
950
- | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3160-3161` |
967
+ | `version` | property | `TriggerOptions` | `dist/core/actions.d.ts:3369-3370` |
951
968
  | `versionTag` | property | `IxpExtractInputs` | `dist/core/actions.d.ts:914-915` |
952
969
  | `versionTag` | property | `IxpToolRef` | `dist/core/actions.d.ts:1846-1847` |
953
970
  | `voice` | property | `VoiceAgentInputs` | `dist/core/actions.d.ts:769-770` |
@@ -960,8 +977,8 @@ not find it either.
960
977
  | `waitForTimer` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:877-883` |
961
978
  | `waypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:547-552` |
962
979
  | `when` | property | `SlaOpts` | `dist/case/case-sdk.d.ts:176-182` |
963
- | `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3169-3187` |
964
- | `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3125-3142` |
980
+ | `where` | property | `EventSubscription` | `dist/core/actions.d.ts:3378-3396` |
981
+ | `where` | property | `TriggerOptions` | `dist/core/actions.d.ts:3334-3351` |
965
982
  | `width` | property | `CaseNodeLayout` | `dist/case/case-sdk.d.ts:604-605` |
966
983
  | `width` | property | `StickyNote` | `dist/flow-sdk.d.ts:602-603` |
967
984
  | `x` | property | `StickyNote` | `dist/flow-sdk.d.ts:598-599` |
@@ -0,0 +1,22 @@
1
+ import type { RegistryTypeSpec } from './typed-node.js';
2
+ /**
3
+ * Shape a raw registry `ExtensionType` into the spec the emitter reads.
4
+ *
5
+ * Deliberately the same field-for-field mapping as `trim()` in
6
+ * `scripts/materialize-bpmn-registry.mjs`. They are pinned together by
7
+ * `bpmn-registry-fallback.test.ts`, which resolves a type the snapshot ALREADY
8
+ * carries through this path and asserts the result deep-equals the committed
9
+ * entry — so the two cannot drift for any type that matters without a red test.
10
+ */
11
+ export declare function shapeExtensionType(spec: Record<string, any>): RegistryTypeSpec;
12
+ /**
13
+ * Resolve an extension type the snapshot does not carry, from the registry.
14
+ *
15
+ * @param type - The extension type, e.g. `'Maestro.CasePlanScheduler'`.
16
+ * @returns Its emission spec, or `undefined` when the fallback is disabled, `uip`
17
+ * cannot answer, or the registry has no such type either — in which case the type
18
+ * really is wrong, not merely new.
19
+ */
20
+ export declare function resolveFromRegistry(type: string): RegistryTypeSpec | undefined;
21
+ /** Test seam: forget resolved specs, the pull, and the warning. */
22
+ export declare function resetRegistryFallback(): void;
@@ -0,0 +1,206 @@
1
+ /**
2
+ * bpmn/registry-fallback — resolve an extension type the committed snapshot does
3
+ * not carry, by asking the registry through `uip`.
4
+ *
5
+ * `registry-types.json` is a snapshot, and a snapshot is always behind the
6
+ * platform by however long it has been since someone ran
7
+ * `scripts/materialize-bpmn-registry.mjs`. Until now a type outside it was simply
8
+ * unauthorable: `registryType()` threw, and the author had nowhere to go, because
9
+ * the SDK's whole discovery surface — the typed methods, `dist/api-members.md`,
10
+ * `registryTypeNames()` — is generated from that same snapshot. A type it has
11
+ * never heard of is invisible, not merely unsupported.
12
+ *
13
+ * That cost a full point on `skill-bpmn-contract-variant-wrappers` in the
14
+ * 2026-09-23 v1-vs-v2 run: the task wanted `Maestro.CasePlanScheduler`, the
15
+ * snapshot was stamped `uipVersion: 1.201.0-preview.122` against a `1.204.0-dev`
16
+ * CLI, the type was not in its 30, and the agent had no way to learn the name.
17
+ * The v1 arm ran `uip maestro bpmn registry search` and found it in one command.
18
+ *
19
+ * So: snapshot first, CLI second. The snapshot stays the fast, offline,
20
+ * reviewable default and nothing about a hit changes. A miss is no longer fatal
21
+ * — it costs one subprocess, warns loudly, and tells the author to refresh the
22
+ * snapshot so the next build is offline again.
23
+ *
24
+ * What this deliberately does NOT do:
25
+ *
26
+ * - **Write the snapshot back.** A build that silently rewrites its own spec
27
+ * source stops being reproducible, and `registry-types.json` exists so a spec
28
+ * change is a reviewable diff. The warning points at the materializer instead.
29
+ * - **Run for a type the snapshot already has.** Offline compilation of known
30
+ * types is the common path and must not acquire a tenant dependency.
31
+ * - **Retry forever.** One `registry get`; if that misses, one
32
+ * `registry pull --force` and one more `get`. Both outcomes are remembered
33
+ * for the process, so a file with ten unknown nodes costs at most two CLI
34
+ * calls, not twenty.
35
+ */
36
+ import { execFileSync } from 'node:child_process';
37
+ /** The `uip` binary. Matches `scripts/materialize-bpmn-registry.mjs`. */
38
+ const UIP = () => process.env.UIP ?? 'uip';
39
+ /**
40
+ * Set `FLOW_SDK_BPMN_REGISTRY_FALLBACK=0` to keep the resolver snapshot-only.
41
+ *
42
+ * For hermetic builds and for tests that must not reach a tenant: with it off, a
43
+ * miss throws exactly as it did before this module existed.
44
+ */
45
+ function fallbackEnabled() {
46
+ const v = process.env.FLOW_SDK_BPMN_REGISTRY_FALLBACK;
47
+ return v !== '0' && v !== 'false';
48
+ }
49
+ /** Resolved specs, and misses, for the life of the process. */
50
+ const resolved = new Map();
51
+ /** `registry pull --force` is tried at most once, however many types miss. */
52
+ let pulled = false;
53
+ /** One "you are resolving live" warning per process, not one per type. */
54
+ let warnedLive = false;
55
+ /**
56
+ * Run `uip` and return the `Data` of its JSON envelope, or `undefined`.
57
+ *
58
+ * Never throws: every failure mode here — no `uip` on PATH, not logged in, a
59
+ * `Result: Failure` envelope, a timeout — means the same thing to the caller
60
+ * (the type could not be resolved live) and the caller's error message is better
61
+ * than anything this could raise.
62
+ *
63
+ * `uip` prints a self-update failure to stderr before its real output, so stderr
64
+ * is ignored and stdout is parsed from its first `{`.
65
+ */
66
+ function uip(args, timeoutMs) {
67
+ let out;
68
+ try {
69
+ out = execFileSync(UIP(), args, {
70
+ encoding: 'utf8',
71
+ stdio: ['ignore', 'pipe', 'ignore'],
72
+ timeout: timeoutMs,
73
+ maxBuffer: 64 * 1024 * 1024,
74
+ });
75
+ }
76
+ catch {
77
+ return undefined;
78
+ }
79
+ const start = out.indexOf('{');
80
+ if (start === -1)
81
+ return undefined;
82
+ try {
83
+ const parsed = JSON.parse(out.slice(start));
84
+ if (parsed.Result !== 'Success')
85
+ return undefined;
86
+ return parsed.Data;
87
+ }
88
+ catch {
89
+ return undefined;
90
+ }
91
+ }
92
+ /**
93
+ * The element-specific child a typed node needs beyond its extension payload.
94
+ *
95
+ * Same rule as the materializer's: a message event is only a message event
96
+ * because of its `<bpmn:messageEventDefinition />`, and nothing else in the spec
97
+ * records that.
98
+ */
99
+ function eventDefinitionOf(template) {
100
+ const m = /<(bpmn:\w*EventDefinition)\s*\/?>/i.exec(typeof template === 'string' ? template : '');
101
+ return m ? m[1] : null;
102
+ }
103
+ /**
104
+ * Shape a raw registry `ExtensionType` into the spec the emitter reads.
105
+ *
106
+ * Deliberately the same field-for-field mapping as `trim()` in
107
+ * `scripts/materialize-bpmn-registry.mjs`. They are pinned together by
108
+ * `bpmn-registry-fallback.test.ts`, which resolves a type the snapshot ALREADY
109
+ * carries through this path and asserts the result deep-equals the committed
110
+ * entry — so the two cannot drift for any type that matters without a red test.
111
+ */
112
+ export function shapeExtensionType(spec) {
113
+ const context = (spec.ContextFields ?? []).map((f) => ({
114
+ name: f.Name,
115
+ displayName: f.DisplayName ?? null,
116
+ type: f.Type ?? 'string',
117
+ required: Boolean(f.Required),
118
+ hidden: Boolean(f.Hidden),
119
+ binding: Boolean(f.Binding),
120
+ default: f.DefaultValue ?? null,
121
+ bindingInfo: f.BindingInfo
122
+ ? {
123
+ resource: f.BindingInfo.Resource ?? null,
124
+ propertyAttribute: f.BindingInfo.PropertyAttribute ?? null,
125
+ }
126
+ : null,
127
+ }));
128
+ const inputs = (spec.InputFields ?? []).map((f) => ({
129
+ name: f.Name,
130
+ displayName: f.DisplayName ?? null,
131
+ type: f.Type ?? 'string',
132
+ required: Boolean(f.Required),
133
+ hidden: Boolean(f.Hidden),
134
+ target: f.Target ?? null,
135
+ default: f.DefaultValue ?? null,
136
+ }));
137
+ // The output is FLAT on the payload — `OutputName`/`OutputType`/`OutputSource`/
138
+ // `UseRelativeSource`, not a nested `Output` object — and its type defaults to
139
+ // `jsonSchema`, not `json`. Both were guessed wrong first and caught by the
140
+ // drift pin in `bpmn-registry-fallback.test.ts`.
141
+ const output = spec.OutputName == null
142
+ ? null
143
+ : {
144
+ name: spec.OutputName,
145
+ type: spec.OutputType ?? 'jsonSchema',
146
+ source: spec.OutputSource ?? null,
147
+ relative: Boolean(spec.UseRelativeSource),
148
+ };
149
+ return {
150
+ element: spec.BpmnElement ?? null,
151
+ tag: spec.ExtensionTag ?? null,
152
+ inputPattern: spec.InputPattern ?? 'none',
153
+ inputName: spec.InputName ?? null,
154
+ inputTarget: spec.InputTarget ?? null,
155
+ context,
156
+ inputs,
157
+ output,
158
+ eventDefinition: eventDefinitionOf(spec.XmlTemplate),
159
+ requiresDiscovery: Boolean(spec.RequiresDiscovery),
160
+ bindingPattern: spec.BindingPattern ?? 'none',
161
+ };
162
+ }
163
+ /** `registry get <type>`, shaped, or `undefined` when the registry has no such type. */
164
+ function get(type) {
165
+ const data = uip(['maestro', 'bpmn', 'registry', 'get', type, '--output', 'json'], 60_000);
166
+ const spec = data?.ExtensionType;
167
+ return spec ? shapeExtensionType(spec) : undefined;
168
+ }
169
+ /**
170
+ * Resolve an extension type the snapshot does not carry, from the registry.
171
+ *
172
+ * @param type - The extension type, e.g. `'Maestro.CasePlanScheduler'`.
173
+ * @returns Its emission spec, or `undefined` when the fallback is disabled, `uip`
174
+ * cannot answer, or the registry has no such type either — in which case the type
175
+ * really is wrong, not merely new.
176
+ */
177
+ export function resolveFromRegistry(type) {
178
+ if (!fallbackEnabled())
179
+ return undefined;
180
+ const seen = resolved.get(type);
181
+ if (seen !== undefined)
182
+ return seen ?? undefined;
183
+ let spec = get(type);
184
+ // `registry get` answers from a local cache that does not refresh itself, so a
185
+ // type added since the last pull reads as absent. One forced pull per process,
186
+ // then one retry — beyond that the type is genuinely unknown.
187
+ if (!spec && !pulled) {
188
+ pulled = true;
189
+ uip(['maestro', 'bpmn', 'registry', 'pull', '--force', '--output', 'json'], 180_000);
190
+ spec = get(type);
191
+ }
192
+ resolved.set(type, spec ?? null);
193
+ if (spec && !warnedLive) {
194
+ warnedLive = true;
195
+ process.stderr.write(` warn: extension type "${type}" is not in the committed registry snapshot; resolved it live `
196
+ + `through \`uip maestro bpmn registry get\`. This build needed a tenant. Run \`node `
197
+ + `scripts/materialize-bpmn-registry.mjs\` and commit the result to make it offline again.\n`);
198
+ }
199
+ return spec;
200
+ }
201
+ /** Test seam: forget resolved specs, the pull, and the warning. */
202
+ export function resetRegistryFallback() {
203
+ resolved.clear();
204
+ pulled = false;
205
+ warnedLive = false;
206
+ }
@@ -98,12 +98,23 @@ export declare function registryTypeNames(): string[];
98
98
  /**
99
99
  * The spec for one extension type.
100
100
  *
101
+ * Snapshot first — that is the offline, reviewable, common path, and a hit costs
102
+ * a property read. On a MISS the registry is asked directly through `uip`
103
+ * ({@link resolveFromRegistry}), because a snapshot is always behind the platform
104
+ * by however long it has been since the last refresh, and a type outside it used
105
+ * to be unauthorable rather than merely unsupported: the typed methods,
106
+ * `dist/api-members.md` and {@link registryTypeNames} are all generated from this
107
+ * same file, so an author had no way even to learn the name. Set
108
+ * `FLOW_SDK_BPMN_REGISTRY_FALLBACK=0` to keep resolution snapshot-only.
109
+ *
101
110
  * @param type - The extension type, e.g. `'Intsvc.UnifiedHttpRequest'`.
102
111
  * @returns Its emission spec.
103
- * @throws If the type is not in the committed snapshot — which means either a
104
- * typo or a registry refresh the snapshot has not caught up with.
112
+ * @throws If the type is in neither the snapshot nor the registry — which means a
113
+ * typo, or no `uip` to ask.
105
114
  */
106
115
  export declare function registryType(type: string): RegistryTypeSpec;
116
+ /** True when the snapshot itself carries the type — no tenant needed to emit it. */
117
+ export declare function isSnapshotType(type: string): boolean;
107
118
  /**
108
119
  * Facts the platform enforces but the registry does not state.
109
120
  *