@decaf-ts/as-graph 0.2.1 → 0.5.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 +274 -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/DagsterGraphQLClient.cjs +738 -0
- package/lib/cjs/dagster/DagsterGraphQLClient.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 +33 -0
- package/lib/cjs/dagster/index.cjs.map +1 -0
- package/lib/cjs/engine/constants.cjs +6 -1
- package/lib/cjs/engine/constants.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphCodeMode.cjs +137 -0
- package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionBackend.cjs +89 -0
- package/lib/cjs/engine/execution/GraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs +107 -0
- package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +250 -733
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +804 -0
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/engine/execution/index.cjs +4 -0
- package/lib/cjs/engine/execution/index.cjs.map +1 -1
- package/lib/cjs/engine/index.cjs +4 -0
- package/lib/cjs/engine/index.cjs.map +1 -1
- package/lib/cjs/engine/runs/GraphRunService.cjs +61 -0
- package/lib/cjs/engine/runs/GraphRunService.cjs.map +1 -1
- package/lib/cjs/engine/services/GraphWorkflowService.cjs +33 -14
- package/lib/cjs/engine/services/GraphWorkflowService.cjs.map +1 -1
- package/lib/cjs/mastra/MastraCapabilities.cjs +171 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -0
- package/lib/cjs/mastra/MastraConditionBridge.cjs +39 -0
- package/lib/cjs/mastra/MastraConditionBridge.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs +486 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -0
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +351 -0
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -0
- package/lib/cjs/mastra/MastraResumeGuard.cjs +127 -0
- package/lib/cjs/mastra/MastraResumeGuard.cjs.map +1 -0
- package/lib/cjs/mastra/MastraSchemaConverter.cjs +124 -0
- package/lib/cjs/mastra/MastraSchemaConverter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +461 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowManager.cjs +401 -0
- package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -0
- package/lib/cjs/mastra/index.cjs +35 -0
- package/lib/cjs/mastra/index.cjs.map +1 -0
- package/lib/cjs/mastra/types.cjs +34 -0
- package/lib/cjs/mastra/types.cjs.map +1 -0
- package/lib/cjs/nest/graph/GraphBackendHost.cjs +146 -0
- package/lib/cjs/nest/graph/GraphBackendHost.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 +31 -2
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
- package/lib/cjs/nest/graph/index.cjs +4 -0
- package/lib/cjs/nest/graph/index.cjs.map +1 -1
- package/lib/cjs/nest/graph/main.cjs +139 -0
- package/lib/cjs/nest/graph/main.cjs.map +1 -0
- package/lib/cjs/nest/graph/servingErrors.cjs +3 -0
- package/lib/cjs/nest/graph/servingErrors.cjs.map +1 -1
- package/lib/cjs/node/utility/code/node.cjs +11 -3
- package/lib/cjs/node/utility/code/node.cjs.map +1 -1
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +2 -3
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
- package/lib/cjs/shared/graph/constants.cjs +8 -0
- package/lib/cjs/shared/graph/constants.cjs.map +1 -1
- package/lib/cjs/shared/graph/index.cjs +2 -1
- package/lib/cjs/shared/graph/index.cjs.map +1 -1
- package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs +146 -0
- package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs.map +1 -0
- package/lib/cjs/shared/graph/layout/index.cjs +23 -0
- package/lib/cjs/shared/graph/layout/index.cjs.map +1 -0
- package/lib/cjs/shared/graph/layout/layout-options.cjs +93 -0
- package/lib/cjs/shared/graph/layout/layout-options.cjs.map +1 -0
- package/lib/cjs/shared/ui/index.cjs +8 -10
- package/lib/cjs/shared/ui/index.cjs.map +1 -1
- package/lib/esm/dagster/DagsterGraphEventBridge.js +339 -0
- package/lib/esm/dagster/DagsterGraphEventBridge.js.map +1 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js +781 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -0
- package/lib/esm/dagster/DagsterGraphQLClient.js +733 -0
- package/lib/esm/dagster/DagsterGraphQLClient.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 +16 -0
- package/lib/esm/dagster/index.js.map +1 -0
- package/lib/esm/engine/constants.js +5 -0
- package/lib/esm/engine/constants.js.map +1 -1
- package/lib/esm/engine/execution/GraphCodeMode.js +132 -0
- package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionBackend.js +83 -0
- package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js +102 -0
- package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionEngine.js +232 -716
- package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +799 -0
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -0
- package/lib/esm/engine/execution/index.js +4 -0
- package/lib/esm/engine/execution/index.js.map +1 -1
- package/lib/esm/engine/index.js +4 -0
- package/lib/esm/engine/index.js.map +1 -1
- package/lib/esm/engine/runs/GraphRunService.js +62 -1
- package/lib/esm/engine/runs/GraphRunService.js.map +1 -1
- package/lib/esm/engine/services/GraphWorkflowService.js +33 -14
- package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
- package/lib/esm/mastra/MastraCapabilities.js +164 -0
- package/lib/esm/mastra/MastraCapabilities.js.map +1 -0
- package/lib/esm/mastra/MastraConditionBridge.js +34 -0
- package/lib/esm/mastra/MastraConditionBridge.js.map +1 -0
- package/lib/esm/mastra/MastraEventBridge.js +481 -0
- package/lib/esm/mastra/MastraEventBridge.js.map +1 -0
- package/lib/esm/mastra/MastraGraphExecutionBackend.js +346 -0
- package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -0
- package/lib/esm/mastra/MastraResumeGuard.js +123 -0
- package/lib/esm/mastra/MastraResumeGuard.js.map +1 -0
- package/lib/esm/mastra/MastraSchemaConverter.js +119 -0
- package/lib/esm/mastra/MastraSchemaConverter.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js +456 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowManager.js +396 -0
- package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -0
- package/lib/esm/mastra/index.js +18 -0
- package/lib/esm/mastra/index.js.map +1 -0
- package/lib/esm/mastra/types.js +30 -0
- package/lib/esm/mastra/types.js.map +1 -0
- package/lib/esm/nest/graph/GraphBackendHost.js +138 -0
- package/lib/esm/nest/graph/GraphBackendHost.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 +31 -2
- package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
- package/lib/esm/nest/graph/index.js +4 -0
- package/lib/esm/nest/graph/index.js.map +1 -1
- package/lib/esm/nest/graph/main.js +103 -0
- package/lib/esm/nest/graph/main.js.map +1 -0
- package/lib/esm/nest/graph/servingErrors.js +3 -0
- package/lib/esm/nest/graph/servingErrors.js.map +1 -1
- package/lib/esm/node/utility/code/node.js +11 -3
- package/lib/esm/node/utility/code/node.js.map +1 -1
- package/lib/esm/shared/graph/GraphExecutionStateMapper.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +2 -3
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
- package/lib/esm/shared/graph/constants.js +8 -0
- package/lib/esm/shared/graph/constants.js.map +1 -1
- package/lib/esm/shared/graph/index.js +2 -1
- package/lib/esm/shared/graph/index.js.map +1 -1
- package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js +107 -0
- package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js.map +1 -0
- package/lib/esm/shared/graph/layout/index.js +6 -0
- package/lib/esm/shared/graph/layout/index.js.map +1 -0
- package/lib/esm/shared/graph/layout/layout-options.js +96 -0
- package/lib/esm/shared/graph/layout/layout-options.js.map +1 -0
- package/lib/esm/shared/ui/index.js +8 -10
- package/lib/esm/shared/ui/index.js.map +1 -1
- package/lib/types/dagster/DagsterGraphEventBridge.d.cts +142 -0
- package/lib/types/dagster/DagsterGraphEventBridge.d.mts +142 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +323 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +323 -0
- package/lib/types/dagster/DagsterGraphQLClient.d.cts +231 -0
- package/lib/types/dagster/DagsterGraphQLClient.d.mts +231 -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 +15 -0
- package/lib/types/dagster/index.d.mts +15 -0
- package/lib/types/engine/constants.d.cts +5 -0
- package/lib/types/engine/constants.d.mts +5 -0
- package/lib/types/engine/execution/GraphCodeMode.d.cts +52 -0
- package/lib/types/engine/execution/GraphCodeMode.d.mts +52 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.cts +306 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.mts +306 -0
- package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.cts +59 -0
- package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.mts +59 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -135
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -135
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +232 -0
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +232 -0
- package/lib/types/engine/execution/index.d.cts +4 -0
- package/lib/types/engine/execution/index.d.mts +4 -0
- package/lib/types/engine/index.d.cts +4 -0
- package/lib/types/engine/index.d.mts +4 -0
- package/lib/types/engine/runs/GraphRunService.d.cts +19 -0
- package/lib/types/engine/runs/GraphRunService.d.mts +19 -0
- package/lib/types/engine/services/GraphWorkflowService.d.cts +22 -0
- package/lib/types/engine/services/GraphWorkflowService.d.mts +22 -0
- package/lib/types/mastra/MastraCapabilities.d.cts +86 -0
- package/lib/types/mastra/MastraCapabilities.d.mts +86 -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/GraphBackendHost.d.cts +100 -0
- package/lib/types/nest/graph/GraphBackendHost.d.mts +100 -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 +20 -0
- package/lib/types/nest/graph/GraphExecutionModule.d.mts +20 -0
- package/lib/types/nest/graph/index.d.cts +4 -0
- package/lib/types/nest/graph/index.d.mts +4 -0
- package/lib/types/nest/graph/main.d.cts +1 -0
- package/lib/types/nest/graph/main.d.mts +1 -0
- package/lib/types/nest/graph/servingErrors.d.cts +3 -1
- package/lib/types/nest/graph/servingErrors.d.mts +3 -1
- package/lib/types/node/utility/code/node.d.cts +1 -1
- package/lib/types/node/utility/code/node.d.mts +1 -1
- package/lib/types/shared/graph/GraphExecutionStateMapper.d.cts +5 -5
- package/lib/types/shared/graph/GraphExecutionStateMapper.d.mts +5 -5
- package/lib/types/shared/graph/constants.d.cts +8 -0
- package/lib/types/shared/graph/constants.d.mts +8 -0
- package/lib/types/shared/graph/index.d.cts +2 -1
- package/lib/types/shared/graph/index.d.mts +2 -1
- package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.cts +49 -0
- package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.mts +49 -0
- package/lib/types/shared/graph/layout/index.d.cts +5 -0
- package/lib/types/shared/graph/layout/index.d.mts +5 -0
- package/lib/types/shared/graph/layout/layout-options.d.cts +46 -0
- package/lib/types/shared/graph/layout/layout-options.d.mts +46 -0
- package/lib/types/shared/graph/types.d.cts +4 -3
- package/lib/types/shared/graph/types.d.mts +4 -3
- package/lib/types/shared/ui/index.d.cts +8 -10
- package/lib/types/shared/ui/index.d.mts +8 -10
- package/package.json +55 -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
|
@@ -23,6 +23,13 @@ export declare function graphWorkflowOwnerOf(ctx: Context | undefined): string |
|
|
|
23
23
|
* (`allowAnonymousAccess`) is set for reads (SAA-595 F3). Overwriting an
|
|
24
24
|
* existing row is a write and is authorized by strict owner equality, so the
|
|
25
25
|
* read tolerance never grants an overwrite (SAA-105 R3).
|
|
26
|
+
*
|
|
27
|
+
* @remarks The overwrite gate is a read-then-write check, so it depends on the
|
|
28
|
+
* persistence adapter's contract (SAA-105 R3-b): `read` must throw
|
|
29
|
+
* `NotFoundError` for an absent row, and `create` must be create-only — it must
|
|
30
|
+
* reject a duplicate primary key rather than upsert. An adapter whose `create`
|
|
31
|
+
* upserts (or whose `read` hides an existing row) would let a named caller
|
|
32
|
+
* silently overwrite an owner-less row and bypass the owner-equality gate.
|
|
26
33
|
*/
|
|
27
34
|
export declare class GraphWorkflowService extends ModelService<GraphWorkflowModel> {
|
|
28
35
|
protected catalogue: GraphNodeCatalogue | undefined;
|
|
@@ -50,6 +57,10 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
|
|
|
50
57
|
* (SAA-105 R3): a named caller cannot overwrite an owner-less workflow and
|
|
51
58
|
* the `allowAnonymousAccess` read tolerance never grants an overwrite.
|
|
52
59
|
*
|
|
60
|
+
* @remarks Relies on the class-level adapter contract that `read` throws
|
|
61
|
+
* `NotFoundError` for an absent row and `create` rejects a duplicate primary
|
|
62
|
+
* key instead of upserting (SAA-105 R3-b).
|
|
63
|
+
*
|
|
53
64
|
* @param {string} workflowId - Workflow id from the request path.
|
|
54
65
|
* @param {GraphWorkflowDocument} document - Canonical document to persist (its `id` must equal `workflowId`).
|
|
55
66
|
* @param args - An optional decaf `Context` carrying the owning principal.
|
|
@@ -119,6 +130,10 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
|
|
|
119
130
|
* authorized by strict owner equality (SAA-105 R3) — see
|
|
120
131
|
* {@link saveDocument}.
|
|
121
132
|
*
|
|
133
|
+
* @remarks Relies on the class-level adapter contract that `read` throws
|
|
134
|
+
* `NotFoundError` for an absent row and `create` rejects a duplicate primary
|
|
135
|
+
* key instead of upserting (SAA-105 R3-b).
|
|
136
|
+
*
|
|
122
137
|
* @param {string} workflowId - Workflow id from the request path.
|
|
123
138
|
* @param {Record<string, unknown>} snapshot - JSON-safe canonical snapshot wrapper.
|
|
124
139
|
* @param args - An optional decaf `Context` carrying the owning principal.
|
|
@@ -135,6 +150,13 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
|
|
|
135
150
|
* @return {Promise<GraphWorkflowModel | null>} The workflow row, or `null` when it does not exist or ownership fails.
|
|
136
151
|
*/
|
|
137
152
|
loadSnapshot(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowModel | null>;
|
|
153
|
+
/**
|
|
154
|
+
* Existence probe for the owner-equality overwrite gate (SAA-105 R3-a): only a
|
|
155
|
+
* genuine absence (`NotFoundError`) resolves to `null`; every other read
|
|
156
|
+
* failure propagates so a transient store fault is never mistaken for absence
|
|
157
|
+
* and downgraded into an unconditional create.
|
|
158
|
+
*/
|
|
159
|
+
private readExistingForWrite;
|
|
138
160
|
/**
|
|
139
161
|
* Read-visibility guard for a persisted workflow record via the centralized
|
|
140
162
|
* {@link assertGraphResourceOwnership} check, honouring this service's
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraCapabilities
|
|
3
|
+
* @summary Exported Mastra capability table (SAA-196).
|
|
4
|
+
* @description The Mastra wrapper declares, per feature, whether the backend
|
|
5
|
+
* supports it natively, not at all, or only through an extension point. The
|
|
6
|
+
* table is exported alongside the engine-agnostic
|
|
7
|
+
* {@link GraphBackendCapabilities} projection (code-mode + workflow
|
|
8
|
+
* listing/lookup) so hosts and servers can surface honest limitations without
|
|
9
|
+
* probing the backend.
|
|
10
|
+
*/
|
|
11
|
+
import type { GraphBackendCapabilities, GraphBackendCapabilityStatus } from "../engine/execution/GraphExecutionBackend.d.cts";
|
|
12
|
+
/**
|
|
13
|
+
* Whether Mastra supports a feature natively, not at all, only partially, or
|
|
14
|
+
* exclusively through a declared extension point.
|
|
15
|
+
*/
|
|
16
|
+
export type MastraFeatureVerdict = "SUPPORTED" | "NOT-SUPPORTED" | "EXTENSION-POINT" | "PARTIAL";
|
|
17
|
+
/** A single row of the exported Mastra capability table (SAA-196). */
|
|
18
|
+
export interface MastraFeatureCapability {
|
|
19
|
+
/** The engine feature being described. */
|
|
20
|
+
feature: string;
|
|
21
|
+
/** The declared Mastra verdict for the feature. */
|
|
22
|
+
verdict: MastraFeatureVerdict;
|
|
23
|
+
/** Human-readable detail for the verdict. */
|
|
24
|
+
detail?: string;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* The exported Mastra capability table (SAA-196). Every row names a feature and
|
|
28
|
+
* whether Mastra supports it natively, not at all, or through a declared
|
|
29
|
+
* extension point. `parallel` and `pinning` are declared NOT-SUPPORTED, and
|
|
30
|
+
* code-mode conditions fail closed, so the wrapper fails loudly rather than
|
|
31
|
+
* silently degrading behaviour.
|
|
32
|
+
*/
|
|
33
|
+
export declare const MASTRA_FEATURE_CAPABILITIES: readonly MastraFeatureCapability[];
|
|
34
|
+
/**
|
|
35
|
+
* The three-valued management status a Mastra workflow-management capability row
|
|
36
|
+
* resolves to. Extends the engine-agnostic two-valued
|
|
37
|
+
* {@link GraphBackendCapabilityStatus} with the honest `extension_point` state.
|
|
38
|
+
*/
|
|
39
|
+
export type MastraWorkflowCapabilityStatus = GraphBackendCapabilityStatus | "extension_point";
|
|
40
|
+
/**
|
|
41
|
+
* The Mastra workflow-management capability projection (SAA-346): the real
|
|
42
|
+
* `@mastra/core` management operations the driver exposes, each resolved honestly
|
|
43
|
+
* from the exported feature table.
|
|
44
|
+
*/
|
|
45
|
+
export interface MastraWorkflowManagementCapabilities {
|
|
46
|
+
/** Create (register a translated canonical document) support. */
|
|
47
|
+
create: MastraWorkflowCapabilityStatus;
|
|
48
|
+
/** Update/edit (recompile and replace the registration) support. */
|
|
49
|
+
update: MastraWorkflowCapabilityStatus;
|
|
50
|
+
/** Delete (remove the registration) support. */
|
|
51
|
+
delete: MastraWorkflowCapabilityStatus;
|
|
52
|
+
/** Serialization (real `serializedStepGraph`) support. */
|
|
53
|
+
serialize: MastraWorkflowCapabilityStatus;
|
|
54
|
+
/** Persistence (real `addDynamicWorkflow`) support. */
|
|
55
|
+
persist: MastraWorkflowCapabilityStatus;
|
|
56
|
+
/** Native workflow versioning support. */
|
|
57
|
+
version: MastraWorkflowCapabilityStatus;
|
|
58
|
+
}
|
|
59
|
+
export interface MastraBackendCapabilities extends GraphBackendCapabilities {
|
|
60
|
+
/** Workflow list/lookup plus the management statuses. */
|
|
61
|
+
workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Resolves a feature row's three-valued management status from the exported
|
|
65
|
+
* table, mapping the wrapper's `SUPPORTED`/`NOT-SUPPORTED`/`EXTENSION-POINT`
|
|
66
|
+
* verdicts onto the projection's lowercase vocabulary.
|
|
67
|
+
*
|
|
68
|
+
* @param feature - The feature row name to resolve.
|
|
69
|
+
* @returns The three-valued management status.
|
|
70
|
+
*/
|
|
71
|
+
export declare function mastraCapabilityStatusOf(feature: string): MastraWorkflowCapabilityStatus;
|
|
72
|
+
/**
|
|
73
|
+
* Engine-agnostic capability projection of the Mastra backend: no in-process
|
|
74
|
+
* code execution, workflow list/lookup supported over the compiled-workflow cache,
|
|
75
|
+
* and the SAA-346 workflow-management statuses resolved from the exported table.
|
|
76
|
+
*
|
|
77
|
+
* @returns The {@link MastraBackendCapabilities} served by the Mastra backend.
|
|
78
|
+
*/
|
|
79
|
+
export declare function resolveMastraCapabilities(): MastraBackendCapabilities;
|
|
80
|
+
/**
|
|
81
|
+
* Looks up one capability row by feature name.
|
|
82
|
+
*
|
|
83
|
+
* @param feature - The engine feature name to look up.
|
|
84
|
+
* @returns The capability row, or `undefined` for an unknown feature.
|
|
85
|
+
*/
|
|
86
|
+
export declare function mastraCapabilityOf(feature: string): MastraFeatureCapability | undefined;
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraCapabilities
|
|
3
|
+
* @summary Exported Mastra capability table (SAA-196).
|
|
4
|
+
* @description The Mastra wrapper declares, per feature, whether the backend
|
|
5
|
+
* supports it natively, not at all, or only through an extension point. The
|
|
6
|
+
* table is exported alongside the engine-agnostic
|
|
7
|
+
* {@link GraphBackendCapabilities} projection (code-mode + workflow
|
|
8
|
+
* listing/lookup) so hosts and servers can surface honest limitations without
|
|
9
|
+
* probing the backend.
|
|
10
|
+
*/
|
|
11
|
+
import type { GraphBackendCapabilities, GraphBackendCapabilityStatus } from "../engine/execution/GraphExecutionBackend.d.mts";
|
|
12
|
+
/**
|
|
13
|
+
* Whether Mastra supports a feature natively, not at all, only partially, or
|
|
14
|
+
* exclusively through a declared extension point.
|
|
15
|
+
*/
|
|
16
|
+
export type MastraFeatureVerdict = "SUPPORTED" | "NOT-SUPPORTED" | "EXTENSION-POINT" | "PARTIAL";
|
|
17
|
+
/** A single row of the exported Mastra capability table (SAA-196). */
|
|
18
|
+
export interface MastraFeatureCapability {
|
|
19
|
+
/** The engine feature being described. */
|
|
20
|
+
feature: string;
|
|
21
|
+
/** The declared Mastra verdict for the feature. */
|
|
22
|
+
verdict: MastraFeatureVerdict;
|
|
23
|
+
/** Human-readable detail for the verdict. */
|
|
24
|
+
detail?: string;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* The exported Mastra capability table (SAA-196). Every row names a feature and
|
|
28
|
+
* whether Mastra supports it natively, not at all, or through a declared
|
|
29
|
+
* extension point. `parallel` and `pinning` are declared NOT-SUPPORTED, and
|
|
30
|
+
* code-mode conditions fail closed, so the wrapper fails loudly rather than
|
|
31
|
+
* silently degrading behaviour.
|
|
32
|
+
*/
|
|
33
|
+
export declare const MASTRA_FEATURE_CAPABILITIES: readonly MastraFeatureCapability[];
|
|
34
|
+
/**
|
|
35
|
+
* The three-valued management status a Mastra workflow-management capability row
|
|
36
|
+
* resolves to. Extends the engine-agnostic two-valued
|
|
37
|
+
* {@link GraphBackendCapabilityStatus} with the honest `extension_point` state.
|
|
38
|
+
*/
|
|
39
|
+
export type MastraWorkflowCapabilityStatus = GraphBackendCapabilityStatus | "extension_point";
|
|
40
|
+
/**
|
|
41
|
+
* The Mastra workflow-management capability projection (SAA-346): the real
|
|
42
|
+
* `@mastra/core` management operations the driver exposes, each resolved honestly
|
|
43
|
+
* from the exported feature table.
|
|
44
|
+
*/
|
|
45
|
+
export interface MastraWorkflowManagementCapabilities {
|
|
46
|
+
/** Create (register a translated canonical document) support. */
|
|
47
|
+
create: MastraWorkflowCapabilityStatus;
|
|
48
|
+
/** Update/edit (recompile and replace the registration) support. */
|
|
49
|
+
update: MastraWorkflowCapabilityStatus;
|
|
50
|
+
/** Delete (remove the registration) support. */
|
|
51
|
+
delete: MastraWorkflowCapabilityStatus;
|
|
52
|
+
/** Serialization (real `serializedStepGraph`) support. */
|
|
53
|
+
serialize: MastraWorkflowCapabilityStatus;
|
|
54
|
+
/** Persistence (real `addDynamicWorkflow`) support. */
|
|
55
|
+
persist: MastraWorkflowCapabilityStatus;
|
|
56
|
+
/** Native workflow versioning support. */
|
|
57
|
+
version: MastraWorkflowCapabilityStatus;
|
|
58
|
+
}
|
|
59
|
+
export interface MastraBackendCapabilities extends GraphBackendCapabilities {
|
|
60
|
+
/** Workflow list/lookup plus the management statuses. */
|
|
61
|
+
workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Resolves a feature row's three-valued management status from the exported
|
|
65
|
+
* table, mapping the wrapper's `SUPPORTED`/`NOT-SUPPORTED`/`EXTENSION-POINT`
|
|
66
|
+
* verdicts onto the projection's lowercase vocabulary.
|
|
67
|
+
*
|
|
68
|
+
* @param feature - The feature row name to resolve.
|
|
69
|
+
* @returns The three-valued management status.
|
|
70
|
+
*/
|
|
71
|
+
export declare function mastraCapabilityStatusOf(feature: string): MastraWorkflowCapabilityStatus;
|
|
72
|
+
/**
|
|
73
|
+
* Engine-agnostic capability projection of the Mastra backend: no in-process
|
|
74
|
+
* code execution, workflow list/lookup supported over the compiled-workflow cache,
|
|
75
|
+
* and the SAA-346 workflow-management statuses resolved from the exported table.
|
|
76
|
+
*
|
|
77
|
+
* @returns The {@link MastraBackendCapabilities} served by the Mastra backend.
|
|
78
|
+
*/
|
|
79
|
+
export declare function resolveMastraCapabilities(): MastraBackendCapabilities;
|
|
80
|
+
/**
|
|
81
|
+
* Looks up one capability row by feature name.
|
|
82
|
+
*
|
|
83
|
+
* @param feature - The engine feature name to look up.
|
|
84
|
+
* @returns The capability row, or `undefined` for an unknown feature.
|
|
85
|
+
*/
|
|
86
|
+
export declare function mastraCapabilityOf(feature: string): MastraFeatureCapability | undefined;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraConditionBridge
|
|
3
|
+
* @summary Bridge between canonical graph conditions and Mastra branch
|
|
4
|
+
* predicates (SAA-196).
|
|
5
|
+
* @description Mastra cannot represent code-mode conditions, so translation
|
|
6
|
+
* fails closed for them; every other canonical condition is wrapped into a
|
|
7
|
+
* synchronous predicate that delegates to the engine's shared condition
|
|
8
|
+
* evaluator, keeping branch semantics identical to the local backend.
|
|
9
|
+
*/
|
|
10
|
+
import type { Condition } from "../shared/graph/index.d.cts";
|
|
11
|
+
/** Arguments the Mastra runtime passes into a branch predicate. */
|
|
12
|
+
export interface MastraBranchPredicateArgs {
|
|
13
|
+
/** The step input data of the branch step. */
|
|
14
|
+
inputData?: unknown;
|
|
15
|
+
/** The workflow state available to the branch step. */
|
|
16
|
+
state?: unknown;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Guards that a flow-control node's condition is translatable by the Mastra
|
|
20
|
+
* backend: it must exist and must not be a code-mode condition.
|
|
21
|
+
*
|
|
22
|
+
* @param condition - The condition attached to the flow-control node.
|
|
23
|
+
* @param nodeId - The document node id used in error payloads.
|
|
24
|
+
* @returns Nothing; returns only when the condition is translatable.
|
|
25
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_UNSUPPORTED_KIND} when the
|
|
26
|
+
* condition is missing or is a code-mode condition.
|
|
27
|
+
*/
|
|
28
|
+
export declare function assertMastraConditionSupported(condition: Condition | undefined, nodeId: string): void;
|
|
29
|
+
/**
|
|
30
|
+
* Wraps a canonical condition into a synchronous Mastra branch predicate. The
|
|
31
|
+
* predicate receives the runtime's step arguments and evaluates the condition
|
|
32
|
+
* against the step input data, falling back to the workflow state.
|
|
33
|
+
*
|
|
34
|
+
* @param condition - The canonical condition to evaluate.
|
|
35
|
+
* @param label - Diagnostic label used in evaluation errors.
|
|
36
|
+
* @returns The synchronous predicate Mastra branch steps call.
|
|
37
|
+
*/
|
|
38
|
+
export declare function mastraConditionPredicate(condition: Condition, label: string): (args: MastraBranchPredicateArgs) => boolean;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraConditionBridge
|
|
3
|
+
* @summary Bridge between canonical graph conditions and Mastra branch
|
|
4
|
+
* predicates (SAA-196).
|
|
5
|
+
* @description Mastra cannot represent code-mode conditions, so translation
|
|
6
|
+
* fails closed for them; every other canonical condition is wrapped into a
|
|
7
|
+
* synchronous predicate that delegates to the engine's shared condition
|
|
8
|
+
* evaluator, keeping branch semantics identical to the local backend.
|
|
9
|
+
*/
|
|
10
|
+
import type { Condition } from "../shared/graph/index.d.mts";
|
|
11
|
+
/** Arguments the Mastra runtime passes into a branch predicate. */
|
|
12
|
+
export interface MastraBranchPredicateArgs {
|
|
13
|
+
/** The step input data of the branch step. */
|
|
14
|
+
inputData?: unknown;
|
|
15
|
+
/** The workflow state available to the branch step. */
|
|
16
|
+
state?: unknown;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Guards that a flow-control node's condition is translatable by the Mastra
|
|
20
|
+
* backend: it must exist and must not be a code-mode condition.
|
|
21
|
+
*
|
|
22
|
+
* @param condition - The condition attached to the flow-control node.
|
|
23
|
+
* @param nodeId - The document node id used in error payloads.
|
|
24
|
+
* @returns Nothing; returns only when the condition is translatable.
|
|
25
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_UNSUPPORTED_KIND} when the
|
|
26
|
+
* condition is missing or is a code-mode condition.
|
|
27
|
+
*/
|
|
28
|
+
export declare function assertMastraConditionSupported(condition: Condition | undefined, nodeId: string): void;
|
|
29
|
+
/**
|
|
30
|
+
* Wraps a canonical condition into a synchronous Mastra branch predicate. The
|
|
31
|
+
* predicate receives the runtime's step arguments and evaluates the condition
|
|
32
|
+
* against the step input data, falling back to the workflow state.
|
|
33
|
+
*
|
|
34
|
+
* @param condition - The canonical condition to evaluate.
|
|
35
|
+
* @param label - Diagnostic label used in evaluation errors.
|
|
36
|
+
* @returns The synchronous predicate Mastra branch steps call.
|
|
37
|
+
*/
|
|
38
|
+
export declare function mastraConditionPredicate(condition: Condition, label: string): (args: MastraBranchPredicateArgs) => boolean;
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraEventBridge
|
|
3
|
+
* @summary Bridges Mastra's `fullStream` events onto the facade event sink
|
|
4
|
+
* (SAA-196).
|
|
5
|
+
* @description The bridge consumes the async event stream a Mastra run emits,
|
|
6
|
+
* translates workflow/step/log lifecycle events into canonical
|
|
7
|
+
* {@link GraphExecutionEvent} emissions, and mirrors node/edge visual-state and
|
|
8
|
+
* routed edge values so the canvas renders a Mastra run exactly like a local
|
|
9
|
+
* one. Unrecognised events are ignored unless they look like log entries.
|
|
10
|
+
*/
|
|
11
|
+
import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.cts";
|
|
12
|
+
import type { GraphExecutionEventSink } from "../engine/execution/GraphExecutionBackend.d.cts";
|
|
13
|
+
/** Options a {@link MastraEventBridge} is created with. */
|
|
14
|
+
export interface MastraEventBridgeOptions {
|
|
15
|
+
/** The canonical run id the bridged events belong to. */
|
|
16
|
+
runId: string;
|
|
17
|
+
/** The parent run id, when the run is a nested execution. */
|
|
18
|
+
parentRunId?: string;
|
|
19
|
+
/** The canonical workflow id the bridged events belong to. */
|
|
20
|
+
workflowId: string;
|
|
21
|
+
/** The canonical document the Mastra workflow was compiled from. */
|
|
22
|
+
document: GraphWorkflowDocument;
|
|
23
|
+
/** The frame-aware facade event sink every event is emitted onto. */
|
|
24
|
+
sink: GraphExecutionEventSink;
|
|
25
|
+
/** The node path prefix events are reported under. */
|
|
26
|
+
path?: string[];
|
|
27
|
+
}
|
|
28
|
+
/** One raw Mastra `fullStream` event; shape is runtime-defined. */
|
|
29
|
+
export type MastraFullStreamEvent = Record<string, unknown>;
|
|
30
|
+
/**
|
|
31
|
+
* Translates Mastra `fullStream` events into canonical facade events. The
|
|
32
|
+
* bridge indexes the document's data edges by node endpoint so step results can
|
|
33
|
+
* be routed as edge values and step lifecycles can drive node/edge visual
|
|
34
|
+
* states. Log events (`log`, `writer`, `console`) are surfaced as
|
|
35
|
+
* `GRAPH_RUN_LOG` entries with a known log level.
|
|
36
|
+
*/
|
|
37
|
+
export declare class MastraEventBridge {
|
|
38
|
+
private readonly options;
|
|
39
|
+
/** Data edges leaving each node, keyed by source node id. */
|
|
40
|
+
private readonly outgoing;
|
|
41
|
+
/** Data edges entering each node, keyed by target node id. */
|
|
42
|
+
private readonly incoming;
|
|
43
|
+
/**
|
|
44
|
+
* Creates the bridge and indexes the document's node-scoped data edges.
|
|
45
|
+
*
|
|
46
|
+
* @param options - Run identity, document, and event sink options.
|
|
47
|
+
*/
|
|
48
|
+
constructor(options: MastraEventBridgeOptions);
|
|
49
|
+
/**
|
|
50
|
+
* Consumes a Mastra run's full event stream until it ends.
|
|
51
|
+
*
|
|
52
|
+
* @param stream - The async iterable of Mastra `fullStream` events.
|
|
53
|
+
* @returns Resolves when the stream is exhausted.
|
|
54
|
+
*/
|
|
55
|
+
attach(stream: AsyncIterable<MastraFullStreamEvent>): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* Translates one raw Mastra event and emits the matching canonical events.
|
|
58
|
+
* Unrecognised event types are ignored unless they look like log entries.
|
|
59
|
+
*
|
|
60
|
+
* @param event - The raw Mastra `fullStream` event.
|
|
61
|
+
* @returns Resolves once the derived events have been emitted.
|
|
62
|
+
*/
|
|
63
|
+
handle(event: MastraFullStreamEvent): Promise<void>;
|
|
64
|
+
/**
|
|
65
|
+
* Emits the node-started lifecycle, node visual state, and running edge
|
|
66
|
+
* states for the incoming data edges of a started step.
|
|
67
|
+
*
|
|
68
|
+
* @param event - The raw `workflow-step-start` event.
|
|
69
|
+
* @returns Resolves once the derived events have been emitted.
|
|
70
|
+
*/
|
|
71
|
+
private onStepStart;
|
|
72
|
+
/**
|
|
73
|
+
* Emits the step's incremental output as a node-output event.
|
|
74
|
+
*
|
|
75
|
+
* @param event - The raw `workflow-step-output` event.
|
|
76
|
+
* @returns Resolves once the derived events have been emitted.
|
|
77
|
+
*/
|
|
78
|
+
private onStepOutput;
|
|
79
|
+
/**
|
|
80
|
+
* Emits one loop-iteration progress event for a foreach/while step.
|
|
81
|
+
*
|
|
82
|
+
* @param event - The raw `workflow-step-progress` event.
|
|
83
|
+
* @returns Resolves once the derived events have been emitted.
|
|
84
|
+
*/
|
|
85
|
+
private onStepProgress;
|
|
86
|
+
/**
|
|
87
|
+
* Emits the terminal lifecycle of a finished step: failure, suspension
|
|
88
|
+
* block, or completion (including routed outgoing edge values).
|
|
89
|
+
*
|
|
90
|
+
* @param event - The raw `workflow-step-result` event.
|
|
91
|
+
* @returns Resolves once the derived events have been emitted.
|
|
92
|
+
*/
|
|
93
|
+
private onStepResult;
|
|
94
|
+
/**
|
|
95
|
+
* Emits the suspension state of a suspended step and the workflow-suspended
|
|
96
|
+
* event carrying Mastra's suspend payload.
|
|
97
|
+
*
|
|
98
|
+
* @param event - The raw `workflow-step-suspended` event.
|
|
99
|
+
* @returns Resolves once the derived events have been emitted.
|
|
100
|
+
*/
|
|
101
|
+
private onStepSuspended;
|
|
102
|
+
/**
|
|
103
|
+
* Emits the terminal workflow event: failed, cancelled, or completed with
|
|
104
|
+
* the final workflow result.
|
|
105
|
+
*
|
|
106
|
+
* @param event - The raw `workflow-finish` event.
|
|
107
|
+
* @returns Resolves once the derived events have been emitted.
|
|
108
|
+
*/
|
|
109
|
+
private onWorkflowFinish;
|
|
110
|
+
/**
|
|
111
|
+
* Emits a run-log entry for a bridged log event; unknown levels are dropped.
|
|
112
|
+
*
|
|
113
|
+
* @param event - The raw log/writer/console event.
|
|
114
|
+
* @returns Resolves once the log entry has been emitted.
|
|
115
|
+
*/
|
|
116
|
+
private onLog;
|
|
117
|
+
/**
|
|
118
|
+
* Heuristic check whether an unrecognised event is a log entry.
|
|
119
|
+
*
|
|
120
|
+
* @param event - The raw Mastra event.
|
|
121
|
+
* @returns `true` when the event carries a level and a message.
|
|
122
|
+
*/
|
|
123
|
+
private looksLikeLog;
|
|
124
|
+
/**
|
|
125
|
+
* Routes one finished node's output values along its outgoing data edges,
|
|
126
|
+
* emitting edge-value and edge-state events per routed edge.
|
|
127
|
+
*
|
|
128
|
+
* @param nodeId - The finished node id.
|
|
129
|
+
* @param output - The node's output record.
|
|
130
|
+
* @param path - The node path the events are reported under.
|
|
131
|
+
* @returns Resolves once the routed edge events have been emitted.
|
|
132
|
+
*/
|
|
133
|
+
private routeEdges;
|
|
134
|
+
/**
|
|
135
|
+
* Emits a node visual-state change for the bridged run.
|
|
136
|
+
*
|
|
137
|
+
* @param nodeId - The node whose state changed.
|
|
138
|
+
* @param state - The new visual state.
|
|
139
|
+
* @param path - The node path the event is reported under.
|
|
140
|
+
* @returns Resolves once the event has been emitted.
|
|
141
|
+
*/
|
|
142
|
+
private emitNodeState;
|
|
143
|
+
/**
|
|
144
|
+
* Emits an edge visual-state change for the bridged run.
|
|
145
|
+
*
|
|
146
|
+
* @param edge - The edge whose state changed.
|
|
147
|
+
* @param state - The new visual state.
|
|
148
|
+
* @param status - The execution status carried by the event.
|
|
149
|
+
* @returns Resolves once the event has been emitted.
|
|
150
|
+
*/
|
|
151
|
+
private emitEdgeState;
|
|
152
|
+
/**
|
|
153
|
+
* Maps a visual state to the execution status its event carries.
|
|
154
|
+
*
|
|
155
|
+
* @param state - The node visual state.
|
|
156
|
+
* @returns The matching execution status.
|
|
157
|
+
*/
|
|
158
|
+
private statusFor;
|
|
159
|
+
/**
|
|
160
|
+
* Resolves the Mastra step id of an event (the canonical node id).
|
|
161
|
+
*
|
|
162
|
+
* @param event - The raw Mastra event.
|
|
163
|
+
* @returns The step id, or `undefined` when the event has none.
|
|
164
|
+
*/
|
|
165
|
+
private stepId;
|
|
166
|
+
/**
|
|
167
|
+
* Extracts an event's payload record, tolerating missing or non-object
|
|
168
|
+
* payloads.
|
|
169
|
+
*
|
|
170
|
+
* @param event - The raw Mastra event.
|
|
171
|
+
* @returns The payload record, or an empty record.
|
|
172
|
+
*/
|
|
173
|
+
private payloadOf;
|
|
174
|
+
/**
|
|
175
|
+
* Normalises an arbitrary error into the canonical error payload shape.
|
|
176
|
+
*
|
|
177
|
+
* @param error - The thrown error or value.
|
|
178
|
+
* @returns The normalised name/message/code payload.
|
|
179
|
+
*/
|
|
180
|
+
private errorPayload;
|
|
181
|
+
/**
|
|
182
|
+
* Forwards one canonical event onto the configured facade event sink.
|
|
183
|
+
*
|
|
184
|
+
* @param partial - The event to emit (run identity fields are supplied by
|
|
185
|
+
* the sink's frame awareness).
|
|
186
|
+
* @returns Resolves once the sink accepted the event.
|
|
187
|
+
*/
|
|
188
|
+
private emit;
|
|
189
|
+
}
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraEventBridge
|
|
3
|
+
* @summary Bridges Mastra's `fullStream` events onto the facade event sink
|
|
4
|
+
* (SAA-196).
|
|
5
|
+
* @description The bridge consumes the async event stream a Mastra run emits,
|
|
6
|
+
* translates workflow/step/log lifecycle events into canonical
|
|
7
|
+
* {@link GraphExecutionEvent} emissions, and mirrors node/edge visual-state and
|
|
8
|
+
* routed edge values so the canvas renders a Mastra run exactly like a local
|
|
9
|
+
* one. Unrecognised events are ignored unless they look like log entries.
|
|
10
|
+
*/
|
|
11
|
+
import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.mts";
|
|
12
|
+
import type { GraphExecutionEventSink } from "../engine/execution/GraphExecutionBackend.d.mts";
|
|
13
|
+
/** Options a {@link MastraEventBridge} is created with. */
|
|
14
|
+
export interface MastraEventBridgeOptions {
|
|
15
|
+
/** The canonical run id the bridged events belong to. */
|
|
16
|
+
runId: string;
|
|
17
|
+
/** The parent run id, when the run is a nested execution. */
|
|
18
|
+
parentRunId?: string;
|
|
19
|
+
/** The canonical workflow id the bridged events belong to. */
|
|
20
|
+
workflowId: string;
|
|
21
|
+
/** The canonical document the Mastra workflow was compiled from. */
|
|
22
|
+
document: GraphWorkflowDocument;
|
|
23
|
+
/** The frame-aware facade event sink every event is emitted onto. */
|
|
24
|
+
sink: GraphExecutionEventSink;
|
|
25
|
+
/** The node path prefix events are reported under. */
|
|
26
|
+
path?: string[];
|
|
27
|
+
}
|
|
28
|
+
/** One raw Mastra `fullStream` event; shape is runtime-defined. */
|
|
29
|
+
export type MastraFullStreamEvent = Record<string, unknown>;
|
|
30
|
+
/**
|
|
31
|
+
* Translates Mastra `fullStream` events into canonical facade events. The
|
|
32
|
+
* bridge indexes the document's data edges by node endpoint so step results can
|
|
33
|
+
* be routed as edge values and step lifecycles can drive node/edge visual
|
|
34
|
+
* states. Log events (`log`, `writer`, `console`) are surfaced as
|
|
35
|
+
* `GRAPH_RUN_LOG` entries with a known log level.
|
|
36
|
+
*/
|
|
37
|
+
export declare class MastraEventBridge {
|
|
38
|
+
private readonly options;
|
|
39
|
+
/** Data edges leaving each node, keyed by source node id. */
|
|
40
|
+
private readonly outgoing;
|
|
41
|
+
/** Data edges entering each node, keyed by target node id. */
|
|
42
|
+
private readonly incoming;
|
|
43
|
+
/**
|
|
44
|
+
* Creates the bridge and indexes the document's node-scoped data edges.
|
|
45
|
+
*
|
|
46
|
+
* @param options - Run identity, document, and event sink options.
|
|
47
|
+
*/
|
|
48
|
+
constructor(options: MastraEventBridgeOptions);
|
|
49
|
+
/**
|
|
50
|
+
* Consumes a Mastra run's full event stream until it ends.
|
|
51
|
+
*
|
|
52
|
+
* @param stream - The async iterable of Mastra `fullStream` events.
|
|
53
|
+
* @returns Resolves when the stream is exhausted.
|
|
54
|
+
*/
|
|
55
|
+
attach(stream: AsyncIterable<MastraFullStreamEvent>): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* Translates one raw Mastra event and emits the matching canonical events.
|
|
58
|
+
* Unrecognised event types are ignored unless they look like log entries.
|
|
59
|
+
*
|
|
60
|
+
* @param event - The raw Mastra `fullStream` event.
|
|
61
|
+
* @returns Resolves once the derived events have been emitted.
|
|
62
|
+
*/
|
|
63
|
+
handle(event: MastraFullStreamEvent): Promise<void>;
|
|
64
|
+
/**
|
|
65
|
+
* Emits the node-started lifecycle, node visual state, and running edge
|
|
66
|
+
* states for the incoming data edges of a started step.
|
|
67
|
+
*
|
|
68
|
+
* @param event - The raw `workflow-step-start` event.
|
|
69
|
+
* @returns Resolves once the derived events have been emitted.
|
|
70
|
+
*/
|
|
71
|
+
private onStepStart;
|
|
72
|
+
/**
|
|
73
|
+
* Emits the step's incremental output as a node-output event.
|
|
74
|
+
*
|
|
75
|
+
* @param event - The raw `workflow-step-output` event.
|
|
76
|
+
* @returns Resolves once the derived events have been emitted.
|
|
77
|
+
*/
|
|
78
|
+
private onStepOutput;
|
|
79
|
+
/**
|
|
80
|
+
* Emits one loop-iteration progress event for a foreach/while step.
|
|
81
|
+
*
|
|
82
|
+
* @param event - The raw `workflow-step-progress` event.
|
|
83
|
+
* @returns Resolves once the derived events have been emitted.
|
|
84
|
+
*/
|
|
85
|
+
private onStepProgress;
|
|
86
|
+
/**
|
|
87
|
+
* Emits the terminal lifecycle of a finished step: failure, suspension
|
|
88
|
+
* block, or completion (including routed outgoing edge values).
|
|
89
|
+
*
|
|
90
|
+
* @param event - The raw `workflow-step-result` event.
|
|
91
|
+
* @returns Resolves once the derived events have been emitted.
|
|
92
|
+
*/
|
|
93
|
+
private onStepResult;
|
|
94
|
+
/**
|
|
95
|
+
* Emits the suspension state of a suspended step and the workflow-suspended
|
|
96
|
+
* event carrying Mastra's suspend payload.
|
|
97
|
+
*
|
|
98
|
+
* @param event - The raw `workflow-step-suspended` event.
|
|
99
|
+
* @returns Resolves once the derived events have been emitted.
|
|
100
|
+
*/
|
|
101
|
+
private onStepSuspended;
|
|
102
|
+
/**
|
|
103
|
+
* Emits the terminal workflow event: failed, cancelled, or completed with
|
|
104
|
+
* the final workflow result.
|
|
105
|
+
*
|
|
106
|
+
* @param event - The raw `workflow-finish` event.
|
|
107
|
+
* @returns Resolves once the derived events have been emitted.
|
|
108
|
+
*/
|
|
109
|
+
private onWorkflowFinish;
|
|
110
|
+
/**
|
|
111
|
+
* Emits a run-log entry for a bridged log event; unknown levels are dropped.
|
|
112
|
+
*
|
|
113
|
+
* @param event - The raw log/writer/console event.
|
|
114
|
+
* @returns Resolves once the log entry has been emitted.
|
|
115
|
+
*/
|
|
116
|
+
private onLog;
|
|
117
|
+
/**
|
|
118
|
+
* Heuristic check whether an unrecognised event is a log entry.
|
|
119
|
+
*
|
|
120
|
+
* @param event - The raw Mastra event.
|
|
121
|
+
* @returns `true` when the event carries a level and a message.
|
|
122
|
+
*/
|
|
123
|
+
private looksLikeLog;
|
|
124
|
+
/**
|
|
125
|
+
* Routes one finished node's output values along its outgoing data edges,
|
|
126
|
+
* emitting edge-value and edge-state events per routed edge.
|
|
127
|
+
*
|
|
128
|
+
* @param nodeId - The finished node id.
|
|
129
|
+
* @param output - The node's output record.
|
|
130
|
+
* @param path - The node path the events are reported under.
|
|
131
|
+
* @returns Resolves once the routed edge events have been emitted.
|
|
132
|
+
*/
|
|
133
|
+
private routeEdges;
|
|
134
|
+
/**
|
|
135
|
+
* Emits a node visual-state change for the bridged run.
|
|
136
|
+
*
|
|
137
|
+
* @param nodeId - The node whose state changed.
|
|
138
|
+
* @param state - The new visual state.
|
|
139
|
+
* @param path - The node path the event is reported under.
|
|
140
|
+
* @returns Resolves once the event has been emitted.
|
|
141
|
+
*/
|
|
142
|
+
private emitNodeState;
|
|
143
|
+
/**
|
|
144
|
+
* Emits an edge visual-state change for the bridged run.
|
|
145
|
+
*
|
|
146
|
+
* @param edge - The edge whose state changed.
|
|
147
|
+
* @param state - The new visual state.
|
|
148
|
+
* @param status - The execution status carried by the event.
|
|
149
|
+
* @returns Resolves once the event has been emitted.
|
|
150
|
+
*/
|
|
151
|
+
private emitEdgeState;
|
|
152
|
+
/**
|
|
153
|
+
* Maps a visual state to the execution status its event carries.
|
|
154
|
+
*
|
|
155
|
+
* @param state - The node visual state.
|
|
156
|
+
* @returns The matching execution status.
|
|
157
|
+
*/
|
|
158
|
+
private statusFor;
|
|
159
|
+
/**
|
|
160
|
+
* Resolves the Mastra step id of an event (the canonical node id).
|
|
161
|
+
*
|
|
162
|
+
* @param event - The raw Mastra event.
|
|
163
|
+
* @returns The step id, or `undefined` when the event has none.
|
|
164
|
+
*/
|
|
165
|
+
private stepId;
|
|
166
|
+
/**
|
|
167
|
+
* Extracts an event's payload record, tolerating missing or non-object
|
|
168
|
+
* payloads.
|
|
169
|
+
*
|
|
170
|
+
* @param event - The raw Mastra event.
|
|
171
|
+
* @returns The payload record, or an empty record.
|
|
172
|
+
*/
|
|
173
|
+
private payloadOf;
|
|
174
|
+
/**
|
|
175
|
+
* Normalises an arbitrary error into the canonical error payload shape.
|
|
176
|
+
*
|
|
177
|
+
* @param error - The thrown error or value.
|
|
178
|
+
* @returns The normalised name/message/code payload.
|
|
179
|
+
*/
|
|
180
|
+
private errorPayload;
|
|
181
|
+
/**
|
|
182
|
+
* Forwards one canonical event onto the configured facade event sink.
|
|
183
|
+
*
|
|
184
|
+
* @param partial - The event to emit (run identity fields are supplied by
|
|
185
|
+
* the sink's frame awareness).
|
|
186
|
+
* @returns Resolves once the sink accepted the event.
|
|
187
|
+
*/
|
|
188
|
+
private emit;
|
|
189
|
+
}
|