@uipath/maestro-builder-sdk 6.58.0 → 6.59.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.
package/dist/api-index.md CHANGED
@@ -43,14 +43,14 @@ could hand you spans for a version you do not have.
43
43
  | --- | --- | --- | --- | --- |
44
44
  | `ActionSpec` | type | `dist/core/actions.d.ts:847-855` | Supporting types | One action step's spec: `{ kind }` plus that kind's body from FlowActionSpecs, for every kind there. |
45
45
  | `agent` | function | `dist/nodes/process/flow/factories.d.ts:159-213` | Actions | Invoke an AGENT resource — either one published to Orchestrator or a sibling agent project registered in the same… |
46
- | `AgentFlavour` | type | `dist/nodes/process/flow/spec.d.ts:235-239` | Supporting types | Which KIND of agent project was published behind a `uipath.core.agent.<key>` resource. |
46
+ | `AgentFlavour` | type | `dist/nodes/process/flow/spec.d.ts:260-264` | Supporting types | Which KIND of agent project was published behind a `uipath.core.agent.<key>` resource. |
47
47
  | `AgentGuardrail` | type | `dist/core/actions.d.ts:393` | Supporting types | |
48
48
  | `agenticProcess` | function | `dist/nodes/process/flow/factories.d.ts:113-158` | Actions | Invoke a deployed AGENTIC PROCESS — a Maestro process orchestration published to Orchestrator: a BPMN process that… |
49
- | `AgenticProcessCompletion` | type | `dist/nodes/process/flow/spec.d.ts:194-232` | Supporting types | Whether an Agentic Process step waits for the process's result. |
50
- | `AgenticProcessInputs` | type | `dist/nodes/process/flow/spec.d.ts:233-234` | Option shapes | What `agenticProcess()` takes: the shared fields plus the completion policy. |
51
- | `AgenticProcessInputsBase` | interface | `dist/nodes/process/flow/spec.d.ts:137-193` | Option shapes | 7 field(s) |
52
- | `AgentInputs` | interface | `dist/nodes/process/flow/spec.d.ts:242-337` | Option shapes | What `agent()` takes: the agent resource to start, its arguments, and the output fields a read may name. |
53
- | `AgentLocation` | type | `dist/nodes/process/flow/spec.d.ts:240-241` | Supporting types | Where a published agent lives: deployed to a folder (`'published'`) or a sibling project of the same solution… |
49
+ | `AgenticProcessCompletion` | type | `dist/nodes/process/flow/spec.d.ts:219-257` | Supporting types | Whether an Agentic Process step waits for the process's result. |
50
+ | `AgenticProcessInputs` | type | `dist/nodes/process/flow/spec.d.ts:258-259` | Option shapes | What `agenticProcess()` takes: the shared fields plus the completion policy. |
51
+ | `AgenticProcessInputsBase` | interface | `dist/nodes/process/flow/spec.d.ts:162-218` | Option shapes | 7 field(s) |
52
+ | `AgentInputs` | interface | `dist/nodes/process/flow/spec.d.ts:267-362` | Option shapes | What `agent()` takes: the agent resource to start, its arguments, and the output fields a read may name. |
53
+ | `AgentLocation` | type | `dist/nodes/process/flow/spec.d.ts:265-266` | Supporting types | Where a published agent lives: deployed to a folder (`'published'`) or a sibling project of the same solution… |
54
54
  | `AgentMemoryRef` | interface | `dist/core/actions.d.ts:538-562` | Supporting types | An episodic memory the agent learns from across runs, wired to the agent's own `memory` handle. |
55
55
  | `AgentResourcePlacement` | interface | `dist/core/actions.d.ts:406-441` | Supporting types | Where one of an inline agent's resources (a context index, a tool, an escalation) sits in the `.flow`: the id of its own… |
56
56
  | `Aggregation` | interface | `dist/nodes/transform/flow/spec.d.ts:36-42` | Supporting types | 3 field(s) |
@@ -209,7 +209,7 @@ could hand you spans for a version you do not have.
209
209
  | `ProcessToolKind` | type | `dist/core/actions.d.ts:622-635` | Supporting types | The tool kinds that wrap a DEPLOYED tenant resource. |
210
210
  | `ProcessToolRef` | interface | `dist/core/actions.d.ts:636-665` | Supporting types | A deployed tenant resource the agent may invoke. |
211
211
  | `publishedFunction` | function | `dist/nodes/process/flow/factories.d.ts:88-112` | Actions | Invoke a published Orchestrator **Function** — a deployed unit of code run as one step (`uipath.core.function.<key>`,… |
212
- | `PublishedFunctionInputs` | interface | `dist/nodes/process/flow/spec.d.ts:102-136` | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
212
+ | `PublishedFunctionInputs` | interface | `dist/nodes/process/flow/spec.d.ts:102-161` | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
213
213
  | `queueItem` | function | `dist/nodes/queue/flow/factories.d.ts:4-49` | Actions | Declare an Orchestrator QUEUE ITEM step. |
214
214
  | `QueueItemInputs` | interface | `dist/nodes/queue/flow/spec.d.ts:11-84` | Option shapes | 10 field(s) |
215
215
  | `QueuePriority` | type | `dist/nodes/queue/flow/spec.d.ts:9-10` | Supporting types | The three priorities an Orchestrator queue item can carry. |
@@ -5,12 +5,12 @@
5
5
 
6
6
  # Maestro Builder SDK — member index
7
7
 
8
- **A lookup table of 1200 rows — match one name in it, do not read it.**
8
+ **A lookup table of 1202 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 — 1200 across
13
+ Every field and method of every exported shape — 1202 across
14
14
  218 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
@@ -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 1200 rows here.
31
+ which is why its span is not repeated on all 1202 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
@@ -52,15 +52,15 @@ not find it either.
52
52
  | `actions` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1403-1412` |
53
53
  | `activity` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2966-2999` |
54
54
  | `additionalOutputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:98-102` |
55
- | `agent` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:356-359` |
55
+ | `agent` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:381-384` |
56
56
  | `agent` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:883-892` |
57
- | `agenticProcess` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:352-355` |
57
+ | `agenticProcess` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:377-380` |
58
58
  | `alias` | property | `Aggregation` | `dist/nodes/transform/flow/spec.d.ts:38-39` |
59
59
  | `aliases` | property | `LookupSpec` | `dist/core/lookups.d.ts:31-32` |
60
60
  | `allErrors` | property | `RetrySpec` | `dist/bpmn/bpmn-sdk.d.ts:837-838` |
61
61
  | `allowAdhocOptionalStageTasks` | property | `BuiltCase` | `dist/case/case-sdk.d.ts:773-774` |
62
62
  | `allowAdhocTasks` | method | `CaseBuilder` | `dist/case/case-sdk.d.ts:1373-1380` |
63
- | `apiWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:344-347` |
63
+ | `apiWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:369-372` |
64
64
  | `apiWorkflow` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:903-912` |
65
65
  | `app` | property | `EscalationRef` | `dist/core/actions.d.ts:729-756` |
66
66
  | `app` | property | `HitlInputs` | `dist/nodes/hitl/flow/spec.d.ts:192-196` |
@@ -389,7 +389,7 @@ not find it either.
389
389
  | `filters` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:79-80` |
390
390
  | `filters` | property | `EventSubscription` | `dist/core/actions.d.ts:1046-1047` |
391
391
  | `filters` | property | `TriggerOptions` | `dist/core/actions.d.ts:1003-1004` |
392
- | `flavour` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:322-336` |
392
+ | `flavour` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:347-361` |
393
393
  | `flowIds` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3163-3206` |
394
394
  | `flowMode` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:2174-2213` |
395
395
  | `flowProcess` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:925-934` |
@@ -418,8 +418,8 @@ not find it either.
418
418
  | `folderKey` | property | `OrchestratorOpts` | `dist/bpmn/bpmn-sdk.d.ts:1293-1301` |
419
419
  | `folderKey` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:489` |
420
420
  | `folderName` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:108-114` |
421
- | `folderPath` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:163-170` |
422
- | `folderPath` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:266-277` |
421
+ | `folderPath` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:188-195` |
422
+ | `folderPath` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:291-302` |
423
423
  | `folderPath` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:81-82` |
424
424
  | `folderPath` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:168-169` |
425
425
  | `folderPath` | property | `ConnectorEventOpts` | `dist/bpmn/bpmn-sdk.d.ts:1508-1509` |
@@ -428,14 +428,14 @@ not find it either.
428
428
  | `folderPath` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:134-140` |
429
429
  | `folderPath` | property | `McpToolRef` | `dist/core/actions.d.ts:455-456` |
430
430
  | `folderPath` | property | `ProcessToolRef` | `dist/core/actions.d.ts:653-654` |
431
- | `folderPath` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:118-124` |
431
+ | `folderPath` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:130-140` |
432
432
  | `folderPath` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:14-15` |
433
433
  | `folderPath` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:488` |
434
434
  | `folderPath` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:31-38` |
435
435
  | `folderPath` | property | `TaskRef` | `dist/case/case-sdk.d.ts:467` |
436
436
  | `fork` | property | `ParallelOptions` | `dist/flow-sdk.d.ts:452-469` |
437
437
  | `fork` | method | `ScopeBuilder` | `dist/bpmn/bpmn-sdk.d.ts:3106-3131` |
438
- | `form` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:185-192` |
438
+ | `form` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:210-217` |
439
439
  | `form` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1399-1400` |
440
440
  | `form` | property | `HumanTaskFormOpts` | `dist/bpmn/bpmn-sdk.d.ts:1433-1434` |
441
441
  | `from` | property | `CreateOutgoingCallInputs` | `dist/nodes/agent/flow/spec.d.ts:88-92` |
@@ -507,8 +507,8 @@ not find it either.
507
507
  | `inputRows` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1618-1626` |
508
508
  | `inputs` | property | `ActionSpecData` | `dist/case/case-sdk.d.ts:564-565` |
509
509
  | `inputs` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1616-1617` |
510
- | `inputs` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:179-184` |
511
- | `inputs` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:284-301` |
510
+ | `inputs` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:204-209` |
511
+ | `inputs` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:309-326` |
512
512
  | `inputs` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:83-87` |
513
513
  | `inputs` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:176-184` |
514
514
  | `inputs` | property | `BuiltEntryPoint` | `dist/flow-sdk.d.ts:829-830` |
@@ -519,7 +519,7 @@ not find it either.
519
519
  | `inputs` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:228-258` |
520
520
  | `inputs` | property | `NodeContribution` | `dist/core/node-classes.d.ts:113-117` |
521
521
  | `inputs` | property | `ProcessToolRef` | `dist/core/actions.d.ts:661-662` |
522
- | `inputs` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:125-126` |
522
+ | `inputs` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:150-151` |
523
523
  | `inputs` | property | `RegistryTypeSpec` | `dist/bpmn/typed-node.d.ts:95-96` |
524
524
  | `inputs` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:47-52` |
525
525
  | `inputs` | property | `ScriptTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:913-927` |
@@ -549,15 +549,15 @@ not find it either.
549
549
  | `join` | property | `ChooseOpts` | `dist/bpmn/bpmn-sdk.d.ts:1911-1912` |
550
550
  | `join` | property | `SplitOpts` | `dist/bpmn/bpmn-sdk.d.ts:1918-1919` |
551
551
  | `js` | property | `Expr` | `dist/core/expr.d.ts:17` |
552
- | `key` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:138-149` |
553
- | `key` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:244-257` |
552
+ | `key` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:163-174` |
553
+ | `key` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:269-282` |
554
554
  | `key` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:71-78` |
555
555
  | `key` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:166-167` |
556
556
  | `key` | property | `HitlConnection` | `dist/nodes/hitl/flow/spec.d.ts:28-29` |
557
557
  | `key` | property | `HumanTaskAppOpts` | `dist/bpmn/bpmn-sdk.d.ts:1413-1414` |
558
558
  | `key` | property | `McpToolRef` | `dist/core/actions.d.ts:452-453` |
559
559
  | `key` | property | `ProcessToolRef` | `dist/core/actions.d.ts:645-650` |
560
- | `key` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:109-115` |
560
+ | `key` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:109-119` |
561
561
  | `key` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:16-25` |
562
562
  | `key` | property | `RemoteA2aToolRef` | `dist/core/actions.d.ts:480-481` |
563
563
  | `key` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:12-22` |
@@ -599,8 +599,9 @@ not find it either.
599
599
  | `limit` | property | `DataFabricReadInputs` | `dist/nodes/data-fabric/flow/spec.d.ts:95-100` |
600
600
  | `limit` | property | `DoWhileOptions` | `dist/flow-sdk.d.ts:552-553` |
601
601
  | `literal` | property | `Expr` | `dist/core/expr.d.ts:18` |
602
- | `location` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:152-162` |
603
- | `location` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:260-265` |
602
+ | `location` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:177-187` |
603
+ | `location` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:285-290` |
604
+ | `location` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:122-129` |
604
605
  | `location` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:25-30` |
605
606
  | `lookups` | property | `ConnectorMeta` | `dist/core/connectors.d.ts:76-87` |
606
607
  | `loop` | property | `ActivityNodeFields` | `dist/bpmn/bpmn-sdk.d.ts:353-354` |
@@ -662,8 +663,8 @@ not find it either.
662
663
  | `name` | property | `ActionAppRef` | `dist/case/case-sdk.d.ts:541-542` |
663
664
  | `name` | property | `ActionField` | `dist/case/case-sdk.d.ts:514-515` |
664
665
  | `name` | property | `ActivityNodeOpts` | `dist/bpmn/bpmn-sdk.d.ts:1604-1605` |
665
- | `name` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:150-151` |
666
- | `name` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:258-259` |
666
+ | `name` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:175-176` |
667
+ | `name` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:283-284` |
667
668
  | `name` | property | `AgentMemoryRef` | `dist/core/actions.d.ts:547-548` |
668
669
  | `name` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:79-80` |
669
670
  | `name` | property | `AppRef` | `dist/nodes/hitl/flow/spec.d.ts:164-165` |
@@ -718,7 +719,7 @@ not find it either.
718
719
  | `name` | property | `PendingExit` | `dist/bpmn/bpmn-sdk.d.ts:2010-2011` |
719
720
  | `name` | property | `PlainTaskOpts` | `dist/bpmn/bpmn-sdk.d.ts:1703-1704` |
720
721
  | `name` | property | `ProcessToolRef` | `dist/core/actions.d.ts:651-652` |
721
- | `name` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:116-117` |
722
+ | `name` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:120-121` |
722
723
  | `name` | property | `QueueItemOpts` | `dist/bpmn/bpmn-sdk.d.ts:1336-1337` |
723
724
  | `name` | property | `ReceiveMessageOpts` | `dist/bpmn/bpmn-sdk.d.ts:1459-1460` |
724
725
  | `name` | property | `RegistryContextField` | `dist/bpmn/typed-node.d.ts:22` |
@@ -856,16 +857,17 @@ not find it either.
856
857
  | `process` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:857-866` |
857
858
  | `processId` | property | `SugarRegistry` | `dist/bpmn/bpmn-sdk.d.ts:2053-2058` |
858
859
  | `project` | property | `IxpExtractInputs` | `dist/nodes/document/flow/spec.d.ts:76-89` |
859
- | `projectId` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:171-178` |
860
- | `projectId` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:278-283` |
860
+ | `projectId` | property | `AgenticProcessInputsBase` | `dist/nodes/process/flow/spec.d.ts:196-203` |
861
+ | `projectId` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:303-308` |
861
862
  | `projectId` | property | `IxpToolRef` | `dist/core/actions.d.ts:678-688` |
863
+ | `projectId` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:141-149` |
862
864
  | `projectId` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:39-46` |
863
865
  | `prompt` | property | `BatchTransformInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:54-55` |
864
866
  | `prompt` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:32-33` |
865
867
  | `propertyAttribute` | property | `BindingContribution` | `dist/core/node-classes.d.ts:97-98` |
866
868
  | `propertyAttribute` | property | `BindingDecl` | `dist/bpmn/bpmn-sdk.d.ts:427-428` |
867
869
  | `propertyAttribute` | property | `BindingOpts` | `dist/bpmn/bpmn-sdk.d.ts:1069-1070` |
868
- | `publishedFunction` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:348-351` |
870
+ | `publishedFunction` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:373-376` |
869
871
  | `query` | property | `BuiltinToolRef` | `dist/core/actions.d.ts:573-578` |
870
872
  | `query` | property | `ContextIndexRef` | `dist/core/actions.d.ts:793-798` |
871
873
  | `query` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:34` |
@@ -932,13 +934,13 @@ not find it either.
932
934
  | `retryCount` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:109-123` |
933
935
  | `return` | method | `StepList` | `dist/flow-sdk.d.ts:1353-1362` |
934
936
  | `returnCitations` | property | `SummarizeInputs` | `dist/nodes/ai-patterns/flow/spec.d.ts:34-39` |
935
- | `returns` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:302-321` |
937
+ | `returns` | property | `AgentInputs` | `dist/nodes/process/flow/spec.d.ts:327-346` |
936
938
  | `returns` | property | `ApiWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:88-100` |
937
939
  | `returns` | property | `ClientSideToolRef` | `dist/core/actions.d.ts:505-506` |
938
940
  | `returns` | property | `HttpInputsBase` | `dist/nodes/http/flow/spec.d.ts:68-90` |
939
941
  | `returns` | property | `InlineAgentInputs` | `dist/nodes/agent/flow/spec.d.ts:259-272` |
940
942
  | `returns` | property | `ProcessToolRef` | `dist/core/actions.d.ts:663-664` |
941
- | `returns` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:127-135` |
943
+ | `returns` | property | `PublishedFunctionInputs` | `dist/nodes/process/flow/spec.d.ts:152-160` |
942
944
  | `returns` | property | `QueueItemInputs` | `dist/nodes/queue/flow/spec.d.ts:63-83` |
943
945
  | `returns` | property | `RpaWorkflowInputs` | `dist/nodes/process/flow/spec.d.ts:53-68` |
944
946
  | `returns` | property | `ScriptInputs` | `dist/nodes/script/flow/spec.d.ts:10-43` |
@@ -948,7 +950,7 @@ not find it either.
948
950
  | `role` | property | `FlowTrigger` | `dist/core/node-classes.d.ts:173-174` |
949
951
  | `routedWaypoints` | property | `EdgeRoute` | `dist/flow-sdk.d.ts:753-758` |
950
952
  | `rpa` | method | `TaskBuilder` | `dist/case/case-sdk.d.ts:893-902` |
951
- | `rpaWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:340-343` |
953
+ | `rpaWorkflow` | property | `FlowActionSpecs` | `dist/nodes/process/flow/spec.d.ts:365-368` |
952
954
  | `rule` | property | `CaseRule` | `dist/case/case-sdk.d.ts:88` |
953
955
  | `rules` | property | `BuiltCaseExitCondition` | `dist/case/case-sdk.d.ts:381` |
954
956
  | `rules` | property | `BuiltEntryCondition` | `dist/case/case-sdk.d.ts:323` |
@@ -151,6 +151,9 @@ export declare const REFUSALS: {
151
151
  readonly FORM_TRIGGER_NO_INPUTS: "lint";
152
152
  readonly FUNCTION_EMPTY_RETURNS: "lint";
153
153
  readonly FUNCTION_KEY_NOT_KEY: "lint";
154
+ readonly FUNCTION_LOCAL_HAS_FOLDER: "lint";
155
+ readonly FUNCTION_LOCAL_NO_PROJECT_ID: "lint";
156
+ readonly FUNCTION_LOCAL_PROJECT_ID_NOT_GUID: "lint";
154
157
  readonly FUNCTION_NAME_IS_PATH: "lint";
155
158
  readonly FUNCTION_NO_FOLDER: "lint";
156
159
  readonly FUNCTION_NO_KEY: "lint";
@@ -188,6 +188,9 @@ export const REFUSALS = {
188
188
  FORM_TRIGGER_NO_INPUTS: 'lint',
189
189
  FUNCTION_EMPTY_RETURNS: 'lint',
190
190
  FUNCTION_KEY_NOT_KEY: 'lint',
191
+ FUNCTION_LOCAL_HAS_FOLDER: 'lint',
192
+ FUNCTION_LOCAL_NO_PROJECT_ID: 'lint',
193
+ FUNCTION_LOCAL_PROJECT_ID_NOT_GUID: 'lint',
191
194
  FUNCTION_NAME_IS_PATH: 'lint',
192
195
  FUNCTION_NO_FOLDER: 'lint',
193
196
  FUNCTION_NO_KEY: 'lint',
@@ -0,0 +1,180 @@
1
+ /**
2
+ * edit-scope — which parts of a Flow the author edited, and where a finding
3
+ * sits relative to that edit.
4
+ *
5
+ * A node or subflow of the edited flow that differs from its `baseline`
6
+ * counterpart (compile(decompile(original)), the no-edit round trip) is one
7
+ * the author changed; one that equals it is untouched. `mergeFlow` takes the
8
+ * changed ones from the edited flow and restores the untouched ones from the
9
+ * original; `flow merge --baseline-from` (merge-cli.ts) sorts each draft
10
+ * refusal and `check()` finding by the same rule, so a finding on an untouched
11
+ * node is a warning and one on an edited node is an error.
12
+ *
13
+ * For instance, a canvas Slack node with no connection yet that the author did
14
+ * not touch is `kept`; the same node with a new message text is `refused`.
15
+ *
16
+ * Pure: no file access, so a portable entry (`check.ts`, `merge.ts`) can use
17
+ * it. Reading the original and compiling its baseline is merge-compile.ts's.
18
+ */
19
+ import type { Diagnostic } from './check.js';
20
+ export interface AnyNode {
21
+ id: string;
22
+ type: string;
23
+ typeVersion?: string;
24
+ parentId?: string;
25
+ ui?: unknown;
26
+ display?: unknown;
27
+ inputs?: Record<string, unknown>;
28
+ outputs?: Record<string, unknown>;
29
+ [k: string]: unknown;
30
+ }
31
+ export interface AnyEdge {
32
+ id?: string;
33
+ sourceNodeId: string;
34
+ sourcePort: string;
35
+ targetNodeId: string;
36
+ targetPort: string;
37
+ [k: string]: unknown;
38
+ }
39
+ export interface AnyFlow {
40
+ id?: string;
41
+ name?: string;
42
+ version?: string;
43
+ nodes?: AnyNode[];
44
+ edges?: AnyEdge[];
45
+ definitions?: Array<{
46
+ nodeType?: string;
47
+ [k: string]: unknown;
48
+ }>;
49
+ variables?: unknown;
50
+ subflows?: Record<string, unknown>;
51
+ bindings?: Array<{
52
+ id?: string;
53
+ [k: string]: unknown;
54
+ }>;
55
+ metadata?: unknown;
56
+ solutionId?: unknown;
57
+ projectId?: unknown;
58
+ layout?: unknown;
59
+ runtime?: unknown;
60
+ [k: string]: unknown;
61
+ }
62
+ export declare function byId(nodes: AnyNode[] | undefined): Map<string, AnyNode>;
63
+ /**
64
+ * Whether two nodes are the SAME as far as the author is concerned — same type,
65
+ * same inputs and same output mappings. Layout (`ui`), `display`, `typeVersion`,
66
+ * and the derived parts of `outputs` (type, schema, description) are ignored,
67
+ * because those are exactly the parts decompile does not carry through. An
68
+ * output's `source` is authored, not derived: it is what an End returns, so an
69
+ * edit to `.return({ ... })` changes nothing else on the node. Used only to
70
+ * decide "did the user edit this node?" against the baseline.
71
+ */
72
+ export declare function nodeUnchanged(a: AnyNode | undefined, b: AnyNode | undefined): boolean;
73
+ /**
74
+ * The keys of the subflows `mergeFlow` (merge.ts) takes from `edited` rather than
75
+ * restoring from `original`: every subflow that is new, that the original does
76
+ * not have, or that differs from its `baseline` counterpart in any way the
77
+ * author can edit — a node's inputs, output sources or label, an edge, the
78
+ * scope's `variables` or `layout` (`subflowUnchanged`, #1322). With no
79
+ * baseline, that is every subflow. A kept subflow is the original's whole: its
80
+ * nodes, edges, variables and layout.
81
+ */
82
+ export declare function subflowsTakenFromEdited(original: AnyFlow, edited: AnyFlow, baseline?: AnyFlow): string[];
83
+ export type SubflowScope = {
84
+ nodes?: AnyNode[];
85
+ edges?: AnyEdge[];
86
+ variables?: unknown;
87
+ layout?: unknown;
88
+ };
89
+ /**
90
+ * Whether merge restores `e`'s ORIGINAL node instead of taking `e`: there is a
91
+ * baseline, the original has the node, and `e` equals its baseline counterpart.
92
+ * merge.ts's `mergeFlow` node loop and {@link nodesTakenFromEdited} both ask this.
93
+ */
94
+ export declare function isKept(e: AnyNode, origNodes: Map<string, AnyNode>, baseNodes: Map<string, AnyNode>, baseline: AnyFlow | undefined): boolean;
95
+ /**
96
+ * Why a finding is an error: `edited`, its node is one the author changed or
97
+ * added; `subflow`, it sits in a subflow the edit changed, which merge takes
98
+ * whole; `unplaced`, it names no node and the original's own round trip does
99
+ * not report it, so the edit introduced it.
100
+ */
101
+ export type TakenReason = 'edited' | 'subflow' | 'unplaced';
102
+ /**
103
+ * A finding on a node merge takes from the edited flow, with the reason it
104
+ * takes it: `edited`, the author changed or added the node; `subflow`, the
105
+ * node sits in a subflow the edit changed, which merge takes whole (`subflow`
106
+ * names it).
107
+ */
108
+ export type Refused<T> = T & {
109
+ reason: TakenReason;
110
+ subflow?: string;
111
+ };
112
+ /** A finding on a node merge restores from the original; `subflow` names the untouched subflow it sits in. */
113
+ type Kept<T> = T & {
114
+ subflow?: string;
115
+ };
116
+ /**
117
+ * Sort each finding by what merge does with its node: `refused` when the node
118
+ * comes from the edited flow (reason `edited`: the author changed or added it;
119
+ * reason `subflow`: it sits in a subflow the edit changed, which merge takes
120
+ * whole), `kept` when merge restores the original node — a root node the edit
121
+ * did not touch, or any node of a subflow the edit did not touch (#1322) — and
122
+ * `unplaced` when the finding names no node merge knows (an unnamed End's
123
+ * `.return`, a flow-level finding). The caller sorts those again with
124
+ * {@link splitUnplaced}: one the original's own round trip reports too is
125
+ * printed, one the edit introduced is refused.
126
+ *
127
+ * For instance a Slack node with no connection that the author did not touch
128
+ * is `kept`; the same node with a new message text is `refused` as `edited`.
129
+ */
130
+ export declare function classifyDrafts<T extends {
131
+ nodeId: string;
132
+ subflow?: string;
133
+ }>(original: any, edited: any, baseline: any, findings: readonly T[]): {
134
+ kept: Kept<T>[];
135
+ refused: Refused<T>[];
136
+ unplaced: T[];
137
+ };
138
+ /**
139
+ * A `check()` diagnostic, placed on the node its step emitted (`''` when it
140
+ * names no node); `subflow` is the calling step when the finding is inside a
141
+ * subflow, which then decides how it is classified.
142
+ */
143
+ export type PlacedDiagnostic = Diagnostic & {
144
+ nodeId: string;
145
+ subflow?: string;
146
+ };
147
+ /**
148
+ * Place each `check()` diagnostic on the node its step emitted in `editedFlow`, so
149
+ * {@link classifyDrafts} can sort it: a root step on its node (by label, then
150
+ * id); a step inside a subflow (`check` reports it as `<caller> › <step>`, one
151
+ * segment per level) on the deepest step the path resolves to, with `subflow`
152
+ * set to the deepest subflow on that path, which is what decides; a named End
153
+ * on its End node (#1322). A diagnostic with no step, or one no node answers
154
+ * to, gets nodeId `''`.
155
+ */
156
+ export declare function placeDiagnostics(diagnostics: readonly Diagnostic[], editedFlow: any): PlacedDiagnostic[];
157
+ /** How many times each {@link findingKey} occurs, for {@link splitUnplaced}'s baseline. */
158
+ export declare function findingCounts(findings: ReadonlyArray<{
159
+ code: string;
160
+ message: string;
161
+ }>): Map<string, number>;
162
+ /**
163
+ * Sort findings merge could not place on a node by whether the edit introduced
164
+ * them: `known` when the ORIGINAL's own round trip (`baseline`, the decompiled
165
+ * original compiled and checked, as {@link findingCounts}) reports the same
166
+ * code and message — once per occurrence, so a second copy of a finding the
167
+ * original has once is `introduced` — so the finding predates the edit and
168
+ * only prints; `introduced` otherwise, which is refused like any error on an
169
+ * edited node (#1322). With no baseline findings to compare against (a
170
+ * precompiled `--baseline` file), every one is `introduced`, as merge treated
171
+ * them before.
172
+ */
173
+ export declare function splitUnplaced<T extends {
174
+ code: string;
175
+ message: string;
176
+ }>(unplaced: readonly T[], baseline: ReadonlyMap<string, number> | undefined): {
177
+ known: T[];
178
+ introduced: T[];
179
+ };
180
+ export {};