@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,98 @@
|
|
|
1
|
+
import type { Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
2
|
+
import type { GraphBackendWorkflowSummary } from "../../engine/execution/GraphExecutionBackend.d.cts";
|
|
3
|
+
import type { GraphExecutionEngine } from "../../engine/execution/GraphExecutionEngine.d.cts";
|
|
4
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
|
|
5
|
+
import { type GraphEngineCapabilityManifest, type GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.cts";
|
|
6
|
+
/** DI token for {@link GraphEngineCapabilityOptions}. */
|
|
7
|
+
export declare const GRAPH_ENGINE_CAPABILITY_OPTIONS = "GRAPH_ENGINE_CAPABILITY_OPTIONS";
|
|
8
|
+
/** Rate-limit configuration for the engine capability routes: window and request cap. */
|
|
9
|
+
export interface GraphEngineRateLimitOptions {
|
|
10
|
+
windowMs?: number;
|
|
11
|
+
maxRequests?: number;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Default rate limit for the engine capability routes: 120 requests per 60-second
|
|
15
|
+
* window, applied by the `@nestjs/throttler` guard on the `engines` bucket.
|
|
16
|
+
*/
|
|
17
|
+
export declare const DEFAULT_GRAPH_ENGINE_RATE_LIMIT: Required<GraphEngineRateLimitOptions>;
|
|
18
|
+
/**
|
|
19
|
+
* Options for the engine capability HTTP API (SAA-193 C20/C21): authentication
|
|
20
|
+
* mode, the host-preferred default engine id, and the engine-route rate limit.
|
|
21
|
+
*/
|
|
22
|
+
export interface GraphEngineCapabilityOptions {
|
|
23
|
+
/**
|
|
24
|
+
* `"required"` (default) rejects a request with no request context, or with a
|
|
25
|
+
* context that carries no resolved owner user, with `401`, matching the other
|
|
26
|
+
* graph read routes; `"optional"` tolerates anonymous/system callers for
|
|
27
|
+
* standalone module runs.
|
|
28
|
+
*/
|
|
29
|
+
auth?: "required" | "optional";
|
|
30
|
+
/**
|
|
31
|
+
* Engine id the manifest advertises as the default. Ignored when it is not one of
|
|
32
|
+
* the registered, allowlisted engine ids; the current backend flavour is used
|
|
33
|
+
* instead.
|
|
34
|
+
*/
|
|
35
|
+
defaultEngineId?: string;
|
|
36
|
+
/** Rate limit for the engine capability routes (the `engines` throttler bucket). */
|
|
37
|
+
rateLimit?: GraphEngineRateLimitOptions;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Owns the boot-time capability manifest and resolves engine-scoped workflow
|
|
41
|
+
* listing/lookup. The manifest is built once in the constructor from the
|
|
42
|
+
* registered backends; request handling never mutates it and never probes a remote
|
|
43
|
+
* engine.
|
|
44
|
+
*/
|
|
45
|
+
export declare class GraphEngineCapabilityService {
|
|
46
|
+
private readonly engine?;
|
|
47
|
+
private readonly manifest;
|
|
48
|
+
private readonly engineIds;
|
|
49
|
+
/**
|
|
50
|
+
* @param options - Controller options (auth, default engine id, rate limit).
|
|
51
|
+
* @param engine - The engine facade resolving flavour-scoped listing/lookup.
|
|
52
|
+
*/
|
|
53
|
+
constructor(options?: GraphEngineCapabilityOptions, engine?: GraphExecutionEngine | undefined);
|
|
54
|
+
/**
|
|
55
|
+
* Returns a defensive copy of the statically-derived capability manifest.
|
|
56
|
+
*
|
|
57
|
+
* @returns The C20 capability manifest snapshot.
|
|
58
|
+
*/
|
|
59
|
+
manifestSnapshot(): GraphEngineCapabilityManifest;
|
|
60
|
+
/**
|
|
61
|
+
* Returns a defensive copy of a single allowlisted engine descriptor.
|
|
62
|
+
*
|
|
63
|
+
* @param engineId - The engine id to look up.
|
|
64
|
+
* @returns The engine descriptor, or `undefined` when not allowlisted.
|
|
65
|
+
*/
|
|
66
|
+
descriptor(engineId: string): GraphEngineDescriptor | undefined;
|
|
67
|
+
/**
|
|
68
|
+
* Whether the engine id is registered and allowlisted.
|
|
69
|
+
*
|
|
70
|
+
* @param engineId - The engine id to check.
|
|
71
|
+
* @returns `true` when the id is an available engine.
|
|
72
|
+
*/
|
|
73
|
+
isKnownEngine(engineId: string): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Lists the workflows a registered engine can surface through the engine-agnostic
|
|
76
|
+
* facade, which applies the fail-closed capability gate and the
|
|
77
|
+
* `GRAPH_BACKEND_WORKFLOWS_NOT_SUPPORTED` error code.
|
|
78
|
+
*
|
|
79
|
+
* @param engineId - The allowlisted engine id to list for.
|
|
80
|
+
* @param args - Optional decaf contextual arguments forwarded to the backend.
|
|
81
|
+
* @returns Workflow summaries.
|
|
82
|
+
* @throws {GraphExecutionError} when the engine declares no listing support.
|
|
83
|
+
*/
|
|
84
|
+
listWorkflows(engineId: string, ...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
|
|
85
|
+
/**
|
|
86
|
+
* Looks up a single canonical workflow document on a registered engine through
|
|
87
|
+
* the engine-agnostic facade.
|
|
88
|
+
*
|
|
89
|
+
* @param engineId - The allowlisted engine id to read from.
|
|
90
|
+
* @param workflowId - The canonical workflow id to read.
|
|
91
|
+
* @param args - Optional decaf contextual arguments forwarded to the backend.
|
|
92
|
+
* @returns The canonical workflow document.
|
|
93
|
+
* @throws {GraphExecutionError} when the engine declares no lookup support.
|
|
94
|
+
*/
|
|
95
|
+
getWorkflow(engineId: string, workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
96
|
+
/** Resolves the engine facade, failing closed when it is not wired. */
|
|
97
|
+
private requireEngine;
|
|
98
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import type { Context, MaybeContextualArg } from "@decaf-ts/core";
|
|
2
|
+
import type { GraphBackendWorkflowSummary } from "../../engine/execution/GraphExecutionBackend.d.mts";
|
|
3
|
+
import type { GraphExecutionEngine } from "../../engine/execution/GraphExecutionEngine.d.mts";
|
|
4
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
5
|
+
import { type GraphEngineCapabilityManifest, type GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.mts";
|
|
6
|
+
/** DI token for {@link GraphEngineCapabilityOptions}. */
|
|
7
|
+
export declare const GRAPH_ENGINE_CAPABILITY_OPTIONS = "GRAPH_ENGINE_CAPABILITY_OPTIONS";
|
|
8
|
+
/** Rate-limit configuration for the engine capability routes: window and request cap. */
|
|
9
|
+
export interface GraphEngineRateLimitOptions {
|
|
10
|
+
windowMs?: number;
|
|
11
|
+
maxRequests?: number;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Default rate limit for the engine capability routes: 120 requests per 60-second
|
|
15
|
+
* window, applied by the `@nestjs/throttler` guard on the `engines` bucket.
|
|
16
|
+
*/
|
|
17
|
+
export declare const DEFAULT_GRAPH_ENGINE_RATE_LIMIT: Required<GraphEngineRateLimitOptions>;
|
|
18
|
+
/**
|
|
19
|
+
* Options for the engine capability HTTP API (SAA-193 C20/C21): authentication
|
|
20
|
+
* mode, the host-preferred default engine id, and the engine-route rate limit.
|
|
21
|
+
*/
|
|
22
|
+
export interface GraphEngineCapabilityOptions {
|
|
23
|
+
/**
|
|
24
|
+
* `"required"` (default) rejects a request with no request context, or with a
|
|
25
|
+
* context that carries no resolved owner user, with `401`, matching the other
|
|
26
|
+
* graph read routes; `"optional"` tolerates anonymous/system callers for
|
|
27
|
+
* standalone module runs.
|
|
28
|
+
*/
|
|
29
|
+
auth?: "required" | "optional";
|
|
30
|
+
/**
|
|
31
|
+
* Engine id the manifest advertises as the default. Ignored when it is not one of
|
|
32
|
+
* the registered, allowlisted engine ids; the current backend flavour is used
|
|
33
|
+
* instead.
|
|
34
|
+
*/
|
|
35
|
+
defaultEngineId?: string;
|
|
36
|
+
/** Rate limit for the engine capability routes (the `engines` throttler bucket). */
|
|
37
|
+
rateLimit?: GraphEngineRateLimitOptions;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Owns the boot-time capability manifest and resolves engine-scoped workflow
|
|
41
|
+
* listing/lookup. The manifest is built once in the constructor from the
|
|
42
|
+
* registered backends; request handling never mutates it and never probes a remote
|
|
43
|
+
* engine.
|
|
44
|
+
*/
|
|
45
|
+
export declare class GraphEngineCapabilityService {
|
|
46
|
+
private readonly engine?;
|
|
47
|
+
private readonly manifest;
|
|
48
|
+
private readonly engineIds;
|
|
49
|
+
/**
|
|
50
|
+
* @param options - Controller options (auth, default engine id, rate limit).
|
|
51
|
+
* @param engine - The engine facade resolving flavour-scoped listing/lookup.
|
|
52
|
+
*/
|
|
53
|
+
constructor(options?: GraphEngineCapabilityOptions, engine?: GraphExecutionEngine | undefined);
|
|
54
|
+
/**
|
|
55
|
+
* Returns a defensive copy of the statically-derived capability manifest.
|
|
56
|
+
*
|
|
57
|
+
* @returns The C20 capability manifest snapshot.
|
|
58
|
+
*/
|
|
59
|
+
manifestSnapshot(): GraphEngineCapabilityManifest;
|
|
60
|
+
/**
|
|
61
|
+
* Returns a defensive copy of a single allowlisted engine descriptor.
|
|
62
|
+
*
|
|
63
|
+
* @param engineId - The engine id to look up.
|
|
64
|
+
* @returns The engine descriptor, or `undefined` when not allowlisted.
|
|
65
|
+
*/
|
|
66
|
+
descriptor(engineId: string): GraphEngineDescriptor | undefined;
|
|
67
|
+
/**
|
|
68
|
+
* Whether the engine id is registered and allowlisted.
|
|
69
|
+
*
|
|
70
|
+
* @param engineId - The engine id to check.
|
|
71
|
+
* @returns `true` when the id is an available engine.
|
|
72
|
+
*/
|
|
73
|
+
isKnownEngine(engineId: string): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Lists the workflows a registered engine can surface through the engine-agnostic
|
|
76
|
+
* facade, which applies the fail-closed capability gate and the
|
|
77
|
+
* `GRAPH_BACKEND_WORKFLOWS_NOT_SUPPORTED` error code.
|
|
78
|
+
*
|
|
79
|
+
* @param engineId - The allowlisted engine id to list for.
|
|
80
|
+
* @param args - Optional decaf contextual arguments forwarded to the backend.
|
|
81
|
+
* @returns Workflow summaries.
|
|
82
|
+
* @throws {GraphExecutionError} when the engine declares no listing support.
|
|
83
|
+
*/
|
|
84
|
+
listWorkflows(engineId: string, ...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
|
|
85
|
+
/**
|
|
86
|
+
* Looks up a single canonical workflow document on a registered engine through
|
|
87
|
+
* the engine-agnostic facade.
|
|
88
|
+
*
|
|
89
|
+
* @param engineId - The allowlisted engine id to read from.
|
|
90
|
+
* @param workflowId - The canonical workflow id to read.
|
|
91
|
+
* @param args - Optional decaf contextual arguments forwarded to the backend.
|
|
92
|
+
* @returns The canonical workflow document.
|
|
93
|
+
* @throws {GraphExecutionError} when the engine declares no lookup support.
|
|
94
|
+
*/
|
|
95
|
+
getWorkflow(engineId: string, workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
96
|
+
/** Resolves the engine facade, failing closed when it is not wired. */
|
|
97
|
+
private requireEngine;
|
|
98
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { DecafRequestContext } from "@decaf-ts/for-nest";
|
|
2
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
|
|
3
|
+
import type { GraphEngineCapabilityManifest, GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.cts";
|
|
4
|
+
import { GraphEngineCapabilityService, type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.cts";
|
|
5
|
+
/** One row of the engine workflow list: the serving summary a list binds to. */
|
|
6
|
+
export interface GraphEngineWorkflowSummary {
|
|
7
|
+
/** Canonical workflow id. */
|
|
8
|
+
workflowId: string;
|
|
9
|
+
/** Display name mirrored from the document, when present. */
|
|
10
|
+
name?: string;
|
|
11
|
+
/** ISO timestamp of the last update, when the backend exposes one. */
|
|
12
|
+
updatedAt?: string;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Engine capability manifest and engine-scoped workflow catalogue endpoints:
|
|
16
|
+
*
|
|
17
|
+
* - `GET /graph/engines` — the C20 capability manifest for every available
|
|
18
|
+
* (registered, allowlisted) engine.
|
|
19
|
+
* - `GET /graph/engines/{engineId}` — one engine descriptor.
|
|
20
|
+
* - `GET /graph/engines/{engineId}/workflows` — the workflows that engine
|
|
21
|
+
* surfaces through the engine-agnostic facade.
|
|
22
|
+
* - `GET /graph/engines/{engineId}/workflows/{workflowId}` — one canonical
|
|
23
|
+
* workflow document from that engine.
|
|
24
|
+
*
|
|
25
|
+
* All routes are read-only `GET`s, select engines by allowlisted id only, and
|
|
26
|
+
* never reflect arbitrary query input.
|
|
27
|
+
*/
|
|
28
|
+
export declare class GraphEngineController {
|
|
29
|
+
private readonly capabilityService;
|
|
30
|
+
private readonly requestContext?;
|
|
31
|
+
private readonly options;
|
|
32
|
+
constructor(capabilityService: GraphEngineCapabilityService, requestContext?: DecafRequestContext | undefined, options?: GraphEngineCapabilityOptions);
|
|
33
|
+
/**
|
|
34
|
+
* Enforces the configured authentication mode: `auth` defaults to `"required"`
|
|
35
|
+
* and rejects a request with no request context, or with a context that carries
|
|
36
|
+
* no resolved owner user, with `401`; `"optional"` admits anonymous requests.
|
|
37
|
+
*/
|
|
38
|
+
private requireAuthenticatedContext;
|
|
39
|
+
private assertKnownEngine;
|
|
40
|
+
/**
|
|
41
|
+
* Returns the capability manifest for every available engine.
|
|
42
|
+
*
|
|
43
|
+
* @return {Promise<GraphEngineCapabilityManifest>} The C20 capability manifest.
|
|
44
|
+
* @throws {HttpException} 401 without an authenticated caller.
|
|
45
|
+
*/
|
|
46
|
+
getManifest(): Promise<GraphEngineCapabilityManifest>;
|
|
47
|
+
/**
|
|
48
|
+
* Returns one allowlisted engine's capability descriptor.
|
|
49
|
+
*
|
|
50
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
51
|
+
* @return {Promise<GraphEngineDescriptor>} The engine descriptor.
|
|
52
|
+
* @throws {HttpException} 404 when the engine id is not available.
|
|
53
|
+
*/
|
|
54
|
+
getEngine(engineId: string): Promise<GraphEngineDescriptor>;
|
|
55
|
+
/**
|
|
56
|
+
* Lists the workflows the selected engine surfaces through the
|
|
57
|
+
* engine-agnostic facade.
|
|
58
|
+
*
|
|
59
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
60
|
+
* @return {Promise<GraphEngineWorkflowSummary[]>} Workflow summaries.
|
|
61
|
+
* @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no listing support.
|
|
62
|
+
*/
|
|
63
|
+
listWorkflows(engineId: string): Promise<GraphEngineWorkflowSummary[]>;
|
|
64
|
+
/**
|
|
65
|
+
* Returns one canonical workflow document from the selected engine through the
|
|
66
|
+
* engine-agnostic facade.
|
|
67
|
+
*
|
|
68
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
69
|
+
* @param {string} workflowId - Canonical workflow id path parameter.
|
|
70
|
+
* @return {Promise<GraphWorkflowDocument>} The canonical workflow document.
|
|
71
|
+
* @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no lookup support.
|
|
72
|
+
*/
|
|
73
|
+
getWorkflow(engineId: string, workflowId: string): Promise<GraphWorkflowDocument>;
|
|
74
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { DecafRequestContext } from "@decaf-ts/for-nest";
|
|
2
|
+
import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
3
|
+
import type { GraphEngineCapabilityManifest, GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.mts";
|
|
4
|
+
import { GraphEngineCapabilityService, type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.mts";
|
|
5
|
+
/** One row of the engine workflow list: the serving summary a list binds to. */
|
|
6
|
+
export interface GraphEngineWorkflowSummary {
|
|
7
|
+
/** Canonical workflow id. */
|
|
8
|
+
workflowId: string;
|
|
9
|
+
/** Display name mirrored from the document, when present. */
|
|
10
|
+
name?: string;
|
|
11
|
+
/** ISO timestamp of the last update, when the backend exposes one. */
|
|
12
|
+
updatedAt?: string;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Engine capability manifest and engine-scoped workflow catalogue endpoints:
|
|
16
|
+
*
|
|
17
|
+
* - `GET /graph/engines` — the C20 capability manifest for every available
|
|
18
|
+
* (registered, allowlisted) engine.
|
|
19
|
+
* - `GET /graph/engines/{engineId}` — one engine descriptor.
|
|
20
|
+
* - `GET /graph/engines/{engineId}/workflows` — the workflows that engine
|
|
21
|
+
* surfaces through the engine-agnostic facade.
|
|
22
|
+
* - `GET /graph/engines/{engineId}/workflows/{workflowId}` — one canonical
|
|
23
|
+
* workflow document from that engine.
|
|
24
|
+
*
|
|
25
|
+
* All routes are read-only `GET`s, select engines by allowlisted id only, and
|
|
26
|
+
* never reflect arbitrary query input.
|
|
27
|
+
*/
|
|
28
|
+
export declare class GraphEngineController {
|
|
29
|
+
private readonly capabilityService;
|
|
30
|
+
private readonly requestContext?;
|
|
31
|
+
private readonly options;
|
|
32
|
+
constructor(capabilityService: GraphEngineCapabilityService, requestContext?: DecafRequestContext | undefined, options?: GraphEngineCapabilityOptions);
|
|
33
|
+
/**
|
|
34
|
+
* Enforces the configured authentication mode: `auth` defaults to `"required"`
|
|
35
|
+
* and rejects a request with no request context, or with a context that carries
|
|
36
|
+
* no resolved owner user, with `401`; `"optional"` admits anonymous requests.
|
|
37
|
+
*/
|
|
38
|
+
private requireAuthenticatedContext;
|
|
39
|
+
private assertKnownEngine;
|
|
40
|
+
/**
|
|
41
|
+
* Returns the capability manifest for every available engine.
|
|
42
|
+
*
|
|
43
|
+
* @return {Promise<GraphEngineCapabilityManifest>} The C20 capability manifest.
|
|
44
|
+
* @throws {HttpException} 401 without an authenticated caller.
|
|
45
|
+
*/
|
|
46
|
+
getManifest(): Promise<GraphEngineCapabilityManifest>;
|
|
47
|
+
/**
|
|
48
|
+
* Returns one allowlisted engine's capability descriptor.
|
|
49
|
+
*
|
|
50
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
51
|
+
* @return {Promise<GraphEngineDescriptor>} The engine descriptor.
|
|
52
|
+
* @throws {HttpException} 404 when the engine id is not available.
|
|
53
|
+
*/
|
|
54
|
+
getEngine(engineId: string): Promise<GraphEngineDescriptor>;
|
|
55
|
+
/**
|
|
56
|
+
* Lists the workflows the selected engine surfaces through the
|
|
57
|
+
* engine-agnostic facade.
|
|
58
|
+
*
|
|
59
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
60
|
+
* @return {Promise<GraphEngineWorkflowSummary[]>} Workflow summaries.
|
|
61
|
+
* @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no listing support.
|
|
62
|
+
*/
|
|
63
|
+
listWorkflows(engineId: string): Promise<GraphEngineWorkflowSummary[]>;
|
|
64
|
+
/**
|
|
65
|
+
* Returns one canonical workflow document from the selected engine through the
|
|
66
|
+
* engine-agnostic facade.
|
|
67
|
+
*
|
|
68
|
+
* @param {string} engineId - Allowlisted engine id path parameter.
|
|
69
|
+
* @param {string} workflowId - Canonical workflow id path parameter.
|
|
70
|
+
* @return {Promise<GraphWorkflowDocument>} The canonical workflow document.
|
|
71
|
+
* @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no lookup support.
|
|
72
|
+
*/
|
|
73
|
+
getWorkflow(engineId: string, workflowId: string): Promise<GraphWorkflowDocument>;
|
|
74
|
+
}
|
|
@@ -15,7 +15,9 @@ import { type GraphCredentialAuthorizer, type GraphNamespaceMatchOptions } from
|
|
|
15
15
|
import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.cts";
|
|
16
16
|
import { type GraphRunControllerOptions } from "./GraphRunController.d.cts";
|
|
17
17
|
import type { GraphWorkflowServiceOptions } from "../../engine/services/GraphEnvironment.d.cts";
|
|
18
|
+
import type { GraphRunServiceOptions } from "../../engine/runs/GraphRunService.d.cts";
|
|
18
19
|
import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.cts";
|
|
20
|
+
import { type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.cts";
|
|
19
21
|
/**
|
|
20
22
|
* Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
|
|
21
23
|
* plus per-API (catalogue, workflows, runs) authentication and limit
|
|
@@ -51,8 +53,19 @@ export interface GraphExecutionModuleOptions {
|
|
|
51
53
|
/**
|
|
52
54
|
* Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
|
|
53
55
|
* authentication enforcement and backend-enforced run resource limits.
|
|
56
|
+
* The service-level `allowAnonymousAccess` tolerance is supplied through the
|
|
57
|
+
* intersected {@link GraphRunServiceOptions} and forwarded to
|
|
58
|
+
* {@link GraphRunService}; it is intentionally not a controller option
|
|
59
|
+
* (SAA-93 F3).
|
|
54
60
|
*/
|
|
55
|
-
runs?: GraphRunControllerOptions;
|
|
61
|
+
runs?: GraphRunControllerOptions & GraphRunServiceOptions;
|
|
62
|
+
/**
|
|
63
|
+
* Options for the engine capability HTTP API (SAA-197, SAA-193 C20/C21):
|
|
64
|
+
* authentication mode, the advertised default engine id, and the engine-route
|
|
65
|
+
* rate limit. The capability manifest is derived statically at boot from the
|
|
66
|
+
* registered backends and never read from the environment or a remote engine.
|
|
67
|
+
*/
|
|
68
|
+
engines?: GraphEngineCapabilityOptions;
|
|
56
69
|
/**
|
|
57
70
|
* Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
|
|
58
71
|
* their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
|
|
@@ -15,7 +15,9 @@ import { type GraphCredentialAuthorizer, type GraphNamespaceMatchOptions } from
|
|
|
15
15
|
import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.mts";
|
|
16
16
|
import { type GraphRunControllerOptions } from "./GraphRunController.d.mts";
|
|
17
17
|
import type { GraphWorkflowServiceOptions } from "../../engine/services/GraphEnvironment.d.mts";
|
|
18
|
+
import type { GraphRunServiceOptions } from "../../engine/runs/GraphRunService.d.mts";
|
|
18
19
|
import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.mts";
|
|
20
|
+
import { type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.mts";
|
|
19
21
|
/**
|
|
20
22
|
* Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
|
|
21
23
|
* plus per-API (catalogue, workflows, runs) authentication and limit
|
|
@@ -51,8 +53,19 @@ export interface GraphExecutionModuleOptions {
|
|
|
51
53
|
/**
|
|
52
54
|
* Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
|
|
53
55
|
* authentication enforcement and backend-enforced run resource limits.
|
|
56
|
+
* The service-level `allowAnonymousAccess` tolerance is supplied through the
|
|
57
|
+
* intersected {@link GraphRunServiceOptions} and forwarded to
|
|
58
|
+
* {@link GraphRunService}; it is intentionally not a controller option
|
|
59
|
+
* (SAA-93 F3).
|
|
54
60
|
*/
|
|
55
|
-
runs?: GraphRunControllerOptions;
|
|
61
|
+
runs?: GraphRunControllerOptions & GraphRunServiceOptions;
|
|
62
|
+
/**
|
|
63
|
+
* Options for the engine capability HTTP API (SAA-197, SAA-193 C20/C21):
|
|
64
|
+
* authentication mode, the advertised default engine id, and the engine-route
|
|
65
|
+
* rate limit. The capability manifest is derived statically at boot from the
|
|
66
|
+
* registered backends and never read from the environment or a remote engine.
|
|
67
|
+
*/
|
|
68
|
+
engines?: GraphEngineCapabilityOptions;
|
|
56
69
|
/**
|
|
57
70
|
* Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
|
|
58
71
|
* their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
|
|
@@ -5,7 +5,8 @@
|
|
|
5
5
|
* (`GET /graph/runs/:runId`), cancels (`DELETE /graph/runs/:runId`), and
|
|
6
6
|
* replays (`SSE /graph/runs/:runId/events`) graph runs on top of
|
|
7
7
|
* {@link GraphRunService}, enforcing authentication, run limits, and
|
|
8
|
-
* ownership; engine errors surface as `500`
|
|
8
|
+
* ownership; unmapped engine errors surface as a constant generic `500`
|
|
9
|
+
* (the underlying error is logged server-side only) while Nest
|
|
9
10
|
* {@link HttpException}s pass through unchanged.
|
|
10
11
|
*/
|
|
11
12
|
import { MessageEvent } from "@nestjs/common";
|
|
@@ -15,38 +16,46 @@ import { DecafRequestContext } from "@decaf-ts/for-nest";
|
|
|
15
16
|
import type { GraphRunLimits } from "../../shared/graph/index.d.cts";
|
|
16
17
|
import type { GraphExecutionValues } from "../..//index.d.cts";
|
|
17
18
|
import { GraphRunService } from "../..//index.d.cts";
|
|
19
|
+
import { GraphWorkflowService } from "../../engine/services/GraphWorkflowService.d.cts";
|
|
18
20
|
/** DI token for {@link GraphRunControllerOptions}. */
|
|
19
21
|
export declare const GRAPH_RUN_OPTIONS = "GRAPH_RUN_OPTIONS";
|
|
20
22
|
/** Options for the run lifecycle HTTP API (DECAF-50 §4.14–§4.15): authentication mode and run limits. */
|
|
21
23
|
export interface GraphRunControllerOptions {
|
|
22
24
|
/**
|
|
23
25
|
* Whether an authenticated request context is required (default
|
|
24
|
-
* `"required"`, SAA-595 secure-defaults alignment). `"
|
|
25
|
-
*
|
|
26
|
-
*
|
|
26
|
+
* `"required"`, SAA-595 secure-defaults alignment). `"required"` rejects a
|
|
27
|
+
* request with no request context **and** a request whose context carries no
|
|
28
|
+
* resolved owner user with `401` (SAA-93 F2): in a host that installs the
|
|
29
|
+
* request-context machinery a context exists for every request, so gating on
|
|
30
|
+
* context existence alone would admit unauthenticated callers as anonymous.
|
|
31
|
+
* `"optional"` admits anonymous requests for standalone module runs
|
|
32
|
+
* (DECAF-48 §4.15) — pair it with an explicit `allowAnonymousAccess`
|
|
33
|
+
* decision on the run service options.
|
|
27
34
|
*/
|
|
28
35
|
auth?: "required" | "optional";
|
|
29
|
-
/**
|
|
30
|
-
* Explicit DECAF-48 §4.15 standalone tolerance: when `true`, anonymous
|
|
31
|
-
* callers are tolerated on owned runs. Defaults to `false` — ownership
|
|
32
|
-
* checks fail closed for absent identities (SAA-595 F3).
|
|
33
|
-
*/
|
|
34
|
-
allowAnonymousAccess?: boolean;
|
|
35
36
|
/** Run limits forwarded to {@link GraphRunService}. */
|
|
36
37
|
limits?: GraphRunLimits;
|
|
37
38
|
}
|
|
38
39
|
/** Response of `POST /graph/runs`: the queued run's identity and its event/result URLs. */
|
|
39
40
|
export interface GraphRunCreatedResponse {
|
|
41
|
+
/** Queued run's id. */
|
|
40
42
|
runId: string;
|
|
43
|
+
/** Id of the workflow the run executes. */
|
|
41
44
|
workflowId: string;
|
|
45
|
+
/** Constant `"queued"`: the run is scheduled, not yet started. */
|
|
42
46
|
status: "queued";
|
|
47
|
+
/** SSE stream URL for the run's event envelopes. */
|
|
43
48
|
eventsUrl: string;
|
|
49
|
+
/** Read URL for the run's lifecycle state. */
|
|
44
50
|
resultUrl: string;
|
|
45
51
|
}
|
|
46
52
|
/** Request body for creating a run: an inline workflow document or a saved `workflowId`, plus optional inputs. */
|
|
47
53
|
export interface GraphRunRequestBody {
|
|
54
|
+
/** Inline workflow document to execute, when not referencing a saved workflow. */
|
|
48
55
|
workflow?: GraphWorkflowDocument;
|
|
56
|
+
/** Saved workflow id to execute, when no inline document is provided. */
|
|
49
57
|
workflowId?: string;
|
|
58
|
+
/** Optional execution inputs forwarded to the run. */
|
|
50
59
|
inputs?: GraphExecutionValues;
|
|
51
60
|
}
|
|
52
61
|
/**
|
|
@@ -59,16 +68,24 @@ export interface GraphRunRequestBody {
|
|
|
59
68
|
*/
|
|
60
69
|
export declare class GraphRunController {
|
|
61
70
|
private readonly runService;
|
|
71
|
+
private readonly workflowService;
|
|
62
72
|
private readonly requestContext?;
|
|
63
73
|
private readonly options;
|
|
64
|
-
constructor(runService: GraphRunService, requestContext?: DecafRequestContext | undefined, options?: GraphRunControllerOptions);
|
|
74
|
+
constructor(runService: GraphRunService, workflowService: GraphWorkflowService, requestContext?: DecafRequestContext | undefined, options?: GraphRunControllerOptions);
|
|
65
75
|
/**
|
|
66
76
|
* Enforces the configured authentication mode: `auth` defaults to
|
|
67
|
-
* `"required"` (SAA-595 secure-defaults alignment) and rejects
|
|
68
|
-
*
|
|
69
|
-
*
|
|
77
|
+
* `"required"` (SAA-595 secure-defaults alignment) and rejects a request
|
|
78
|
+
* with no request context, or with a context that carries no resolved owner
|
|
79
|
+
* user, with `401` (SAA-93 F2); `"optional"` admits anonymous requests
|
|
80
|
+
* for standalone module runs (DECAF-48 §4.15).
|
|
70
81
|
*/
|
|
71
82
|
private requireAuthenticatedContext;
|
|
83
|
+
/**
|
|
84
|
+
* Resolves the requesting caller's identity from the injected request
|
|
85
|
+
* context via {@link graphWorkflowOwnerOf}; `null` for anonymous callers.
|
|
86
|
+
*
|
|
87
|
+
* @return {string | null} The authenticated owner user, or `null` when absent.
|
|
88
|
+
*/
|
|
72
89
|
private ownerUserOf;
|
|
73
90
|
/**
|
|
74
91
|
* Concurrency-bucket key for the per-caller run cap: the authenticated
|
|
@@ -87,9 +104,34 @@ export declare class GraphRunController {
|
|
|
87
104
|
* else a single shared anonymous bucket (SAA-595 F4, SAA-1950 F7).
|
|
88
105
|
*/
|
|
89
106
|
createRun(body: GraphRunRequestBody): Promise<GraphRunCreatedResponse>;
|
|
107
|
+
/**
|
|
108
|
+
* Lists a workflow's past runs, newest first (DECAF-50 §4.14).
|
|
109
|
+
*
|
|
110
|
+
* The workflow itself is access-checked first (unknown → `404`, foreign
|
|
111
|
+
* owner → `403`), then the persisted `GraphRunModel` rows for that workflow
|
|
112
|
+
* are ownership-filtered and returned as their JSON rows. Each row carries
|
|
113
|
+
* `runId`, `workflowId`, `owner`, `status`, `documentFingerprint`,
|
|
114
|
+
* `inputs`, `result`, `error`, `createdAt`, `updatedAt`, `startedAt` and
|
|
115
|
+
* `finishedAt` (dates as ISO strings; optional members are omitted when
|
|
116
|
+
* unset). The `inputs`/`result`/`error` payload members are served only
|
|
117
|
+
* for rows the caller owns (SAA-93 F1): a caller that may see an
|
|
118
|
+
* owner-less row by the documented owner-less visibility contract but does
|
|
119
|
+
* not own it receives the summary-only projection. Rows whose required
|
|
120
|
+
* dates cannot be projected are skipped per row (SAA-93 F4). Auth follows
|
|
121
|
+
* the controller's configured `auth` mode.
|
|
122
|
+
*
|
|
123
|
+
* @param {string} workflowId - Workflow id path parameter.
|
|
124
|
+
* @return {Promise<Array<Record<string, unknown>>>} The workflow's runs, newest first.
|
|
125
|
+
* @throws {HttpException} The mapped graph-run HTTP error (404 for unknown workflows/runs, 403 for foreign owners, 401 without an authenticated caller).
|
|
126
|
+
*/
|
|
127
|
+
listRuns(workflowId: string): Promise<Record<string, unknown>[]>;
|
|
90
128
|
/**
|
|
91
129
|
* Reads a run and maps it to its HTTP representation.
|
|
92
130
|
*
|
|
131
|
+
* The run's `result`/`error` payload is projected out for a caller that
|
|
132
|
+
* does not own the run (SAA-93 F1): the summary-only projection the list
|
|
133
|
+
* path applies cannot be bypassed by reading the run by id.
|
|
134
|
+
*
|
|
93
135
|
* @param {string} runId - Run id path parameter.
|
|
94
136
|
* @return {Promise<Record<string, unknown>>} The run's HTTP shape.
|
|
95
137
|
* @throws {HttpException} The mapped graph-run HTTP error (404 for unknown runs, 403 for foreign owners).
|
|
@@ -108,11 +150,24 @@ export declare class GraphRunController {
|
|
|
108
150
|
* `afterSequence`, then streams live events until the terminal event type
|
|
109
151
|
* completes the stream.
|
|
110
152
|
*
|
|
153
|
+
* SAA-93 F1: a caller that may see an owner-less run by the documented
|
|
154
|
+
* owner-less visibility contract but does not own it receives envelopes with
|
|
155
|
+
* the `payload`/`error` members projected out, matching the list and
|
|
156
|
+
* single-read projections.
|
|
157
|
+
*
|
|
111
158
|
* @param {string} runId - Run id path parameter.
|
|
112
159
|
* @param {string} [afterSequence] - Sequence number to replay events after.
|
|
113
160
|
* @return {Promise<Observable<MessageEvent>>} The SSE event stream.
|
|
114
161
|
* @throws {HttpException} The mapped graph-run HTTP error (404 for unknown runs, 403 for foreign owners).
|
|
115
162
|
*/
|
|
116
163
|
events(runId: string, afterSequence?: string): Promise<Observable<MessageEvent>>;
|
|
164
|
+
/**
|
|
165
|
+
* Parses the SSE replay cursor: `0` for absent/empty values, otherwise the
|
|
166
|
+
* parsed non-negative integer.
|
|
167
|
+
*
|
|
168
|
+
* @param {string | undefined} afterSequence - Raw `afterSequence` query parameter.
|
|
169
|
+
* @return {number} The sequence number to replay events after.
|
|
170
|
+
* @throws {HttpException} `400` when the value is not a non-negative integer.
|
|
171
|
+
*/
|
|
117
172
|
private parseAfterSequence;
|
|
118
173
|
}
|