@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,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.mts";
|
|
17
|
+
import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
|
|
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>;
|
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @module as-graph/loops/GraphConditionEvaluator
|
|
3
|
-
* @summary Evaluator for built-in loop condition types
|
|
4
|
-
* @description Supports safe, built-in condition types
|
|
5
|
-
*
|
|
6
|
-
* {@link ConditionExpressionEvaluator}
|
|
3
|
+
* @summary Evaluator for built-in loop condition types, the `ConditionExpression` DSL, and `CodeCondition` code mode.
|
|
4
|
+
* @description Supports safe, built-in condition types, the declarative `ConditionExpression` DSL, and — through the
|
|
5
|
+
* shared {@link evaluateCondition} dispatch — pluggable `CodeCondition` code mode. When the condition object carries an
|
|
6
|
+
* `op` field (ALFRED-5 §8 / DECAF-32 §22.3) it dispatches to the {@link ConditionExpressionEvaluator}; when it carries
|
|
7
|
+
* `type: "code"` (DECAF-32 §22.4) it dispatches to the registered `CodeSandboxEvaluator`; otherwise the built-in
|
|
8
|
+
* `type`-based switch is used.
|
|
7
9
|
*/
|
|
8
|
-
import type { GraphConditionDefinition } from "../types.d.cts";
|
|
10
|
+
import type { GraphConditionDefinition, LoopCondition } from "../types.d.cts";
|
|
9
11
|
import type { ConditionExpression } from "../../shared/graph/index.d.cts";
|
|
12
|
+
import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
|
|
10
13
|
/**
|
|
11
|
-
* Evaluates loop conditions using built-in comparison types
|
|
12
|
-
* `ConditionExpression` DSL.
|
|
14
|
+
* Evaluates loop conditions using built-in comparison types, the
|
|
15
|
+
* `ConditionExpression` DSL, or the pluggable code sandbox.
|
|
13
16
|
*/
|
|
14
17
|
export declare class GraphConditionEvaluator {
|
|
15
18
|
private readonly expressionEvaluator;
|
|
@@ -26,6 +29,23 @@ export declare class GraphConditionEvaluator {
|
|
|
26
29
|
* @returns `true` when the condition passes.
|
|
27
30
|
*/
|
|
28
31
|
evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
|
|
32
|
+
/**
|
|
33
|
+
* Evaluates a loop condition that may be a built-in `GraphConditionDefinition`,
|
|
34
|
+
* a graphical `ConditionExpression`, or a code `CodeCondition`.
|
|
35
|
+
*
|
|
36
|
+
* `CodeCondition` evaluation is asynchronous (it runs through the pluggable
|
|
37
|
+
* `CodeSandboxEvaluator`), so the loop nodes call this method instead of the
|
|
38
|
+
* synchronous {@link evaluate}. Graphical and built-in conditions delegate to
|
|
39
|
+
* {@link evaluate} unchanged.
|
|
40
|
+
*
|
|
41
|
+
* @param condition - The condition definition.
|
|
42
|
+
* @param state - The current loop state (the graphical resolution root).
|
|
43
|
+
* @param context - The run-scoped execution context.
|
|
44
|
+
* @param input - The value map exposed to code conditions as `$input`.
|
|
45
|
+
* @returns `true` when the condition passes.
|
|
46
|
+
* @throws {GraphExecutionError} When no code sandbox evaluator is registered.
|
|
47
|
+
*/
|
|
48
|
+
evaluateAsync(condition: LoopCondition, state: unknown, context: GraphExecutionContext, input: Record<string, unknown>): Promise<boolean>;
|
|
29
49
|
/**
|
|
30
50
|
* Resolves a value that may be a dotted path into the state object.
|
|
31
51
|
*/
|
|
@@ -1,15 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @module as-graph/loops/GraphConditionEvaluator
|
|
3
|
-
* @summary Evaluator for built-in loop condition types
|
|
4
|
-
* @description Supports safe, built-in condition types
|
|
5
|
-
*
|
|
6
|
-
* {@link ConditionExpressionEvaluator}
|
|
3
|
+
* @summary Evaluator for built-in loop condition types, the `ConditionExpression` DSL, and `CodeCondition` code mode.
|
|
4
|
+
* @description Supports safe, built-in condition types, the declarative `ConditionExpression` DSL, and — through the
|
|
5
|
+
* shared {@link evaluateCondition} dispatch — pluggable `CodeCondition` code mode. When the condition object carries an
|
|
6
|
+
* `op` field (ALFRED-5 §8 / DECAF-32 §22.3) it dispatches to the {@link ConditionExpressionEvaluator}; when it carries
|
|
7
|
+
* `type: "code"` (DECAF-32 §22.4) it dispatches to the registered `CodeSandboxEvaluator`; otherwise the built-in
|
|
8
|
+
* `type`-based switch is used.
|
|
7
9
|
*/
|
|
8
|
-
import type { GraphConditionDefinition } from "../types.d.mts";
|
|
10
|
+
import type { GraphConditionDefinition, LoopCondition } from "../types.d.mts";
|
|
9
11
|
import type { ConditionExpression } from "../../shared/graph/index.d.mts";
|
|
12
|
+
import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
|
|
10
13
|
/**
|
|
11
|
-
* Evaluates loop conditions using built-in comparison types
|
|
12
|
-
* `ConditionExpression` DSL.
|
|
14
|
+
* Evaluates loop conditions using built-in comparison types, the
|
|
15
|
+
* `ConditionExpression` DSL, or the pluggable code sandbox.
|
|
13
16
|
*/
|
|
14
17
|
export declare class GraphConditionEvaluator {
|
|
15
18
|
private readonly expressionEvaluator;
|
|
@@ -26,6 +29,23 @@ export declare class GraphConditionEvaluator {
|
|
|
26
29
|
* @returns `true` when the condition passes.
|
|
27
30
|
*/
|
|
28
31
|
evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
|
|
32
|
+
/**
|
|
33
|
+
* Evaluates a loop condition that may be a built-in `GraphConditionDefinition`,
|
|
34
|
+
* a graphical `ConditionExpression`, or a code `CodeCondition`.
|
|
35
|
+
*
|
|
36
|
+
* `CodeCondition` evaluation is asynchronous (it runs through the pluggable
|
|
37
|
+
* `CodeSandboxEvaluator`), so the loop nodes call this method instead of the
|
|
38
|
+
* synchronous {@link evaluate}. Graphical and built-in conditions delegate to
|
|
39
|
+
* {@link evaluate} unchanged.
|
|
40
|
+
*
|
|
41
|
+
* @param condition - The condition definition.
|
|
42
|
+
* @param state - The current loop state (the graphical resolution root).
|
|
43
|
+
* @param context - The run-scoped execution context.
|
|
44
|
+
* @param input - The value map exposed to code conditions as `$input`.
|
|
45
|
+
* @returns `true` when the condition passes.
|
|
46
|
+
* @throws {GraphExecutionError} When no code sandbox evaluator is registered.
|
|
47
|
+
*/
|
|
48
|
+
evaluateAsync(condition: LoopCondition, state: unknown, context: GraphExecutionContext, input: Record<string, unknown>): Promise<boolean>;
|
|
29
49
|
/**
|
|
30
50
|
* Resolves a value that may be a dotted path into the state object.
|
|
31
51
|
*/
|
|
@@ -4,5 +4,6 @@
|
|
|
4
4
|
* @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
|
|
5
5
|
*/
|
|
6
6
|
export * from "./GraphConditionEvaluator.d.cts";
|
|
7
|
+
export * from "./ConditionEvaluator.d.cts";
|
|
7
8
|
export * from "./ConditionExpressionEvaluator.d.cts";
|
|
8
9
|
export * from "./GraphLoopExecutionContext.d.cts";
|
|
@@ -4,5 +4,6 @@
|
|
|
4
4
|
* @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
|
|
5
5
|
*/
|
|
6
6
|
export * from "./GraphConditionEvaluator.d.mts";
|
|
7
|
+
export * from "./ConditionEvaluator.d.mts";
|
|
7
8
|
export * from "./ConditionExpressionEvaluator.d.mts";
|
|
8
9
|
export * from "./GraphLoopExecutionContext.d.mts";
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import type { Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
2
2
|
import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
|
|
3
|
+
import type { GraphResumeAudit, GraphResumeRequest } from "../execution/GraphExecutionBackend.d.cts";
|
|
3
4
|
import { type GraphRunEventEnvelope, type GraphRunLimits } from "../../shared/graph/index.d.cts";
|
|
4
5
|
import { type GraphRun, type GraphRunCreateRequest, type GraphRunDocumentResolver, type GraphRunEventStore, type GraphRunStore } from "./types.d.cts";
|
|
6
|
+
import type { GraphRunModel } from "../../shared/graph/index.d.cts";
|
|
5
7
|
/** Construction options for {@link GraphRunService}. */
|
|
6
8
|
export interface GraphRunServiceOptions {
|
|
7
9
|
/** Run limits (timeouts, event payload caps, concurrency); defaults from {@link DEFAULT_GRAPH_RUN_LIMITS}. */
|
|
@@ -22,7 +24,8 @@ export interface GraphRunServiceOptions {
|
|
|
22
24
|
* observes graph runs on top of a {@link GraphRunStore} and
|
|
23
25
|
* {@link GraphRunEventStore}. Enforces per-caller run limits (concurrency
|
|
24
26
|
* buckets keyed by owner or caller key, timeout, event payload size), scopes
|
|
25
|
-
* every read
|
|
27
|
+
* every read to the owning user, authorizes cancellation by strict owner
|
|
28
|
+
* equality (SAA-105 R3), auto-releases retained event state
|
|
26
29
|
* after the configured replay window (SAA-595), and exposes the sequenced
|
|
27
30
|
* event stream the SSE controller replays.
|
|
28
31
|
*/
|
|
@@ -56,11 +59,58 @@ export declare class GraphRunService {
|
|
|
56
59
|
createRun(request: GraphRunCreateRequest, ownerUser: string | null, concurrencyKey?: string, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
57
60
|
/** Reads a run, asserting it belongs to `ownerUser`. */
|
|
58
61
|
getRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
62
|
+
/**
|
|
63
|
+
* Lists the persisted run rows for a workflow document, scoped to the
|
|
64
|
+
* requesting owner and ordered newest first.
|
|
65
|
+
*
|
|
66
|
+
* The collection is ownership-filtered with
|
|
67
|
+
* {@link canAccessGraphResource}: owner-less runs stay visible to everyone,
|
|
68
|
+
* a named caller sees their own plus owner-less runs, and an anonymous caller
|
|
69
|
+
* without the explicit `allowAnonymousAccess` tolerance sees only owner-less
|
|
70
|
+
* runs (SAA-595). The persisted {@link GraphRunModel} rows are returned so
|
|
71
|
+
* the HTTP boundary can serve the frontend-safe listing shape.
|
|
72
|
+
*
|
|
73
|
+
* The newest-first sort is corrupt-date-safe (SAA-93 R2): a row whose
|
|
74
|
+
* `updatedAt` is missing or not a valid `Date` is treated as oldest
|
|
75
|
+
* (epoch `0`) instead of producing `NaN` comparisons that would make the
|
|
76
|
+
* ordering of adjacent rows undefined.
|
|
77
|
+
*
|
|
78
|
+
* @param {string} workflowId - Workflow document id to list runs for.
|
|
79
|
+
* @param {string | null} ownerUser - Identity of the requesting caller.
|
|
80
|
+
* @param args - An optional decaf `Context` forwarded to the store.
|
|
81
|
+
* @return {Promise<GraphRunModel[]>} The workflow's runs, newest first.
|
|
82
|
+
* @throws Re-throws any store failure from {@link GraphRunStore.listRuns}.
|
|
83
|
+
*/
|
|
84
|
+
listRunsByWorkflow(workflowId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunModel[]>;
|
|
59
85
|
/**
|
|
60
86
|
* Cancels a non-terminal run: aborts in-flight execution and persists the
|
|
61
87
|
* `cancelled` status. Terminal runs are returned unchanged.
|
|
88
|
+
*
|
|
89
|
+
* Cancellation is a write and is authorized by strict owner equality
|
|
90
|
+
* ({@link assertGraphResourceWriteOwnership}, SAA-105 R3): only the run's
|
|
91
|
+
* recorded owner may cancel it. A named caller can no longer cancel an
|
|
92
|
+
* owner-less run, and the read-visibility tolerance `allowAnonymousAccess`
|
|
93
|
+
* never grants a cancellation.
|
|
62
94
|
*/
|
|
63
95
|
cancelRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
96
|
+
/**
|
|
97
|
+
* Resumes a suspended run: resolves the run, asserts strict owner equality on
|
|
98
|
+
* the write path ({@link assertGraphResourceWriteOwnership}, SAA-105 R3), then
|
|
99
|
+
* delegates to the active backend's optional SAA-196 `resume?()` extension and
|
|
100
|
+
* audits the accepted resume through the event publisher (C18). A backend without
|
|
101
|
+
* the extension fails closed rather than silently no-op.
|
|
102
|
+
*
|
|
103
|
+
* C14: resume is exposed only through this service, behind the owner-equality
|
|
104
|
+
* write gate — never from an HTTP route. The standing SAA-200 hardening rule
|
|
105
|
+
* holds here too: a {@link GraphExecutionError} thrown by the backend is
|
|
106
|
+
* re-thrown without its `details` so no server-side state leaks to clients.
|
|
107
|
+
*
|
|
108
|
+
* @throws NotFoundError when no run exists for `runId`.
|
|
109
|
+
* @throws ForbiddenError when the caller is not the run's recorded owner.
|
|
110
|
+
* @throws GraphExecutionError when the active backend does not support resume
|
|
111
|
+
* or the backend rejects the resume.
|
|
112
|
+
*/
|
|
113
|
+
resumeRun(runId: string, request: GraphResumeRequest, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
|
|
64
114
|
/** Lists a run's event envelopes after the given sequence (ownership-checked). */
|
|
65
115
|
listEvents(runId: string, afterSequence: number, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunEventEnvelope[]>;
|
|
66
116
|
/** Subscribes a live listener to a run's event stream (ownership-checked); returns an unsubscribe function. */
|
|
@@ -88,7 +138,16 @@ export declare class GraphRunService {
|
|
|
88
138
|
private finishActiveRun;
|
|
89
139
|
private validateCreateRequest;
|
|
90
140
|
private documentProviderFor;
|
|
141
|
+
/**
|
|
142
|
+
* Read-visibility check for a run: honours the owner-less visibility contract
|
|
143
|
+
* and the explicit `allowAnonymousAccess` tolerance (SAA-595/SAA-93 F1).
|
|
144
|
+
*/
|
|
91
145
|
private assertOwnership;
|
|
146
|
+
/**
|
|
147
|
+
* Write-path check for a run: strict owner equality, never the read tolerance
|
|
148
|
+
* (SAA-105 R3).
|
|
149
|
+
*/
|
|
150
|
+
private assertWriteOwnership;
|
|
92
151
|
/**
|
|
93
152
|
* Generates a cryptographically random run id. `crypto.randomUUID` is always
|
|
94
153
|
* available in the backend runtimes as-graph targets; the frontend never
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import type { Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
2
2
|
import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
|
|
3
|
+
import type { GraphResumeAudit, GraphResumeRequest } from "../execution/GraphExecutionBackend.d.mts";
|
|
3
4
|
import { type GraphRunEventEnvelope, type GraphRunLimits } from "../../shared/graph/index.d.mts";
|
|
4
5
|
import { type GraphRun, type GraphRunCreateRequest, type GraphRunDocumentResolver, type GraphRunEventStore, type GraphRunStore } from "./types.d.mts";
|
|
6
|
+
import type { GraphRunModel } from "../../shared/graph/index.d.mts";
|
|
5
7
|
/** Construction options for {@link GraphRunService}. */
|
|
6
8
|
export interface GraphRunServiceOptions {
|
|
7
9
|
/** Run limits (timeouts, event payload caps, concurrency); defaults from {@link DEFAULT_GRAPH_RUN_LIMITS}. */
|
|
@@ -22,7 +24,8 @@ export interface GraphRunServiceOptions {
|
|
|
22
24
|
* observes graph runs on top of a {@link GraphRunStore} and
|
|
23
25
|
* {@link GraphRunEventStore}. Enforces per-caller run limits (concurrency
|
|
24
26
|
* buckets keyed by owner or caller key, timeout, event payload size), scopes
|
|
25
|
-
* every read
|
|
27
|
+
* every read to the owning user, authorizes cancellation by strict owner
|
|
28
|
+
* equality (SAA-105 R3), auto-releases retained event state
|
|
26
29
|
* after the configured replay window (SAA-595), and exposes the sequenced
|
|
27
30
|
* event stream the SSE controller replays.
|
|
28
31
|
*/
|
|
@@ -56,11 +59,58 @@ export declare class GraphRunService {
|
|
|
56
59
|
createRun(request: GraphRunCreateRequest, ownerUser: string | null, concurrencyKey?: string, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
57
60
|
/** Reads a run, asserting it belongs to `ownerUser`. */
|
|
58
61
|
getRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
62
|
+
/**
|
|
63
|
+
* Lists the persisted run rows for a workflow document, scoped to the
|
|
64
|
+
* requesting owner and ordered newest first.
|
|
65
|
+
*
|
|
66
|
+
* The collection is ownership-filtered with
|
|
67
|
+
* {@link canAccessGraphResource}: owner-less runs stay visible to everyone,
|
|
68
|
+
* a named caller sees their own plus owner-less runs, and an anonymous caller
|
|
69
|
+
* without the explicit `allowAnonymousAccess` tolerance sees only owner-less
|
|
70
|
+
* runs (SAA-595). The persisted {@link GraphRunModel} rows are returned so
|
|
71
|
+
* the HTTP boundary can serve the frontend-safe listing shape.
|
|
72
|
+
*
|
|
73
|
+
* The newest-first sort is corrupt-date-safe (SAA-93 R2): a row whose
|
|
74
|
+
* `updatedAt` is missing or not a valid `Date` is treated as oldest
|
|
75
|
+
* (epoch `0`) instead of producing `NaN` comparisons that would make the
|
|
76
|
+
* ordering of adjacent rows undefined.
|
|
77
|
+
*
|
|
78
|
+
* @param {string} workflowId - Workflow document id to list runs for.
|
|
79
|
+
* @param {string | null} ownerUser - Identity of the requesting caller.
|
|
80
|
+
* @param args - An optional decaf `Context` forwarded to the store.
|
|
81
|
+
* @return {Promise<GraphRunModel[]>} The workflow's runs, newest first.
|
|
82
|
+
* @throws Re-throws any store failure from {@link GraphRunStore.listRuns}.
|
|
83
|
+
*/
|
|
84
|
+
listRunsByWorkflow(workflowId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunModel[]>;
|
|
59
85
|
/**
|
|
60
86
|
* Cancels a non-terminal run: aborts in-flight execution and persists the
|
|
61
87
|
* `cancelled` status. Terminal runs are returned unchanged.
|
|
88
|
+
*
|
|
89
|
+
* Cancellation is a write and is authorized by strict owner equality
|
|
90
|
+
* ({@link assertGraphResourceWriteOwnership}, SAA-105 R3): only the run's
|
|
91
|
+
* recorded owner may cancel it. A named caller can no longer cancel an
|
|
92
|
+
* owner-less run, and the read-visibility tolerance `allowAnonymousAccess`
|
|
93
|
+
* never grants a cancellation.
|
|
62
94
|
*/
|
|
63
95
|
cancelRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
|
|
96
|
+
/**
|
|
97
|
+
* Resumes a suspended run: resolves the run, asserts strict owner equality on
|
|
98
|
+
* the write path ({@link assertGraphResourceWriteOwnership}, SAA-105 R3), then
|
|
99
|
+
* delegates to the active backend's optional SAA-196 `resume?()` extension and
|
|
100
|
+
* audits the accepted resume through the event publisher (C18). A backend without
|
|
101
|
+
* the extension fails closed rather than silently no-op.
|
|
102
|
+
*
|
|
103
|
+
* C14: resume is exposed only through this service, behind the owner-equality
|
|
104
|
+
* write gate — never from an HTTP route. The standing SAA-200 hardening rule
|
|
105
|
+
* holds here too: a {@link GraphExecutionError} thrown by the backend is
|
|
106
|
+
* re-thrown without its `details` so no server-side state leaks to clients.
|
|
107
|
+
*
|
|
108
|
+
* @throws NotFoundError when no run exists for `runId`.
|
|
109
|
+
* @throws ForbiddenError when the caller is not the run's recorded owner.
|
|
110
|
+
* @throws GraphExecutionError when the active backend does not support resume
|
|
111
|
+
* or the backend rejects the resume.
|
|
112
|
+
*/
|
|
113
|
+
resumeRun(runId: string, request: GraphResumeRequest, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
|
|
64
114
|
/** Lists a run's event envelopes after the given sequence (ownership-checked). */
|
|
65
115
|
listEvents(runId: string, afterSequence: number, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunEventEnvelope[]>;
|
|
66
116
|
/** Subscribes a live listener to a run's event stream (ownership-checked); returns an unsubscribe function. */
|
|
@@ -88,7 +138,16 @@ export declare class GraphRunService {
|
|
|
88
138
|
private finishActiveRun;
|
|
89
139
|
private validateCreateRequest;
|
|
90
140
|
private documentProviderFor;
|
|
141
|
+
/**
|
|
142
|
+
* Read-visibility check for a run: honours the owner-less visibility contract
|
|
143
|
+
* and the explicit `allowAnonymousAccess` tolerance (SAA-595/SAA-93 F1).
|
|
144
|
+
*/
|
|
91
145
|
private assertOwnership;
|
|
146
|
+
/**
|
|
147
|
+
* Write-path check for a run: strict owner equality, never the read tolerance
|
|
148
|
+
* (SAA-105 R3).
|
|
149
|
+
*/
|
|
150
|
+
private assertWriteOwnership;
|
|
92
151
|
/**
|
|
93
152
|
* Generates a cryptographically random run id. `crypto.randomUUID` is always
|
|
94
153
|
* available in the backend runtimes as-graph targets; the frontend never
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { GraphRun, GraphRunStore } from "./types.d.cts";
|
|
2
|
+
import type { GraphRunModel } from "../../shared/graph/index.d.cts";
|
|
2
3
|
/**
|
|
3
4
|
* Non-persistent {@link GraphRunStore} backed by a `Map`: serves tests and
|
|
4
5
|
* in-process deployments. Runs are cloned on save/read so callers never
|
|
@@ -6,7 +7,35 @@ import type { GraphRun, GraphRunStore } from "./types.d.cts";
|
|
|
6
7
|
*/
|
|
7
8
|
export declare class InMemoryGraphRunStore implements GraphRunStore {
|
|
8
9
|
private readonly runs;
|
|
10
|
+
/**
|
|
11
|
+
* Clones and stores the run by its id (upsert semantics).
|
|
12
|
+
*
|
|
13
|
+
* @param {GraphRun} run - Engine-side run to persist.
|
|
14
|
+
* @return {Promise<void>} Resolves once the run is stored.
|
|
15
|
+
*/
|
|
9
16
|
saveRun(run: GraphRun): Promise<void>;
|
|
17
|
+
/**
|
|
18
|
+
* Reads a run and returns a clone, so callers never share mutable
|
|
19
|
+
* references with the store.
|
|
20
|
+
*
|
|
21
|
+
* @param {string} runId - Id of the run to read.
|
|
22
|
+
* @return {Promise<GraphRun | null>} The run, or `null` when no row exists.
|
|
23
|
+
*/
|
|
10
24
|
readRun(runId: string): Promise<GraphRun | null>;
|
|
25
|
+
/**
|
|
26
|
+
* Lists every in-memory run that executed the given workflow, converted to
|
|
27
|
+
* its persisted {@link GraphRunModel} shape so the serving list keeps the
|
|
28
|
+
* storage-derived fields (`updatedAt`, `inputs`). Unordered; the run
|
|
29
|
+
* service orders the serving result.
|
|
30
|
+
*
|
|
31
|
+
* @param {string} workflowId - Workflow document id the runs executed.
|
|
32
|
+
* @return {Promise<GraphRunModel[]>} The matching rows (empty when none exist).
|
|
33
|
+
*/
|
|
34
|
+
listRuns(workflowId: string): Promise<GraphRunModel[]>;
|
|
35
|
+
/**
|
|
36
|
+
* Deletes a run's row, mirroring the event-store `release?` contract.
|
|
37
|
+
*
|
|
38
|
+
* @param {string} runId - Id of the run to release.
|
|
39
|
+
*/
|
|
11
40
|
release(runId: string): void;
|
|
12
41
|
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { GraphRun, GraphRunStore } from "./types.d.mts";
|
|
2
|
+
import type { GraphRunModel } from "../../shared/graph/index.d.mts";
|
|
2
3
|
/**
|
|
3
4
|
* Non-persistent {@link GraphRunStore} backed by a `Map`: serves tests and
|
|
4
5
|
* in-process deployments. Runs are cloned on save/read so callers never
|
|
@@ -6,7 +7,35 @@ import type { GraphRun, GraphRunStore } from "./types.d.mts";
|
|
|
6
7
|
*/
|
|
7
8
|
export declare class InMemoryGraphRunStore implements GraphRunStore {
|
|
8
9
|
private readonly runs;
|
|
10
|
+
/**
|
|
11
|
+
* Clones and stores the run by its id (upsert semantics).
|
|
12
|
+
*
|
|
13
|
+
* @param {GraphRun} run - Engine-side run to persist.
|
|
14
|
+
* @return {Promise<void>} Resolves once the run is stored.
|
|
15
|
+
*/
|
|
9
16
|
saveRun(run: GraphRun): Promise<void>;
|
|
17
|
+
/**
|
|
18
|
+
* Reads a run and returns a clone, so callers never share mutable
|
|
19
|
+
* references with the store.
|
|
20
|
+
*
|
|
21
|
+
* @param {string} runId - Id of the run to read.
|
|
22
|
+
* @return {Promise<GraphRun | null>} The run, or `null` when no row exists.
|
|
23
|
+
*/
|
|
10
24
|
readRun(runId: string): Promise<GraphRun | null>;
|
|
25
|
+
/**
|
|
26
|
+
* Lists every in-memory run that executed the given workflow, converted to
|
|
27
|
+
* its persisted {@link GraphRunModel} shape so the serving list keeps the
|
|
28
|
+
* storage-derived fields (`updatedAt`, `inputs`). Unordered; the run
|
|
29
|
+
* service orders the serving result.
|
|
30
|
+
*
|
|
31
|
+
* @param {string} workflowId - Workflow document id the runs executed.
|
|
32
|
+
* @return {Promise<GraphRunModel[]>} The matching rows (empty when none exist).
|
|
33
|
+
*/
|
|
34
|
+
listRuns(workflowId: string): Promise<GraphRunModel[]>;
|
|
35
|
+
/**
|
|
36
|
+
* Deletes a run's row, mirroring the event-store `release?` contract.
|
|
37
|
+
*
|
|
38
|
+
* @param {string} runId - Id of the run to release.
|
|
39
|
+
*/
|
|
11
40
|
release(runId: string): void;
|
|
12
41
|
}
|
|
@@ -1,10 +1,95 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Centralized graph resource
|
|
2
|
+
* Centralized graph resource access predicate (SAA-595 security hardening).
|
|
3
3
|
*
|
|
4
|
-
* Fail-closed by default: a resource that carries an owner is only
|
|
5
|
-
*
|
|
4
|
+
* Fail-closed by default: a resource that carries an owner is only visible to
|
|
5
|
+
* that owner; an absent caller identity is denied unless the explicit
|
|
6
6
|
* `allowAnonymousAccess` tolerance (DECAF-48 §4.15 standalone runs) is set.
|
|
7
|
-
* Owner-less resources remain accessible to everyone.
|
|
7
|
+
* Owner-less resources remain accessible to everyone. Returns a boolean so list
|
|
8
|
+
* endpoints can filter a collection without aborting on the first foreign row.
|
|
9
|
+
*
|
|
10
|
+
* @param resource - The guarded resource (or its persisted record); only its
|
|
11
|
+
* `owner` member is read. `null`/`undefined` counts as owner-less.
|
|
12
|
+
* @param callerOwner - Identity of the caller resolved from the request
|
|
13
|
+
* context; `null`/`undefined`/`""` represent anonymous callers.
|
|
14
|
+
* @param options - `allowAnonymousAccess` opts in to the DECAF-48 §4.15
|
|
15
|
+
* standalone tolerance (default `false`).
|
|
16
|
+
* @return `true` when the caller may access the resource.
|
|
17
|
+
*/
|
|
18
|
+
export declare function canAccessGraphResource(resource: {
|
|
19
|
+
owner?: string | null;
|
|
20
|
+
} | null | undefined, callerOwner: string | null | undefined, options?: {
|
|
21
|
+
allowAnonymousAccess?: boolean;
|
|
22
|
+
}): boolean;
|
|
23
|
+
/**
|
|
24
|
+
* Payload-scoped companion to {@link canAccessGraphResource} (SAA-93 F1).
|
|
25
|
+
*
|
|
26
|
+
* Read *visibility* of an owner-less resource is intentionally open to every
|
|
27
|
+
* caller, but the sensitive payload members a list projection serves
|
|
28
|
+
* (`inputs`/`result`/`error` on run rows) must not be. This predicate is
|
|
29
|
+
* fail-closed: a caller may see a row's payload only when the row's recorded
|
|
30
|
+
* owner equals the caller's resolved owner. An owner-less row (no recorded
|
|
31
|
+
* owner) therefore exposes its payload only to an owner-less caller (an
|
|
32
|
+
* anonymous/standalone caller); a named caller — even one allowed to see the row
|
|
33
|
+
* by {@link canAccessGraphResource} — receives the summary-only projection.
|
|
34
|
+
* That closes the cross-caller exposure where an unrelated authenticated caller
|
|
35
|
+
* could read another anonymous caller's `inputs`/`result`/`error` through
|
|
36
|
+
* `GET /graph/workflows/{workflowId}/runs`.
|
|
37
|
+
*
|
|
38
|
+
* @param resource - The guarded resource (or its persisted record); only its
|
|
39
|
+
* `owner` member is read. `null`/`undefined` counts as owner-less.
|
|
40
|
+
* @param callerOwner - Identity of the caller resolved from the request
|
|
41
|
+
* context; `null`/`undefined`/`""` represent owner-less callers.
|
|
42
|
+
* @return `true` when the caller may see the resource's payload members.
|
|
43
|
+
*/
|
|
44
|
+
export declare function canAccessGraphResourcePayload(resource: {
|
|
45
|
+
owner?: string | null;
|
|
46
|
+
} | null | undefined, callerOwner: string | null | undefined): boolean;
|
|
47
|
+
/**
|
|
48
|
+
* Write-path ownership assertion for graph resources (SAA-105 R3).
|
|
49
|
+
*
|
|
50
|
+
* Mutation authorization is strict owner equality, deliberately stricter than the
|
|
51
|
+
* read-visibility predicate {@link canAccessGraphResource}: the owner-less
|
|
52
|
+
* visibility branch that lets any caller *read* an owner-less resource must never
|
|
53
|
+
* authorize a write. Concretely this denies a named caller mutating an owner-less
|
|
54
|
+
* resource (the R3 cross-caller hole) and denies an anonymous caller mutating an
|
|
55
|
+
* owned resource even when the read tolerance `allowAnonymousAccess` is set.
|
|
56
|
+
*
|
|
57
|
+
* The normative effects are:
|
|
58
|
+
* - owner-less resource + owner-less (anonymous) caller → allow;
|
|
59
|
+
* - owner-less resource + named caller → `ForbiddenError`;
|
|
60
|
+
* - owned resource + its owner → allow;
|
|
61
|
+
* - owned resource + any other caller (including anonymous with the read
|
|
62
|
+
* tolerance) → `ForbiddenError`.
|
|
63
|
+
*
|
|
64
|
+
* `allowAnonymousAccess` is intentionally not a parameter here: it is a
|
|
65
|
+
* read-visibility tolerance and never grants a write.
|
|
66
|
+
*
|
|
67
|
+
* @param resource - The guarded resource (or its persisted record); only its
|
|
68
|
+
* `owner` member is read. `null`/`undefined` counts as owner-less.
|
|
69
|
+
* @param callerOwner - Identity of the caller resolved from the request
|
|
70
|
+
* context; `null`/`undefined`/`""` represent owner-less callers.
|
|
71
|
+
* @param options - `resourceKind`/`resourceId` name the resource in the
|
|
72
|
+
* denial message.
|
|
73
|
+
* @throws ForbiddenError when the caller is not the resource's recorded owner
|
|
74
|
+
* (owner equality).
|
|
75
|
+
*/
|
|
76
|
+
export declare function assertGraphResourceWriteOwnership(resource: {
|
|
77
|
+
owner?: string | null;
|
|
78
|
+
} | null | undefined, callerOwner: string | null | undefined, options: {
|
|
79
|
+
resourceKind: string;
|
|
80
|
+
resourceId: string;
|
|
81
|
+
}): void;
|
|
82
|
+
/**
|
|
83
|
+
* Centralized graph resource ownership check (SAA-595 security hardening).
|
|
84
|
+
*
|
|
85
|
+
* Read-visibility check. Fail-closed by default: a resource that carries an
|
|
86
|
+
* owner is only accessible to that owner; an absent caller identity is denied
|
|
87
|
+
* unless the explicit `allowAnonymousAccess` tolerance (DECAF-48 §4.15 standalone
|
|
88
|
+
* runs) is set. Owner-less resources remain accessible to everyone.
|
|
89
|
+
*
|
|
90
|
+
* Writes must NOT use this predicate; use
|
|
91
|
+
* {@link assertGraphResourceWriteOwnership} so the owner-less visibility branch
|
|
92
|
+
* and the `allowAnonymousAccess` tolerance cannot authorize a mutation.
|
|
8
93
|
*
|
|
9
94
|
* @param resource - The guarded resource (or its persisted record); only its
|
|
10
95
|
* `owner` member is read. `null`/`undefined` counts as owner-less.
|