@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,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/execution/GraphCodeMode
|
|
3
|
+
* @summary Code-mode surface detection for the pluggable backend gate (SAA-193 C1).
|
|
4
|
+
* @description The security gate requires the facade to detect every code-mode
|
|
5
|
+
* surface in a workflow before delegating to a non-local backend, so it can fail
|
|
6
|
+
* closed instead of launching a remote run that cannot execute it. This module is
|
|
7
|
+
* the single detection authority. It walks the canonical
|
|
8
|
+
* {@link GraphWorkflowDocument} and reports every surface the reference engine
|
|
9
|
+
* would evaluate through the code sandbox:
|
|
10
|
+
*
|
|
11
|
+
* - a `CodeCondition` (`{ type: "code" }`) on any flow-control carrier —
|
|
12
|
+
* if / elseIf / while / until conditions and switch-case conditions, in either
|
|
13
|
+
* the `parameters` or the `metadata` carrier;
|
|
14
|
+
* - a `core.utility.code` node;
|
|
15
|
+
* - a `GraphValueTemplate` parameter;
|
|
16
|
+
* - an expression input binding (`mode: "expression"`) and an expression
|
|
17
|
+
* {@link GraphValueReference} in a loop input/output mapping.
|
|
18
|
+
*
|
|
19
|
+
* Nested loop-body documents are scanned recursively, so a code-mode surface
|
|
20
|
+
* buried inside a loop body is caught before any remote launch.
|
|
21
|
+
*/
|
|
22
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
|
|
23
|
+
/**
|
|
24
|
+
* The kind of code-mode surface detected in a workflow document.
|
|
25
|
+
*/
|
|
26
|
+
export type GraphCodeModeSurfaceKind = "code-condition" | "code-node" | "value-template" | "expression-binding";
|
|
27
|
+
/**
|
|
28
|
+
* A single code-mode surface found in a workflow document.
|
|
29
|
+
*/
|
|
30
|
+
export interface GraphCodeModeSurface {
|
|
31
|
+
/** The node carrying the surface. */
|
|
32
|
+
nodeId: string;
|
|
33
|
+
/** The kind of surface detected. */
|
|
34
|
+
kind: GraphCodeModeSurfaceKind;
|
|
35
|
+
/** Optional carrier detail (e.g. the bound input port). */
|
|
36
|
+
detail?: string;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Detects every code-mode surface in a canonical workflow document (SAA-193 C1).
|
|
40
|
+
*
|
|
41
|
+
* @param document - The canonical document to inspect.
|
|
42
|
+
* @returns One entry per code-mode surface found; empty when the workflow is
|
|
43
|
+
* fully graphical and host-executable.
|
|
44
|
+
*/
|
|
45
|
+
export declare function detectGraphCodeModeSurfaces(document: GraphWorkflowDocument): GraphCodeModeSurface[];
|
|
46
|
+
/**
|
|
47
|
+
* Reports whether a canonical workflow document carries any code-mode surface.
|
|
48
|
+
*
|
|
49
|
+
* @param document - The canonical document to inspect.
|
|
50
|
+
* @returns `true` when at least one code-mode surface is present.
|
|
51
|
+
*/
|
|
52
|
+
export declare function graphDocumentHasCodeMode(document: GraphWorkflowDocument): boolean;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/execution/GraphCodeMode
|
|
3
|
+
* @summary Code-mode surface detection for the pluggable backend gate (SAA-193 C1).
|
|
4
|
+
* @description The security gate requires the facade to detect every code-mode
|
|
5
|
+
* surface in a workflow before delegating to a non-local backend, so it can fail
|
|
6
|
+
* closed instead of launching a remote run that cannot execute it. This module is
|
|
7
|
+
* the single detection authority. It walks the canonical
|
|
8
|
+
* {@link GraphWorkflowDocument} and reports every surface the reference engine
|
|
9
|
+
* would evaluate through the code sandbox:
|
|
10
|
+
*
|
|
11
|
+
* - a `CodeCondition` (`{ type: "code" }`) on any flow-control carrier —
|
|
12
|
+
* if / elseIf / while / until conditions and switch-case conditions, in either
|
|
13
|
+
* the `parameters` or the `metadata` carrier;
|
|
14
|
+
* - a `core.utility.code` node;
|
|
15
|
+
* - a `GraphValueTemplate` parameter;
|
|
16
|
+
* - an expression input binding (`mode: "expression"`) and an expression
|
|
17
|
+
* {@link GraphValueReference} in a loop input/output mapping.
|
|
18
|
+
*
|
|
19
|
+
* Nested loop-body documents are scanned recursively, so a code-mode surface
|
|
20
|
+
* buried inside a loop body is caught before any remote launch.
|
|
21
|
+
*/
|
|
22
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
23
|
+
/**
|
|
24
|
+
* The kind of code-mode surface detected in a workflow document.
|
|
25
|
+
*/
|
|
26
|
+
export type GraphCodeModeSurfaceKind = "code-condition" | "code-node" | "value-template" | "expression-binding";
|
|
27
|
+
/**
|
|
28
|
+
* A single code-mode surface found in a workflow document.
|
|
29
|
+
*/
|
|
30
|
+
export interface GraphCodeModeSurface {
|
|
31
|
+
/** The node carrying the surface. */
|
|
32
|
+
nodeId: string;
|
|
33
|
+
/** The kind of surface detected. */
|
|
34
|
+
kind: GraphCodeModeSurfaceKind;
|
|
35
|
+
/** Optional carrier detail (e.g. the bound input port). */
|
|
36
|
+
detail?: string;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Detects every code-mode surface in a canonical workflow document (SAA-193 C1).
|
|
40
|
+
*
|
|
41
|
+
* @param document - The canonical document to inspect.
|
|
42
|
+
* @returns One entry per code-mode surface found; empty when the workflow is
|
|
43
|
+
* fully graphical and host-executable.
|
|
44
|
+
*/
|
|
45
|
+
export declare function detectGraphCodeModeSurfaces(document: GraphWorkflowDocument): GraphCodeModeSurface[];
|
|
46
|
+
/**
|
|
47
|
+
* Reports whether a canonical workflow document carries any code-mode surface.
|
|
48
|
+
*
|
|
49
|
+
* @param document - The canonical document to inspect.
|
|
50
|
+
* @returns `true` when at least one code-mode surface is present.
|
|
51
|
+
*/
|
|
52
|
+
export declare function graphDocumentHasCodeMode(document: GraphWorkflowDocument): boolean;
|
|
@@ -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.cts";
|
|
17
|
+
import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.cts";
|
|
18
|
+
import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphRunId } from "../types.d.cts";
|
|
19
|
+
import type { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.cts";
|
|
20
|
+
import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.cts";
|
|
21
|
+
import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.cts";
|
|
22
|
+
import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.cts";
|
|
23
|
+
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
|
|
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;
|