@decaf-ts/as-graph 0.6.0 → 0.7.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 +776 -26
- package/assets/i18n/en.json +2527 -32
- 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/engine/auth/GraphAuthValidator.cjs +19 -0
- package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
- package/lib/cjs/engine/constants.cjs +61 -1
- package/lib/cjs/engine/constants.cjs.map +1 -1
- package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
- package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +228 -67
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
- package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
- package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +53 -1
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/engine/execution/index.cjs +1 -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/store/GraphDataTableModel.cjs +76 -0
- package/lib/cjs/engine/store/GraphDataTableModel.cjs.map +1 -0
- package/lib/cjs/engine/store/GraphDataTableRepository.cjs +324 -0
- package/lib/cjs/engine/store/GraphDataTableRepository.cjs.map +1 -0
- package/lib/cjs/engine/store/index.cjs +2 -0
- package/lib/cjs/engine/store/index.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs +28 -0
- package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs +4 -2
- package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphParameterValidator.cjs +6 -0
- package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
- package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
- package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
- package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
- package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
- package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
- package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
- package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
- package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
- package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
- package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +240 -22
- package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -1
- package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
- package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
- package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs +21 -1
- package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +414 -19
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
- package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
- package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
- package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
- package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMemory.cjs +467 -0
- package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
- package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
- package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
- package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
- package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
- package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
- package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraObservability.cjs +335 -0
- package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
- package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
- package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
- package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
- package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
- package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
- package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
- package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
- package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
- package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
- package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
- package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
- package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
- package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
- package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
- package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
- package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
- package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +38 -6
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
- package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
- package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
- package/lib/cjs/mastra/index.cjs +40 -1
- package/lib/cjs/mastra/index.cjs.map +1 -1
- package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
- package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
- package/lib/cjs/mastra/nodes/index.cjs +29 -0
- package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
- package/lib/cjs/mastra/nodes/types.cjs +4 -0
- package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
- package/lib/cjs/mastra/types.cjs +126 -1
- package/lib/cjs/mastra/types.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphBackendHost.cjs +12 -4
- package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs +35 -1
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphRunController.cjs +47 -6
- package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
- package/lib/cjs/nest/graph/main.cjs +83 -1
- package/lib/cjs/nest/graph/main.cjs.map +1 -1
- package/lib/cjs/node/agents/agent/node.cjs +189 -31
- package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
- package/lib/cjs/node/agents/hitl/node.cjs +115 -0
- package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
- package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
- package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
- package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
- package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
- package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
- package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
- package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
- package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
- package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
- package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/types.cjs +68 -0
- package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
- package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
- package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
- package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
- package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
- package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
- package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
- package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
- package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
- package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
- package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
- package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
- package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
- package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
- package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
- package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
- package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
- package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
- package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
- package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
- package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
- package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
- package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
- package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/agents/voice/node.cjs +107 -0
- package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
- package/lib/cjs/node/agents/zones.cjs +43 -0
- package/lib/cjs/node/agents/zones.cjs.map +1 -0
- package/lib/cjs/node/comms/email-send/node.cjs +340 -0
- package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
- package/lib/cjs/node/comms/gmail/node.cjs +287 -0
- package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
- package/lib/cjs/node/comms/slack/node.cjs +276 -0
- package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
- package/lib/cjs/node/comms/teams/node.cjs +231 -0
- package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
- package/lib/cjs/node/comms/telegram/node.cjs +260 -0
- package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/credentials.cjs +103 -0
- package/lib/cjs/node/credentials.cjs.map +1 -0
- package/lib/cjs/node/data/data-table/node.cjs +265 -0
- package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
- package/lib/cjs/node/data/date-time/node.cjs +180 -0
- package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
- package/lib/cjs/node/data/filter/node.cjs +134 -0
- package/lib/cjs/node/data/filter/node.cjs.map +1 -0
- package/lib/cjs/node/data/limit/node.cjs +104 -0
- package/lib/cjs/node/data/limit/node.cjs.map +1 -0
- package/lib/cjs/node/data/merge/node.cjs +251 -0
- package/lib/cjs/node/data/merge/node.cjs.map +1 -0
- package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
- package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
- package/lib/cjs/node/data/set/node.cjs +148 -0
- package/lib/cjs/node/data/set/node.cjs.map +1 -0
- package/lib/cjs/node/data/sort/node.cjs +125 -0
- package/lib/cjs/node/data/sort/node.cjs.map +1 -0
- package/lib/cjs/node/data/split-out/node.cjs +140 -0
- package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
- package/lib/cjs/node/data/support.cjs +398 -0
- package/lib/cjs/node/data/support.cjs.map +1 -0
- package/lib/cjs/node/devops/crypto/node.cjs +364 -0
- package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
- package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
- package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
- package/lib/cjs/node/devops/ftp/node.cjs +241 -0
- package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
- package/lib/cjs/node/devops/github/node.cjs +282 -0
- package/lib/cjs/node/devops/github/node.cjs.map +1 -0
- package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
- package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
- package/lib/cjs/node/devops/jwt/node.cjs +204 -0
- package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
- package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
- package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
- package/lib/cjs/node/index.cjs +402 -66
- package/lib/cjs/node/index.cjs.map +1 -1
- package/lib/cjs/node/io/airtable/node.cjs +318 -0
- package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
- package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
- package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
- package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
- package/lib/cjs/node/io/graphql/node.cjs +169 -0
- package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
- package/lib/cjs/node/io/http-request/node.cjs +415 -0
- package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
- package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
- package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
- package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
- package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
- package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
- package/lib/cjs/node/manifests.cjs +264 -36
- package/lib/cjs/node/manifests.cjs.map +1 -1
- package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
- package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/base.cjs +321 -0
- package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
- package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
- package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/base.cjs +301 -0
- package/lib/cjs/node/storage/database/base.cjs.map +1 -0
- package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
- package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
- package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
- package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
- package/lib/cjs/node/storage/redis/node.cjs +340 -0
- package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
- package/lib/cjs/node/storage/support.cjs +81 -0
- package/lib/cjs/node/storage/support.cjs.map +1 -0
- package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
- package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
- package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
- package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/GraphNodeModel.cjs +4 -0
- package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
- package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
- package/lib/cjs/shared/graph/category-styles.cjs +12 -0
- package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
- package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
- package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
- package/lib/cjs/typeorm/index.cjs +29 -0
- package/lib/cjs/typeorm/index.cjs.map +1 -0
- package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
- package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
- package/lib/esm/engine/constants.js +60 -0
- package/lib/esm/engine/constants.js.map +1 -1
- package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
- package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionEngine.js +229 -68
- package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
- package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
- package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
- package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
- package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +54 -2
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
- package/lib/esm/engine/execution/index.js +1 -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/store/GraphDataTableModel.js +67 -0
- package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
- package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
- package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
- package/lib/esm/engine/store/index.js +2 -0
- package/lib/esm/engine/store/index.js.map +1 -1
- package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
- package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
- package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
- package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
- package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
- package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
- package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
- package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
- package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
- package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
- package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
- package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
- package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
- package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
- package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
- package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraCapabilities.js +115 -0
- package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
- package/lib/esm/mastra/MastraChannelResponse.js +154 -0
- package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
- package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
- package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraDefaultStepHandlers.js +240 -22
- package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -1
- package/lib/esm/mastra/MastraEnvironment.js +287 -0
- package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
- package/lib/esm/mastra/MastraEvalModels.js +535 -0
- package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
- package/lib/esm/mastra/MastraEventBridge.js +21 -1
- package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
- package/lib/esm/mastra/MastraGraphExecutionBackend.js +414 -19
- package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
- package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
- package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
- package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
- package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
- package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraMemory.js +455 -0
- package/lib/esm/mastra/MastraMemory.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
- package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
- package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsModels.js +486 -0
- package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
- package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
- package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
- package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
- package/lib/esm/mastra/MastraObservability.js +327 -0
- package/lib/esm/mastra/MastraObservability.js.map +1 -0
- package/lib/esm/mastra/MastraPersistence.js +530 -0
- package/lib/esm/mastra/MastraPersistence.js.map +1 -0
- package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
- package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
- package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
- package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
- package/lib/esm/mastra/MastraRunRecovery.js +89 -0
- package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
- package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
- package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraStorageWiring.js +119 -0
- package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
- package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
- package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
- package/lib/esm/mastra/MastraToolBuilder.js +68 -0
- package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
- package/lib/esm/mastra/MastraToolConfig.js +37 -0
- package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
- package/lib/esm/mastra/MastraToolDecorator.js +92 -0
- package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
- package/lib/esm/mastra/MastraVectorStore.js +605 -0
- package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
- package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
- package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js +38 -6
- package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
- package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
- package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
- package/lib/esm/mastra/index.js +40 -1
- package/lib/esm/mastra/index.js.map +1 -1
- package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
- package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
- package/lib/esm/mastra/nodes/index.js +12 -0
- package/lib/esm/mastra/nodes/index.js.map +1 -0
- package/lib/esm/mastra/nodes/types.js +2 -0
- package/lib/esm/mastra/nodes/types.js.map +1 -0
- package/lib/esm/mastra/types.js +125 -0
- package/lib/esm/mastra/types.js.map +1 -1
- package/lib/esm/nest/graph/GraphBackendHost.js +10 -2
- package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
- package/lib/esm/nest/graph/GraphExecutionModule.js +35 -1
- package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
- package/lib/esm/nest/graph/GraphRunController.js +47 -6
- package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
- package/lib/esm/nest/graph/main.js +83 -1
- package/lib/esm/nest/graph/main.js.map +1 -1
- package/lib/esm/node/agents/agent/node.js +189 -31
- package/lib/esm/node/agents/agent/node.js.map +1 -1
- package/lib/esm/node/agents/hitl/node.js +106 -0
- package/lib/esm/node/agents/hitl/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
- package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/hook/node.js +111 -0
- package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
- package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
- package/lib/esm/node/agents/memory/memory/node.js +222 -0
- package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
- package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
- package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
- package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
- package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
- package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
- package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
- package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
- package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
- package/lib/esm/node/agents/processors/types.js +64 -0
- package/lib/esm/node/agents/processors/types.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
- package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
- package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
- package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chunking/node.js +211 -0
- package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
- package/lib/esm/node/agents/rag/embedding/node.js +101 -0
- package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
- package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
- package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
- package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
- package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
- package/lib/esm/node/agents/rag/rerank/node.js +103 -0
- package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
- package/lib/esm/node/agents/rag/retriever/node.js +111 -0
- package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
- package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
- package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
- package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
- package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
- package/lib/esm/node/agents/responses/discord/node.js +92 -0
- package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
- package/lib/esm/node/agents/responses/slack/node.js +92 -0
- package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
- package/lib/esm/node/agents/responses/teams/node.js +92 -0
- package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
- package/lib/esm/node/agents/responses/telegram/node.js +92 -0
- package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
- package/lib/esm/node/agents/sandbox/node.js +125 -0
- package/lib/esm/node/agents/sandbox/node.js.map +1 -0
- package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
- package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
- package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
- package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
- package/lib/esm/node/agents/skills/skill/node.js +96 -0
- package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
- package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
- package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
- package/lib/esm/node/agents/tools/tool/node.js +91 -0
- package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
- package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
- package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/discord/node.js +92 -0
- package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
- package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/slack/node.js +92 -0
- package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/teams/node.js +92 -0
- package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
- package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
- package/lib/esm/node/agents/voice/node.js +98 -0
- package/lib/esm/node/agents/voice/node.js.map +1 -0
- package/lib/esm/node/agents/zones.js +39 -0
- package/lib/esm/node/agents/zones.js.map +1 -0
- package/lib/esm/node/comms/email-send/node.js +331 -0
- package/lib/esm/node/comms/email-send/node.js.map +1 -0
- package/lib/esm/node/comms/gmail/node.js +278 -0
- package/lib/esm/node/comms/gmail/node.js.map +1 -0
- package/lib/esm/node/comms/slack/node.js +267 -0
- package/lib/esm/node/comms/slack/node.js.map +1 -0
- package/lib/esm/node/comms/teams/node.js +222 -0
- package/lib/esm/node/comms/teams/node.js.map +1 -0
- package/lib/esm/node/comms/telegram/node.js +251 -0
- package/lib/esm/node/comms/telegram/node.js.map +1 -0
- package/lib/esm/node/credentials.js +96 -0
- package/lib/esm/node/credentials.js.map +1 -0
- package/lib/esm/node/data/data-table/node.js +256 -0
- package/lib/esm/node/data/data-table/node.js.map +1 -0
- package/lib/esm/node/data/date-time/node.js +171 -0
- package/lib/esm/node/data/date-time/node.js.map +1 -0
- package/lib/esm/node/data/filter/node.js +125 -0
- package/lib/esm/node/data/filter/node.js.map +1 -0
- package/lib/esm/node/data/limit/node.js +95 -0
- package/lib/esm/node/data/limit/node.js.map +1 -0
- package/lib/esm/node/data/merge/node.js +242 -0
- package/lib/esm/node/data/merge/node.js.map +1 -0
- package/lib/esm/node/data/rename-keys/node.js +130 -0
- package/lib/esm/node/data/rename-keys/node.js.map +1 -0
- package/lib/esm/node/data/set/node.js +139 -0
- package/lib/esm/node/data/set/node.js.map +1 -0
- package/lib/esm/node/data/sort/node.js +116 -0
- package/lib/esm/node/data/sort/node.js.map +1 -0
- package/lib/esm/node/data/split-out/node.js +131 -0
- package/lib/esm/node/data/split-out/node.js.map +1 -0
- package/lib/esm/node/data/support.js +382 -0
- package/lib/esm/node/data/support.js.map +1 -0
- package/lib/esm/node/devops/crypto/node.js +355 -0
- package/lib/esm/node/devops/crypto/node.js.map +1 -0
- package/lib/esm/node/devops/execute-command/node.js +192 -0
- package/lib/esm/node/devops/execute-command/node.js.map +1 -0
- package/lib/esm/node/devops/ftp/node.js +232 -0
- package/lib/esm/node/devops/ftp/node.js.map +1 -0
- package/lib/esm/node/devops/github/node.js +273 -0
- package/lib/esm/node/devops/github/node.js.map +1 -0
- package/lib/esm/node/devops/gitlab/node.js +264 -0
- package/lib/esm/node/devops/gitlab/node.js.map +1 -0
- package/lib/esm/node/devops/jwt/node.js +195 -0
- package/lib/esm/node/devops/jwt/node.js.map +1 -0
- package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
- package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
- package/lib/esm/node/index.js +338 -2
- package/lib/esm/node/index.js.map +1 -1
- package/lib/esm/node/io/airtable/node.js +309 -0
- package/lib/esm/node/io/airtable/node.js.map +1 -0
- package/lib/esm/node/io/extract-from-file/node.js +260 -0
- package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
- package/lib/esm/node/io/google-sheets/node.js +258 -0
- package/lib/esm/node/io/google-sheets/node.js.map +1 -0
- package/lib/esm/node/io/graphql/node.js +160 -0
- package/lib/esm/node/io/graphql/node.js.map +1 -0
- package/lib/esm/node/io/http-request/node.js +406 -0
- package/lib/esm/node/io/http-request/node.js.map +1 -0
- package/lib/esm/node/io/read-pdf/node.js +164 -0
- package/lib/esm/node/io/read-pdf/node.js.map +1 -0
- package/lib/esm/node/io/read-write-file/node.js +305 -0
- package/lib/esm/node/io/read-write-file/node.js.map +1 -0
- package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
- package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
- package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
- package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
- package/lib/esm/node/manifests.js +228 -0
- package/lib/esm/node/manifests.js.map +1 -1
- package/lib/esm/node/storage/blob/azure/node.js +129 -0
- package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
- package/lib/esm/node/storage/blob/base.js +311 -0
- package/lib/esm/node/storage/blob/base.js.map +1 -0
- package/lib/esm/node/storage/blob/gcs/node.js +117 -0
- package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
- package/lib/esm/node/storage/blob/s3/node.js +176 -0
- package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
- package/lib/esm/node/storage/database/base.js +291 -0
- package/lib/esm/node/storage/database/base.js.map +1 -0
- package/lib/esm/node/storage/database/mssql/node.js +42 -0
- package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
- package/lib/esm/node/storage/database/mysql/node.js +42 -0
- package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
- package/lib/esm/node/storage/database/postgres/node.js +42 -0
- package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
- package/lib/esm/node/storage/redis/node.js +331 -0
- package/lib/esm/node/storage/redis/node.js.map +1 -0
- package/lib/esm/node/storage/support.js +69 -0
- package/lib/esm/node/storage/support.js.map +1 -0
- package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
- package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
- package/lib/esm/ram/GraphRunEventModel.js +5 -1
- package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
- package/lib/esm/shared/graph/GraphNodeModel.js +5 -1
- package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -1
- package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
- package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
- package/lib/esm/shared/graph/category-styles.js +12 -0
- package/lib/esm/shared/graph/category-styles.js.map +1 -1
- package/lib/esm/shared/graph/constants.js.map +1 -1
- package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
- package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
- package/lib/esm/typeorm/index.js +12 -0
- package/lib/esm/typeorm/index.js.map +1 -0
- package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
- package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
- package/lib/types/engine/constants.d.cts +60 -0
- package/lib/types/engine/constants.d.mts +60 -0
- package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
- package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +88 -1
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +88 -1
- package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
- package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
- package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
- package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +12 -3
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +12 -3
- package/lib/types/engine/execution/index.d.cts +1 -0
- package/lib/types/engine/execution/index.d.mts +1 -0
- package/lib/types/engine/index.d.cts +4 -0
- package/lib/types/engine/index.d.mts +4 -0
- package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
- package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
- package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
- package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
- package/lib/types/engine/store/index.d.cts +2 -0
- package/lib/types/engine/store/index.d.mts +2 -0
- package/lib/types/engine/types.d.cts +12 -0
- package/lib/types/engine/types.d.mts +12 -0
- package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
- package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
- package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
- package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
- package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
- package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
- package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
- package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
- package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
- package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
- package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
- package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
- package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
- package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
- package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
- package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
- package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
- package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
- package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
- package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
- package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +53 -6
- package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +53 -6
- package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
- package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
- package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
- package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
- package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
- package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
- package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +108 -1
- package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +108 -1
- package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
- package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
- package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
- package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
- package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
- package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
- package/lib/types/mastra/MastraMemory.d.cts +362 -0
- package/lib/types/mastra/MastraMemory.d.mts +362 -0
- package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
- package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
- package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
- package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
- package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
- package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
- package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
- package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
- package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
- package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
- package/lib/types/mastra/MastraObservability.d.cts +197 -0
- package/lib/types/mastra/MastraObservability.d.mts +197 -0
- package/lib/types/mastra/MastraPersistence.d.cts +241 -0
- package/lib/types/mastra/MastraPersistence.d.mts +241 -0
- package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
- package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
- package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
- package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
- package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
- package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
- package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
- package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
- package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
- package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
- package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
- package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
- package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
- package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
- package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
- package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
- package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
- package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
- package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
- package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
- package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
- package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
- package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
- package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
- package/lib/types/mastra/index.d.cts +40 -1
- package/lib/types/mastra/index.d.mts +40 -1
- package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
- package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
- package/lib/types/mastra/nodes/index.d.cts +11 -0
- package/lib/types/mastra/nodes/index.d.mts +11 -0
- package/lib/types/mastra/nodes/types.d.cts +57 -0
- package/lib/types/mastra/nodes/types.d.mts +57 -0
- package/lib/types/mastra/types.d.cts +365 -6
- package/lib/types/mastra/types.d.mts +365 -6
- package/lib/types/nest/graph/GraphExecutionModule.d.cts +17 -0
- package/lib/types/nest/graph/GraphExecutionModule.d.mts +17 -0
- package/lib/types/nest/graph/GraphRunController.d.cts +24 -4
- package/lib/types/nest/graph/GraphRunController.d.mts +24 -4
- package/lib/types/node/agents/agent/node.d.cts +72 -16
- package/lib/types/node/agents/agent/node.d.mts +72 -16
- package/lib/types/node/agents/hitl/node.d.cts +45 -0
- package/lib/types/node/agents/hitl/node.d.mts +45 -0
- package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
- package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
- package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
- package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
- package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
- package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
- package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
- package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
- package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
- package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
- package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
- package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
- package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
- package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
- package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
- package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
- package/lib/types/node/agents/processors/types.d.cts +45 -0
- package/lib/types/node/agents/processors/types.d.mts +45 -0
- package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
- package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
- package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
- package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
- package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
- package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
- package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
- package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
- package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
- package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
- package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
- package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
- package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
- package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
- package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
- package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
- package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
- package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
- package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
- package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
- package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
- package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
- package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
- package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
- package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
- package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
- package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
- package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
- package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
- package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
- package/lib/types/node/agents/sandbox/node.d.cts +47 -0
- package/lib/types/node/agents/sandbox/node.d.mts +47 -0
- package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
- package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
- package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
- package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
- package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
- package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
- package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
- package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
- package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
- package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
- package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
- package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
- package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
- package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
- package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
- package/lib/types/node/agents/voice/node.d.cts +34 -0
- package/lib/types/node/agents/voice/node.d.mts +34 -0
- package/lib/types/node/agents/zones.d.cts +30 -0
- package/lib/types/node/agents/zones.d.mts +30 -0
- package/lib/types/node/comms/email-send/node.d.cts +85 -0
- package/lib/types/node/comms/email-send/node.d.mts +85 -0
- package/lib/types/node/comms/gmail/node.d.cts +67 -0
- package/lib/types/node/comms/gmail/node.d.mts +67 -0
- package/lib/types/node/comms/slack/node.d.cts +65 -0
- package/lib/types/node/comms/slack/node.d.mts +65 -0
- package/lib/types/node/comms/teams/node.d.cts +49 -0
- package/lib/types/node/comms/teams/node.d.mts +49 -0
- package/lib/types/node/comms/telegram/node.d.cts +61 -0
- package/lib/types/node/comms/telegram/node.d.mts +61 -0
- package/lib/types/node/credentials.d.cts +43 -0
- package/lib/types/node/credentials.d.mts +43 -0
- package/lib/types/node/data/data-table/node.d.cts +86 -0
- package/lib/types/node/data/data-table/node.d.mts +86 -0
- package/lib/types/node/data/date-time/node.d.cts +49 -0
- package/lib/types/node/data/date-time/node.d.mts +49 -0
- package/lib/types/node/data/filter/node.d.cts +31 -0
- package/lib/types/node/data/filter/node.d.mts +31 -0
- package/lib/types/node/data/limit/node.d.cts +28 -0
- package/lib/types/node/data/limit/node.d.mts +28 -0
- package/lib/types/node/data/merge/node.d.cts +63 -0
- package/lib/types/node/data/merge/node.d.mts +63 -0
- package/lib/types/node/data/rename-keys/node.d.cts +35 -0
- package/lib/types/node/data/rename-keys/node.d.mts +35 -0
- package/lib/types/node/data/set/node.d.cts +52 -0
- package/lib/types/node/data/set/node.d.mts +52 -0
- package/lib/types/node/data/sort/node.d.cts +40 -0
- package/lib/types/node/data/sort/node.d.mts +40 -0
- package/lib/types/node/data/split-out/node.d.cts +30 -0
- package/lib/types/node/data/split-out/node.d.mts +30 -0
- package/lib/types/node/data/support.d.cts +164 -0
- package/lib/types/node/data/support.d.mts +164 -0
- package/lib/types/node/devops/crypto/node.d.cts +65 -0
- package/lib/types/node/devops/crypto/node.d.mts +65 -0
- package/lib/types/node/devops/execute-command/node.d.cts +55 -0
- package/lib/types/node/devops/execute-command/node.d.mts +55 -0
- package/lib/types/node/devops/ftp/node.d.cts +55 -0
- package/lib/types/node/devops/ftp/node.d.mts +55 -0
- package/lib/types/node/devops/github/node.d.cts +61 -0
- package/lib/types/node/devops/github/node.d.mts +61 -0
- package/lib/types/node/devops/gitlab/node.d.cts +61 -0
- package/lib/types/node/devops/gitlab/node.d.mts +61 -0
- package/lib/types/node/devops/jwt/node.d.cts +53 -0
- package/lib/types/node/devops/jwt/node.d.mts +53 -0
- package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
- package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
- package/lib/types/node/index.d.cts +182 -2
- package/lib/types/node/index.d.mts +182 -2
- package/lib/types/node/io/airtable/node.d.cts +73 -0
- package/lib/types/node/io/airtable/node.d.mts +73 -0
- package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
- package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
- package/lib/types/node/io/google-sheets/node.d.cts +77 -0
- package/lib/types/node/io/google-sheets/node.d.mts +77 -0
- package/lib/types/node/io/graphql/node.d.cts +46 -0
- package/lib/types/node/io/graphql/node.d.mts +46 -0
- package/lib/types/node/io/http-request/node.d.cts +107 -0
- package/lib/types/node/io/http-request/node.d.mts +107 -0
- package/lib/types/node/io/read-pdf/node.d.cts +40 -0
- package/lib/types/node/io/read-pdf/node.d.mts +40 -0
- package/lib/types/node/io/read-write-file/node.d.cts +41 -0
- package/lib/types/node/io/read-write-file/node.d.mts +41 -0
- package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
- package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
- package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
- package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
- package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
- package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
- package/lib/types/node/storage/blob/base.d.cts +83 -0
- package/lib/types/node/storage/blob/base.d.mts +83 -0
- package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
- package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
- package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
- package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
- package/lib/types/node/storage/database/base.d.cts +97 -0
- package/lib/types/node/storage/database/base.d.mts +97 -0
- package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
- package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
- package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
- package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
- package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
- package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
- package/lib/types/node/storage/redis/node.d.cts +68 -0
- package/lib/types/node/storage/redis/node.d.mts +68 -0
- package/lib/types/node/storage/support.d.cts +36 -0
- package/lib/types/node/storage/support.d.mts +36 -0
- package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
- package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
- package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
- package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
- package/lib/types/shared/graph/GraphNodeModel.d.cts +6 -0
- package/lib/types/shared/graph/GraphNodeModel.d.mts +6 -0
- package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
- package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
- package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
- package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
- package/lib/types/shared/graph/constants.d.cts +39 -0
- package/lib/types/shared/graph/constants.d.mts +39 -0
- package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
- package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
- package/lib/types/typeorm/index.d.cts +11 -0
- package/lib/types/typeorm/index.d.mts +11 -0
- package/package.json +51 -11
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/engine/credentials/GraphNodeCredentials
|
|
3
|
+
* @summary Ctx-bound credential resolution for graph nodes (DECAF-809 Phase B).
|
|
4
|
+
* @description Replaces the Phase-2 `GRAPH_CREDENTIAL_*` environment-variable
|
|
5
|
+
* convention (whose remaining `GRAPH_CREDENTIAL_*` strings here are
|
|
6
|
+
* `GraphExecutionError` codes, not configuration): node executors resolve
|
|
7
|
+
* credential references only through the engine's
|
|
8
|
+
* {@link GraphNodeCredentialResolver}, which forwards the execution context to
|
|
9
|
+
* the namespaced Phase A `CredentialService` and to the model/filesystem
|
|
10
|
+
* secret services, so tenancy (RLS) scoping is enforced and secrets are never
|
|
11
|
+
* read from `process.env`. Resolution fails closed — missing, disabled,
|
|
12
|
+
* expired, or type-mismatched credentials, and unsupported secret providers,
|
|
13
|
+
* all throw typed `GRAPH_CREDENTIAL_*` errors.
|
|
14
|
+
*
|
|
15
|
+
* @mermaid
|
|
16
|
+
* sequenceDiagram
|
|
17
|
+
* autonumber
|
|
18
|
+
* participant N as Node executor
|
|
19
|
+
* participant R as resolveNodeCredential
|
|
20
|
+
* participant E as Engine (ctx-bound)
|
|
21
|
+
* participant Res as GraphNodeCredentialResolver
|
|
22
|
+
* participant C as CredentialService (RLS)
|
|
23
|
+
* participant S as Secret service
|
|
24
|
+
* N->>R: resolveNodeCredential(context, references, expectedType)
|
|
25
|
+
* R->>E: context.engine.nodeCredentials
|
|
26
|
+
* alt no engine resolver configured
|
|
27
|
+
* R-->>N: throw GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE
|
|
28
|
+
* else resolver present
|
|
29
|
+
* R->>Res: resolve(reference, expectedType, required, nodeName, context)
|
|
30
|
+
* Res->>C: getCredential(credentialId, context)
|
|
31
|
+
* activate C
|
|
32
|
+
* C-->>Res: GraphCredentialRecord
|
|
33
|
+
* deactivate C
|
|
34
|
+
* alt disabled / expired / type mismatch / not found
|
|
35
|
+
* Res-->>N: throw GRAPH_CREDENTIAL_* (fail closed)
|
|
36
|
+
* else valid
|
|
37
|
+
* Res->>S: retrieve(record.secretName, {}, context)
|
|
38
|
+
* activate S
|
|
39
|
+
* S-->>Res: secret payload
|
|
40
|
+
* deactivate S
|
|
41
|
+
* Res->>C: markCredentialUsed(credentialId, context)
|
|
42
|
+
* Res-->>N: string | record secret (never process.env)
|
|
43
|
+
* end
|
|
44
|
+
* end
|
|
45
|
+
*/
|
|
46
|
+
import type { Context } from "@decaf-ts/core";
|
|
47
|
+
import type { GraphCredentialReference } from "../../shared/graph/index.d.cts";
|
|
48
|
+
import type { GraphResolvedCredentials } from "../types.d.cts";
|
|
49
|
+
/**
|
|
50
|
+
* The resolved credential payload handed to a node: a bare token/secret
|
|
51
|
+
* string, a JSON-shaped record the node re-parses per its credential format,
|
|
52
|
+
* or `undefined` when no reference exists and none is required.
|
|
53
|
+
*/
|
|
54
|
+
export type GraphNodeCredentialSecret = string | Record<string, unknown> | undefined;
|
|
55
|
+
/** Structural view of a Phase A credential record the resolver reads. */
|
|
56
|
+
export interface GraphCredentialRecord {
|
|
57
|
+
id: string;
|
|
58
|
+
name: string;
|
|
59
|
+
credentialType: string;
|
|
60
|
+
/** Name of the secret held by the provider's secret service. */
|
|
61
|
+
secretName: string;
|
|
62
|
+
/** Secret provider backing the credential (`model` or `filesystem`). */
|
|
63
|
+
provider: string;
|
|
64
|
+
enabled?: boolean;
|
|
65
|
+
expiresAt?: Date | string | null;
|
|
66
|
+
tenantId?: string;
|
|
67
|
+
orgUnitId?: string;
|
|
68
|
+
ownerPrincipalId?: string;
|
|
69
|
+
}
|
|
70
|
+
/** Port over the namespaced credential service the resolver needs. */
|
|
71
|
+
export interface GraphCredentialServicePort {
|
|
72
|
+
getCredential(credentialId: string, ...args: any[]): Promise<GraphCredentialRecord>;
|
|
73
|
+
markCredentialUsed?(credentialId: string, ...args: any[]): Promise<unknown>;
|
|
74
|
+
}
|
|
75
|
+
/** Port over a secret service (model-backed or filesystem-backed). */
|
|
76
|
+
export interface GraphSecretServicePort {
|
|
77
|
+
readonly provider?: string;
|
|
78
|
+
retrieve(nameOrRef: string, options?: Record<string, unknown>, ...args: any[]): Promise<unknown>;
|
|
79
|
+
}
|
|
80
|
+
/** Host-supplied Phase A services the engine wires into the credential resolver. */
|
|
81
|
+
export interface GraphNodeCredentialServices {
|
|
82
|
+
credentialService: GraphCredentialServicePort;
|
|
83
|
+
modelSecretService: GraphSecretServicePort;
|
|
84
|
+
fsSecretService?: GraphSecretServicePort;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Resolves workflow credential references through ctx-bound Phase A
|
|
88
|
+
* credential/secret services.
|
|
89
|
+
*
|
|
90
|
+
* The engine constructs one resolver per execution from the host's
|
|
91
|
+
* {@link GraphNodeCredentialServices}; nodes reach it as
|
|
92
|
+
* `context.engine.nodeCredentials`. Every failure mode is fail-closed and
|
|
93
|
+
* typed: the `GRAPH_CREDENTIAL_*` strings in thrown errors are error codes,
|
|
94
|
+
* never environment-variable names.
|
|
95
|
+
*/
|
|
96
|
+
export declare class GraphNodeCredentialResolver {
|
|
97
|
+
private readonly services;
|
|
98
|
+
constructor(services: GraphNodeCredentialServices);
|
|
99
|
+
/**
|
|
100
|
+
* Resolves one credential reference to its secret payload.
|
|
101
|
+
*
|
|
102
|
+
* @param reference - The credential reference declared by the node (absent when the node declared none).
|
|
103
|
+
* @param expectedType - Credential type the node accepts (e.g. `"github"`).
|
|
104
|
+
* @param required - Whether execution may proceed without a credential.
|
|
105
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
106
|
+
* @param context - Execution context forwarded to the credential and secret services for tenancy scoping.
|
|
107
|
+
* @returns The credential record's secret payload as a string or record; `undefined` when no reference exists and `required` is false.
|
|
108
|
+
* @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` (no reference, required),
|
|
109
|
+
* `GRAPH_CREDENTIAL_TYPE_MISMATCH` (declared/record type differs from `expectedType`),
|
|
110
|
+
* `GRAPH_CREDENTIAL_NOT_FOUND` (credential service lookup failed),
|
|
111
|
+
* `GRAPH_CREDENTIAL_DISABLED`, `GRAPH_CREDENTIAL_EXPIRED`,
|
|
112
|
+
* `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` (filesystem provider without a configured service), and
|
|
113
|
+
* `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` (provider other than `model`/`filesystem`).
|
|
114
|
+
*/
|
|
115
|
+
resolve(reference: GraphCredentialReference | undefined, expectedType: string, required: boolean, nodeName: string, context?: Context): Promise<GraphNodeCredentialSecret>;
|
|
116
|
+
/**
|
|
117
|
+
* Picks the secret service backing the credential's provider.
|
|
118
|
+
*
|
|
119
|
+
* @param provider - Provider recorded on the credential (`model` or `filesystem`).
|
|
120
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
121
|
+
* @returns The secret service port for the provider.
|
|
122
|
+
* @throws {GraphExecutionError} with code `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the filesystem provider has no configured service, or `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` for any other provider.
|
|
123
|
+
*/
|
|
124
|
+
private secretServiceFor;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Resolves the credential reference registered under `id` for a node
|
|
128
|
+
* execution, through the ctx-bound resolver the executing engine carries.
|
|
129
|
+
*
|
|
130
|
+
* Convenience wrapper used by every migrated `src/node/**` executor: it reads
|
|
131
|
+
* the reference from `references`, obtains the engine's
|
|
132
|
+
* {@link GraphNodeCredentialResolver} from `context`, and delegates. There is
|
|
133
|
+
* deliberately no environment fallback — without a configured engine resolver
|
|
134
|
+
* the node fails closed.
|
|
135
|
+
*
|
|
136
|
+
* @param context - The node execution context carrying the engine reference; may be `undefined` in legacy call sites.
|
|
137
|
+
* @param references - Credential references resolved by the engine for this run.
|
|
138
|
+
* @param expectedType - Credential type the node accepts (e.g. `"sftp"`).
|
|
139
|
+
* @param required - Whether execution may proceed without any credential.
|
|
140
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
141
|
+
* @param id - Handle under which the reference was registered (default `"credentialRef"`).
|
|
142
|
+
* @returns The resolved secret (string or record), or `undefined` when no reference exists and `required` is false.
|
|
143
|
+
* @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` when no reference exists and `required` is true, `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the engine carries no credential resolver, and the `GRAPH_CREDENTIAL_*` codes propagated from {@link GraphNodeCredentialResolver.resolve}.
|
|
144
|
+
*/
|
|
145
|
+
export declare function resolveNodeCredential(context: Context | undefined, references: GraphResolvedCredentials, expectedType: string, required: boolean, nodeName: string, id?: string): Promise<GraphNodeCredentialSecret>;
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/engine/credentials/GraphNodeCredentials
|
|
3
|
+
* @summary Ctx-bound credential resolution for graph nodes (DECAF-809 Phase B).
|
|
4
|
+
* @description Replaces the Phase-2 `GRAPH_CREDENTIAL_*` environment-variable
|
|
5
|
+
* convention (whose remaining `GRAPH_CREDENTIAL_*` strings here are
|
|
6
|
+
* `GraphExecutionError` codes, not configuration): node executors resolve
|
|
7
|
+
* credential references only through the engine's
|
|
8
|
+
* {@link GraphNodeCredentialResolver}, which forwards the execution context to
|
|
9
|
+
* the namespaced Phase A `CredentialService` and to the model/filesystem
|
|
10
|
+
* secret services, so tenancy (RLS) scoping is enforced and secrets are never
|
|
11
|
+
* read from `process.env`. Resolution fails closed — missing, disabled,
|
|
12
|
+
* expired, or type-mismatched credentials, and unsupported secret providers,
|
|
13
|
+
* all throw typed `GRAPH_CREDENTIAL_*` errors.
|
|
14
|
+
*
|
|
15
|
+
* @mermaid
|
|
16
|
+
* sequenceDiagram
|
|
17
|
+
* autonumber
|
|
18
|
+
* participant N as Node executor
|
|
19
|
+
* participant R as resolveNodeCredential
|
|
20
|
+
* participant E as Engine (ctx-bound)
|
|
21
|
+
* participant Res as GraphNodeCredentialResolver
|
|
22
|
+
* participant C as CredentialService (RLS)
|
|
23
|
+
* participant S as Secret service
|
|
24
|
+
* N->>R: resolveNodeCredential(context, references, expectedType)
|
|
25
|
+
* R->>E: context.engine.nodeCredentials
|
|
26
|
+
* alt no engine resolver configured
|
|
27
|
+
* R-->>N: throw GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE
|
|
28
|
+
* else resolver present
|
|
29
|
+
* R->>Res: resolve(reference, expectedType, required, nodeName, context)
|
|
30
|
+
* Res->>C: getCredential(credentialId, context)
|
|
31
|
+
* activate C
|
|
32
|
+
* C-->>Res: GraphCredentialRecord
|
|
33
|
+
* deactivate C
|
|
34
|
+
* alt disabled / expired / type mismatch / not found
|
|
35
|
+
* Res-->>N: throw GRAPH_CREDENTIAL_* (fail closed)
|
|
36
|
+
* else valid
|
|
37
|
+
* Res->>S: retrieve(record.secretName, {}, context)
|
|
38
|
+
* activate S
|
|
39
|
+
* S-->>Res: secret payload
|
|
40
|
+
* deactivate S
|
|
41
|
+
* Res->>C: markCredentialUsed(credentialId, context)
|
|
42
|
+
* Res-->>N: string | record secret (never process.env)
|
|
43
|
+
* end
|
|
44
|
+
* end
|
|
45
|
+
*/
|
|
46
|
+
import type { Context } from "@decaf-ts/core";
|
|
47
|
+
import type { GraphCredentialReference } from "../../shared/graph/index.d.mts";
|
|
48
|
+
import type { GraphResolvedCredentials } from "../types.d.mts";
|
|
49
|
+
/**
|
|
50
|
+
* The resolved credential payload handed to a node: a bare token/secret
|
|
51
|
+
* string, a JSON-shaped record the node re-parses per its credential format,
|
|
52
|
+
* or `undefined` when no reference exists and none is required.
|
|
53
|
+
*/
|
|
54
|
+
export type GraphNodeCredentialSecret = string | Record<string, unknown> | undefined;
|
|
55
|
+
/** Structural view of a Phase A credential record the resolver reads. */
|
|
56
|
+
export interface GraphCredentialRecord {
|
|
57
|
+
id: string;
|
|
58
|
+
name: string;
|
|
59
|
+
credentialType: string;
|
|
60
|
+
/** Name of the secret held by the provider's secret service. */
|
|
61
|
+
secretName: string;
|
|
62
|
+
/** Secret provider backing the credential (`model` or `filesystem`). */
|
|
63
|
+
provider: string;
|
|
64
|
+
enabled?: boolean;
|
|
65
|
+
expiresAt?: Date | string | null;
|
|
66
|
+
tenantId?: string;
|
|
67
|
+
orgUnitId?: string;
|
|
68
|
+
ownerPrincipalId?: string;
|
|
69
|
+
}
|
|
70
|
+
/** Port over the namespaced credential service the resolver needs. */
|
|
71
|
+
export interface GraphCredentialServicePort {
|
|
72
|
+
getCredential(credentialId: string, ...args: any[]): Promise<GraphCredentialRecord>;
|
|
73
|
+
markCredentialUsed?(credentialId: string, ...args: any[]): Promise<unknown>;
|
|
74
|
+
}
|
|
75
|
+
/** Port over a secret service (model-backed or filesystem-backed). */
|
|
76
|
+
export interface GraphSecretServicePort {
|
|
77
|
+
readonly provider?: string;
|
|
78
|
+
retrieve(nameOrRef: string, options?: Record<string, unknown>, ...args: any[]): Promise<unknown>;
|
|
79
|
+
}
|
|
80
|
+
/** Host-supplied Phase A services the engine wires into the credential resolver. */
|
|
81
|
+
export interface GraphNodeCredentialServices {
|
|
82
|
+
credentialService: GraphCredentialServicePort;
|
|
83
|
+
modelSecretService: GraphSecretServicePort;
|
|
84
|
+
fsSecretService?: GraphSecretServicePort;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Resolves workflow credential references through ctx-bound Phase A
|
|
88
|
+
* credential/secret services.
|
|
89
|
+
*
|
|
90
|
+
* The engine constructs one resolver per execution from the host's
|
|
91
|
+
* {@link GraphNodeCredentialServices}; nodes reach it as
|
|
92
|
+
* `context.engine.nodeCredentials`. Every failure mode is fail-closed and
|
|
93
|
+
* typed: the `GRAPH_CREDENTIAL_*` strings in thrown errors are error codes,
|
|
94
|
+
* never environment-variable names.
|
|
95
|
+
*/
|
|
96
|
+
export declare class GraphNodeCredentialResolver {
|
|
97
|
+
private readonly services;
|
|
98
|
+
constructor(services: GraphNodeCredentialServices);
|
|
99
|
+
/**
|
|
100
|
+
* Resolves one credential reference to its secret payload.
|
|
101
|
+
*
|
|
102
|
+
* @param reference - The credential reference declared by the node (absent when the node declared none).
|
|
103
|
+
* @param expectedType - Credential type the node accepts (e.g. `"github"`).
|
|
104
|
+
* @param required - Whether execution may proceed without a credential.
|
|
105
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
106
|
+
* @param context - Execution context forwarded to the credential and secret services for tenancy scoping.
|
|
107
|
+
* @returns The credential record's secret payload as a string or record; `undefined` when no reference exists and `required` is false.
|
|
108
|
+
* @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` (no reference, required),
|
|
109
|
+
* `GRAPH_CREDENTIAL_TYPE_MISMATCH` (declared/record type differs from `expectedType`),
|
|
110
|
+
* `GRAPH_CREDENTIAL_NOT_FOUND` (credential service lookup failed),
|
|
111
|
+
* `GRAPH_CREDENTIAL_DISABLED`, `GRAPH_CREDENTIAL_EXPIRED`,
|
|
112
|
+
* `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` (filesystem provider without a configured service), and
|
|
113
|
+
* `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` (provider other than `model`/`filesystem`).
|
|
114
|
+
*/
|
|
115
|
+
resolve(reference: GraphCredentialReference | undefined, expectedType: string, required: boolean, nodeName: string, context?: Context): Promise<GraphNodeCredentialSecret>;
|
|
116
|
+
/**
|
|
117
|
+
* Picks the secret service backing the credential's provider.
|
|
118
|
+
*
|
|
119
|
+
* @param provider - Provider recorded on the credential (`model` or `filesystem`).
|
|
120
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
121
|
+
* @returns The secret service port for the provider.
|
|
122
|
+
* @throws {GraphExecutionError} with code `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the filesystem provider has no configured service, or `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` for any other provider.
|
|
123
|
+
*/
|
|
124
|
+
private secretServiceFor;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Resolves the credential reference registered under `id` for a node
|
|
128
|
+
* execution, through the ctx-bound resolver the executing engine carries.
|
|
129
|
+
*
|
|
130
|
+
* Convenience wrapper used by every migrated `src/node/**` executor: it reads
|
|
131
|
+
* the reference from `references`, obtains the engine's
|
|
132
|
+
* {@link GraphNodeCredentialResolver} from `context`, and delegates. There is
|
|
133
|
+
* deliberately no environment fallback — without a configured engine resolver
|
|
134
|
+
* the node fails closed.
|
|
135
|
+
*
|
|
136
|
+
* @param context - The node execution context carrying the engine reference; may be `undefined` in legacy call sites.
|
|
137
|
+
* @param references - Credential references resolved by the engine for this run.
|
|
138
|
+
* @param expectedType - Credential type the node accepts (e.g. `"sftp"`).
|
|
139
|
+
* @param required - Whether execution may proceed without any credential.
|
|
140
|
+
* @param nodeName - Human-readable node name used in error messages.
|
|
141
|
+
* @param id - Handle under which the reference was registered (default `"credentialRef"`).
|
|
142
|
+
* @returns The resolved secret (string or record), or `undefined` when no reference exists and `required` is false.
|
|
143
|
+
* @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` when no reference exists and `required` is true, `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the engine carries no credential resolver, and the `GRAPH_CREDENTIAL_*` codes propagated from {@link GraphNodeCredentialResolver.resolve}.
|
|
144
|
+
*/
|
|
145
|
+
export declare function resolveNodeCredential(context: Context | undefined, references: GraphResolvedCredentials, expectedType: string, required: boolean, nodeName: string, id?: string): Promise<GraphNodeCredentialSecret>;
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
*/
|
|
19
19
|
import { Adapter, ClientBasedService, type Context, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
|
|
20
20
|
import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
|
|
21
|
+
import { GraphNodeCredentialResolver, type GraphNodeCredentialServices } from "../credentials/GraphNodeCredentials.d.cts";
|
|
21
22
|
import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.cts";
|
|
22
23
|
import type { GraphExecutionObserver } from "../events/GraphExecutionObserver.d.cts";
|
|
23
24
|
import { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.cts";
|
|
@@ -26,9 +27,11 @@ import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.cts";
|
|
|
26
27
|
import { GraphExecutionPlanner } from "../planning/GraphExecutionPlanner.d.cts";
|
|
27
28
|
import { GraphWorkflowDocumentValidator, type GraphWorkflowDocumentValidationLimits } from "../validation/GraphWorkflowDocumentValidator.d.cts";
|
|
28
29
|
import type { GraphCredentialAuthorizer } from "../validation/GraphCredentialReferenceValidator.d.cts";
|
|
30
|
+
import { GraphWebhookResponseRegistry } from "./GraphWebhookResponseRegistry.d.cts";
|
|
31
|
+
import { type GraphDataTableRepository } from "../store/GraphDataTableRepository.d.cts";
|
|
29
32
|
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
|
|
30
33
|
import { type GraphBackendCapabilities, type GraphBackendWorkflowStore, type GraphBackendWorkflowSummary, type GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
|
|
31
|
-
import { GraphAuthValidator, type GraphNamespaceMatchOptions } from "../auth/index.d.cts";
|
|
34
|
+
import { GraphAuthValidator, graphAuthDataOf, type GraphNamespaceMatchOptions } from "../auth/index.d.cts";
|
|
32
35
|
/**
|
|
33
36
|
* Strips facade-owned keys from a backend's retained configuration that the facade
|
|
34
37
|
* did not itself set (defense in depth). A backend's `config` getter may derive
|
|
@@ -119,6 +122,13 @@ export interface GraphExecutionEngineConfig {
|
|
|
119
122
|
* sub-workflows through the same engine).
|
|
120
123
|
*/
|
|
121
124
|
onEngineCreated?: (engine: GraphExecutionEngine) => void | Promise<void>;
|
|
125
|
+
/**
|
|
126
|
+
* Ctx-bound credential services every node kind resolves its credential
|
|
127
|
+
* references through. The host supplies the undecorated integration
|
|
128
|
+
* service instances booted with explicit configuration; node execution never
|
|
129
|
+
* reads secrets from the Environment.
|
|
130
|
+
*/
|
|
131
|
+
nodeCredentials?: GraphNodeCredentialServices;
|
|
122
132
|
}
|
|
123
133
|
/**
|
|
124
134
|
* Runtime collaborators resolved by {@link GraphExecutionEngine.initialize}.
|
|
@@ -142,6 +152,8 @@ export interface GraphExecutionEngineClient {
|
|
|
142
152
|
authValidator: GraphAuthValidator;
|
|
143
153
|
/** Optional pluggable code sandbox evaluator. */
|
|
144
154
|
codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
155
|
+
/** Ctx-bound credential resolver, when the host configured credential services. */
|
|
156
|
+
nodeCredentials?: GraphNodeCredentialResolver;
|
|
145
157
|
}
|
|
146
158
|
/**
|
|
147
159
|
* Reference graph execution engine.
|
|
@@ -184,6 +196,50 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
184
196
|
}>;
|
|
185
197
|
/** Pluggable code sandbox evaluator (§22.4); may be undefined. */
|
|
186
198
|
get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
|
|
199
|
+
/**
|
|
200
|
+
* The ctx-bound credential resolver configured by the host.
|
|
201
|
+
*
|
|
202
|
+
* Nodes resolve credential references only through this resolver, which
|
|
203
|
+
* forwards the execution context to the namespaced `CredentialService` and
|
|
204
|
+
* the model/filesystem secret services, so RLS scoping is enforced.
|
|
205
|
+
*/
|
|
206
|
+
get nodeCredentials(): GraphNodeCredentialResolver | undefined;
|
|
207
|
+
/** Lazily-bound data-table repository backing {@linkcode GraphExecutionEngine.dataTableStore}. */
|
|
208
|
+
private dataTableRepository?;
|
|
209
|
+
/** Registry instance backing {@linkcode GraphExecutionEngine.webhookResponses}. */
|
|
210
|
+
private readonly webhookResponseRegistry;
|
|
211
|
+
/** Sub-workflow depth of each in-flight run, used by the depth guard. */
|
|
212
|
+
private readonly runSubWorkflowDepth;
|
|
213
|
+
/** Root run id of each in-flight run, used by the child-run budget. */
|
|
214
|
+
private readonly runRootId;
|
|
215
|
+
/** Sub-workflow child-run count per root run. */
|
|
216
|
+
private readonly rootChildRunCounts;
|
|
217
|
+
/**
|
|
218
|
+
* Cross-run data-table persistence for the `core.data.dataTable` kind.
|
|
219
|
+
*
|
|
220
|
+
* The repository is created lazily on first access and bound to the
|
|
221
|
+
* engine's value adapter via `createGraphDataTableRepository`, so data-table
|
|
222
|
+
* rows live in the same adapter (and flavour behaviour) as workflow values
|
|
223
|
+
* but survive their originating run. Data-table nodes resolve the store
|
|
224
|
+
* through `context.engine?.dataTableStore` and fail closed with
|
|
225
|
+
* `GRAPH_ENGINE_NOT_AVAILABLE` when the engine is absent.
|
|
226
|
+
*
|
|
227
|
+
* @returns The data-table repository for this engine.
|
|
228
|
+
*/
|
|
229
|
+
get dataTableStore(): GraphDataTableRepository;
|
|
230
|
+
/**
|
|
231
|
+
* Run-keyed webhook response correlation for the `core.io.respondToWebhook`
|
|
232
|
+
* kind.
|
|
233
|
+
*
|
|
234
|
+
* One registry instance is owned per engine for its lifetime: a
|
|
235
|
+
* webhook-triggered run awaits `register(runId, timeoutMs)` while the
|
|
236
|
+
* Respond to Webhook node resolves it through
|
|
237
|
+
* `deliver(context.runId, response)`. Consumers treat `webhookResponses` as
|
|
238
|
+
* the engine-owned correlation point rather than building their own.
|
|
239
|
+
*
|
|
240
|
+
* @returns The engine's webhook response registry.
|
|
241
|
+
*/
|
|
242
|
+
get webhookResponses(): GraphWebhookResponseRegistry;
|
|
187
243
|
private get emitter();
|
|
188
244
|
private get planner();
|
|
189
245
|
private get valueAdapter();
|
|
@@ -262,6 +318,22 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
262
318
|
* when the active backend declares no lookup support.
|
|
263
319
|
*/
|
|
264
320
|
getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
321
|
+
/**
|
|
322
|
+
* Applies the engine's workflow-level read authorization to a document that
|
|
323
|
+
* was resolved through the workflow catalogue seam.
|
|
324
|
+
*
|
|
325
|
+
* Ownership is enforced by the persistence store's own read path; this adds
|
|
326
|
+
* the namespace/role check for the resolved document when graph auth is
|
|
327
|
+
* enabled, so a sub-workflow lookup cannot read a namespace-scoped document
|
|
328
|
+
* the caller is not entitled to.
|
|
329
|
+
*
|
|
330
|
+
* @param document - The resolved canonical workflow document.
|
|
331
|
+
* @param auth - The caller's authenticated principal facts.
|
|
332
|
+
* @param logger - Optional run-scoped logger for the denial audit line.
|
|
333
|
+
* @throws {ForbiddenError} when the document's workflow-level namespace/role
|
|
334
|
+
* requirements are not granted.
|
|
335
|
+
*/
|
|
336
|
+
assertWorkflowReadAccess(document: GraphWorkflowDocument, auth: ReturnType<typeof graphAuthDataOf>, logger?: Parameters<GraphAuthValidator["validateWorkflowRead"]>[2]): void;
|
|
265
337
|
/**
|
|
266
338
|
* Lists the workflows a *specific* registered backend can surface, resolved by
|
|
267
339
|
* flavour. This is the flavour-scoped counterpart of {@link listWorkflows}: the
|
|
@@ -330,6 +402,21 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
330
402
|
*/
|
|
331
403
|
private mergeOptions;
|
|
332
404
|
private assertNotAborted;
|
|
405
|
+
/**
|
|
406
|
+
* Registers a run in the sub-workflow depth/child-budget bookkeeping and
|
|
407
|
+
* fails closed when either bound would be exceeded.
|
|
408
|
+
*
|
|
409
|
+
* Depth is inherited through the `parentRunId` chain and only increments when
|
|
410
|
+
* the execution itself is a `subworkflow` edge (the last path segment), so
|
|
411
|
+
* loop bodies remain governed by their iteration caps. The child-run budget
|
|
412
|
+
* is tracked per root run and increments for every sub-workflow child.
|
|
413
|
+
*/
|
|
414
|
+
private enterExecutionBudget;
|
|
415
|
+
/**
|
|
416
|
+
* Releases a finished run's depth/root bookkeeping. The root's child count is
|
|
417
|
+
* removed only when the root itself finishes, after all descendants.
|
|
418
|
+
*/
|
|
419
|
+
private releaseExecutionBudget;
|
|
333
420
|
/**
|
|
334
421
|
* Generates a cryptographically random run id. `crypto.randomUUID` is always
|
|
335
422
|
* available in the backend runtimes as-graph targets; the frontend never
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
*/
|
|
19
19
|
import { Adapter, ClientBasedService, type Context, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
|
|
20
20
|
import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
|
|
21
|
+
import { GraphNodeCredentialResolver, type GraphNodeCredentialServices } from "../credentials/GraphNodeCredentials.d.mts";
|
|
21
22
|
import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.mts";
|
|
22
23
|
import type { GraphExecutionObserver } from "../events/GraphExecutionObserver.d.mts";
|
|
23
24
|
import { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.mts";
|
|
@@ -26,9 +27,11 @@ import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.mts";
|
|
|
26
27
|
import { GraphExecutionPlanner } from "../planning/GraphExecutionPlanner.d.mts";
|
|
27
28
|
import { GraphWorkflowDocumentValidator, type GraphWorkflowDocumentValidationLimits } from "../validation/GraphWorkflowDocumentValidator.d.mts";
|
|
28
29
|
import type { GraphCredentialAuthorizer } from "../validation/GraphCredentialReferenceValidator.d.mts";
|
|
30
|
+
import { GraphWebhookResponseRegistry } from "./GraphWebhookResponseRegistry.d.mts";
|
|
31
|
+
import { type GraphDataTableRepository } from "../store/GraphDataTableRepository.d.mts";
|
|
29
32
|
import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
|
|
30
33
|
import { type GraphBackendCapabilities, type GraphBackendWorkflowStore, type GraphBackendWorkflowSummary, type GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
|
|
31
|
-
import { GraphAuthValidator, type GraphNamespaceMatchOptions } from "../auth/index.d.mts";
|
|
34
|
+
import { GraphAuthValidator, graphAuthDataOf, type GraphNamespaceMatchOptions } from "../auth/index.d.mts";
|
|
32
35
|
/**
|
|
33
36
|
* Strips facade-owned keys from a backend's retained configuration that the facade
|
|
34
37
|
* did not itself set (defense in depth). A backend's `config` getter may derive
|
|
@@ -119,6 +122,13 @@ export interface GraphExecutionEngineConfig {
|
|
|
119
122
|
* sub-workflows through the same engine).
|
|
120
123
|
*/
|
|
121
124
|
onEngineCreated?: (engine: GraphExecutionEngine) => void | Promise<void>;
|
|
125
|
+
/**
|
|
126
|
+
* Ctx-bound credential services every node kind resolves its credential
|
|
127
|
+
* references through. The host supplies the undecorated integration
|
|
128
|
+
* service instances booted with explicit configuration; node execution never
|
|
129
|
+
* reads secrets from the Environment.
|
|
130
|
+
*/
|
|
131
|
+
nodeCredentials?: GraphNodeCredentialServices;
|
|
122
132
|
}
|
|
123
133
|
/**
|
|
124
134
|
* Runtime collaborators resolved by {@link GraphExecutionEngine.initialize}.
|
|
@@ -142,6 +152,8 @@ export interface GraphExecutionEngineClient {
|
|
|
142
152
|
authValidator: GraphAuthValidator;
|
|
143
153
|
/** Optional pluggable code sandbox evaluator. */
|
|
144
154
|
codeSandboxEvaluator?: CodeSandboxEvaluator;
|
|
155
|
+
/** Ctx-bound credential resolver, when the host configured credential services. */
|
|
156
|
+
nodeCredentials?: GraphNodeCredentialResolver;
|
|
145
157
|
}
|
|
146
158
|
/**
|
|
147
159
|
* Reference graph execution engine.
|
|
@@ -184,6 +196,50 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
184
196
|
}>;
|
|
185
197
|
/** Pluggable code sandbox evaluator (§22.4); may be undefined. */
|
|
186
198
|
get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
|
|
199
|
+
/**
|
|
200
|
+
* The ctx-bound credential resolver configured by the host.
|
|
201
|
+
*
|
|
202
|
+
* Nodes resolve credential references only through this resolver, which
|
|
203
|
+
* forwards the execution context to the namespaced `CredentialService` and
|
|
204
|
+
* the model/filesystem secret services, so RLS scoping is enforced.
|
|
205
|
+
*/
|
|
206
|
+
get nodeCredentials(): GraphNodeCredentialResolver | undefined;
|
|
207
|
+
/** Lazily-bound data-table repository backing {@linkcode GraphExecutionEngine.dataTableStore}. */
|
|
208
|
+
private dataTableRepository?;
|
|
209
|
+
/** Registry instance backing {@linkcode GraphExecutionEngine.webhookResponses}. */
|
|
210
|
+
private readonly webhookResponseRegistry;
|
|
211
|
+
/** Sub-workflow depth of each in-flight run, used by the depth guard. */
|
|
212
|
+
private readonly runSubWorkflowDepth;
|
|
213
|
+
/** Root run id of each in-flight run, used by the child-run budget. */
|
|
214
|
+
private readonly runRootId;
|
|
215
|
+
/** Sub-workflow child-run count per root run. */
|
|
216
|
+
private readonly rootChildRunCounts;
|
|
217
|
+
/**
|
|
218
|
+
* Cross-run data-table persistence for the `core.data.dataTable` kind.
|
|
219
|
+
*
|
|
220
|
+
* The repository is created lazily on first access and bound to the
|
|
221
|
+
* engine's value adapter via `createGraphDataTableRepository`, so data-table
|
|
222
|
+
* rows live in the same adapter (and flavour behaviour) as workflow values
|
|
223
|
+
* but survive their originating run. Data-table nodes resolve the store
|
|
224
|
+
* through `context.engine?.dataTableStore` and fail closed with
|
|
225
|
+
* `GRAPH_ENGINE_NOT_AVAILABLE` when the engine is absent.
|
|
226
|
+
*
|
|
227
|
+
* @returns The data-table repository for this engine.
|
|
228
|
+
*/
|
|
229
|
+
get dataTableStore(): GraphDataTableRepository;
|
|
230
|
+
/**
|
|
231
|
+
* Run-keyed webhook response correlation for the `core.io.respondToWebhook`
|
|
232
|
+
* kind.
|
|
233
|
+
*
|
|
234
|
+
* One registry instance is owned per engine for its lifetime: a
|
|
235
|
+
* webhook-triggered run awaits `register(runId, timeoutMs)` while the
|
|
236
|
+
* Respond to Webhook node resolves it through
|
|
237
|
+
* `deliver(context.runId, response)`. Consumers treat `webhookResponses` as
|
|
238
|
+
* the engine-owned correlation point rather than building their own.
|
|
239
|
+
*
|
|
240
|
+
* @returns The engine's webhook response registry.
|
|
241
|
+
*/
|
|
242
|
+
get webhookResponses(): GraphWebhookResponseRegistry;
|
|
187
243
|
private get emitter();
|
|
188
244
|
private get planner();
|
|
189
245
|
private get valueAdapter();
|
|
@@ -262,6 +318,22 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
262
318
|
* when the active backend declares no lookup support.
|
|
263
319
|
*/
|
|
264
320
|
getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
|
|
321
|
+
/**
|
|
322
|
+
* Applies the engine's workflow-level read authorization to a document that
|
|
323
|
+
* was resolved through the workflow catalogue seam.
|
|
324
|
+
*
|
|
325
|
+
* Ownership is enforced by the persistence store's own read path; this adds
|
|
326
|
+
* the namespace/role check for the resolved document when graph auth is
|
|
327
|
+
* enabled, so a sub-workflow lookup cannot read a namespace-scoped document
|
|
328
|
+
* the caller is not entitled to.
|
|
329
|
+
*
|
|
330
|
+
* @param document - The resolved canonical workflow document.
|
|
331
|
+
* @param auth - The caller's authenticated principal facts.
|
|
332
|
+
* @param logger - Optional run-scoped logger for the denial audit line.
|
|
333
|
+
* @throws {ForbiddenError} when the document's workflow-level namespace/role
|
|
334
|
+
* requirements are not granted.
|
|
335
|
+
*/
|
|
336
|
+
assertWorkflowReadAccess(document: GraphWorkflowDocument, auth: ReturnType<typeof graphAuthDataOf>, logger?: Parameters<GraphAuthValidator["validateWorkflowRead"]>[2]): void;
|
|
265
337
|
/**
|
|
266
338
|
* Lists the workflows a *specific* registered backend can surface, resolved by
|
|
267
339
|
* flavour. This is the flavour-scoped counterpart of {@link listWorkflows}: the
|
|
@@ -330,6 +402,21 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
|
|
|
330
402
|
*/
|
|
331
403
|
private mergeOptions;
|
|
332
404
|
private assertNotAborted;
|
|
405
|
+
/**
|
|
406
|
+
* Registers a run in the sub-workflow depth/child-budget bookkeeping and
|
|
407
|
+
* fails closed when either bound would be exceeded.
|
|
408
|
+
*
|
|
409
|
+
* Depth is inherited through the `parentRunId` chain and only increments when
|
|
410
|
+
* the execution itself is a `subworkflow` edge (the last path segment), so
|
|
411
|
+
* loop bodies remain governed by their iteration caps. The child-run budget
|
|
412
|
+
* is tracked per root run and increments for every sub-workflow child.
|
|
413
|
+
*/
|
|
414
|
+
private enterExecutionBudget;
|
|
415
|
+
/**
|
|
416
|
+
* Releases a finished run's depth/root bookkeeping. The root's child count is
|
|
417
|
+
* removed only when the root itself finishes, after all descendants.
|
|
418
|
+
*/
|
|
419
|
+
private releaseExecutionBudget;
|
|
333
420
|
/**
|
|
334
421
|
* Generates a cryptographically random run id. `crypto.randomUUID` is always
|
|
335
422
|
* available in the backend runtimes as-graph targets; the frontend never
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/engine/execution/GraphNodeEngineRequirements
|
|
3
|
+
* @summary Which node kinds require a specific execution engine (SAA-837 M1).
|
|
4
|
+
* @description Single authority for the kind-level capability boundary the
|
|
5
|
+
* acceptance criteria describe: the mastra AI family (`core.agent` and its
|
|
6
|
+
* `core.agent.*` sub-kinds — tools, hooks, skills, sandbox, scorers) only runs on
|
|
7
|
+
* the mastra backend. The general (local) engine consults this to fail closed
|
|
8
|
+
* instead of executing a registered placeholder for an AI kind it cannot run.
|
|
9
|
+
* Kept engine-private; node manifests keep declaring their own traits.
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* Kind prefix of the mastra AI family. `core.agent` itself (the agent node) and
|
|
13
|
+
* every `core.agent.*` family kind require the mastra engine.
|
|
14
|
+
*/
|
|
15
|
+
export declare const GRAPH_MASTRA_ONLY_KIND_PREFIX = "core.agent";
|
|
16
|
+
/**
|
|
17
|
+
* Whether a node kind requires the mastra engine. The agent node (`core.agent`)
|
|
18
|
+
* and its family kinds (`core.agent.tool`, `core.agent.scorer`, …) return
|
|
19
|
+
* `true`; every general-engine structural/utility/flow kind returns `false`.
|
|
20
|
+
*
|
|
21
|
+
* @param kind - The node kind discriminator.
|
|
22
|
+
* @returns `true` when only the mastra engine can execute the kind.
|
|
23
|
+
*/
|
|
24
|
+
export declare function graphNodeRequiresMastraEngine(kind: string): boolean;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/engine/execution/GraphNodeEngineRequirements
|
|
3
|
+
* @summary Which node kinds require a specific execution engine (SAA-837 M1).
|
|
4
|
+
* @description Single authority for the kind-level capability boundary the
|
|
5
|
+
* acceptance criteria describe: the mastra AI family (`core.agent` and its
|
|
6
|
+
* `core.agent.*` sub-kinds — tools, hooks, skills, sandbox, scorers) only runs on
|
|
7
|
+
* the mastra backend. The general (local) engine consults this to fail closed
|
|
8
|
+
* instead of executing a registered placeholder for an AI kind it cannot run.
|
|
9
|
+
* Kept engine-private; node manifests keep declaring their own traits.
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* Kind prefix of the mastra AI family. `core.agent` itself (the agent node) and
|
|
13
|
+
* every `core.agent.*` family kind require the mastra engine.
|
|
14
|
+
*/
|
|
15
|
+
export declare const GRAPH_MASTRA_ONLY_KIND_PREFIX = "core.agent";
|
|
16
|
+
/**
|
|
17
|
+
* Whether a node kind requires the mastra engine. The agent node (`core.agent`)
|
|
18
|
+
* and its family kinds (`core.agent.tool`, `core.agent.scorer`, …) return
|
|
19
|
+
* `true`; every general-engine structural/utility/flow kind returns `false`.
|
|
20
|
+
*
|
|
21
|
+
* @param kind - The node kind discriminator.
|
|
22
|
+
* @returns `true` when only the mastra engine can execute the kind.
|
|
23
|
+
*/
|
|
24
|
+
export declare function graphNodeRequiresMastraEngine(kind: string): boolean;
|