@decaf-ts/as-graph 0.2.0 → 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 +160 -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 +5 -0
- package/lib/cjs/engine/index.cjs.map +1 -1
- package/lib/cjs/engine/loops/ConditionEvaluator.cjs +116 -0
- package/lib/cjs/engine/loops/ConditionEvaluator.cjs.map +1 -0
- package/lib/cjs/engine/loops/GraphConditionEvaluator.cjs +25 -2
- package/lib/cjs/engine/loops/GraphConditionEvaluator.cjs.map +1 -1
- package/lib/cjs/engine/loops/index.cjs +1 -0
- package/lib/cjs/engine/loops/index.cjs.map +1 -1
- package/lib/cjs/engine/runs/GraphRunService.cjs +121 -3
- package/lib/cjs/engine/runs/GraphRunService.cjs.map +1 -1
- package/lib/cjs/engine/runs/InMemoryGraphRunStore.cjs +33 -0
- package/lib/cjs/engine/runs/InMemoryGraphRunStore.cjs.map +1 -1
- package/lib/cjs/engine/runs/ownership.cjs +100 -11
- package/lib/cjs/engine/runs/ownership.cjs.map +1 -1
- package/lib/cjs/engine/services/GraphRunModelService.cjs +16 -0
- package/lib/cjs/engine/services/GraphRunModelService.cjs.map +1 -1
- package/lib/cjs/engine/services/GraphWorkflowService.cjs +153 -16
- 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/GraphRunController.cjs +208 -28
- package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphWorkflowController.cjs +97 -14
- package/lib/cjs/nest/graph/GraphWorkflowController.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/servingDates.cjs +53 -0
- package/lib/cjs/nest/graph/servingDates.cjs.map +1 -0
- package/lib/cjs/nest/graph/servingErrors.cjs +68 -0
- package/lib/cjs/nest/graph/servingErrors.cjs.map +1 -0
- package/lib/cjs/node/flow/if/node.cjs +27 -9
- package/lib/cjs/node/flow/if/node.cjs.map +1 -1
- package/lib/cjs/node/flow/loop/until/node.cjs +5 -2
- package/lib/cjs/node/flow/loop/until/node.cjs.map +1 -1
- package/lib/cjs/node/flow/loop/while/node.cjs +8 -2
- package/lib/cjs/node/flow/loop/while/node.cjs.map +1 -1
- package/lib/cjs/node/flow/switch/node.cjs +2 -37
- package/lib/cjs/node/flow/switch/node.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/ram/GraphRunStore.cjs +14 -0
- package/lib/cjs/ram/GraphRunStore.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 +5 -0
- package/lib/esm/engine/index.js.map +1 -1
- package/lib/esm/engine/loops/ConditionEvaluator.js +108 -0
- package/lib/esm/engine/loops/ConditionEvaluator.js.map +1 -0
- package/lib/esm/engine/loops/GraphConditionEvaluator.js +25 -2
- package/lib/esm/engine/loops/GraphConditionEvaluator.js.map +1 -1
- package/lib/esm/engine/loops/index.js +1 -0
- package/lib/esm/engine/loops/index.js.map +1 -1
- package/lib/esm/engine/runs/GraphRunService.js +123 -5
- package/lib/esm/engine/runs/GraphRunService.js.map +1 -1
- package/lib/esm/engine/runs/InMemoryGraphRunStore.js +33 -0
- package/lib/esm/engine/runs/InMemoryGraphRunStore.js.map +1 -1
- package/lib/esm/engine/runs/ownership.js +97 -11
- package/lib/esm/engine/runs/ownership.js.map +1 -1
- package/lib/esm/engine/services/GraphRunModelService.js +16 -0
- package/lib/esm/engine/services/GraphRunModelService.js.map +1 -1
- package/lib/esm/engine/services/GraphWorkflowService.js +155 -18
- 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/GraphRunController.js +209 -29
- package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
- package/lib/esm/nest/graph/GraphWorkflowController.js +98 -15
- package/lib/esm/nest/graph/GraphWorkflowController.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/servingDates.js +49 -0
- package/lib/esm/nest/graph/servingDates.js.map +1 -0
- package/lib/esm/nest/graph/servingErrors.js +63 -0
- package/lib/esm/nest/graph/servingErrors.js.map +1 -0
- package/lib/esm/node/flow/if/node.js +27 -9
- package/lib/esm/node/flow/if/node.js.map +1 -1
- package/lib/esm/node/flow/loop/until/node.js +5 -2
- package/lib/esm/node/flow/loop/until/node.js.map +1 -1
- package/lib/esm/node/flow/loop/while/node.js +8 -2
- package/lib/esm/node/flow/loop/while/node.js.map +1 -1
- package/lib/esm/node/flow/switch/node.js +2 -37
- package/lib/esm/node/flow/switch/node.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/ram/GraphRunStore.js +14 -0
- package/lib/esm/ram/GraphRunStore.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/document/GraphFlowBuilder.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 +5 -0
- package/lib/types/engine/index.d.mts +5 -0
- package/lib/types/engine/loops/ConditionEvaluator.d.cts +87 -0
- package/lib/types/engine/loops/ConditionEvaluator.d.mts +87 -0
- package/lib/types/engine/loops/GraphConditionEvaluator.d.cts +27 -7
- package/lib/types/engine/loops/GraphConditionEvaluator.d.mts +27 -7
- package/lib/types/engine/loops/index.d.cts +1 -0
- package/lib/types/engine/loops/index.d.mts +1 -0
- package/lib/types/engine/runs/GraphRunService.d.cts +60 -1
- package/lib/types/engine/runs/GraphRunService.d.mts +60 -1
- package/lib/types/engine/runs/InMemoryGraphRunStore.d.cts +29 -0
- package/lib/types/engine/runs/InMemoryGraphRunStore.d.mts +29 -0
- package/lib/types/engine/runs/ownership.d.cts +89 -4
- package/lib/types/engine/runs/ownership.d.mts +89 -4
- package/lib/types/engine/runs/types.d.cts +12 -1
- package/lib/types/engine/runs/types.d.mts +12 -1
- package/lib/types/engine/services/GraphRunModelService.d.cts +13 -0
- package/lib/types/engine/services/GraphRunModelService.d.mts +13 -0
- package/lib/types/engine/services/GraphWorkflowService.d.cts +74 -2
- package/lib/types/engine/services/GraphWorkflowService.d.mts +74 -2
- package/lib/types/engine/types.d.cts +11 -4
- package/lib/types/engine/types.d.mts +11 -4
- 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 +14 -1
- package/lib/types/nest/graph/GraphExecutionModule.d.mts +14 -1
- package/lib/types/nest/graph/GraphRunController.d.cts +69 -14
- package/lib/types/nest/graph/GraphRunController.d.mts +69 -14
- package/lib/types/nest/graph/GraphWorkflowController.d.cts +50 -17
- package/lib/types/nest/graph/GraphWorkflowController.d.mts +50 -17
- 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/servingDates.d.cts +35 -0
- package/lib/types/nest/graph/servingDates.d.mts +35 -0
- package/lib/types/nest/graph/servingErrors.d.cts +44 -0
- package/lib/types/nest/graph/servingErrors.d.mts +44 -0
- package/lib/types/node/flow/if/node.d.cts +20 -8
- package/lib/types/node/flow/if/node.d.mts +20 -8
- package/lib/types/node/flow/loop/until/node.d.cts +4 -1
- package/lib/types/node/flow/loop/until/node.d.mts +4 -1
- package/lib/types/node/flow/loop/while/node.d.cts +4 -1
- package/lib/types/node/flow/loop/while/node.d.mts +4 -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/ram/GraphRunStore.d.cts +12 -0
- package/lib/types/ram/GraphRunStore.d.mts +12 -0
- 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/document/GraphFlowBuilder.d.cts +5 -5
- package/lib/types/shared/graph/document/GraphFlowBuilder.d.mts +5 -5
- 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 +12 -4
- package/lib/types/shared/graph/types.d.mts +12 -4
- 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,232 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/execution/LocalGraphExecutionBackend
|
|
3
|
+
* @summary Built-in reference graph execution backend (DECAF-50 §4.9).
|
|
4
|
+
* @description The `RamAdapter` analogue of the engine abstraction seam: the
|
|
5
|
+
* reference interpreter extracted verbatim from {@link GraphExecutionEngine}.
|
|
6
|
+
* Given a resolved, topologically layered plan (and the canonical document for
|
|
7
|
+
* translation parity), it executes nodes layer-by-layer, honours disabled-node
|
|
8
|
+
* semantics, builds node inputs from routed edges/literal/expression bindings/
|
|
9
|
+
* manifest defaults, validates executor outputs against the effective manifest,
|
|
10
|
+
* routes values along activated data edges, and reports every transition through
|
|
11
|
+
* the facade-owned {@link GraphExecutionEventSink}. All per-run state lives in
|
|
12
|
+
* the facade-created {@link GraphExecutionFrame} carried by the sink; the backend
|
|
13
|
+
* holds only the facade-provided collaborators (value adapter, optional code
|
|
14
|
+
* sandbox evaluator, and owning engine reference).
|
|
15
|
+
*/
|
|
16
|
+
import type { Adapter, Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
17
|
+
import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.cts";
|
|
18
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
|
|
19
|
+
import type { GraphExecutionResult } from "../types.d.cts";
|
|
20
|
+
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
|
|
21
|
+
import type { GraphBackendCapabilities, GraphBackendExecutionRequest, GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
|
|
22
|
+
/**
|
|
23
|
+
* Configuration for the {@link LocalGraphExecutionBackend}.
|
|
24
|
+
*/
|
|
25
|
+
export interface LocalGraphExecutionBackendConfig extends Record<string, unknown> {
|
|
26
|
+
/** Decaf adapter backing cached/pinned value persistence. */
|
|
27
|
+
valueAdapter: Adapter<any, any, any, any>;
|
|
28
|
+
/** Optional pluggable code sandbox evaluator. */
|
|
29
|
+
codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
30
|
+
/**
|
|
31
|
+
* Optional workflow catalogue port backing the listing/lookup capability.
|
|
32
|
+
* Hosts pass their `GraphWorkflowService` here; when absent the backend
|
|
33
|
+
* reports the capability as `not_supported` instead of returning an empty list.
|
|
34
|
+
*/
|
|
35
|
+
workflowStore?: GraphBackendWorkflowStore;
|
|
36
|
+
/** The facade engine, exposed to node contexts. */
|
|
37
|
+
engine: GraphExecutionEngine;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Built-in reference graph execution backend. Registers itself under
|
|
41
|
+
* {@link GRAPH_LOCAL_EXECUTION_BACKEND} on construction.
|
|
42
|
+
*/
|
|
43
|
+
export declare class LocalGraphExecutionBackend implements GraphExecutionBackend<LocalGraphExecutionBackendConfig> {
|
|
44
|
+
/** This backend executes locally, in-process. */
|
|
45
|
+
readonly local = true;
|
|
46
|
+
/**
|
|
47
|
+
* This backend executes code-mode surfaces host-side through the
|
|
48
|
+
* facade-owned `CodeSandboxEvaluator` (SAA-193 C1).
|
|
49
|
+
*/
|
|
50
|
+
readonly codeMode: "hostSide";
|
|
51
|
+
private valueAdapter;
|
|
52
|
+
private codeSandboxEvaluator?;
|
|
53
|
+
private workflowStore?;
|
|
54
|
+
private engine;
|
|
55
|
+
constructor();
|
|
56
|
+
/**
|
|
57
|
+
* Resolves the backend's runtime collaborators. Called by the facade during
|
|
58
|
+
* `GraphExecutionEngine.initialize`.
|
|
59
|
+
*
|
|
60
|
+
* @param config - The facade-provided collaborators.
|
|
61
|
+
*/
|
|
62
|
+
initialize(config: LocalGraphExecutionBackendConfig): Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* Effective capability metadata: code-mode is host-side and workflow
|
|
65
|
+
* listing/lookup is supported exactly when a catalogue port is wired in.
|
|
66
|
+
*/
|
|
67
|
+
get capabilities(): GraphBackendCapabilities;
|
|
68
|
+
/**
|
|
69
|
+
* Lists the workflows visible to the requesting principal through the wired
|
|
70
|
+
* `GraphWorkflowStore` port.
|
|
71
|
+
*
|
|
72
|
+
* @param args - Optional decaf contextual arguments forwarded to the store.
|
|
73
|
+
* @returns Workflow summaries, newest first when the store orders them.
|
|
74
|
+
* @throws {GraphExecutionError} when no workflow store is wired in.
|
|
75
|
+
*/
|
|
76
|
+
listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
|
|
77
|
+
/**
|
|
78
|
+
* Reads a single canonical workflow document through the wired
|
|
79
|
+
* `GraphWorkflowStore` port.
|
|
80
|
+
*
|
|
81
|
+
* @param workflowId - The workflow id to read.
|
|
82
|
+
* @param args - Optional decaf contextual arguments forwarded to the store.
|
|
83
|
+
* @returns The canonical workflow document.
|
|
84
|
+
* @throws {GraphExecutionError} when no workflow store is wired in.
|
|
85
|
+
*/
|
|
86
|
+
getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
87
|
+
/**
|
|
88
|
+
* Executes a validated/resolved workflow's plan against the facade-owned
|
|
89
|
+
* frame carried by the request's event sink.
|
|
90
|
+
*
|
|
91
|
+
* @param request - The execution request.
|
|
92
|
+
* @returns The complete execution result.
|
|
93
|
+
* @throws {GraphExecutionError} when the request's sink is not the
|
|
94
|
+
* facade-created frame-aware sink.
|
|
95
|
+
*/
|
|
96
|
+
execute(request: GraphBackendExecutionRequest): Promise<GraphExecutionResult>;
|
|
97
|
+
/**
|
|
98
|
+
* Executes a layer of nodes with the configured concurrency.
|
|
99
|
+
*/
|
|
100
|
+
private executeLayer;
|
|
101
|
+
/**
|
|
102
|
+
* Executes a single node, honouring disabled-node semantics (§4.9).
|
|
103
|
+
*/
|
|
104
|
+
private executeNode;
|
|
105
|
+
/**
|
|
106
|
+
* Resolves whether a plan node is activated for execution under the
|
|
107
|
+
* DECAF-50 §4.9 branch semantics. A node with no incoming data edges is
|
|
108
|
+
* a root/source node and always runs. A node fed by one or more data
|
|
109
|
+
* edges runs only when at least one of those edges was activated by a
|
|
110
|
+
* routed upstream output port — a branch the upstream switch (or any
|
|
111
|
+
* partial-output node) did not select leaves its downstream edges
|
|
112
|
+
* unactivated, so the branch is never executed. Workflow-boundary edges
|
|
113
|
+
* are active from the start because workflow inputs are seeded before
|
|
114
|
+
* execution begins.
|
|
115
|
+
*/
|
|
116
|
+
private isNodeActivated;
|
|
117
|
+
/**
|
|
118
|
+
* Skips a node whose incoming data edges were all left unactivated by an
|
|
119
|
+
* upstream branch selection. The node is not executed and its outputs are
|
|
120
|
+
* never routed or collected into workflow outputs (DECAF-50 §4.9).
|
|
121
|
+
*/
|
|
122
|
+
private skipInactiveNode;
|
|
123
|
+
/**
|
|
124
|
+
* Applies the explicit disabled-node semantics (§4.9):
|
|
125
|
+
* `skip`, `passThroughFirstInput`, or `emitDefaults`, resolved from the
|
|
126
|
+
* instance metadata, document settings, and the default.
|
|
127
|
+
*/
|
|
128
|
+
private executeDisabledNode;
|
|
129
|
+
/**
|
|
130
|
+
* Invokes the node's catalogue-resolved executor (§4.9 request contract,
|
|
131
|
+
* post-cutover: every executor receives the full request with
|
|
132
|
+
* configuration and input data separated).
|
|
133
|
+
*/
|
|
134
|
+
private invokeExecutor;
|
|
135
|
+
/**
|
|
136
|
+
* Validates executor outputs against the effective output manifest
|
|
137
|
+
* (§4.9): unknown outputs are rejected by default; missing required
|
|
138
|
+
* outputs fail the node. Lenient transition manifests (legacy
|
|
139
|
+
* executor-only registrations) are exempt until cutover.
|
|
140
|
+
*/
|
|
141
|
+
private validateNodeOutputs;
|
|
142
|
+
/**
|
|
143
|
+
* Collects the resolved credential references for a node: credential-type
|
|
144
|
+
* parameter values plus the `credentials` record in instance metadata.
|
|
145
|
+
* Documents carry references only — secret material never enters requests.
|
|
146
|
+
*/
|
|
147
|
+
private collectCredentials;
|
|
148
|
+
/**
|
|
149
|
+
* Resolves a node's input values from routed data edges, literal bindings,
|
|
150
|
+
* allowed expression bindings, and manifest port defaults (§4.9).
|
|
151
|
+
*
|
|
152
|
+
* When multiple edges target the same port, their values are spread into the
|
|
153
|
+
* top-level inputs keyed by each edge's `sourcePort`. This allows multiple
|
|
154
|
+
* workflow input badges to connect to a single port (e.g. the Code node's
|
|
155
|
+
* `data` port) and have all values accessible directly as
|
|
156
|
+
* `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
|
|
157
|
+
*/
|
|
158
|
+
private resolveNodeInputs;
|
|
159
|
+
/**
|
|
160
|
+
* Resolves a node's persisted parameters at execution time, evaluating any
|
|
161
|
+
* `GraphValueTemplate` user property through the code-evaluator VM and
|
|
162
|
+
* leaving straight literal values unchanged.
|
|
163
|
+
*/
|
|
164
|
+
private resolveNodeParameters;
|
|
165
|
+
/**
|
|
166
|
+
* Evaluates a persisted `GraphValueTemplate` with the pluggable
|
|
167
|
+
* {@link CodeSandboxEvaluator} (DECAF-32 §22.4) — no new evaluator.
|
|
168
|
+
* `expression` mode evaluates the body directly; `template` mode compiles its
|
|
169
|
+
* `{{ ... }}` placeholders into a JavaScript template literal evaluated in
|
|
170
|
+
* the same sandbox, so both modes share the code-evaluator VM.
|
|
171
|
+
*/
|
|
172
|
+
private evaluateValueTemplate;
|
|
173
|
+
/**
|
|
174
|
+
* Evaluates an expression binding with the EXISTING allowed-expression
|
|
175
|
+
* machinery only (the pluggable {@link CodeSandboxEvaluator}, DECAF-32
|
|
176
|
+
* §22.4) — no new evaluator. The expression sees the already-routed input
|
|
177
|
+
* values as `$input` and the run metadata as context.
|
|
178
|
+
*/
|
|
179
|
+
private evaluateExpressionBinding;
|
|
180
|
+
/**
|
|
181
|
+
* Attempts to read a pinned value for the node. Returns the cached outputs
|
|
182
|
+
* when a valid pinned value exists, or `undefined` to proceed with normal
|
|
183
|
+
* execution.
|
|
184
|
+
*/
|
|
185
|
+
private tryPinnedValue;
|
|
186
|
+
/**
|
|
187
|
+
* Recursively computes fingerprints for all upstream dependencies of a node
|
|
188
|
+
* using the results already accumulated in the frame.
|
|
189
|
+
*/
|
|
190
|
+
private computeDependencyFingerprints;
|
|
191
|
+
/**
|
|
192
|
+
* Routes a node's outputs to downstream inputs and workflow outputs along
|
|
193
|
+
* data edges (connection edges are structural and never route values).
|
|
194
|
+
*
|
|
195
|
+
* An edge is traversed only when the source node actually emitted the
|
|
196
|
+
* edge's `sourcePort` (DECAF-50 §4.9 branch semantics). A node that
|
|
197
|
+
* emitted a subset of its declared outputs — e.g. a switch that selected
|
|
198
|
+
* one case — therefore activates only the downstream branch edges of the
|
|
199
|
+
* emitted ports; unselected branch edges are left unactivated, so their
|
|
200
|
+
* downstream nodes are skipped and never contribute to workflow outputs.
|
|
201
|
+
* Emitting an output port explicitly with `undefined` still counts as
|
|
202
|
+
* activated (the port was produced by the executor).
|
|
203
|
+
*/
|
|
204
|
+
private routeOutgoingEdges;
|
|
205
|
+
/**
|
|
206
|
+
* Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
|
|
207
|
+
* visual state for the node. Rides the existing Observable pipeline; no
|
|
208
|
+
* second out-of-band channel.
|
|
209
|
+
*/
|
|
210
|
+
private emitNodeStateChanged;
|
|
211
|
+
/**
|
|
212
|
+
* Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
|
|
213
|
+
* visual state for a routed edge.
|
|
214
|
+
*/
|
|
215
|
+
private emitEdgeStateChanged;
|
|
216
|
+
/**
|
|
217
|
+
* Creates a {@link GraphPinningService} backed by the run's value store
|
|
218
|
+
* adapter.
|
|
219
|
+
*/
|
|
220
|
+
private createPinningService;
|
|
221
|
+
/**
|
|
222
|
+
* Resolves the effective loop-iteration ceilings for a run. A node-level
|
|
223
|
+
* `maxIterations` can never exceed these; loop executors read them from the
|
|
224
|
+
* node context.
|
|
225
|
+
*/
|
|
226
|
+
private executionLimits;
|
|
227
|
+
private assertNotAborted;
|
|
228
|
+
/**
|
|
229
|
+
* Converts an error into a serialized payload.
|
|
230
|
+
*/
|
|
231
|
+
private toErrorPayload;
|
|
232
|
+
}
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/execution/LocalGraphExecutionBackend
|
|
3
|
+
* @summary Built-in reference graph execution backend (DECAF-50 §4.9).
|
|
4
|
+
* @description The `RamAdapter` analogue of the engine abstraction seam: the
|
|
5
|
+
* reference interpreter extracted verbatim from {@link GraphExecutionEngine}.
|
|
6
|
+
* Given a resolved, topologically layered plan (and the canonical document for
|
|
7
|
+
* translation parity), it executes nodes layer-by-layer, honours disabled-node
|
|
8
|
+
* semantics, builds node inputs from routed edges/literal/expression bindings/
|
|
9
|
+
* manifest defaults, validates executor outputs against the effective manifest,
|
|
10
|
+
* routes values along activated data edges, and reports every transition through
|
|
11
|
+
* the facade-owned {@link GraphExecutionEventSink}. All per-run state lives in
|
|
12
|
+
* the facade-created {@link GraphExecutionFrame} carried by the sink; the backend
|
|
13
|
+
* holds only the facade-provided collaborators (value adapter, optional code
|
|
14
|
+
* sandbox evaluator, and owning engine reference).
|
|
15
|
+
*/
|
|
16
|
+
import type { Adapter, Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
17
|
+
import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.mts";
|
|
18
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
19
|
+
import type { GraphExecutionResult } from "../types.d.mts";
|
|
20
|
+
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
|
|
21
|
+
import type { GraphBackendCapabilities, GraphBackendExecutionRequest, GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
|
|
22
|
+
/**
|
|
23
|
+
* Configuration for the {@link LocalGraphExecutionBackend}.
|
|
24
|
+
*/
|
|
25
|
+
export interface LocalGraphExecutionBackendConfig extends Record<string, unknown> {
|
|
26
|
+
/** Decaf adapter backing cached/pinned value persistence. */
|
|
27
|
+
valueAdapter: Adapter<any, any, any, any>;
|
|
28
|
+
/** Optional pluggable code sandbox evaluator. */
|
|
29
|
+
codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
30
|
+
/**
|
|
31
|
+
* Optional workflow catalogue port backing the listing/lookup capability.
|
|
32
|
+
* Hosts pass their `GraphWorkflowService` here; when absent the backend
|
|
33
|
+
* reports the capability as `not_supported` instead of returning an empty list.
|
|
34
|
+
*/
|
|
35
|
+
workflowStore?: GraphBackendWorkflowStore;
|
|
36
|
+
/** The facade engine, exposed to node contexts. */
|
|
37
|
+
engine: GraphExecutionEngine;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Built-in reference graph execution backend. Registers itself under
|
|
41
|
+
* {@link GRAPH_LOCAL_EXECUTION_BACKEND} on construction.
|
|
42
|
+
*/
|
|
43
|
+
export declare class LocalGraphExecutionBackend implements GraphExecutionBackend<LocalGraphExecutionBackendConfig> {
|
|
44
|
+
/** This backend executes locally, in-process. */
|
|
45
|
+
readonly local = true;
|
|
46
|
+
/**
|
|
47
|
+
* This backend executes code-mode surfaces host-side through the
|
|
48
|
+
* facade-owned `CodeSandboxEvaluator` (SAA-193 C1).
|
|
49
|
+
*/
|
|
50
|
+
readonly codeMode: "hostSide";
|
|
51
|
+
private valueAdapter;
|
|
52
|
+
private codeSandboxEvaluator?;
|
|
53
|
+
private workflowStore?;
|
|
54
|
+
private engine;
|
|
55
|
+
constructor();
|
|
56
|
+
/**
|
|
57
|
+
* Resolves the backend's runtime collaborators. Called by the facade during
|
|
58
|
+
* `GraphExecutionEngine.initialize`.
|
|
59
|
+
*
|
|
60
|
+
* @param config - The facade-provided collaborators.
|
|
61
|
+
*/
|
|
62
|
+
initialize(config: LocalGraphExecutionBackendConfig): Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* Effective capability metadata: code-mode is host-side and workflow
|
|
65
|
+
* listing/lookup is supported exactly when a catalogue port is wired in.
|
|
66
|
+
*/
|
|
67
|
+
get capabilities(): GraphBackendCapabilities;
|
|
68
|
+
/**
|
|
69
|
+
* Lists the workflows visible to the requesting principal through the wired
|
|
70
|
+
* `GraphWorkflowStore` port.
|
|
71
|
+
*
|
|
72
|
+
* @param args - Optional decaf contextual arguments forwarded to the store.
|
|
73
|
+
* @returns Workflow summaries, newest first when the store orders them.
|
|
74
|
+
* @throws {GraphExecutionError} when no workflow store is wired in.
|
|
75
|
+
*/
|
|
76
|
+
listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
|
|
77
|
+
/**
|
|
78
|
+
* Reads a single canonical workflow document through the wired
|
|
79
|
+
* `GraphWorkflowStore` port.
|
|
80
|
+
*
|
|
81
|
+
* @param workflowId - The workflow id to read.
|
|
82
|
+
* @param args - Optional decaf contextual arguments forwarded to the store.
|
|
83
|
+
* @returns The canonical workflow document.
|
|
84
|
+
* @throws {GraphExecutionError} when no workflow store is wired in.
|
|
85
|
+
*/
|
|
86
|
+
getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
87
|
+
/**
|
|
88
|
+
* Executes a validated/resolved workflow's plan against the facade-owned
|
|
89
|
+
* frame carried by the request's event sink.
|
|
90
|
+
*
|
|
91
|
+
* @param request - The execution request.
|
|
92
|
+
* @returns The complete execution result.
|
|
93
|
+
* @throws {GraphExecutionError} when the request's sink is not the
|
|
94
|
+
* facade-created frame-aware sink.
|
|
95
|
+
*/
|
|
96
|
+
execute(request: GraphBackendExecutionRequest): Promise<GraphExecutionResult>;
|
|
97
|
+
/**
|
|
98
|
+
* Executes a layer of nodes with the configured concurrency.
|
|
99
|
+
*/
|
|
100
|
+
private executeLayer;
|
|
101
|
+
/**
|
|
102
|
+
* Executes a single node, honouring disabled-node semantics (§4.9).
|
|
103
|
+
*/
|
|
104
|
+
private executeNode;
|
|
105
|
+
/**
|
|
106
|
+
* Resolves whether a plan node is activated for execution under the
|
|
107
|
+
* DECAF-50 §4.9 branch semantics. A node with no incoming data edges is
|
|
108
|
+
* a root/source node and always runs. A node fed by one or more data
|
|
109
|
+
* edges runs only when at least one of those edges was activated by a
|
|
110
|
+
* routed upstream output port — a branch the upstream switch (or any
|
|
111
|
+
* partial-output node) did not select leaves its downstream edges
|
|
112
|
+
* unactivated, so the branch is never executed. Workflow-boundary edges
|
|
113
|
+
* are active from the start because workflow inputs are seeded before
|
|
114
|
+
* execution begins.
|
|
115
|
+
*/
|
|
116
|
+
private isNodeActivated;
|
|
117
|
+
/**
|
|
118
|
+
* Skips a node whose incoming data edges were all left unactivated by an
|
|
119
|
+
* upstream branch selection. The node is not executed and its outputs are
|
|
120
|
+
* never routed or collected into workflow outputs (DECAF-50 §4.9).
|
|
121
|
+
*/
|
|
122
|
+
private skipInactiveNode;
|
|
123
|
+
/**
|
|
124
|
+
* Applies the explicit disabled-node semantics (§4.9):
|
|
125
|
+
* `skip`, `passThroughFirstInput`, or `emitDefaults`, resolved from the
|
|
126
|
+
* instance metadata, document settings, and the default.
|
|
127
|
+
*/
|
|
128
|
+
private executeDisabledNode;
|
|
129
|
+
/**
|
|
130
|
+
* Invokes the node's catalogue-resolved executor (§4.9 request contract,
|
|
131
|
+
* post-cutover: every executor receives the full request with
|
|
132
|
+
* configuration and input data separated).
|
|
133
|
+
*/
|
|
134
|
+
private invokeExecutor;
|
|
135
|
+
/**
|
|
136
|
+
* Validates executor outputs against the effective output manifest
|
|
137
|
+
* (§4.9): unknown outputs are rejected by default; missing required
|
|
138
|
+
* outputs fail the node. Lenient transition manifests (legacy
|
|
139
|
+
* executor-only registrations) are exempt until cutover.
|
|
140
|
+
*/
|
|
141
|
+
private validateNodeOutputs;
|
|
142
|
+
/**
|
|
143
|
+
* Collects the resolved credential references for a node: credential-type
|
|
144
|
+
* parameter values plus the `credentials` record in instance metadata.
|
|
145
|
+
* Documents carry references only — secret material never enters requests.
|
|
146
|
+
*/
|
|
147
|
+
private collectCredentials;
|
|
148
|
+
/**
|
|
149
|
+
* Resolves a node's input values from routed data edges, literal bindings,
|
|
150
|
+
* allowed expression bindings, and manifest port defaults (§4.9).
|
|
151
|
+
*
|
|
152
|
+
* When multiple edges target the same port, their values are spread into the
|
|
153
|
+
* top-level inputs keyed by each edge's `sourcePort`. This allows multiple
|
|
154
|
+
* workflow input badges to connect to a single port (e.g. the Code node's
|
|
155
|
+
* `data` port) and have all values accessible directly as
|
|
156
|
+
* `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
|
|
157
|
+
*/
|
|
158
|
+
private resolveNodeInputs;
|
|
159
|
+
/**
|
|
160
|
+
* Resolves a node's persisted parameters at execution time, evaluating any
|
|
161
|
+
* `GraphValueTemplate` user property through the code-evaluator VM and
|
|
162
|
+
* leaving straight literal values unchanged.
|
|
163
|
+
*/
|
|
164
|
+
private resolveNodeParameters;
|
|
165
|
+
/**
|
|
166
|
+
* Evaluates a persisted `GraphValueTemplate` with the pluggable
|
|
167
|
+
* {@link CodeSandboxEvaluator} (DECAF-32 §22.4) — no new evaluator.
|
|
168
|
+
* `expression` mode evaluates the body directly; `template` mode compiles its
|
|
169
|
+
* `{{ ... }}` placeholders into a JavaScript template literal evaluated in
|
|
170
|
+
* the same sandbox, so both modes share the code-evaluator VM.
|
|
171
|
+
*/
|
|
172
|
+
private evaluateValueTemplate;
|
|
173
|
+
/**
|
|
174
|
+
* Evaluates an expression binding with the EXISTING allowed-expression
|
|
175
|
+
* machinery only (the pluggable {@link CodeSandboxEvaluator}, DECAF-32
|
|
176
|
+
* §22.4) — no new evaluator. The expression sees the already-routed input
|
|
177
|
+
* values as `$input` and the run metadata as context.
|
|
178
|
+
*/
|
|
179
|
+
private evaluateExpressionBinding;
|
|
180
|
+
/**
|
|
181
|
+
* Attempts to read a pinned value for the node. Returns the cached outputs
|
|
182
|
+
* when a valid pinned value exists, or `undefined` to proceed with normal
|
|
183
|
+
* execution.
|
|
184
|
+
*/
|
|
185
|
+
private tryPinnedValue;
|
|
186
|
+
/**
|
|
187
|
+
* Recursively computes fingerprints for all upstream dependencies of a node
|
|
188
|
+
* using the results already accumulated in the frame.
|
|
189
|
+
*/
|
|
190
|
+
private computeDependencyFingerprints;
|
|
191
|
+
/**
|
|
192
|
+
* Routes a node's outputs to downstream inputs and workflow outputs along
|
|
193
|
+
* data edges (connection edges are structural and never route values).
|
|
194
|
+
*
|
|
195
|
+
* An edge is traversed only when the source node actually emitted the
|
|
196
|
+
* edge's `sourcePort` (DECAF-50 §4.9 branch semantics). A node that
|
|
197
|
+
* emitted a subset of its declared outputs — e.g. a switch that selected
|
|
198
|
+
* one case — therefore activates only the downstream branch edges of the
|
|
199
|
+
* emitted ports; unselected branch edges are left unactivated, so their
|
|
200
|
+
* downstream nodes are skipped and never contribute to workflow outputs.
|
|
201
|
+
* Emitting an output port explicitly with `undefined` still counts as
|
|
202
|
+
* activated (the port was produced by the executor).
|
|
203
|
+
*/
|
|
204
|
+
private routeOutgoingEdges;
|
|
205
|
+
/**
|
|
206
|
+
* Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
|
|
207
|
+
* visual state for the node. Rides the existing Observable pipeline; no
|
|
208
|
+
* second out-of-band channel.
|
|
209
|
+
*/
|
|
210
|
+
private emitNodeStateChanged;
|
|
211
|
+
/**
|
|
212
|
+
* Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
|
|
213
|
+
* visual state for a routed edge.
|
|
214
|
+
*/
|
|
215
|
+
private emitEdgeStateChanged;
|
|
216
|
+
/**
|
|
217
|
+
* Creates a {@link GraphPinningService} backed by the run's value store
|
|
218
|
+
* adapter.
|
|
219
|
+
*/
|
|
220
|
+
private createPinningService;
|
|
221
|
+
/**
|
|
222
|
+
* Resolves the effective loop-iteration ceilings for a run. A node-level
|
|
223
|
+
* `maxIterations` can never exceed these; loop executors read them from the
|
|
224
|
+
* node context.
|
|
225
|
+
*/
|
|
226
|
+
private executionLimits;
|
|
227
|
+
private assertNotAborted;
|
|
228
|
+
/**
|
|
229
|
+
* Converts an error into a serialized payload.
|
|
230
|
+
*/
|
|
231
|
+
private toErrorPayload;
|
|
232
|
+
}
|
|
@@ -7,6 +7,10 @@ export * from "./GraphExecutionContext.d.cts";
|
|
|
7
7
|
export * from "./GraphNodeExecutor.d.cts";
|
|
8
8
|
export * from "./GraphExecutionResult.d.cts";
|
|
9
9
|
export * from "./GraphExecutionFrame.d.cts";
|
|
10
|
+
export * from "./GraphExecutionBackend.d.cts";
|
|
11
|
+
export * from "./GraphExecutionBackendRegistry.d.cts";
|
|
12
|
+
export * from "./GraphCodeMode.d.cts";
|
|
13
|
+
export * from "./LocalGraphExecutionBackend.d.cts";
|
|
10
14
|
export * from "./GraphExecutionEngine.d.cts";
|
|
11
15
|
export * from "./CodeSandboxEvaluator.d.cts";
|
|
12
16
|
export * from "./IsolatedVmCodeSandboxEvaluator.d.cts";
|
|
@@ -7,6 +7,10 @@ export * from "./GraphExecutionContext.d.mts";
|
|
|
7
7
|
export * from "./GraphNodeExecutor.d.mts";
|
|
8
8
|
export * from "./GraphExecutionResult.d.mts";
|
|
9
9
|
export * from "./GraphExecutionFrame.d.mts";
|
|
10
|
+
export * from "./GraphExecutionBackend.d.mts";
|
|
11
|
+
export * from "./GraphExecutionBackendRegistry.d.mts";
|
|
12
|
+
export * from "./GraphCodeMode.d.mts";
|
|
13
|
+
export * from "./LocalGraphExecutionBackend.d.mts";
|
|
10
14
|
export * from "./GraphExecutionEngine.d.mts";
|
|
11
15
|
export * from "./CodeSandboxEvaluator.d.mts";
|
|
12
16
|
export * from "./IsolatedVmCodeSandboxEvaluator.d.mts";
|
|
@@ -29,6 +29,10 @@ export * from "./execution/GraphExecutionContext.d.cts";
|
|
|
29
29
|
export * from "./execution/GraphNodeExecutor.d.cts";
|
|
30
30
|
export * from "./execution/GraphExecutionFrame.d.cts";
|
|
31
31
|
export * from "./execution/GraphExecutionResult.d.cts";
|
|
32
|
+
export * from "./execution/GraphExecutionBackend.d.cts";
|
|
33
|
+
export * from "./execution/GraphExecutionBackendRegistry.d.cts";
|
|
34
|
+
export * from "./execution/GraphCodeMode.d.cts";
|
|
35
|
+
export * from "./execution/LocalGraphExecutionBackend.d.cts";
|
|
32
36
|
export * from "./execution/GraphExecutionEngine.d.cts";
|
|
33
37
|
export * from "./execution/CodeSandboxEvaluator.d.cts";
|
|
34
38
|
export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.cts";
|
|
@@ -47,6 +51,7 @@ export * from "./planning/GraphExecutionPlanner.d.cts";
|
|
|
47
51
|
export * from "./planning/GraphTopology.d.cts";
|
|
48
52
|
export * from "./validation/index.d.cts";
|
|
49
53
|
export * from "./loops/GraphConditionEvaluator.d.cts";
|
|
54
|
+
export * from "./loops/ConditionEvaluator.d.cts";
|
|
50
55
|
export * from "./loops/ConditionExpressionEvaluator.d.cts";
|
|
51
56
|
export * from "./loops/GraphLoopExecutionContext.d.cts";
|
|
52
57
|
export * from "./pinning/GraphPinningMetadata.d.cts";
|
|
@@ -29,6 +29,10 @@ export * from "./execution/GraphExecutionContext.d.mts";
|
|
|
29
29
|
export * from "./execution/GraphNodeExecutor.d.mts";
|
|
30
30
|
export * from "./execution/GraphExecutionFrame.d.mts";
|
|
31
31
|
export * from "./execution/GraphExecutionResult.d.mts";
|
|
32
|
+
export * from "./execution/GraphExecutionBackend.d.mts";
|
|
33
|
+
export * from "./execution/GraphExecutionBackendRegistry.d.mts";
|
|
34
|
+
export * from "./execution/GraphCodeMode.d.mts";
|
|
35
|
+
export * from "./execution/LocalGraphExecutionBackend.d.mts";
|
|
32
36
|
export * from "./execution/GraphExecutionEngine.d.mts";
|
|
33
37
|
export * from "./execution/CodeSandboxEvaluator.d.mts";
|
|
34
38
|
export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.mts";
|
|
@@ -47,6 +51,7 @@ export * from "./planning/GraphExecutionPlanner.d.mts";
|
|
|
47
51
|
export * from "./planning/GraphTopology.d.mts";
|
|
48
52
|
export * from "./validation/index.d.mts";
|
|
49
53
|
export * from "./loops/GraphConditionEvaluator.d.mts";
|
|
54
|
+
export * from "./loops/ConditionEvaluator.d.mts";
|
|
50
55
|
export * from "./loops/ConditionExpressionEvaluator.d.mts";
|
|
51
56
|
export * from "./loops/GraphLoopExecutionContext.d.mts";
|
|
52
57
|
export * from "./pinning/GraphPinningMetadata.d.mts";
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/loops/ConditionEvaluator
|
|
3
|
+
* @summary Shared dispatch for graphical and code conditions (DECAF-32 §22.3–22.4).
|
|
4
|
+
* @description The single authority that evaluates a condition carried by any
|
|
5
|
+
* flow-control node (if, elseIf, while, until, switch):
|
|
6
|
+
*
|
|
7
|
+
* - a `ConditionExpression` (graphical mode) is dispatched to the
|
|
8
|
+
* {@link ConditionExpressionEvaluator};
|
|
9
|
+
* - a `CodeCondition` (code mode) is dispatched to the pluggable
|
|
10
|
+
* `CodeSandboxEvaluator` registered on `GraphExecutionEngineConfig`.
|
|
11
|
+
*
|
|
12
|
+
* Extracted from the switch node so the if node and the loop condition evaluator
|
|
13
|
+
* reuse exactly the same semantics — including the
|
|
14
|
+
* `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` failure mode — instead of duplicating it.
|
|
15
|
+
*/
|
|
16
|
+
import type { Condition, ConditionExpression, CodeCondition } from "../../shared/graph/index.d.cts";
|
|
17
|
+
import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
|
|
18
|
+
/**
|
|
19
|
+
* Detects whether a condition is a {@link CodeCondition} (code mode) by checking
|
|
20
|
+
* for a `type` field equal to `"code"`.
|
|
21
|
+
*
|
|
22
|
+
* @param condition - The condition to inspect.
|
|
23
|
+
* @returns `true` when the condition is a `CodeCondition`.
|
|
24
|
+
*/
|
|
25
|
+
export declare function isCodeCondition(condition: unknown): condition is CodeCondition;
|
|
26
|
+
/**
|
|
27
|
+
* Detects whether a condition is a {@link ConditionExpression} (graphical mode) by
|
|
28
|
+
* checking for a string `op` field.
|
|
29
|
+
*
|
|
30
|
+
* @param condition - The condition to inspect.
|
|
31
|
+
* @returns `true` when the condition is a `ConditionExpression`.
|
|
32
|
+
*/
|
|
33
|
+
export declare function isConditionExpression(condition: unknown): condition is ConditionExpression;
|
|
34
|
+
/**
|
|
35
|
+
* Evaluates a {@link CodeCondition} through the `CodeSandboxEvaluator` registered
|
|
36
|
+
* on the execution engine (DECAF-32 §22.4).
|
|
37
|
+
*
|
|
38
|
+
* The sandbox context exposes the run's `$input`, `$vars`, `$item`, `$index`, and
|
|
39
|
+
* `$node` values, mirroring the switch node. When no evaluator is registered the
|
|
40
|
+
* call fails with `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`, the same failure mode as
|
|
41
|
+
* every other code-mode condition path.
|
|
42
|
+
*
|
|
43
|
+
* @param condition - The code condition to evaluate.
|
|
44
|
+
* @param input - The value map exposed to the sandbox as `$input`.
|
|
45
|
+
* @param context - The run-scoped execution context.
|
|
46
|
+
* @returns `true` when the sandbox result is truthy.
|
|
47
|
+
* @throws {GraphExecutionError} When no evaluator is registered or the sandbox fails.
|
|
48
|
+
*/
|
|
49
|
+
export declare function evaluateCodeCondition(condition: CodeCondition, input: Record<string, unknown>, context: GraphExecutionContext): Promise<boolean>;
|
|
50
|
+
/**
|
|
51
|
+
* Options for {@link evaluateCondition}.
|
|
52
|
+
*/
|
|
53
|
+
export interface ConditionEvaluationOptions {
|
|
54
|
+
/** The value map exposed to code conditions as `$input`. */
|
|
55
|
+
input: Record<string, unknown>;
|
|
56
|
+
/** The state a graphical `ConditionExpression` resolves against. */
|
|
57
|
+
state: unknown;
|
|
58
|
+
/**
|
|
59
|
+
* Human label for the carrier used in the unknown-condition error message
|
|
60
|
+
* (e.g. `"switch case"`, `"if"`, `"loop"`).
|
|
61
|
+
*/
|
|
62
|
+
label?: string;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Evaluates a graphical {@link ConditionExpression} synchronously, throwing for
|
|
66
|
+
* any other shape. Used by synchronous executors that must preserve their
|
|
67
|
+
* synchronous throw contract for graphical conditions.
|
|
68
|
+
*
|
|
69
|
+
* @param condition - The condition to evaluate.
|
|
70
|
+
* @param state - The state a graphical `ConditionExpression` resolves against.
|
|
71
|
+
* @param label - Human label for the carrier used in the unknown-condition error.
|
|
72
|
+
* @returns `true` when the expression matches.
|
|
73
|
+
* @throws {GraphExecutionError} When the condition is not a `ConditionExpression`.
|
|
74
|
+
*/
|
|
75
|
+
export declare function evaluateConditionSync(condition: unknown, state: unknown, label?: string): boolean;
|
|
76
|
+
/**
|
|
77
|
+
* Evaluates a {@link Condition} carried by any flow-control node, dispatching
|
|
78
|
+
* graphical expressions to the {@link ConditionExpressionEvaluator} and code
|
|
79
|
+
* conditions to the registered `CodeSandboxEvaluator`.
|
|
80
|
+
*
|
|
81
|
+
* @param condition - The condition to evaluate.
|
|
82
|
+
* @param options - The sandbox input, graphical state, and error label.
|
|
83
|
+
* @param context - The run-scoped execution context.
|
|
84
|
+
* @returns `true` when the condition matches.
|
|
85
|
+
* @throws {GraphExecutionError} When the condition shape is unknown.
|
|
86
|
+
*/
|
|
87
|
+
export declare function evaluateCondition(condition: Condition, options: ConditionEvaluationOptions, context: GraphExecutionContext): Promise<boolean>;
|