@decaf-ts/as-graph 0.6.0 → 0.8.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 +857 -27
- package/assets/i18n/en.json +3899 -15
- package/dist/as-graph.cjs +1 -1
- package/dist/as-graph.cjs.map +1 -1
- package/dist/as-graph.js +1 -1
- package/dist/as-graph.js.map +1 -1
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +13 -0
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/dagster/capabilities.cjs +5 -0
- package/lib/cjs/dagster/capabilities.cjs.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/GraphCodeMode.cjs +42 -0
- package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +263 -71
- 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/GraphNodeInstanceValidator.cjs +29 -1
- package/lib/cjs/engine/validation/GraphNodeInstanceValidator.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/engine/validation/GraphWorkflowDocumentValidator.cjs +6 -2
- package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.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 +79 -15
- 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/GraphEngineController.cjs +18 -0
- package/lib/cjs/nest/graph/GraphEngineController.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/GraphNodeCatalogueController.cjs +14 -0
- package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphRunController.cjs +64 -6
- package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphWorkflowController.cjs +34 -5
- package/lib/cjs/nest/graph/GraphWorkflowController.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/discord/node.cjs +384 -0
- package/lib/cjs/node/comms/discord/node.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/outlook/node.cjs +395 -0
- package/lib/cjs/node/comms/outlook/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/comms/whatsapp/node.cjs +341 -0
- package/lib/cjs/node/comms/whatsapp/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/aggregate/node.cjs +196 -0
- package/lib/cjs/node/data/aggregate/node.cjs.map +1 -0
- package/lib/cjs/node/data/compare-datasets/node.cjs +331 -0
- package/lib/cjs/node/data/compare-datasets/node.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/item-lists/node.cjs +416 -0
- package/lib/cjs/node/data/item-lists/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/remove-duplicates/node.cjs +141 -0
- package/lib/cjs/node/data/remove-duplicates/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/summarize/node.cjs +155 -0
- package/lib/cjs/node/data/summarize/node.cjs.map +1 -0
- package/lib/cjs/node/data/support.cjs +403 -0
- package/lib/cjs/node/data/support.cjs.map +1 -0
- package/lib/cjs/node/data/transform-utils.cjs +719 -0
- package/lib/cjs/node/data/transform-utils.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 +508 -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/confluence/node.cjs +253 -0
- package/lib/cjs/node/io/confluence/node.cjs.map +1 -0
- package/lib/cjs/node/io/convert-to-file/node.cjs +349 -0
- package/lib/cjs/node/io/convert-to-file/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/file-support.cjs +311 -0
- package/lib/cjs/node/io/file-support.cjs.map +1 -0
- package/lib/cjs/node/io/google-calendar/node.cjs +359 -0
- package/lib/cjs/node/io/google-calendar/node.cjs.map +1 -0
- package/lib/cjs/node/io/google-docs/node.cjs +272 -0
- package/lib/cjs/node/io/google-docs/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/html/node.cjs +275 -0
- package/lib/cjs/node/io/html/node.cjs.map +1 -0
- package/lib/cjs/node/io/html-extract/node.cjs +162 -0
- package/lib/cjs/node/io/html-extract/node.cjs.map +1 -0
- package/lib/cjs/node/io/html-support.cjs +246 -0
- package/lib/cjs/node/io/html-support.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/jira/node.cjs +351 -0
- package/lib/cjs/node/io/jira/node.cjs.map +1 -0
- package/lib/cjs/node/io/markdown/node.cjs +229 -0
- package/lib/cjs/node/io/markdown/node.cjs.map +1 -0
- package/lib/cjs/node/io/microsoft-excel/node.cjs +261 -0
- package/lib/cjs/node/io/microsoft-excel/node.cjs.map +1 -0
- package/lib/cjs/node/io/microsoft-sharepoint/node.cjs +274 -0
- package/lib/cjs/node/io/microsoft-sharepoint/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-binary-file/node.cjs +114 -0
- package/lib/cjs/node/io/read-binary-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-binary-files/node.cjs +113 -0
- package/lib/cjs/node/io/read-binary-files/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/io/write-binary-file/node.cjs +164 -0
- package/lib/cjs/node/io/write-binary-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/xml/node.cjs +322 -0
- package/lib/cjs/node/io/xml/node.cjs.map +1 -0
- package/lib/cjs/node/manifests.cjs +322 -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/rabbitmq/node.cjs +252 -0
- package/lib/cjs/node/storage/rabbitmq/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/error/node.cjs +108 -0
- package/lib/cjs/node/triggers/error/node.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/node/triggers/postgres/node.cjs +244 -0
- package/lib/cjs/node/triggers/postgres/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/rabbitmq/node.cjs +284 -0
- package/lib/cjs/node/triggers/rabbitmq/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/redis/node.cjs +233 -0
- package/lib/cjs/node/triggers/redis/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/sse/node.cjs +196 -0
- package/lib/cjs/node/triggers/sse/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/support.cjs +107 -0
- package/lib/cjs/node/triggers/support.cjs.map +1 -0
- package/lib/cjs/node/triggers/workflow/node.cjs +193 -0
- package/lib/cjs/node/triggers/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/catalog/GraphValueSchemaDerivation.cjs +20 -3
- package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.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/cjs/workflows/boundary-value.workflow.cjs +38 -0
- package/lib/cjs/workflows/boundary-value.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/builders.cjs +47 -0
- package/lib/cjs/workflows/builders.cjs.map +1 -0
- package/lib/cjs/workflows/chat-agent.workflow.cjs +40 -0
- package/lib/cjs/workflows/chat-agent.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/error-boundary.workflow.cjs +54 -0
- package/lib/cjs/workflows/error-boundary.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/event-map.workflow.cjs +37 -0
- package/lib/cjs/workflows/event-map.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/foreach-break.workflow.cjs +58 -0
- package/lib/cjs/workflows/foreach-break.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/human-approval.workflow.cjs +44 -0
- package/lib/cjs/workflows/human-approval.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/if-switch.workflow.cjs +66 -0
- package/lib/cjs/workflows/if-switch.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/index.cjs +135 -0
- package/lib/cjs/workflows/index.cjs.map +1 -0
- package/lib/cjs/workflows/loops-while-until.workflow.cjs +76 -0
- package/lib/cjs/workflows/loops-while-until.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/manual-log.workflow.cjs +52 -0
- package/lib/cjs/workflows/manual-log.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/schedule-code.workflow.cjs +42 -0
- package/lib/cjs/workflows/schedule-code.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/types.cjs +4 -0
- package/lib/cjs/workflows/types.cjs.map +1 -0
- package/lib/cjs/workflows/value-templates.workflow.cjs +43 -0
- package/lib/cjs/workflows/value-templates.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/webhook-form.workflow.cjs +48 -0
- package/lib/cjs/workflows/webhook-form.workflow.cjs.map +1 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js +13 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
- package/lib/esm/dagster/capabilities.js +5 -0
- package/lib/esm/dagster/capabilities.js.map +1 -1
- 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/GraphCodeMode.js +40 -0
- package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -1
- package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
- package/lib/esm/engine/execution/GraphExecutionEngine.js +265 -73
- 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/GraphNodeInstanceValidator.js +29 -1
- package/lib/esm/engine/validation/GraphNodeInstanceValidator.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/engine/validation/GraphWorkflowDocumentValidator.js +6 -2
- package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.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 +79 -15
- 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/GraphEngineController.js +19 -1
- package/lib/esm/nest/graph/GraphEngineController.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/GraphNodeCatalogueController.js +15 -1
- package/lib/esm/nest/graph/GraphNodeCatalogueController.js.map +1 -1
- package/lib/esm/nest/graph/GraphRunController.js +65 -7
- package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
- package/lib/esm/nest/graph/GraphWorkflowController.js +35 -6
- package/lib/esm/nest/graph/GraphWorkflowController.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/discord/node.js +375 -0
- package/lib/esm/node/comms/discord/node.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/outlook/node.js +386 -0
- package/lib/esm/node/comms/outlook/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/comms/whatsapp/node.js +332 -0
- package/lib/esm/node/comms/whatsapp/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/aggregate/node.js +187 -0
- package/lib/esm/node/data/aggregate/node.js.map +1 -0
- package/lib/esm/node/data/compare-datasets/node.js +322 -0
- package/lib/esm/node/data/compare-datasets/node.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/item-lists/node.js +407 -0
- package/lib/esm/node/data/item-lists/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/remove-duplicates/node.js +132 -0
- package/lib/esm/node/data/remove-duplicates/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/summarize/node.js +146 -0
- package/lib/esm/node/data/summarize/node.js.map +1 -0
- package/lib/esm/node/data/support.js +386 -0
- package/lib/esm/node/data/support.js.map +1 -0
- package/lib/esm/node/data/transform-utils.js +702 -0
- package/lib/esm/node/data/transform-utils.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 +444 -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/confluence/node.js +244 -0
- package/lib/esm/node/io/confluence/node.js.map +1 -0
- package/lib/esm/node/io/convert-to-file/node.js +340 -0
- package/lib/esm/node/io/convert-to-file/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/file-support.js +299 -0
- package/lib/esm/node/io/file-support.js.map +1 -0
- package/lib/esm/node/io/google-calendar/node.js +350 -0
- package/lib/esm/node/io/google-calendar/node.js.map +1 -0
- package/lib/esm/node/io/google-docs/node.js +263 -0
- package/lib/esm/node/io/google-docs/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/html/node.js +266 -0
- package/lib/esm/node/io/html/node.js.map +1 -0
- package/lib/esm/node/io/html-extract/node.js +153 -0
- package/lib/esm/node/io/html-extract/node.js.map +1 -0
- package/lib/esm/node/io/html-support.js +206 -0
- package/lib/esm/node/io/html-support.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/jira/node.js +342 -0
- package/lib/esm/node/io/jira/node.js.map +1 -0
- package/lib/esm/node/io/markdown/node.js +217 -0
- package/lib/esm/node/io/markdown/node.js.map +1 -0
- package/lib/esm/node/io/microsoft-excel/node.js +252 -0
- package/lib/esm/node/io/microsoft-excel/node.js.map +1 -0
- package/lib/esm/node/io/microsoft-sharepoint/node.js +265 -0
- package/lib/esm/node/io/microsoft-sharepoint/node.js.map +1 -0
- package/lib/esm/node/io/read-binary-file/node.js +105 -0
- package/lib/esm/node/io/read-binary-file/node.js.map +1 -0
- package/lib/esm/node/io/read-binary-files/node.js +104 -0
- package/lib/esm/node/io/read-binary-files/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/io/write-binary-file/node.js +155 -0
- package/lib/esm/node/io/write-binary-file/node.js.map +1 -0
- package/lib/esm/node/io/xml/node.js +313 -0
- package/lib/esm/node/io/xml/node.js.map +1 -0
- package/lib/esm/node/manifests.js +286 -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/rabbitmq/node.js +243 -0
- package/lib/esm/node/storage/rabbitmq/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/error/node.js +99 -0
- package/lib/esm/node/triggers/error/node.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/node/triggers/postgres/node.js +235 -0
- package/lib/esm/node/triggers/postgres/node.js.map +1 -0
- package/lib/esm/node/triggers/rabbitmq/node.js +275 -0
- package/lib/esm/node/triggers/rabbitmq/node.js.map +1 -0
- package/lib/esm/node/triggers/redis/node.js +224 -0
- package/lib/esm/node/triggers/redis/node.js.map +1 -0
- package/lib/esm/node/triggers/sse/node.js +187 -0
- package/lib/esm/node/triggers/sse/node.js.map +1 -0
- package/lib/esm/node/triggers/support.js +99 -0
- package/lib/esm/node/triggers/support.js.map +1 -0
- package/lib/esm/node/triggers/workflow/node.js +184 -0
- package/lib/esm/node/triggers/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/catalog/GraphValueSchemaDerivation.js +20 -3
- package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.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/esm/workflows/boundary-value.workflow.js +34 -0
- package/lib/esm/workflows/boundary-value.workflow.js.map +1 -0
- package/lib/esm/workflows/builders.js +40 -0
- package/lib/esm/workflows/builders.js.map +1 -0
- package/lib/esm/workflows/chat-agent.workflow.js +36 -0
- package/lib/esm/workflows/chat-agent.workflow.js.map +1 -0
- package/lib/esm/workflows/error-boundary.workflow.js +50 -0
- package/lib/esm/workflows/error-boundary.workflow.js.map +1 -0
- package/lib/esm/workflows/event-map.workflow.js +33 -0
- package/lib/esm/workflows/event-map.workflow.js.map +1 -0
- package/lib/esm/workflows/foreach-break.workflow.js +54 -0
- package/lib/esm/workflows/foreach-break.workflow.js.map +1 -0
- package/lib/esm/workflows/human-approval.workflow.js +40 -0
- package/lib/esm/workflows/human-approval.workflow.js.map +1 -0
- package/lib/esm/workflows/if-switch.workflow.js +62 -0
- package/lib/esm/workflows/if-switch.workflow.js.map +1 -0
- package/lib/esm/workflows/index.js +116 -0
- package/lib/esm/workflows/index.js.map +1 -0
- package/lib/esm/workflows/loops-while-until.workflow.js +72 -0
- package/lib/esm/workflows/loops-while-until.workflow.js.map +1 -0
- package/lib/esm/workflows/manual-log.workflow.js +48 -0
- package/lib/esm/workflows/manual-log.workflow.js.map +1 -0
- package/lib/esm/workflows/schedule-code.workflow.js +38 -0
- package/lib/esm/workflows/schedule-code.workflow.js.map +1 -0
- package/lib/esm/workflows/types.js +2 -0
- package/lib/esm/workflows/types.js.map +1 -0
- package/lib/esm/workflows/value-templates.workflow.js +39 -0
- package/lib/esm/workflows/value-templates.workflow.js.map +1 -0
- package/lib/esm/workflows/webhook-form.workflow.js +44 -0
- package/lib/esm/workflows/webhook-form.workflow.js.map +1 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +7 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +7 -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/GraphCodeMode.d.cts +46 -0
- package/lib/types/engine/execution/GraphCodeMode.d.mts +46 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.cts +21 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.mts +21 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -4
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -4
- 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/GraphNodeInstanceValidator.d.cts +11 -1
- package/lib/types/engine/validation/GraphNodeInstanceValidator.d.mts +11 -1
- package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
- package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
- package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.cts +7 -0
- package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.mts +7 -0
- 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/MastraWorkflowCompiler.d.cts +23 -8
- package/lib/types/mastra/MastraWorkflowCompiler.d.mts +23 -8
- 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/GraphEngineController.d.cts +19 -0
- package/lib/types/nest/graph/GraphEngineController.d.mts +19 -0
- 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/GraphNodeCatalogueController.d.cts +13 -0
- package/lib/types/nest/graph/GraphNodeCatalogueController.d.mts +13 -0
- package/lib/types/nest/graph/GraphRunController.d.cts +40 -4
- package/lib/types/nest/graph/GraphRunController.d.mts +40 -4
- package/lib/types/nest/graph/GraphWorkflowController.d.cts +26 -3
- package/lib/types/nest/graph/GraphWorkflowController.d.mts +26 -3
- 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/discord/node.d.cts +67 -0
- package/lib/types/node/comms/discord/node.d.mts +67 -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/outlook/node.d.cts +77 -0
- package/lib/types/node/comms/outlook/node.d.mts +77 -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/comms/whatsapp/node.d.cts +71 -0
- package/lib/types/node/comms/whatsapp/node.d.mts +71 -0
- package/lib/types/node/credentials.d.cts +43 -0
- package/lib/types/node/credentials.d.mts +43 -0
- package/lib/types/node/data/aggregate/node.d.cts +58 -0
- package/lib/types/node/data/aggregate/node.d.mts +58 -0
- package/lib/types/node/data/compare-datasets/node.d.cts +72 -0
- package/lib/types/node/data/compare-datasets/node.d.mts +72 -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/item-lists/node.d.cts +92 -0
- package/lib/types/node/data/item-lists/node.d.mts +92 -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/remove-duplicates/node.d.cts +47 -0
- package/lib/types/node/data/remove-duplicates/node.d.mts +47 -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/summarize/node.d.cts +44 -0
- package/lib/types/node/data/summarize/node.d.mts +44 -0
- package/lib/types/node/data/support.d.cts +177 -0
- package/lib/types/node/data/support.d.mts +177 -0
- package/lib/types/node/data/transform-utils.d.cts +236 -0
- package/lib/types/node/data/transform-utils.d.mts +236 -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 +230 -2
- package/lib/types/node/index.d.mts +230 -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/confluence/node.d.cts +49 -0
- package/lib/types/node/io/confluence/node.d.mts +49 -0
- package/lib/types/node/io/convert-to-file/node.d.cts +75 -0
- package/lib/types/node/io/convert-to-file/node.d.mts +75 -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/file-support.d.cts +118 -0
- package/lib/types/node/io/file-support.d.mts +118 -0
- package/lib/types/node/io/google-calendar/node.d.cts +65 -0
- package/lib/types/node/io/google-calendar/node.d.mts +65 -0
- package/lib/types/node/io/google-docs/node.d.cts +51 -0
- package/lib/types/node/io/google-docs/node.d.mts +51 -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/html/node.d.cts +68 -0
- package/lib/types/node/io/html/node.d.mts +68 -0
- package/lib/types/node/io/html-extract/node.d.cts +42 -0
- package/lib/types/node/io/html-extract/node.d.mts +42 -0
- package/lib/types/node/io/html-support.d.cts +69 -0
- package/lib/types/node/io/html-support.d.mts +69 -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/jira/node.d.cts +57 -0
- package/lib/types/node/io/jira/node.d.mts +57 -0
- package/lib/types/node/io/markdown/node.d.cts +61 -0
- package/lib/types/node/io/markdown/node.d.mts +61 -0
- package/lib/types/node/io/microsoft-excel/node.d.cts +45 -0
- package/lib/types/node/io/microsoft-excel/node.d.mts +45 -0
- package/lib/types/node/io/microsoft-sharepoint/node.d.cts +47 -0
- package/lib/types/node/io/microsoft-sharepoint/node.d.mts +47 -0
- package/lib/types/node/io/read-binary-file/node.d.cts +45 -0
- package/lib/types/node/io/read-binary-file/node.d.mts +45 -0
- package/lib/types/node/io/read-binary-files/node.d.cts +41 -0
- package/lib/types/node/io/read-binary-files/node.d.mts +41 -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/io/write-binary-file/node.d.cts +55 -0
- package/lib/types/node/io/write-binary-file/node.d.mts +55 -0
- package/lib/types/node/io/xml/node.d.cts +67 -0
- package/lib/types/node/io/xml/node.d.mts +67 -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/rabbitmq/node.d.cts +55 -0
- package/lib/types/node/storage/rabbitmq/node.d.mts +55 -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/error/node.d.cts +34 -0
- package/lib/types/node/triggers/error/node.d.mts +34 -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/node/triggers/postgres/node.d.cts +54 -0
- package/lib/types/node/triggers/postgres/node.d.mts +54 -0
- package/lib/types/node/triggers/rabbitmq/node.d.cts +59 -0
- package/lib/types/node/triggers/rabbitmq/node.d.mts +59 -0
- package/lib/types/node/triggers/redis/node.d.cts +53 -0
- package/lib/types/node/triggers/redis/node.d.mts +53 -0
- package/lib/types/node/triggers/sse/node.d.cts +43 -0
- package/lib/types/node/triggers/sse/node.d.mts +43 -0
- package/lib/types/node/triggers/support.d.cts +41 -0
- package/lib/types/node/triggers/support.d.mts +41 -0
- package/lib/types/node/triggers/workflow/node.d.cts +46 -0
- package/lib/types/node/triggers/workflow/node.d.mts +46 -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/lib/types/workflows/boundary-value.workflow.d.cts +3 -0
- package/lib/types/workflows/boundary-value.workflow.d.mts +3 -0
- package/lib/types/workflows/builders.d.cts +31 -0
- package/lib/types/workflows/builders.d.mts +31 -0
- package/lib/types/workflows/chat-agent.workflow.d.cts +3 -0
- package/lib/types/workflows/chat-agent.workflow.d.mts +3 -0
- package/lib/types/workflows/error-boundary.workflow.d.cts +3 -0
- package/lib/types/workflows/error-boundary.workflow.d.mts +3 -0
- package/lib/types/workflows/event-map.workflow.d.cts +3 -0
- package/lib/types/workflows/event-map.workflow.d.mts +3 -0
- package/lib/types/workflows/foreach-break.workflow.d.cts +3 -0
- package/lib/types/workflows/foreach-break.workflow.d.mts +3 -0
- package/lib/types/workflows/human-approval.workflow.d.cts +3 -0
- package/lib/types/workflows/human-approval.workflow.d.mts +3 -0
- package/lib/types/workflows/if-switch.workflow.d.cts +3 -0
- package/lib/types/workflows/if-switch.workflow.d.mts +3 -0
- package/lib/types/workflows/index.d.cts +37 -0
- package/lib/types/workflows/index.d.mts +37 -0
- package/lib/types/workflows/loops-while-until.workflow.d.cts +3 -0
- package/lib/types/workflows/loops-while-until.workflow.d.mts +3 -0
- package/lib/types/workflows/manual-log.workflow.d.cts +3 -0
- package/lib/types/workflows/manual-log.workflow.d.mts +3 -0
- package/lib/types/workflows/schedule-code.workflow.d.cts +3 -0
- package/lib/types/workflows/schedule-code.workflow.d.mts +3 -0
- package/lib/types/workflows/types.d.cts +32 -0
- package/lib/types/workflows/types.d.mts +32 -0
- package/lib/types/workflows/value-templates.workflow.d.cts +16 -0
- package/lib/types/workflows/value-templates.workflow.d.mts +16 -0
- package/lib/types/workflows/webhook-form.workflow.d.cts +3 -0
- package/lib/types/workflows/webhook-form.workflow.d.mts +3 -0
- package/package.json +283 -21
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
import type { Logger } from "@decaf-ts/logging";
|
|
2
|
+
/** The mastra runtime surface the observability layer attaches through
|
|
3
|
+
* (`@mastra/core`'s `Mastra.registerExporter`). Real mastra runtimes always
|
|
4
|
+
* expose it; duck-typed test doubles do not, and for those the wiring is
|
|
5
|
+
* skipped so the general engine keeps booting them unchanged.
|
|
6
|
+
*/
|
|
7
|
+
export declare const GRAPH_MASTRA_OBSERVABILITY_RUNTIME_METHOD = "registerExporter";
|
|
8
|
+
/** Canonical attribute key the compiler stamps onto every translated mastra
|
|
9
|
+
* step so exported spans carry the OUR-node origin. */
|
|
10
|
+
export declare const MASTRA_DECAF_NODE_ORIGIN_KEY = "decafNode";
|
|
11
|
+
/** Resolved mastra observability configuration (SAA-836 O1). */
|
|
12
|
+
export interface MastraObservabilityConfig {
|
|
13
|
+
/** Whether the observability layer is wired at engine boot. */
|
|
14
|
+
enabled: boolean;
|
|
15
|
+
/** The service name attached to every exported trace. */
|
|
16
|
+
serviceName: string;
|
|
17
|
+
/** Optional deployment environment tag attached to exported traces. */
|
|
18
|
+
environment: string;
|
|
19
|
+
langfuse: {
|
|
20
|
+
/** The langfuse endpoint traces are exported to (non-secret). */
|
|
21
|
+
endpoint: string;
|
|
22
|
+
/** The name of the `.env.secret` variable carrying the langfuse public key. */
|
|
23
|
+
publicKeyEnv: string;
|
|
24
|
+
/** The name of the `.env.secret` variable carrying the langfuse secret key. */
|
|
25
|
+
secretKeyEnv: string;
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Reads the mastra observability configuration from the accumulated mastra
|
|
30
|
+
* environment (the `MASTRA__OBSERVABILITY__*` overrides are already applied by
|
|
31
|
+
* {@link MastraEnvironment}).
|
|
32
|
+
*
|
|
33
|
+
* @returns The resolved observability configuration.
|
|
34
|
+
*/
|
|
35
|
+
export declare function resolveMastraObservabilityConfig(): MastraObservabilityConfig;
|
|
36
|
+
/** The OUR-node origin the compiler stamps onto a translated mastra step. */
|
|
37
|
+
export interface MastraDecafNodeOrigin {
|
|
38
|
+
/** The canonical graph node id the step was translated from. */
|
|
39
|
+
id: string;
|
|
40
|
+
/** The canonical graph node kind the step was translated from. */
|
|
41
|
+
kind: string;
|
|
42
|
+
}
|
|
43
|
+
/** A minimal exported-span surface the isolation classifier reads (duck-typed
|
|
44
|
+
* against `@mastra/core/observability`'s `AnyExportedSpan` so the classifier
|
|
45
|
+
* stays usable without importing the mastra runtime). */
|
|
46
|
+
export interface MastraExportedSpanLike {
|
|
47
|
+
id: string;
|
|
48
|
+
traceId: string;
|
|
49
|
+
name: string;
|
|
50
|
+
type?: string;
|
|
51
|
+
entityType?: string;
|
|
52
|
+
entityId?: string;
|
|
53
|
+
attributes?: Record<string, unknown>;
|
|
54
|
+
metadata?: Record<string, unknown>;
|
|
55
|
+
[key: string]: unknown;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Resolves the OUR-node origin an exported span carries **by metadata**, when
|
|
59
|
+
* any. The origin is stamped by the workflow compiler under
|
|
60
|
+
* {@link MASTRA_DECAF_NODE_ORIGIN_KEY} on the step's entry metadata.
|
|
61
|
+
*
|
|
62
|
+
* @param span - The exported span to classify.
|
|
63
|
+
* @returns The OUR-node origin, or `undefined` for engine-internal spans.
|
|
64
|
+
*/
|
|
65
|
+
export declare function decafNodeOriginOf(span: MastraExportedSpanLike | undefined): MastraDecafNodeOrigin | undefined;
|
|
66
|
+
/**
|
|
67
|
+
* The OUR-node isolation exporter (SAA-836 O1). Implements mastra's
|
|
68
|
+
* `ObservabilityExporter` contract on top of OUR observability layer: every
|
|
69
|
+
* event the mastra engine exports is received here and logged through the
|
|
70
|
+
* decaf logger, attributed to the canonical graph node it belongs to when the
|
|
71
|
+
* span carries the compiler-stamped `decafNode` origin — so OUR-node signals
|
|
72
|
+
* are isolatable in OUR observability (`decaf-node` scope) from
|
|
73
|
+
* engine-internal signals (`decaf-engine` scope) while mastra still catches
|
|
74
|
+
* everything on its engine.
|
|
75
|
+
*
|
|
76
|
+
* The exporter never throws into the engine's export pipeline: a logging
|
|
77
|
+
* failure is swallowed so observability cannot break a run.
|
|
78
|
+
*/
|
|
79
|
+
export declare class DecafNodeObservabilityExporter {
|
|
80
|
+
/** The exporter name mastra registers. */
|
|
81
|
+
readonly name = "decaf-node-observability";
|
|
82
|
+
private readonly logger;
|
|
83
|
+
/** Canonical node origins known to the isolation classifier, keyed by node
|
|
84
|
+
* id. The backend tracks the executed document's nodes per run. */
|
|
85
|
+
private readonly knownNodes;
|
|
86
|
+
constructor(logger?: Logger);
|
|
87
|
+
/**
|
|
88
|
+
* Tracks the canonical nodes of a document about to run, so the isolation
|
|
89
|
+
* classifier can attribute mastra's `workflow step: '<stepId>'` spans (the
|
|
90
|
+
* step id is the canonical node id) to their OUR-node origin.
|
|
91
|
+
*
|
|
92
|
+
* @param nodes - The canonical nodes of the document being executed.
|
|
93
|
+
*/
|
|
94
|
+
trackNodes(nodes: readonly {
|
|
95
|
+
id: string;
|
|
96
|
+
kind: string;
|
|
97
|
+
}[]): void;
|
|
98
|
+
/**
|
|
99
|
+
* Classifies an exported span: the OUR-node origin when the span belongs to
|
|
100
|
+
* a canonical graph node (via the compiler-stamped entry metadata or a
|
|
101
|
+
* mastra workflow-step span naming a tracked canonical node id),
|
|
102
|
+
* `undefined` for engine-internal spans.
|
|
103
|
+
*
|
|
104
|
+
* @param span - The exported span to classify.
|
|
105
|
+
* @returns The OUR-node origin, or `undefined`.
|
|
106
|
+
*/
|
|
107
|
+
originOf(span: MastraExportedSpanLike | undefined): MastraDecafNodeOrigin | undefined;
|
|
108
|
+
/** The engine-scope logger for signals without an OUR-node origin. */
|
|
109
|
+
private engineFor;
|
|
110
|
+
/**
|
|
111
|
+
* Exports a tracing event into OUR observability layer, attributed to the
|
|
112
|
+
* canonical node when the span belongs to one.
|
|
113
|
+
*
|
|
114
|
+
* @param event - The tracing event mastra's export pipeline emitted.
|
|
115
|
+
*/
|
|
116
|
+
exportTracingEvent(event: {
|
|
117
|
+
type: string;
|
|
118
|
+
exportedSpan?: MastraExportedSpanLike;
|
|
119
|
+
}): Promise<void>;
|
|
120
|
+
/** Aliased mastra tracing-event hook (pipeline calls both spellings). */
|
|
121
|
+
onTracingEvent(event: {
|
|
122
|
+
type: string;
|
|
123
|
+
exportedSpan?: MastraExportedSpanLike;
|
|
124
|
+
}): Promise<void>;
|
|
125
|
+
/**
|
|
126
|
+
* Exports a log event into OUR observability layer.
|
|
127
|
+
*
|
|
128
|
+
* @param event - The log event mastra's export pipeline emitted.
|
|
129
|
+
*/
|
|
130
|
+
onLogEvent(event: {
|
|
131
|
+
message?: unknown;
|
|
132
|
+
[key: string]: unknown;
|
|
133
|
+
}): Promise<void>;
|
|
134
|
+
/**
|
|
135
|
+
* Exports a metric event into OUR observability layer.
|
|
136
|
+
*
|
|
137
|
+
* @param event - The metric event mastra's export pipeline emitted.
|
|
138
|
+
*/
|
|
139
|
+
onMetricEvent(event: {
|
|
140
|
+
[key: string]: unknown;
|
|
141
|
+
}): Promise<void>;
|
|
142
|
+
/**
|
|
143
|
+
* Exports a score event into OUR observability layer.
|
|
144
|
+
*
|
|
145
|
+
* @param event - The score event mastra's export pipeline emitted.
|
|
146
|
+
*/
|
|
147
|
+
onScoreEvent(event: {
|
|
148
|
+
[key: string]: unknown;
|
|
149
|
+
}): Promise<void>;
|
|
150
|
+
/**
|
|
151
|
+
* Exports an exporter-pipeline drop event into OUR observability layer.
|
|
152
|
+
*
|
|
153
|
+
* @param event - The drop event mastra's export pipeline emitted.
|
|
154
|
+
*/
|
|
155
|
+
onDroppedEvent(event: {
|
|
156
|
+
[key: string]: unknown;
|
|
157
|
+
}): Promise<void>;
|
|
158
|
+
/** No buffered state: flush resolves immediately. */
|
|
159
|
+
flush(): Promise<void>;
|
|
160
|
+
/** No external resources held: shutdown resolves immediately. */
|
|
161
|
+
shutdown(): Promise<void>;
|
|
162
|
+
}
|
|
163
|
+
/** The live observability wiring attached to a mastra runtime. */
|
|
164
|
+
export interface MastraObservabilityHandle {
|
|
165
|
+
/** The OUR-node isolation exporter registered on the runtime. */
|
|
166
|
+
decafExporter: DecafNodeObservabilityExporter;
|
|
167
|
+
/** Flushes every registered exporter (used at engine dispose). */
|
|
168
|
+
flush(): Promise<void>;
|
|
169
|
+
/** Shuts every registered exporter down and releases their resources. */
|
|
170
|
+
shutdown(): Promise<void>;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Wires the mastra observability layer onto a real mastra runtime
|
|
174
|
+
* (SAA-836 O1). When the observability lane is disabled, or when the runtime
|
|
175
|
+
* exposes no mastra `registerExporter` surface (a duck-typed test double,
|
|
176
|
+
* never a real `@mastra/core` runtime), the runtime is left untouched and
|
|
177
|
+
* `undefined` is returned. When enabled on a mastra-native runtime, wiring
|
|
178
|
+
* fails closed on credentials: without the user-supplied langfuse
|
|
179
|
+
* `.env.secret` credentials the layer throws
|
|
180
|
+
* {@link GRAPH_MASTRA_OBSERVABILITY_CREDENTIALS_UNAVAILABLE} (gate C) —
|
|
181
|
+
* langfuse is the default and always-present target, so no degraded
|
|
182
|
+
* unauthenticated export path exists.
|
|
183
|
+
*
|
|
184
|
+
* The langfuse exporter is mastra's official `@mastra/langfuse`
|
|
185
|
+
* `LangfuseExporter` (R2 wrap justification recorded in the module docs). The
|
|
186
|
+
* OUR-node isolation exporter is registered alongside it so OUR nodes stay
|
|
187
|
+
* isolatable in OUR observability layer.
|
|
188
|
+
*
|
|
189
|
+
* @param runtime - The wired mastra runtime (a real `@mastra/core` `Mastra`).
|
|
190
|
+
* @param env - The runtime environment bag the credentials are read from;
|
|
191
|
+
* defaults to `process.env`.
|
|
192
|
+
* @returns The observability handle, or `undefined` when the lane is disabled
|
|
193
|
+
* or the runtime is not mastra-native.
|
|
194
|
+
* @throws {GraphExecutionError} when the lane is enabled on a mastra-native
|
|
195
|
+
* runtime but the langfuse credentials are unavailable.
|
|
196
|
+
*/
|
|
197
|
+
export declare function wireMastraObservability(runtime: unknown, env?: Record<string, string | undefined>): Promise<MastraObservabilityHandle | undefined>;
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraPersistence
|
|
3
|
+
* @summary The approved per-layer mastra persistence routing (SAA-836 O1,
|
|
4
|
+
* gate A approved 2026-10-17).
|
|
5
|
+
* @description Maps each mastra-layer object kind to its best-fit storage
|
|
6
|
+
* adapter, Environment-driven through `MASTRA__PERSISTENCE__*` (non-secret,
|
|
7
|
+
* `.env`), with different kinds routed to different adapters by default:
|
|
8
|
+
*
|
|
9
|
+
* - **replays** (versioned run replay snapshots backing restore; mastra's own
|
|
10
|
+
* time-travel mechanism stays the replay engine) → `fs` adapter by default —
|
|
11
|
+
* restart-safe local snapshots with no database driver;
|
|
12
|
+
* - **cache** (compiled-workflow cache ledger keyed by document id +
|
|
13
|
+
* fingerprint; invalidated atomically on fingerprint change so
|
|
14
|
+
* recompilation happens only when the document changes, never per run) →
|
|
15
|
+
* `ram` adapter by default — process-lifetime, fully rebuildable;
|
|
16
|
+
* - **pins** (durable user-owned pinned node states) → `fs` adapter by
|
|
17
|
+
* default. The mastra lane itself declares pinning `NOT-SUPPORTED`
|
|
18
|
+
* (capability table), so the routed adapter is exposed for host value-store
|
|
19
|
+
* wiring only;
|
|
20
|
+
* - **workflows** are NOT routed here — they persist via the as-graph adapter
|
|
21
|
+
* only (binding rule), versioned with restore.
|
|
22
|
+
*
|
|
23
|
+
* The built-in decaf `RamAdapter` and `FilesystemAdapter` back the defaults,
|
|
24
|
+
* so no new database driver is ever required (R8): a host may override any
|
|
25
|
+
* layer with its own adapter (a driver-backed PG/CouchDB adapter activates
|
|
26
|
+
* only when the host configures it). Replay/cache recording is auxiliary:
|
|
27
|
+
* a recording failure never fails a run (logged and skipped), while a
|
|
28
|
+
* restore of a missing snapshot fails closed explicitly (nil rows never,
|
|
29
|
+
* R7). No secret value is ever persisted: payloads are JSON-safe projections.
|
|
30
|
+
*/
|
|
31
|
+
import { Adapter, Repository } from "@decaf-ts/core";
|
|
32
|
+
import { BaseModel } from "@decaf-ts/core";
|
|
33
|
+
import type { Logger } from "@decaf-ts/logging";
|
|
34
|
+
/**
|
|
35
|
+
* Repairs the `Adapter.setCurrent("fs")` import side effect that the
|
|
36
|
+
* `@decaf-ts/core` `./fs` subpath module runs with no adapter registered
|
|
37
|
+
* (core 0.32.x): hands the current flavour back to a registered adapter, or
|
|
38
|
+
* clears it entirely when none exists, so importing the mastra lane never
|
|
39
|
+
* poisons the process-global current flavour.
|
|
40
|
+
*/
|
|
41
|
+
export declare function repairCoreFsCurrentFlavourSideEffect(): void;
|
|
42
|
+
import { type MastraPersistenceAdapterKind } from "./MastraEnvironment.d.cts";
|
|
43
|
+
/**
|
|
44
|
+
* Projects a run value into a JSON-safe form for persistence (no secret or
|
|
45
|
+
* live instance value ever reaches a stored payload): serialisable values
|
|
46
|
+
* round-trip through JSON, cycles and non-serialisable values (functions,
|
|
47
|
+
* class instances that cannot survive the round-trip) degrade to a typed
|
|
48
|
+
* placeholder string, matching the JSON-safe descriptor precedent of the
|
|
49
|
+
* memory layer (R9).
|
|
50
|
+
*
|
|
51
|
+
* @param value - The runtime value to project.
|
|
52
|
+
* @param depth - The current recursion depth; values nested deeper than 8
|
|
53
|
+
* levels degrade to the `[non-serializable:depth]` placeholder (callers
|
|
54
|
+
* omit it — it is threaded by the recursion).
|
|
55
|
+
* @returns The JSON-safe projection.
|
|
56
|
+
*/
|
|
57
|
+
export declare function jsonSafeProjection(value: unknown, depth?: number): unknown;
|
|
58
|
+
/** The mastra-layer persistence kinds the router routes. */
|
|
59
|
+
export type MastraPersistenceLayer = "replays" | "cache" | "pins";
|
|
60
|
+
/** Resolved per-layer persistence configuration (gate A approved defaults). */
|
|
61
|
+
export interface MastraPersistenceConfig {
|
|
62
|
+
/** Adapter kind for the replay-snapshot layer. */
|
|
63
|
+
replaysAdapter: MastraPersistenceAdapterKind;
|
|
64
|
+
/** Adapter kind for the compiled-workflow cache layer. */
|
|
65
|
+
cacheAdapter: MastraPersistenceAdapterKind;
|
|
66
|
+
/** Adapter kind for the pinned-values layer. */
|
|
67
|
+
pinsAdapter: MastraPersistenceAdapterKind;
|
|
68
|
+
/** Base directory for the filesystem adapters' persisted data. */
|
|
69
|
+
fsRoot: string;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Reads the per-layer persistence routing from the accumulated mastra
|
|
73
|
+
* environment (the `MASTRA__PERSISTENCE__*` overrides are already applied by
|
|
74
|
+
* {@link MastraEnvironment}).
|
|
75
|
+
*
|
|
76
|
+
* @returns The resolved persistence configuration.
|
|
77
|
+
*/
|
|
78
|
+
export declare function resolveMastraPersistenceConfig(): MastraPersistenceConfig;
|
|
79
|
+
/**
|
|
80
|
+
* Persistable replay snapshot of a mastra run (SAA-836 O1, replays layer).
|
|
81
|
+
* The `id` is `${runId}::v${version}`, so a run's snapshots are versioned and
|
|
82
|
+
* restorable; the payload is a JSON-safe projection of the run outcome (the
|
|
83
|
+
* live mastra run objects are never persisted).
|
|
84
|
+
*/
|
|
85
|
+
export declare class MastraReplaySnapshotModel extends BaseModel {
|
|
86
|
+
/** Stable `${runId}::v${version}` snapshot key. */
|
|
87
|
+
id: string;
|
|
88
|
+
/** The graph run the snapshot belongs to. */
|
|
89
|
+
runId: string;
|
|
90
|
+
/** The workflow the run executed. */
|
|
91
|
+
workflowId: string;
|
|
92
|
+
/** The document fingerprint the run executed against. */
|
|
93
|
+
documentFingerprint: string;
|
|
94
|
+
/** Monotonic per-run snapshot version (1-based). */
|
|
95
|
+
version: number;
|
|
96
|
+
/** The run's terminal status at snapshot time. */
|
|
97
|
+
status: string;
|
|
98
|
+
/** JSON-safe projection of the run outcome. */
|
|
99
|
+
payload: Record<string, unknown>;
|
|
100
|
+
/** Snapshot creation timestamp. */
|
|
101
|
+
createdAt: Date;
|
|
102
|
+
/** Snapshot last-update timestamp. */
|
|
103
|
+
updatedAt: Date;
|
|
104
|
+
constructor(arg?: Partial<MastraReplaySnapshotModel>);
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Persistable compiled-workflow cache ledger entry (SAA-836 O1, cache layer).
|
|
108
|
+
* Keyed `${workflowId}::${fingerprint}`; the compiled mastra artifacts
|
|
109
|
+
* themselves (functions, schemas) stay in-process — the ledger makes the
|
|
110
|
+
* cache layer's state inspectable and atomically invalidatable.
|
|
111
|
+
*/
|
|
112
|
+
export declare class MastraCacheEntryModel extends BaseModel {
|
|
113
|
+
/** Stable `${workflowId}::${fingerprint}` cache key. */
|
|
114
|
+
id: string;
|
|
115
|
+
/** The canonical workflow document id. */
|
|
116
|
+
workflowId: string;
|
|
117
|
+
/** The document fingerprint the entry was compiled from. */
|
|
118
|
+
fingerprint: string;
|
|
119
|
+
/** When the entry was compiled. */
|
|
120
|
+
compiledAt: Date;
|
|
121
|
+
/** Entry creation timestamp. */
|
|
122
|
+
createdAt: Date;
|
|
123
|
+
/** Entry last-update timestamp. */
|
|
124
|
+
updatedAt: Date;
|
|
125
|
+
constructor(arg?: Partial<MastraCacheEntryModel>);
|
|
126
|
+
}
|
|
127
|
+
/** Adapter-backed repository for versioned replay snapshots. */
|
|
128
|
+
export declare class MastraReplayRepository extends Repository<MastraReplaySnapshotModel, Adapter<any, any, any, any>> {
|
|
129
|
+
/**
|
|
130
|
+
* Builds the replay-snapshot repository over an adapter (or the
|
|
131
|
+
* flavour-registered default).
|
|
132
|
+
*
|
|
133
|
+
* @param adapter - The Decaf adapter backing the layer, when not resolved
|
|
134
|
+
* from the registry.
|
|
135
|
+
*/
|
|
136
|
+
constructor(adapter?: Adapter<any, any, any, any>);
|
|
137
|
+
/**
|
|
138
|
+
* Records a new versioned snapshot for a run (1-based monotonic per-run
|
|
139
|
+
* version).
|
|
140
|
+
*
|
|
141
|
+
* @param entry - The snapshot content (without id/version).
|
|
142
|
+
* @returns The recorded version.
|
|
143
|
+
*/
|
|
144
|
+
record(entry: {
|
|
145
|
+
runId: string;
|
|
146
|
+
workflowId: string;
|
|
147
|
+
documentFingerprint: string;
|
|
148
|
+
status: string;
|
|
149
|
+
payload: Record<string, unknown>;
|
|
150
|
+
}): Promise<number>;
|
|
151
|
+
/**
|
|
152
|
+
* Lists the snapshot versions recorded for a run, ascending.
|
|
153
|
+
*
|
|
154
|
+
* @param runId - The run to list.
|
|
155
|
+
* @returns The recorded versions.
|
|
156
|
+
*/
|
|
157
|
+
versions(runId: string): Promise<number[]>;
|
|
158
|
+
/**
|
|
159
|
+
* Restores a run's replay snapshot: the requested version, or the latest
|
|
160
|
+
* recorded version when none is given. Fails closed when the run has no
|
|
161
|
+
* snapshot (nil rows never, R7).
|
|
162
|
+
*
|
|
163
|
+
* @param runId - The run to restore.
|
|
164
|
+
* @param version - The specific version, when given.
|
|
165
|
+
* @returns The restored snapshot.
|
|
166
|
+
* @throws {NotFoundError} when no snapshot exists for the run/version.
|
|
167
|
+
*/
|
|
168
|
+
restore(runId: string, version?: number): Promise<MastraReplaySnapshotModel>;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Creates a fresh {@link MastraReplayRepository} bound to the provided
|
|
172
|
+
* adapter, resolving the `@repository`-registered constructor (the
|
|
173
|
+
* decoration replaces the constructor with an injectable factory, so a direct
|
|
174
|
+
* `new` would drop the adapter — same pattern as the graph value store).
|
|
175
|
+
*
|
|
176
|
+
* @param adapter - The Decaf adapter backing the replay layer.
|
|
177
|
+
* @returns A repository instance bound to the adapter.
|
|
178
|
+
*/
|
|
179
|
+
export declare function createMastraReplayRepository(adapter: Adapter<any, any, any, any>): MastraReplayRepository;
|
|
180
|
+
/** Adapter-backed repository for the compiled-workflow cache ledger. */
|
|
181
|
+
export declare class MastraCacheRepository extends Repository<MastraCacheEntryModel, Adapter<any, any, any, any>> {
|
|
182
|
+
/**
|
|
183
|
+
* Builds the cache-ledger repository over an adapter (or the
|
|
184
|
+
* flavour-registered default).
|
|
185
|
+
*
|
|
186
|
+
* @param adapter - The Decaf adapter backing the layer, when not resolved
|
|
187
|
+
* from the registry.
|
|
188
|
+
*/
|
|
189
|
+
constructor(adapter?: Adapter<any, any, any, any>);
|
|
190
|
+
/**
|
|
191
|
+
* Records (or refreshes) the cache ledger entry for a compilation.
|
|
192
|
+
*
|
|
193
|
+
* @param workflowId - The canonical workflow document id.
|
|
194
|
+
* @param fingerprint - The document fingerprint it was compiled from.
|
|
195
|
+
*/
|
|
196
|
+
record(workflowId: string, fingerprint: string): Promise<void>;
|
|
197
|
+
/**
|
|
198
|
+
* Invalidates every cache ledger entry for a workflow compiled from a
|
|
199
|
+
* different fingerprint than the one given — the atomic counterpart of a
|
|
200
|
+
* recompilation on document change.
|
|
201
|
+
*
|
|
202
|
+
* @param workflowId - The canonical workflow document id.
|
|
203
|
+
* @param keepFingerprint - The fingerprint to keep.
|
|
204
|
+
*/
|
|
205
|
+
invalidate(workflowId: string, keepFingerprint: string): Promise<void>;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Creates a fresh {@link MastraCacheRepository} bound to the provided
|
|
209
|
+
* adapter (same pattern as {@link createMastraReplayRepository}).
|
|
210
|
+
*
|
|
211
|
+
* @param adapter - The Decaf adapter backing the cache layer.
|
|
212
|
+
* @returns A repository instance bound to the adapter.
|
|
213
|
+
*/
|
|
214
|
+
export declare function createMastraCacheRepository(adapter: Adapter<any, any, any, any>): MastraCacheRepository;
|
|
215
|
+
/** Host-supplied adapter overrides for individual layers (R8 on-demand). */
|
|
216
|
+
export type MastraPersistenceAdapterOverrides = Partial<Record<MastraPersistenceLayer, Adapter<any, any, any, any>>>;
|
|
217
|
+
/** The routed per-layer persistence surface. */
|
|
218
|
+
export interface MastraPersistence {
|
|
219
|
+
/** The resolved routing configuration. */
|
|
220
|
+
config: MastraPersistenceConfig;
|
|
221
|
+
/** The adapter backing each layer. */
|
|
222
|
+
adapters: Record<MastraPersistenceLayer, Adapter<any, any, any, any>>;
|
|
223
|
+
/** The versioned replay-snapshot store (replays layer). */
|
|
224
|
+
replays: MastraReplayRepository;
|
|
225
|
+
/** The compiled-workflow cache ledger (cache layer). */
|
|
226
|
+
cache: MastraCacheRepository;
|
|
227
|
+
/** Shuts the routed adapters down (owned adapters only). */
|
|
228
|
+
shutdown(): Promise<void>;
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* Builds the per-layer persistence routing: one adapter per layer from the
|
|
232
|
+
* Environment-resolved configuration (`ram`/`fs`), with host-supplied adapter
|
|
233
|
+
* overrides taking precedence (R8 on-demand driver adapters). Adapters are
|
|
234
|
+
* initialized eagerly; a layer whose adapter fails to initialize fails the
|
|
235
|
+
* construction — hosts route that layer to `ram` or supply their own adapter.
|
|
236
|
+
*
|
|
237
|
+
* @param overrides - Host-supplied per-layer adapter overrides.
|
|
238
|
+
* @param logger - Optional logger for construction diagnostics.
|
|
239
|
+
* @returns The routed persistence surface.
|
|
240
|
+
*/
|
|
241
|
+
export declare function createMastraPersistence(overrides?: MastraPersistenceAdapterOverrides, logger?: Logger): Promise<MastraPersistence>;
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraPersistence
|
|
3
|
+
* @summary The approved per-layer mastra persistence routing (SAA-836 O1,
|
|
4
|
+
* gate A approved 2026-10-17).
|
|
5
|
+
* @description Maps each mastra-layer object kind to its best-fit storage
|
|
6
|
+
* adapter, Environment-driven through `MASTRA__PERSISTENCE__*` (non-secret,
|
|
7
|
+
* `.env`), with different kinds routed to different adapters by default:
|
|
8
|
+
*
|
|
9
|
+
* - **replays** (versioned run replay snapshots backing restore; mastra's own
|
|
10
|
+
* time-travel mechanism stays the replay engine) → `fs` adapter by default —
|
|
11
|
+
* restart-safe local snapshots with no database driver;
|
|
12
|
+
* - **cache** (compiled-workflow cache ledger keyed by document id +
|
|
13
|
+
* fingerprint; invalidated atomically on fingerprint change so
|
|
14
|
+
* recompilation happens only when the document changes, never per run) →
|
|
15
|
+
* `ram` adapter by default — process-lifetime, fully rebuildable;
|
|
16
|
+
* - **pins** (durable user-owned pinned node states) → `fs` adapter by
|
|
17
|
+
* default. The mastra lane itself declares pinning `NOT-SUPPORTED`
|
|
18
|
+
* (capability table), so the routed adapter is exposed for host value-store
|
|
19
|
+
* wiring only;
|
|
20
|
+
* - **workflows** are NOT routed here — they persist via the as-graph adapter
|
|
21
|
+
* only (binding rule), versioned with restore.
|
|
22
|
+
*
|
|
23
|
+
* The built-in decaf `RamAdapter` and `FilesystemAdapter` back the defaults,
|
|
24
|
+
* so no new database driver is ever required (R8): a host may override any
|
|
25
|
+
* layer with its own adapter (a driver-backed PG/CouchDB adapter activates
|
|
26
|
+
* only when the host configures it). Replay/cache recording is auxiliary:
|
|
27
|
+
* a recording failure never fails a run (logged and skipped), while a
|
|
28
|
+
* restore of a missing snapshot fails closed explicitly (nil rows never,
|
|
29
|
+
* R7). No secret value is ever persisted: payloads are JSON-safe projections.
|
|
30
|
+
*/
|
|
31
|
+
import { Adapter, Repository } from "@decaf-ts/core";
|
|
32
|
+
import { BaseModel } from "@decaf-ts/core";
|
|
33
|
+
import type { Logger } from "@decaf-ts/logging";
|
|
34
|
+
/**
|
|
35
|
+
* Repairs the `Adapter.setCurrent("fs")` import side effect that the
|
|
36
|
+
* `@decaf-ts/core` `./fs` subpath module runs with no adapter registered
|
|
37
|
+
* (core 0.32.x): hands the current flavour back to a registered adapter, or
|
|
38
|
+
* clears it entirely when none exists, so importing the mastra lane never
|
|
39
|
+
* poisons the process-global current flavour.
|
|
40
|
+
*/
|
|
41
|
+
export declare function repairCoreFsCurrentFlavourSideEffect(): void;
|
|
42
|
+
import { type MastraPersistenceAdapterKind } from "./MastraEnvironment.d.mts";
|
|
43
|
+
/**
|
|
44
|
+
* Projects a run value into a JSON-safe form for persistence (no secret or
|
|
45
|
+
* live instance value ever reaches a stored payload): serialisable values
|
|
46
|
+
* round-trip through JSON, cycles and non-serialisable values (functions,
|
|
47
|
+
* class instances that cannot survive the round-trip) degrade to a typed
|
|
48
|
+
* placeholder string, matching the JSON-safe descriptor precedent of the
|
|
49
|
+
* memory layer (R9).
|
|
50
|
+
*
|
|
51
|
+
* @param value - The runtime value to project.
|
|
52
|
+
* @param depth - The current recursion depth; values nested deeper than 8
|
|
53
|
+
* levels degrade to the `[non-serializable:depth]` placeholder (callers
|
|
54
|
+
* omit it — it is threaded by the recursion).
|
|
55
|
+
* @returns The JSON-safe projection.
|
|
56
|
+
*/
|
|
57
|
+
export declare function jsonSafeProjection(value: unknown, depth?: number): unknown;
|
|
58
|
+
/** The mastra-layer persistence kinds the router routes. */
|
|
59
|
+
export type MastraPersistenceLayer = "replays" | "cache" | "pins";
|
|
60
|
+
/** Resolved per-layer persistence configuration (gate A approved defaults). */
|
|
61
|
+
export interface MastraPersistenceConfig {
|
|
62
|
+
/** Adapter kind for the replay-snapshot layer. */
|
|
63
|
+
replaysAdapter: MastraPersistenceAdapterKind;
|
|
64
|
+
/** Adapter kind for the compiled-workflow cache layer. */
|
|
65
|
+
cacheAdapter: MastraPersistenceAdapterKind;
|
|
66
|
+
/** Adapter kind for the pinned-values layer. */
|
|
67
|
+
pinsAdapter: MastraPersistenceAdapterKind;
|
|
68
|
+
/** Base directory for the filesystem adapters' persisted data. */
|
|
69
|
+
fsRoot: string;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Reads the per-layer persistence routing from the accumulated mastra
|
|
73
|
+
* environment (the `MASTRA__PERSISTENCE__*` overrides are already applied by
|
|
74
|
+
* {@link MastraEnvironment}).
|
|
75
|
+
*
|
|
76
|
+
* @returns The resolved persistence configuration.
|
|
77
|
+
*/
|
|
78
|
+
export declare function resolveMastraPersistenceConfig(): MastraPersistenceConfig;
|
|
79
|
+
/**
|
|
80
|
+
* Persistable replay snapshot of a mastra run (SAA-836 O1, replays layer).
|
|
81
|
+
* The `id` is `${runId}::v${version}`, so a run's snapshots are versioned and
|
|
82
|
+
* restorable; the payload is a JSON-safe projection of the run outcome (the
|
|
83
|
+
* live mastra run objects are never persisted).
|
|
84
|
+
*/
|
|
85
|
+
export declare class MastraReplaySnapshotModel extends BaseModel {
|
|
86
|
+
/** Stable `${runId}::v${version}` snapshot key. */
|
|
87
|
+
id: string;
|
|
88
|
+
/** The graph run the snapshot belongs to. */
|
|
89
|
+
runId: string;
|
|
90
|
+
/** The workflow the run executed. */
|
|
91
|
+
workflowId: string;
|
|
92
|
+
/** The document fingerprint the run executed against. */
|
|
93
|
+
documentFingerprint: string;
|
|
94
|
+
/** Monotonic per-run snapshot version (1-based). */
|
|
95
|
+
version: number;
|
|
96
|
+
/** The run's terminal status at snapshot time. */
|
|
97
|
+
status: string;
|
|
98
|
+
/** JSON-safe projection of the run outcome. */
|
|
99
|
+
payload: Record<string, unknown>;
|
|
100
|
+
/** Snapshot creation timestamp. */
|
|
101
|
+
createdAt: Date;
|
|
102
|
+
/** Snapshot last-update timestamp. */
|
|
103
|
+
updatedAt: Date;
|
|
104
|
+
constructor(arg?: Partial<MastraReplaySnapshotModel>);
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Persistable compiled-workflow cache ledger entry (SAA-836 O1, cache layer).
|
|
108
|
+
* Keyed `${workflowId}::${fingerprint}`; the compiled mastra artifacts
|
|
109
|
+
* themselves (functions, schemas) stay in-process — the ledger makes the
|
|
110
|
+
* cache layer's state inspectable and atomically invalidatable.
|
|
111
|
+
*/
|
|
112
|
+
export declare class MastraCacheEntryModel extends BaseModel {
|
|
113
|
+
/** Stable `${workflowId}::${fingerprint}` cache key. */
|
|
114
|
+
id: string;
|
|
115
|
+
/** The canonical workflow document id. */
|
|
116
|
+
workflowId: string;
|
|
117
|
+
/** The document fingerprint the entry was compiled from. */
|
|
118
|
+
fingerprint: string;
|
|
119
|
+
/** When the entry was compiled. */
|
|
120
|
+
compiledAt: Date;
|
|
121
|
+
/** Entry creation timestamp. */
|
|
122
|
+
createdAt: Date;
|
|
123
|
+
/** Entry last-update timestamp. */
|
|
124
|
+
updatedAt: Date;
|
|
125
|
+
constructor(arg?: Partial<MastraCacheEntryModel>);
|
|
126
|
+
}
|
|
127
|
+
/** Adapter-backed repository for versioned replay snapshots. */
|
|
128
|
+
export declare class MastraReplayRepository extends Repository<MastraReplaySnapshotModel, Adapter<any, any, any, any>> {
|
|
129
|
+
/**
|
|
130
|
+
* Builds the replay-snapshot repository over an adapter (or the
|
|
131
|
+
* flavour-registered default).
|
|
132
|
+
*
|
|
133
|
+
* @param adapter - The Decaf adapter backing the layer, when not resolved
|
|
134
|
+
* from the registry.
|
|
135
|
+
*/
|
|
136
|
+
constructor(adapter?: Adapter<any, any, any, any>);
|
|
137
|
+
/**
|
|
138
|
+
* Records a new versioned snapshot for a run (1-based monotonic per-run
|
|
139
|
+
* version).
|
|
140
|
+
*
|
|
141
|
+
* @param entry - The snapshot content (without id/version).
|
|
142
|
+
* @returns The recorded version.
|
|
143
|
+
*/
|
|
144
|
+
record(entry: {
|
|
145
|
+
runId: string;
|
|
146
|
+
workflowId: string;
|
|
147
|
+
documentFingerprint: string;
|
|
148
|
+
status: string;
|
|
149
|
+
payload: Record<string, unknown>;
|
|
150
|
+
}): Promise<number>;
|
|
151
|
+
/**
|
|
152
|
+
* Lists the snapshot versions recorded for a run, ascending.
|
|
153
|
+
*
|
|
154
|
+
* @param runId - The run to list.
|
|
155
|
+
* @returns The recorded versions.
|
|
156
|
+
*/
|
|
157
|
+
versions(runId: string): Promise<number[]>;
|
|
158
|
+
/**
|
|
159
|
+
* Restores a run's replay snapshot: the requested version, or the latest
|
|
160
|
+
* recorded version when none is given. Fails closed when the run has no
|
|
161
|
+
* snapshot (nil rows never, R7).
|
|
162
|
+
*
|
|
163
|
+
* @param runId - The run to restore.
|
|
164
|
+
* @param version - The specific version, when given.
|
|
165
|
+
* @returns The restored snapshot.
|
|
166
|
+
* @throws {NotFoundError} when no snapshot exists for the run/version.
|
|
167
|
+
*/
|
|
168
|
+
restore(runId: string, version?: number): Promise<MastraReplaySnapshotModel>;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Creates a fresh {@link MastraReplayRepository} bound to the provided
|
|
172
|
+
* adapter, resolving the `@repository`-registered constructor (the
|
|
173
|
+
* decoration replaces the constructor with an injectable factory, so a direct
|
|
174
|
+
* `new` would drop the adapter — same pattern as the graph value store).
|
|
175
|
+
*
|
|
176
|
+
* @param adapter - The Decaf adapter backing the replay layer.
|
|
177
|
+
* @returns A repository instance bound to the adapter.
|
|
178
|
+
*/
|
|
179
|
+
export declare function createMastraReplayRepository(adapter: Adapter<any, any, any, any>): MastraReplayRepository;
|
|
180
|
+
/** Adapter-backed repository for the compiled-workflow cache ledger. */
|
|
181
|
+
export declare class MastraCacheRepository extends Repository<MastraCacheEntryModel, Adapter<any, any, any, any>> {
|
|
182
|
+
/**
|
|
183
|
+
* Builds the cache-ledger repository over an adapter (or the
|
|
184
|
+
* flavour-registered default).
|
|
185
|
+
*
|
|
186
|
+
* @param adapter - The Decaf adapter backing the layer, when not resolved
|
|
187
|
+
* from the registry.
|
|
188
|
+
*/
|
|
189
|
+
constructor(adapter?: Adapter<any, any, any, any>);
|
|
190
|
+
/**
|
|
191
|
+
* Records (or refreshes) the cache ledger entry for a compilation.
|
|
192
|
+
*
|
|
193
|
+
* @param workflowId - The canonical workflow document id.
|
|
194
|
+
* @param fingerprint - The document fingerprint it was compiled from.
|
|
195
|
+
*/
|
|
196
|
+
record(workflowId: string, fingerprint: string): Promise<void>;
|
|
197
|
+
/**
|
|
198
|
+
* Invalidates every cache ledger entry for a workflow compiled from a
|
|
199
|
+
* different fingerprint than the one given — the atomic counterpart of a
|
|
200
|
+
* recompilation on document change.
|
|
201
|
+
*
|
|
202
|
+
* @param workflowId - The canonical workflow document id.
|
|
203
|
+
* @param keepFingerprint - The fingerprint to keep.
|
|
204
|
+
*/
|
|
205
|
+
invalidate(workflowId: string, keepFingerprint: string): Promise<void>;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Creates a fresh {@link MastraCacheRepository} bound to the provided
|
|
209
|
+
* adapter (same pattern as {@link createMastraReplayRepository}).
|
|
210
|
+
*
|
|
211
|
+
* @param adapter - The Decaf adapter backing the cache layer.
|
|
212
|
+
* @returns A repository instance bound to the adapter.
|
|
213
|
+
*/
|
|
214
|
+
export declare function createMastraCacheRepository(adapter: Adapter<any, any, any, any>): MastraCacheRepository;
|
|
215
|
+
/** Host-supplied adapter overrides for individual layers (R8 on-demand). */
|
|
216
|
+
export type MastraPersistenceAdapterOverrides = Partial<Record<MastraPersistenceLayer, Adapter<any, any, any, any>>>;
|
|
217
|
+
/** The routed per-layer persistence surface. */
|
|
218
|
+
export interface MastraPersistence {
|
|
219
|
+
/** The resolved routing configuration. */
|
|
220
|
+
config: MastraPersistenceConfig;
|
|
221
|
+
/** The adapter backing each layer. */
|
|
222
|
+
adapters: Record<MastraPersistenceLayer, Adapter<any, any, any, any>>;
|
|
223
|
+
/** The versioned replay-snapshot store (replays layer). */
|
|
224
|
+
replays: MastraReplayRepository;
|
|
225
|
+
/** The compiled-workflow cache ledger (cache layer). */
|
|
226
|
+
cache: MastraCacheRepository;
|
|
227
|
+
/** Shuts the routed adapters down (owned adapters only). */
|
|
228
|
+
shutdown(): Promise<void>;
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* Builds the per-layer persistence routing: one adapter per layer from the
|
|
232
|
+
* Environment-resolved configuration (`ram`/`fs`), with host-supplied adapter
|
|
233
|
+
* overrides taking precedence (R8 on-demand driver adapters). Adapters are
|
|
234
|
+
* initialized eagerly; a layer whose adapter fails to initialize fails the
|
|
235
|
+
* construction — hosts route that layer to `ram` or supply their own adapter.
|
|
236
|
+
*
|
|
237
|
+
* @param overrides - Host-supplied per-layer adapter overrides.
|
|
238
|
+
* @param logger - Optional logger for construction diagnostics.
|
|
239
|
+
* @returns The routed persistence surface.
|
|
240
|
+
*/
|
|
241
|
+
export declare function createMastraPersistence(overrides?: MastraPersistenceAdapterOverrides, logger?: Logger): Promise<MastraPersistence>;
|