@decaf-ts/as-graph 0.2.1 → 0.4.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/README.md +158 -2
- package/dist/as-graph.cjs +1 -1
- package/dist/as-graph.cjs.map +1 -1
- package/dist/as-graph.js +1 -1
- package/dist/as-graph.js.map +1 -1
- package/lib/cjs/dagster/DagsterGraphEventBridge.cjs +344 -0
- package/lib/cjs/dagster/DagsterGraphEventBridge.cjs.map +1 -0
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +789 -0
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/dagster/DagsterResultMapper.cjs +56 -0
- package/lib/cjs/dagster/DagsterResultMapper.cjs.map +1 -0
- package/lib/cjs/dagster/DagsterTypes.cjs +4 -0
- package/lib/cjs/dagster/DagsterTypes.cjs.map +1 -0
- package/lib/cjs/dagster/capabilities.cjs +102 -0
- package/lib/cjs/dagster/capabilities.cjs.map +1 -0
- package/lib/cjs/dagster/constants.cjs +92 -0
- package/lib/cjs/dagster/constants.cjs.map +1 -0
- package/lib/cjs/dagster/index.cjs +32 -0
- package/lib/cjs/dagster/index.cjs.map +1 -0
- package/lib/cjs/engine/constants.cjs +6 -1
- package/lib/cjs/engine/constants.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphCodeMode.cjs +137 -0
- package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionBackend.cjs +89 -0
- package/lib/cjs/engine/execution/GraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs +107 -0
- package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +250 -733
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +804 -0
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/engine/execution/index.cjs +4 -0
- package/lib/cjs/engine/execution/index.cjs.map +1 -1
- package/lib/cjs/engine/index.cjs +4 -0
- package/lib/cjs/engine/index.cjs.map +1 -1
- package/lib/cjs/engine/runs/GraphRunService.cjs +61 -0
- package/lib/cjs/engine/runs/GraphRunService.cjs.map +1 -1
- package/lib/cjs/engine/services/GraphWorkflowService.cjs +33 -14
- package/lib/cjs/engine/services/GraphWorkflowService.cjs.map +1 -1
- package/lib/cjs/mastra/MastraCapabilities.cjs +171 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -0
- package/lib/cjs/mastra/MastraConditionBridge.cjs +39 -0
- package/lib/cjs/mastra/MastraConditionBridge.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs +486 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -0
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +351 -0
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/mastra/MastraResumeGuard.cjs +127 -0
- package/lib/cjs/mastra/MastraResumeGuard.cjs.map +1 -0
- package/lib/cjs/mastra/MastraSchemaConverter.cjs +124 -0
- package/lib/cjs/mastra/MastraSchemaConverter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +461 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowManager.cjs +401 -0
- package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -0
- package/lib/cjs/mastra/index.cjs +35 -0
- package/lib/cjs/mastra/index.cjs.map +1 -0
- package/lib/cjs/mastra/types.cjs +34 -0
- package/lib/cjs/mastra/types.cjs.map +1 -0
- package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs +136 -0
- package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs.map +1 -0
- package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs +140 -0
- package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs.map +1 -0
- package/lib/cjs/nest/graph/GraphEngineController.cjs +227 -0
- package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -0
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs +30 -2
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
- package/lib/cjs/nest/graph/index.cjs +3 -0
- package/lib/cjs/nest/graph/index.cjs.map +1 -1
- package/lib/cjs/nest/graph/main.cjs +54 -0
- package/lib/cjs/nest/graph/main.cjs.map +1 -0
- package/lib/cjs/nest/graph/servingErrors.cjs +3 -0
- package/lib/cjs/nest/graph/servingErrors.cjs.map +1 -1
- package/lib/cjs/node/utility/code/node.cjs +11 -3
- package/lib/cjs/node/utility/code/node.cjs.map +1 -1
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +2 -3
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
- package/lib/cjs/shared/graph/constants.cjs +8 -0
- package/lib/cjs/shared/graph/constants.cjs.map +1 -1
- package/lib/cjs/shared/graph/index.cjs +2 -1
- package/lib/cjs/shared/graph/index.cjs.map +1 -1
- package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs +146 -0
- package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs.map +1 -0
- package/lib/cjs/shared/graph/layout/index.cjs +23 -0
- package/lib/cjs/shared/graph/layout/index.cjs.map +1 -0
- package/lib/cjs/shared/graph/layout/layout-options.cjs +93 -0
- package/lib/cjs/shared/graph/layout/layout-options.cjs.map +1 -0
- package/lib/cjs/shared/ui/index.cjs +8 -10
- package/lib/cjs/shared/ui/index.cjs.map +1 -1
- package/lib/esm/dagster/DagsterGraphEventBridge.js +339 -0
- package/lib/esm/dagster/DagsterGraphEventBridge.js.map +1 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js +781 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -0
- package/lib/esm/dagster/DagsterResultMapper.js +51 -0
- package/lib/esm/dagster/DagsterResultMapper.js.map +1 -0
- package/lib/esm/dagster/DagsterTypes.js +2 -0
- package/lib/esm/dagster/DagsterTypes.js.map +1 -0
- package/lib/esm/dagster/capabilities.js +97 -0
- package/lib/esm/dagster/capabilities.js.map +1 -0
- package/lib/esm/dagster/constants.js +88 -0
- package/lib/esm/dagster/constants.js.map +1 -0
- package/lib/esm/dagster/index.js +15 -0
- package/lib/esm/dagster/index.js.map +1 -0
- package/lib/esm/engine/constants.js +5 -0
- package/lib/esm/engine/constants.js.map +1 -1
- package/lib/esm/engine/execution/GraphCodeMode.js +132 -0
- package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionBackend.js +83 -0
- package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js +102 -0
- package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionEngine.js +232 -716
- package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +799 -0
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -0
- package/lib/esm/engine/execution/index.js +4 -0
- package/lib/esm/engine/execution/index.js.map +1 -1
- package/lib/esm/engine/index.js +4 -0
- package/lib/esm/engine/index.js.map +1 -1
- package/lib/esm/engine/runs/GraphRunService.js +62 -1
- package/lib/esm/engine/runs/GraphRunService.js.map +1 -1
- package/lib/esm/engine/services/GraphWorkflowService.js +33 -14
- package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
- package/lib/esm/mastra/MastraCapabilities.js +164 -0
- package/lib/esm/mastra/MastraCapabilities.js.map +1 -0
- package/lib/esm/mastra/MastraConditionBridge.js +34 -0
- package/lib/esm/mastra/MastraConditionBridge.js.map +1 -0
- package/lib/esm/mastra/MastraEventBridge.js +481 -0
- package/lib/esm/mastra/MastraEventBridge.js.map +1 -0
- package/lib/esm/mastra/MastraGraphExecutionBackend.js +346 -0
- package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -0
- package/lib/esm/mastra/MastraResumeGuard.js +123 -0
- package/lib/esm/mastra/MastraResumeGuard.js.map +1 -0
- package/lib/esm/mastra/MastraSchemaConverter.js +119 -0
- package/lib/esm/mastra/MastraSchemaConverter.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js +456 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowManager.js +396 -0
- package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -0
- package/lib/esm/mastra/index.js +18 -0
- package/lib/esm/mastra/index.js.map +1 -0
- package/lib/esm/mastra/types.js +30 -0
- package/lib/esm/mastra/types.js.map +1 -0
- package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js +129 -0
- package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js.map +1 -0
- package/lib/esm/nest/graph/GraphEngineCapabilityService.js +131 -0
- package/lib/esm/nest/graph/GraphEngineCapabilityService.js.map +1 -0
- package/lib/esm/nest/graph/GraphEngineController.js +218 -0
- package/lib/esm/nest/graph/GraphEngineController.js.map +1 -0
- package/lib/esm/nest/graph/GraphExecutionModule.js +30 -2
- package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
- package/lib/esm/nest/graph/index.js +3 -0
- package/lib/esm/nest/graph/index.js.map +1 -1
- package/lib/esm/nest/graph/main.js +51 -0
- package/lib/esm/nest/graph/main.js.map +1 -0
- package/lib/esm/nest/graph/servingErrors.js +3 -0
- package/lib/esm/nest/graph/servingErrors.js.map +1 -1
- package/lib/esm/node/utility/code/node.js +11 -3
- package/lib/esm/node/utility/code/node.js.map +1 -1
- package/lib/esm/shared/graph/GraphExecutionStateMapper.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +2 -3
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
- package/lib/esm/shared/graph/constants.js +8 -0
- package/lib/esm/shared/graph/constants.js.map +1 -1
- package/lib/esm/shared/graph/index.js +2 -1
- package/lib/esm/shared/graph/index.js.map +1 -1
- package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js +107 -0
- package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js.map +1 -0
- package/lib/esm/shared/graph/layout/index.js +6 -0
- package/lib/esm/shared/graph/layout/index.js.map +1 -0
- package/lib/esm/shared/graph/layout/layout-options.js +96 -0
- package/lib/esm/shared/graph/layout/layout-options.js.map +1 -0
- package/lib/esm/shared/ui/index.js +8 -10
- package/lib/esm/shared/ui/index.js.map +1 -1
- package/lib/types/dagster/DagsterGraphEventBridge.d.cts +142 -0
- package/lib/types/dagster/DagsterGraphEventBridge.d.mts +142 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +323 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +323 -0
- package/lib/types/dagster/DagsterResultMapper.d.cts +50 -0
- package/lib/types/dagster/DagsterResultMapper.d.mts +50 -0
- package/lib/types/dagster/DagsterTypes.d.cts +355 -0
- package/lib/types/dagster/DagsterTypes.d.mts +355 -0
- package/lib/types/dagster/capabilities.d.cts +34 -0
- package/lib/types/dagster/capabilities.d.mts +34 -0
- package/lib/types/dagster/constants.d.cts +87 -0
- package/lib/types/dagster/constants.d.mts +87 -0
- package/lib/types/dagster/index.d.cts +14 -0
- package/lib/types/dagster/index.d.mts +14 -0
- package/lib/types/engine/constants.d.cts +5 -0
- package/lib/types/engine/constants.d.mts +5 -0
- package/lib/types/engine/execution/GraphCodeMode.d.cts +52 -0
- package/lib/types/engine/execution/GraphCodeMode.d.mts +52 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.cts +306 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.mts +306 -0
- package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.cts +59 -0
- package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.mts +59 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -135
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -135
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +232 -0
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +232 -0
- package/lib/types/engine/execution/index.d.cts +4 -0
- package/lib/types/engine/execution/index.d.mts +4 -0
- package/lib/types/engine/index.d.cts +4 -0
- package/lib/types/engine/index.d.mts +4 -0
- package/lib/types/engine/runs/GraphRunService.d.cts +19 -0
- package/lib/types/engine/runs/GraphRunService.d.mts +19 -0
- package/lib/types/engine/services/GraphWorkflowService.d.cts +22 -0
- package/lib/types/engine/services/GraphWorkflowService.d.mts +22 -0
- package/lib/types/mastra/MastraCapabilities.d.cts +91 -0
- package/lib/types/mastra/MastraCapabilities.d.mts +91 -0
- package/lib/types/mastra/MastraConditionBridge.d.cts +38 -0
- package/lib/types/mastra/MastraConditionBridge.d.mts +38 -0
- package/lib/types/mastra/MastraEventBridge.d.cts +189 -0
- package/lib/types/mastra/MastraEventBridge.d.mts +189 -0
- package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +119 -0
- package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +119 -0
- package/lib/types/mastra/MastraResumeGuard.d.cts +58 -0
- package/lib/types/mastra/MastraResumeGuard.d.mts +58 -0
- package/lib/types/mastra/MastraSchemaConverter.d.cts +39 -0
- package/lib/types/mastra/MastraSchemaConverter.d.mts +39 -0
- package/lib/types/mastra/MastraWorkflowCompiler.d.cts +218 -0
- package/lib/types/mastra/MastraWorkflowCompiler.d.mts +218 -0
- package/lib/types/mastra/MastraWorkflowManager.d.cts +220 -0
- package/lib/types/mastra/MastraWorkflowManager.d.mts +220 -0
- package/lib/types/mastra/index.d.cts +17 -0
- package/lib/types/mastra/index.d.mts +17 -0
- package/lib/types/mastra/types.d.cts +222 -0
- package/lib/types/mastra/types.d.mts +222 -0
- package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.cts +87 -0
- package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.mts +87 -0
- package/lib/types/nest/graph/GraphEngineCapabilityService.d.cts +98 -0
- package/lib/types/nest/graph/GraphEngineCapabilityService.d.mts +98 -0
- package/lib/types/nest/graph/GraphEngineController.d.cts +74 -0
- package/lib/types/nest/graph/GraphEngineController.d.mts +74 -0
- package/lib/types/nest/graph/GraphExecutionModule.d.cts +8 -0
- package/lib/types/nest/graph/GraphExecutionModule.d.mts +8 -0
- package/lib/types/nest/graph/index.d.cts +3 -0
- package/lib/types/nest/graph/index.d.mts +3 -0
- package/lib/types/nest/graph/main.d.cts +1 -0
- package/lib/types/nest/graph/main.d.mts +1 -0
- package/lib/types/nest/graph/servingErrors.d.cts +3 -1
- package/lib/types/nest/graph/servingErrors.d.mts +3 -1
- package/lib/types/node/utility/code/node.d.cts +1 -1
- package/lib/types/node/utility/code/node.d.mts +1 -1
- package/lib/types/shared/graph/GraphExecutionStateMapper.d.cts +5 -5
- package/lib/types/shared/graph/GraphExecutionStateMapper.d.mts +5 -5
- package/lib/types/shared/graph/constants.d.cts +8 -0
- package/lib/types/shared/graph/constants.d.mts +8 -0
- package/lib/types/shared/graph/index.d.cts +2 -1
- package/lib/types/shared/graph/index.d.mts +2 -1
- package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.cts +49 -0
- package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.mts +49 -0
- package/lib/types/shared/graph/layout/index.d.cts +5 -0
- package/lib/types/shared/graph/layout/index.d.mts +5 -0
- package/lib/types/shared/graph/layout/layout-options.d.cts +46 -0
- package/lib/types/shared/graph/layout/layout-options.d.mts +46 -0
- package/lib/types/shared/graph/types.d.cts +4 -3
- package/lib/types/shared/graph/types.d.mts +4 -3
- package/lib/types/shared/ui/index.d.cts +8 -10
- package/lib/types/shared/ui/index.d.mts +8 -10
- package/package.json +49 -6
- package/lib/cjs/shared/ui/GraphNodeView.cjs +0 -114
- package/lib/cjs/shared/ui/GraphNodeView.cjs.map +0 -1
- package/lib/cjs/shared/ui/GraphRunView.cjs +0 -96
- package/lib/cjs/shared/ui/GraphRunView.cjs.map +0 -1
- package/lib/cjs/shared/ui/GraphWorkflowView.cjs +0 -78
- package/lib/cjs/shared/ui/GraphWorkflowView.cjs.map +0 -1
- package/lib/cjs/shared/ui/types.cjs +0 -4
- package/lib/cjs/shared/ui/types.cjs.map +0 -1
- package/lib/esm/shared/ui/GraphNodeView.js +0 -107
- package/lib/esm/shared/ui/GraphNodeView.js.map +0 -1
- package/lib/esm/shared/ui/GraphRunView.js +0 -90
- package/lib/esm/shared/ui/GraphRunView.js.map +0 -1
- package/lib/esm/shared/ui/GraphWorkflowView.js +0 -72
- package/lib/esm/shared/ui/GraphWorkflowView.js.map +0 -1
- package/lib/esm/shared/ui/types.js +0 -2
- package/lib/esm/shared/ui/types.js.map +0 -1
- package/lib/types/shared/ui/GraphNodeView.d.cts +0 -48
- package/lib/types/shared/ui/GraphNodeView.d.mts +0 -48
- package/lib/types/shared/ui/GraphRunView.d.cts +0 -88
- package/lib/types/shared/ui/GraphRunView.d.mts +0 -88
- package/lib/types/shared/ui/GraphWorkflowView.d.cts +0 -18
- package/lib/types/shared/ui/GraphWorkflowView.d.mts +0 -18
- package/lib/types/shared/ui/types.d.cts +0 -200
- package/lib/types/shared/ui/types.d.mts +0 -200
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/execution/GraphExecutionBackend
|
|
3
|
+
* @summary Pluggable graph execution backend seam (DECAF-50 §4.9).
|
|
4
|
+
* @description Defines the engine-agnostic execution seam that
|
|
5
|
+
* {@link GraphExecutionEngine} delegates to after validation, catalogue
|
|
6
|
+
* resolution, authorization, and topological planning. The contract is patterned
|
|
7
|
+
* on Decaf's persistence adapters: `GraphExecutionBackend` is the `Adapter`
|
|
8
|
+
* analogue and {@link LocalGraphExecutionBackend} is the built-in `RamAdapter`
|
|
9
|
+
* analogue (the extracted reference interpreter). Remote/translated backends
|
|
10
|
+
* (Dagster, Mastra) receive the canonical document for translation and the
|
|
11
|
+
* resolved plan for built-in execution, but can never bypass the facade's
|
|
12
|
+
* pre-execution gate: validation/resolution/auth always happen against the
|
|
13
|
+
* trusted catalogue before any backend runs.
|
|
14
|
+
*/
|
|
15
|
+
import type { Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
16
|
+
import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
17
|
+
import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.mts";
|
|
18
|
+
import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphRunId } from "../types.d.mts";
|
|
19
|
+
import type { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.mts";
|
|
20
|
+
import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.mts";
|
|
21
|
+
import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.mts";
|
|
22
|
+
import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.mts";
|
|
23
|
+
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
|
|
24
|
+
/**
|
|
25
|
+
* How a {@link GraphExecutionBackend} handles code-mode workflow surfaces.
|
|
26
|
+
*
|
|
27
|
+
* Code-mode surfaces are `CodeCondition`s on any flow-control carrier,
|
|
28
|
+
* `core.utility.code` nodes, `GraphValueTemplate` parameters, and expression
|
|
29
|
+
* input bindings (SAA-193 C1). The facade detects them and fails closed before
|
|
30
|
+
* delegating to any backend with `local === false`:
|
|
31
|
+
*
|
|
32
|
+
* - `hostSide`: the host executes code-mode surfaces through the facade-owned
|
|
33
|
+
* `CodeSandboxEvaluator`; the facade rejects the run with
|
|
34
|
+
* `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` when no evaluator is configured.
|
|
35
|
+
* - `unsupported`: the backend cannot execute code-mode surfaces at all; the
|
|
36
|
+
* facade rejects the run with `GRAPH_CODE_MODE_UNSUPPORTED_BACKEND` before any
|
|
37
|
+
* remote launch.
|
|
38
|
+
*/
|
|
39
|
+
export type GraphCodeMode = "hostSide" | "unsupported";
|
|
40
|
+
/** Whether an optional backend capability is supported. */
|
|
41
|
+
export type GraphBackendCapabilityStatus = "supported" | "not_supported";
|
|
42
|
+
/**
|
|
43
|
+
* Engine-agnostic capability metadata a backend declares. Hosts and servers read
|
|
44
|
+
* this to surface what the active backend can do without probing it.
|
|
45
|
+
*/
|
|
46
|
+
export interface GraphBackendCapabilities {
|
|
47
|
+
/** Code-mode handling (mirrors {@link GraphExecutionBackend.codeMode}). */
|
|
48
|
+
codeMode: GraphCodeMode;
|
|
49
|
+
/** Backend workflow listing/lookup support. */
|
|
50
|
+
workflows: {
|
|
51
|
+
list: GraphBackendCapabilityStatus;
|
|
52
|
+
get: GraphBackendCapabilityStatus;
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
/** A workflow summary surfaced by backend workflow listing. */
|
|
56
|
+
export interface GraphBackendWorkflowSummary {
|
|
57
|
+
/** Canonical workflow id. */
|
|
58
|
+
id: string;
|
|
59
|
+
/** Display name. */
|
|
60
|
+
name?: string;
|
|
61
|
+
/** Last update timestamp, when the backing store exposes one. */
|
|
62
|
+
updatedAt?: Date;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Minimal workflow catalogue record a {@link GraphBackendWorkflowStore} lists.
|
|
66
|
+
* `GraphWorkflowModel` structurally satisfies it.
|
|
67
|
+
*/
|
|
68
|
+
export interface GraphBackendWorkflowRecord {
|
|
69
|
+
/** Canonical workflow id. */
|
|
70
|
+
workflowId: string;
|
|
71
|
+
/** Display name. */
|
|
72
|
+
name?: string;
|
|
73
|
+
/** Last update timestamp, when the backing store exposes one. */
|
|
74
|
+
updatedAt?: Date;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Workflow listing/lookup port the built-in local backend reads through. The
|
|
78
|
+
* existing `GraphWorkflowService` structurally satisfies it; hosts pass their
|
|
79
|
+
* service instance into `GraphExecutionEngineConfig.workflowStore`.
|
|
80
|
+
*/
|
|
81
|
+
export interface GraphBackendWorkflowStore {
|
|
82
|
+
/** Lists the workflows visible to the requesting principal. */
|
|
83
|
+
listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowRecord[]>;
|
|
84
|
+
/** Reads a single canonical workflow document. */
|
|
85
|
+
getDocument(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Facade-owned event sink handed to a backend. The facade owns event
|
|
89
|
+
* sequencing (id/sequence/timestamp) and observer dispatch; a backend reports
|
|
90
|
+
* every transition by calling {@link GraphExecutionEventSink.emit} with a
|
|
91
|
+
* partial event.
|
|
92
|
+
*/
|
|
93
|
+
export interface GraphExecutionEventSink {
|
|
94
|
+
/** Enriches, sequences, records, and dispatches a partial event. */
|
|
95
|
+
emit(event: Partial<GraphExecutionEvent>): Promise<void>;
|
|
96
|
+
/** Dispatches an already-built event to all registered observers. */
|
|
97
|
+
updateObservers(event: GraphExecutionEvent): Promise<void>;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Request passed to a {@link GraphExecutionBackend}. Carries both the canonical
|
|
101
|
+
* document (the translation source for remote backends) and the resolved plan
|
|
102
|
+
* (what built-in backends execute).
|
|
103
|
+
*/
|
|
104
|
+
export interface GraphBackendExecutionRequest {
|
|
105
|
+
/** The canonical workflow document (translation source). */
|
|
106
|
+
document: GraphWorkflowDocument;
|
|
107
|
+
/** The resolved, topologically layered execution plan. */
|
|
108
|
+
plan: GraphExecutionPlan;
|
|
109
|
+
/** Workflow input values keyed by input port id. */
|
|
110
|
+
inputs: GraphExecutionValues;
|
|
111
|
+
/** Effective execution options (already merged with engine defaults). */
|
|
112
|
+
options: GraphExecutionOptions;
|
|
113
|
+
/** Facade-owned event sink: the backend reports all transitions here. */
|
|
114
|
+
events: GraphExecutionEventSink;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Engine-agnostic resume request for a suspended run (SAA-196 C14). The payload
|
|
118
|
+
* is untrusted: a resume-capable backend validates it (JSON-safe, byte-capped,
|
|
119
|
+
* schema-checked against the suspended revision) before handing it to the engine.
|
|
120
|
+
*/
|
|
121
|
+
export interface GraphResumeRequest {
|
|
122
|
+
/** Step id to resume; defaults to the snapshot's single suspended step. */
|
|
123
|
+
step?: string;
|
|
124
|
+
/** Untrusted resume payload supplied by the caller. */
|
|
125
|
+
resumeData?: Record<string, unknown>;
|
|
126
|
+
/** Per-iteration index when resuming inside a `foreach`. */
|
|
127
|
+
forEachIndex?: number;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Engine-agnostic C18 audit record returned by a resume. Carries the caller, run
|
|
131
|
+
* and step identity plus a hash/size of the resume payload — never the raw
|
|
132
|
+
* `resumeData` — so every resume is auditable without leaking secrets.
|
|
133
|
+
*/
|
|
134
|
+
export interface GraphResumeAudit {
|
|
135
|
+
/** Resolved caller identity; `null` for anonymous callers. */
|
|
136
|
+
caller?: string | null;
|
|
137
|
+
/** Canonical run id that was resumed. */
|
|
138
|
+
runId: GraphRunId;
|
|
139
|
+
/** Workflow id the resumed run belongs to. */
|
|
140
|
+
workflowId?: string;
|
|
141
|
+
/** Step id the run was resumed at. */
|
|
142
|
+
step?: string;
|
|
143
|
+
/** Per-iteration index when the run resumed inside a `foreach`. */
|
|
144
|
+
forEachIndex?: number;
|
|
145
|
+
/** Stable hash of the resume payload (never the raw payload). */
|
|
146
|
+
resumeDataHash?: string;
|
|
147
|
+
/** Serialized byte size of the resume payload. */
|
|
148
|
+
resumeDataBytes?: number;
|
|
149
|
+
/** ISO timestamp of the accepted resume. */
|
|
150
|
+
at?: string;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* The pluggable graph execution seam (the Decaf `Adapter` analogue). Owns
|
|
154
|
+
* exactly one responsibility: given the resolved plan and/or canonical document,
|
|
155
|
+
* run it and report results/events through the request's sink.
|
|
156
|
+
*
|
|
157
|
+
* @typeParam CONFIG - Backend-specific initialization configuration.
|
|
158
|
+
*/
|
|
159
|
+
export interface GraphExecutionBackend<CONFIG extends Record<string, unknown> = Record<string, unknown>> {
|
|
160
|
+
/**
|
|
161
|
+
* Resolves the backend's runtime configuration. Called by the facade during
|
|
162
|
+
* `GraphExecutionEngine.initialize`.
|
|
163
|
+
*
|
|
164
|
+
* @param config - Backend-specific configuration.
|
|
165
|
+
* @param args - Optional decaf contextual arguments.
|
|
166
|
+
*/
|
|
167
|
+
initialize(config: CONFIG, ...args: MaybeContextualArg<Context>): Promise<void>;
|
|
168
|
+
/**
|
|
169
|
+
* The backend-specific configuration most recently resolved by
|
|
170
|
+
* {@link initialize}, when the backend retains it. The facade reads this during
|
|
171
|
+
* `GraphExecutionEngine.initialize` and merges its own facade-owned keys over
|
|
172
|
+
* it, so a host that configured the backend directly before booting the engine
|
|
173
|
+
* (e.g. `backend.initialize({ mastra, stepHandlers, suspendStateReader })`) does
|
|
174
|
+
* not lose that wiring when the facade initializes the backend.
|
|
175
|
+
*
|
|
176
|
+
* Facade-owned keys (`engine`, `valueAdapter`, `codeSandboxEvaluator`,
|
|
177
|
+
* `workflowStore`) win on collision: the facade is the authority for the
|
|
178
|
+
* collaborators it owns, while every other host key survives. Backends without
|
|
179
|
+
* host-supplied configuration (the built-in local backend) may omit this.
|
|
180
|
+
*/
|
|
181
|
+
readonly config?: CONFIG;
|
|
182
|
+
/** Whether this backend executes locally (in-process). */
|
|
183
|
+
readonly local: boolean;
|
|
184
|
+
/**
|
|
185
|
+
* How this backend handles code-mode surfaces (SAA-193 C1). Required so the
|
|
186
|
+
* facade can fail closed before delegating a code-mode workflow to a non-local
|
|
187
|
+
* backend instead of launching it and discovering the limitation remotely.
|
|
188
|
+
*/
|
|
189
|
+
readonly codeMode: GraphCodeMode;
|
|
190
|
+
/**
|
|
191
|
+
* Optional capability metadata. When omitted the facade derives capabilities
|
|
192
|
+
* from the declared `codeMode` and the presence of the optional catalogue
|
|
193
|
+
* methods, so an unsupported operation is reported as `not_supported` rather
|
|
194
|
+
* than silently returning an empty result.
|
|
195
|
+
*/
|
|
196
|
+
readonly capabilities?: GraphBackendCapabilities;
|
|
197
|
+
/**
|
|
198
|
+
* Lists the workflows this backend can surface, when supported. Backends
|
|
199
|
+
* without a catalogue omit this method (or declare `not_supported`).
|
|
200
|
+
*/
|
|
201
|
+
listWorkflows?(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
|
|
202
|
+
/**
|
|
203
|
+
* Looks up a single canonical workflow document, when supported. Backends
|
|
204
|
+
* without a catalogue omit this method (or declare `not_supported`).
|
|
205
|
+
*/
|
|
206
|
+
getWorkflow?(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
207
|
+
/**
|
|
208
|
+
* Executes a validated/resolved workflow.
|
|
209
|
+
*
|
|
210
|
+
* @param request - The execution request (document, plan, inputs, options, sink).
|
|
211
|
+
* @param args - Optional decaf contextual arguments.
|
|
212
|
+
* @returns The complete execution result.
|
|
213
|
+
*/
|
|
214
|
+
execute(request: GraphBackendExecutionRequest, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResult>;
|
|
215
|
+
/** Cancels a run, when the backend supports it. */
|
|
216
|
+
cancel?(runId: GraphRunId, reason?: string): boolean | Promise<boolean>;
|
|
217
|
+
/**
|
|
218
|
+
* Resumes a suspended run, when the backend supports suspend/resume (SAA-196
|
|
219
|
+
* extension point). Returns the C18 audit record. A backend that cannot resume
|
|
220
|
+
* omits this method; the facade fails closed rather than silently no-op.
|
|
221
|
+
*/
|
|
222
|
+
resume?(runId: GraphRunId, request: GraphResumeRequest, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
|
|
223
|
+
/** Releases resources associated with a run, when supported. */
|
|
224
|
+
release?(runId: GraphRunId): void | Promise<void>;
|
|
225
|
+
/** Disposes the backend and its resources, when supported. */
|
|
226
|
+
dispose?(): void | Promise<void>;
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* Facade-owned sink extension carrying the per-run execution frame, the shared
|
|
230
|
+
* event factory, the owning engine, and the code sandbox evaluator. The built-in
|
|
231
|
+
* {@link LocalGraphExecutionBackend} reads these to execute the plan without
|
|
232
|
+
* duplicating facade-owned run state or event sequencing. This is an internal
|
|
233
|
+
* extension of the public {@link GraphExecutionEventSink} contract: remote
|
|
234
|
+
* backends only ever need the two public methods.
|
|
235
|
+
*/
|
|
236
|
+
export interface GraphFrameAwareEventSink extends GraphExecutionEventSink {
|
|
237
|
+
/** The facade's stateful event factory (single sequencing authority). */
|
|
238
|
+
readonly eventFactory: GraphExecutionEventFactory;
|
|
239
|
+
/** The owning execution engine, exposed to node contexts. */
|
|
240
|
+
readonly engine: GraphExecutionEngine;
|
|
241
|
+
/** The facade's code sandbox evaluator, when configured. */
|
|
242
|
+
readonly codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
243
|
+
/** The run frame, once the facade has bound it. */
|
|
244
|
+
readonly frame?: GraphExecutionFrame;
|
|
245
|
+
/** Binds the run frame after planning; workflow events are then recorded. */
|
|
246
|
+
bindFrame(frame: GraphExecutionFrame): void;
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* Options used to construct a {@link GraphEngineEventSink}.
|
|
250
|
+
*/
|
|
251
|
+
export interface GraphEngineEventSinkOptions {
|
|
252
|
+
/** Unique id of the current run. */
|
|
253
|
+
runId: GraphRunId;
|
|
254
|
+
/** Run id of the parent execution, for nested loop bodies. */
|
|
255
|
+
parentRunId?: GraphRunId;
|
|
256
|
+
/** Canonical workflow id. */
|
|
257
|
+
workflowId: string;
|
|
258
|
+
/** Dotted path from the workflow root. */
|
|
259
|
+
path?: string[];
|
|
260
|
+
/** The owning execution engine. */
|
|
261
|
+
engine: GraphExecutionEngine;
|
|
262
|
+
/** The facade's code sandbox evaluator, when configured. */
|
|
263
|
+
codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Facade-owned {@link GraphExecutionEventSink} implementation. Enriches each
|
|
267
|
+
* partial event with the run's identity, a factory-assigned id/sequence/
|
|
268
|
+
* timestamp, appends it to the bound frame (when present), and dispatches it to
|
|
269
|
+
* all observers. Validation events emitted before the frame is bound are dispatched
|
|
270
|
+
* but not recorded, matching the reference engine's behaviour.
|
|
271
|
+
*/
|
|
272
|
+
export declare class GraphEngineEventSink implements GraphFrameAwareEventSink {
|
|
273
|
+
private readonly emitter;
|
|
274
|
+
readonly eventFactory: GraphExecutionEventFactory;
|
|
275
|
+
private readonly options;
|
|
276
|
+
private _frame?;
|
|
277
|
+
/**
|
|
278
|
+
* @param emitter - The engine's observer emitter.
|
|
279
|
+
* @param eventFactory - The facade's single event factory (sequencing authority).
|
|
280
|
+
* @param options - Run identity, owner, and evaluator defaults.
|
|
281
|
+
*/
|
|
282
|
+
constructor(emitter: GraphExecutionEventEmitter, eventFactory: GraphExecutionEventFactory, options: GraphEngineEventSinkOptions);
|
|
283
|
+
/** The owning execution engine. */
|
|
284
|
+
get engine(): GraphExecutionEngine;
|
|
285
|
+
/** The facade's code sandbox evaluator, when configured. */
|
|
286
|
+
get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
|
|
287
|
+
/** The run frame, once bound by the facade. */
|
|
288
|
+
get frame(): GraphExecutionFrame | undefined;
|
|
289
|
+
/** Binds the run frame after planning; subsequent events are recorded. */
|
|
290
|
+
bindFrame(frame: GraphExecutionFrame): void;
|
|
291
|
+
/** Enriches, records (when bound), and dispatches a partial event. */
|
|
292
|
+
emit(event: Partial<GraphExecutionEvent>): Promise<void>;
|
|
293
|
+
/** Dispatches an already-built event to all observers. */
|
|
294
|
+
updateObservers(event: GraphExecutionEvent): Promise<void>;
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Resolves a backend's effective capability metadata, falling back to what its
|
|
298
|
+
* declared `codeMode` and optional catalogue methods imply. A declared
|
|
299
|
+
* `capabilities` object always wins, so a backend can explicitly mark an
|
|
300
|
+
* operation `not_supported` even when it exposes a method, and an omitted
|
|
301
|
+
* capability never degrades to a silently empty result.
|
|
302
|
+
*
|
|
303
|
+
* @param backend - The backend to inspect.
|
|
304
|
+
* @returns The effective engine-agnostic capability metadata.
|
|
305
|
+
*/
|
|
306
|
+
export declare function resolveGraphBackendCapabilities(backend: GraphExecutionBackend): GraphBackendCapabilities;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
|
|
2
|
+
/**
|
|
3
|
+
* Static registry mapping backend flavours to their singleton instances, mirroring
|
|
4
|
+
* Decaf's `Adapter` flavour registry.
|
|
5
|
+
*/
|
|
6
|
+
export declare class GraphExecutionBackendRegistry {
|
|
7
|
+
private static _currentFlavour?;
|
|
8
|
+
private static readonly _cache;
|
|
9
|
+
/**
|
|
10
|
+
* Registers a backend under a flavour. Re-registering the same flavour
|
|
11
|
+
* replaces the previous entry (the engine may create several local backends
|
|
12
|
+
* across its lifetime). The current flavour is never changed implicitly:
|
|
13
|
+
* hosts select a non-default backend with {@link setCurrent}, so the engine's
|
|
14
|
+
* default stays a fresh local backend per engine and never shares per-run
|
|
15
|
+
* state between concurrently booted engines.
|
|
16
|
+
*
|
|
17
|
+
* @param flavour - The backend flavour name.
|
|
18
|
+
* @param backend - The backend instance.
|
|
19
|
+
* @returns The registered backend.
|
|
20
|
+
*/
|
|
21
|
+
static register<B extends GraphExecutionBackend<any>>(flavour: string, backend: B): B;
|
|
22
|
+
/**
|
|
23
|
+
* Resolves a registered backend by flavour, or the current backend when no
|
|
24
|
+
* flavour is given. Returns `undefined` when nothing is registered.
|
|
25
|
+
*
|
|
26
|
+
* @param flavour - The backend flavour to resolve, if any.
|
|
27
|
+
* @returns The backend instance, or `undefined`.
|
|
28
|
+
*/
|
|
29
|
+
static get<B extends GraphExecutionBackend<any>>(flavour?: string): B | undefined;
|
|
30
|
+
/**
|
|
31
|
+
* Resolves a registered backend by flavour, throwing when absent.
|
|
32
|
+
*
|
|
33
|
+
* @param flavour - The backend flavour to resolve.
|
|
34
|
+
* @returns The backend instance.
|
|
35
|
+
* @throws {GraphExecutionError} when no backend is registered under the flavour.
|
|
36
|
+
*/
|
|
37
|
+
static getOrFail<B extends GraphExecutionBackend<any>>(flavour: string): B;
|
|
38
|
+
/** The current default backend, when one is registered. */
|
|
39
|
+
static get current(): GraphExecutionBackend<any> | undefined;
|
|
40
|
+
/** The current default backend flavour, defaulting to `local`. */
|
|
41
|
+
static get currentFlavour(): string;
|
|
42
|
+
/** Sets the current default backend flavour. */
|
|
43
|
+
static setCurrent(flavour: string): void;
|
|
44
|
+
/**
|
|
45
|
+
* Lists every registered backend with its flavour, in registration order.
|
|
46
|
+
* Used by the capability manifest to enumerate the available engines without
|
|
47
|
+
* probing them; a flavour is an allowlisted engine id.
|
|
48
|
+
*
|
|
49
|
+
* @returns A snapshot array of registered flavour/backend entries.
|
|
50
|
+
*/
|
|
51
|
+
static list(): Array<{
|
|
52
|
+
flavour: string;
|
|
53
|
+
backend: GraphExecutionBackend<any>;
|
|
54
|
+
}>;
|
|
55
|
+
/** Unregisters a backend by flavour. */
|
|
56
|
+
static unregister(flavour?: string): void;
|
|
57
|
+
/** Clears every registered backend (test isolation). */
|
|
58
|
+
static clear(): void;
|
|
59
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
|
|
2
|
+
/**
|
|
3
|
+
* Static registry mapping backend flavours to their singleton instances, mirroring
|
|
4
|
+
* Decaf's `Adapter` flavour registry.
|
|
5
|
+
*/
|
|
6
|
+
export declare class GraphExecutionBackendRegistry {
|
|
7
|
+
private static _currentFlavour?;
|
|
8
|
+
private static readonly _cache;
|
|
9
|
+
/**
|
|
10
|
+
* Registers a backend under a flavour. Re-registering the same flavour
|
|
11
|
+
* replaces the previous entry (the engine may create several local backends
|
|
12
|
+
* across its lifetime). The current flavour is never changed implicitly:
|
|
13
|
+
* hosts select a non-default backend with {@link setCurrent}, so the engine's
|
|
14
|
+
* default stays a fresh local backend per engine and never shares per-run
|
|
15
|
+
* state between concurrently booted engines.
|
|
16
|
+
*
|
|
17
|
+
* @param flavour - The backend flavour name.
|
|
18
|
+
* @param backend - The backend instance.
|
|
19
|
+
* @returns The registered backend.
|
|
20
|
+
*/
|
|
21
|
+
static register<B extends GraphExecutionBackend<any>>(flavour: string, backend: B): B;
|
|
22
|
+
/**
|
|
23
|
+
* Resolves a registered backend by flavour, or the current backend when no
|
|
24
|
+
* flavour is given. Returns `undefined` when nothing is registered.
|
|
25
|
+
*
|
|
26
|
+
* @param flavour - The backend flavour to resolve, if any.
|
|
27
|
+
* @returns The backend instance, or `undefined`.
|
|
28
|
+
*/
|
|
29
|
+
static get<B extends GraphExecutionBackend<any>>(flavour?: string): B | undefined;
|
|
30
|
+
/**
|
|
31
|
+
* Resolves a registered backend by flavour, throwing when absent.
|
|
32
|
+
*
|
|
33
|
+
* @param flavour - The backend flavour to resolve.
|
|
34
|
+
* @returns The backend instance.
|
|
35
|
+
* @throws {GraphExecutionError} when no backend is registered under the flavour.
|
|
36
|
+
*/
|
|
37
|
+
static getOrFail<B extends GraphExecutionBackend<any>>(flavour: string): B;
|
|
38
|
+
/** The current default backend, when one is registered. */
|
|
39
|
+
static get current(): GraphExecutionBackend<any> | undefined;
|
|
40
|
+
/** The current default backend flavour, defaulting to `local`. */
|
|
41
|
+
static get currentFlavour(): string;
|
|
42
|
+
/** Sets the current default backend flavour. */
|
|
43
|
+
static setCurrent(flavour: string): void;
|
|
44
|
+
/**
|
|
45
|
+
* Lists every registered backend with its flavour, in registration order.
|
|
46
|
+
* Used by the capability manifest to enumerate the available engines without
|
|
47
|
+
* probing them; a flavour is an allowlisted engine id.
|
|
48
|
+
*
|
|
49
|
+
* @returns A snapshot array of registered flavour/backend entries.
|
|
50
|
+
*/
|
|
51
|
+
static list(): Array<{
|
|
52
|
+
flavour: string;
|
|
53
|
+
backend: GraphExecutionBackend<any>;
|
|
54
|
+
}>;
|
|
55
|
+
/** Unregisters a backend by flavour. */
|
|
56
|
+
static unregister(flavour?: string): void;
|
|
57
|
+
/** Clears every registered backend (test isolation). */
|
|
58
|
+
static clear(): void;
|
|
59
|
+
}
|