@decaf-ts/as-graph 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +776 -26
- package/assets/i18n/en.json +2527 -32
- package/dist/as-graph.cjs +1 -1
- package/dist/as-graph.cjs.map +1 -1
- package/dist/as-graph.js +1 -1
- package/dist/as-graph.js.map +1 -1
- package/lib/cjs/engine/auth/GraphAuthValidator.cjs +19 -0
- package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
- package/lib/cjs/engine/constants.cjs +61 -1
- package/lib/cjs/engine/constants.cjs.map +1 -1
- package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
- package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +228 -67
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
- package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
- package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
- package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +53 -1
- package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/engine/execution/index.cjs +1 -0
- package/lib/cjs/engine/execution/index.cjs.map +1 -1
- package/lib/cjs/engine/index.cjs +4 -0
- package/lib/cjs/engine/index.cjs.map +1 -1
- package/lib/cjs/engine/store/GraphDataTableModel.cjs +76 -0
- package/lib/cjs/engine/store/GraphDataTableModel.cjs.map +1 -0
- package/lib/cjs/engine/store/GraphDataTableRepository.cjs +324 -0
- package/lib/cjs/engine/store/GraphDataTableRepository.cjs.map +1 -0
- package/lib/cjs/engine/store/index.cjs +2 -0
- package/lib/cjs/engine/store/index.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs +28 -0
- package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs +4 -2
- package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphParameterValidator.cjs +6 -0
- package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
- package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
- package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
- package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
- package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
- package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
- package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
- package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
- package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
- package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
- package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
- package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
- package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +240 -22
- package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -1
- package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
- package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
- package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
- package/lib/cjs/mastra/MastraEventBridge.cjs +21 -1
- package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +414 -19
- package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
- package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
- package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
- package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
- package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMemory.cjs +467 -0
- package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
- package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
- package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
- package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
- package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
- package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
- package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
- package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
- package/lib/cjs/mastra/MastraObservability.cjs +335 -0
- package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
- package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
- package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
- package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
- package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
- package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
- package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
- package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
- package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
- package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
- package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
- package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
- package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
- package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
- package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
- package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
- package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
- package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
- package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
- package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
- package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +38 -6
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
- package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
- package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
- package/lib/cjs/mastra/index.cjs +40 -1
- package/lib/cjs/mastra/index.cjs.map +1 -1
- package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
- package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
- package/lib/cjs/mastra/nodes/index.cjs +29 -0
- package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
- package/lib/cjs/mastra/nodes/types.cjs +4 -0
- package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
- package/lib/cjs/mastra/types.cjs +126 -1
- package/lib/cjs/mastra/types.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphBackendHost.cjs +12 -4
- package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs +35 -1
- package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphRunController.cjs +47 -6
- package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
- package/lib/cjs/nest/graph/main.cjs +83 -1
- package/lib/cjs/nest/graph/main.cjs.map +1 -1
- package/lib/cjs/node/agents/agent/node.cjs +189 -31
- package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
- package/lib/cjs/node/agents/hitl/node.cjs +115 -0
- package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
- package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
- package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
- package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
- package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
- package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
- package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
- package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
- package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
- package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
- package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
- package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/processors/types.cjs +68 -0
- package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
- package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
- package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
- package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
- package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
- package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
- package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
- package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
- package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
- package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
- package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
- package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
- package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
- package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
- package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
- package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
- package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
- package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
- package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
- package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
- package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
- package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
- package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
- package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
- package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
- package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
- package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
- package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
- package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/agents/voice/node.cjs +107 -0
- package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
- package/lib/cjs/node/agents/zones.cjs +43 -0
- package/lib/cjs/node/agents/zones.cjs.map +1 -0
- package/lib/cjs/node/comms/email-send/node.cjs +340 -0
- package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
- package/lib/cjs/node/comms/gmail/node.cjs +287 -0
- package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
- package/lib/cjs/node/comms/slack/node.cjs +276 -0
- package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
- package/lib/cjs/node/comms/teams/node.cjs +231 -0
- package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
- package/lib/cjs/node/comms/telegram/node.cjs +260 -0
- package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
- package/lib/cjs/node/credentials.cjs +103 -0
- package/lib/cjs/node/credentials.cjs.map +1 -0
- package/lib/cjs/node/data/data-table/node.cjs +265 -0
- package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
- package/lib/cjs/node/data/date-time/node.cjs +180 -0
- package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
- package/lib/cjs/node/data/filter/node.cjs +134 -0
- package/lib/cjs/node/data/filter/node.cjs.map +1 -0
- package/lib/cjs/node/data/limit/node.cjs +104 -0
- package/lib/cjs/node/data/limit/node.cjs.map +1 -0
- package/lib/cjs/node/data/merge/node.cjs +251 -0
- package/lib/cjs/node/data/merge/node.cjs.map +1 -0
- package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
- package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
- package/lib/cjs/node/data/set/node.cjs +148 -0
- package/lib/cjs/node/data/set/node.cjs.map +1 -0
- package/lib/cjs/node/data/sort/node.cjs +125 -0
- package/lib/cjs/node/data/sort/node.cjs.map +1 -0
- package/lib/cjs/node/data/split-out/node.cjs +140 -0
- package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
- package/lib/cjs/node/data/support.cjs +398 -0
- package/lib/cjs/node/data/support.cjs.map +1 -0
- package/lib/cjs/node/devops/crypto/node.cjs +364 -0
- package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
- package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
- package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
- package/lib/cjs/node/devops/ftp/node.cjs +241 -0
- package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
- package/lib/cjs/node/devops/github/node.cjs +282 -0
- package/lib/cjs/node/devops/github/node.cjs.map +1 -0
- package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
- package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
- package/lib/cjs/node/devops/jwt/node.cjs +204 -0
- package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
- package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
- package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
- package/lib/cjs/node/index.cjs +402 -66
- package/lib/cjs/node/index.cjs.map +1 -1
- package/lib/cjs/node/io/airtable/node.cjs +318 -0
- package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
- package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
- package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
- package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
- package/lib/cjs/node/io/graphql/node.cjs +169 -0
- package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
- package/lib/cjs/node/io/http-request/node.cjs +415 -0
- package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
- package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
- package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
- package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
- package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
- package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
- package/lib/cjs/node/manifests.cjs +264 -36
- package/lib/cjs/node/manifests.cjs.map +1 -1
- package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
- package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/base.cjs +321 -0
- package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
- package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
- package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
- package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/base.cjs +301 -0
- package/lib/cjs/node/storage/database/base.cjs.map +1 -0
- package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
- package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
- package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
- package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
- package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
- package/lib/cjs/node/storage/redis/node.cjs +340 -0
- package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
- package/lib/cjs/node/storage/support.cjs +81 -0
- package/lib/cjs/node/storage/support.cjs.map +1 -0
- package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
- package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
- package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
- package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/GraphNodeModel.cjs +4 -0
- package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
- package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
- package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
- package/lib/cjs/shared/graph/category-styles.cjs +12 -0
- package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
- package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
- package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
- package/lib/cjs/typeorm/index.cjs +29 -0
- package/lib/cjs/typeorm/index.cjs.map +1 -0
- package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
- package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
- package/lib/esm/engine/constants.js +60 -0
- package/lib/esm/engine/constants.js.map +1 -1
- package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
- package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
- package/lib/esm/engine/execution/GraphExecutionEngine.js +229 -68
- package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
- package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
- package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
- package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
- package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +54 -2
- package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
- package/lib/esm/engine/execution/index.js +1 -0
- package/lib/esm/engine/execution/index.js.map +1 -1
- package/lib/esm/engine/index.js +4 -0
- package/lib/esm/engine/index.js.map +1 -1
- package/lib/esm/engine/store/GraphDataTableModel.js +67 -0
- package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
- package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
- package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
- package/lib/esm/engine/store/index.js +2 -0
- package/lib/esm/engine/store/index.js.map +1 -1
- package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
- package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
- package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
- package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
- package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
- package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
- package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
- package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
- package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
- package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
- package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
- package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
- package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
- package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
- package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
- package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraCapabilities.js +115 -0
- package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
- package/lib/esm/mastra/MastraChannelResponse.js +154 -0
- package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
- package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
- package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraDefaultStepHandlers.js +240 -22
- package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -1
- package/lib/esm/mastra/MastraEnvironment.js +287 -0
- package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
- package/lib/esm/mastra/MastraEvalModels.js +535 -0
- package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
- package/lib/esm/mastra/MastraEventBridge.js +21 -1
- package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
- package/lib/esm/mastra/MastraGraphExecutionBackend.js +414 -19
- package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
- package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
- package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
- package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
- package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
- package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraMemory.js +455 -0
- package/lib/esm/mastra/MastraMemory.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
- package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
- package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsModels.js +486 -0
- package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
- package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
- package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
- package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
- package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
- package/lib/esm/mastra/MastraObservability.js +327 -0
- package/lib/esm/mastra/MastraObservability.js.map +1 -0
- package/lib/esm/mastra/MastraPersistence.js +530 -0
- package/lib/esm/mastra/MastraPersistence.js.map +1 -0
- package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
- package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
- package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
- package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
- package/lib/esm/mastra/MastraRunRecovery.js +89 -0
- package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
- package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
- package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
- package/lib/esm/mastra/MastraStorageWiring.js +119 -0
- package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
- package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
- package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
- package/lib/esm/mastra/MastraToolBuilder.js +68 -0
- package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
- package/lib/esm/mastra/MastraToolConfig.js +37 -0
- package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
- package/lib/esm/mastra/MastraToolDecorator.js +92 -0
- package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
- package/lib/esm/mastra/MastraVectorStore.js +605 -0
- package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
- package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
- package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
- package/lib/esm/mastra/MastraWorkflowCompiler.js +38 -6
- package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
- package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
- package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
- package/lib/esm/mastra/index.js +40 -1
- package/lib/esm/mastra/index.js.map +1 -1
- package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
- package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
- package/lib/esm/mastra/nodes/index.js +12 -0
- package/lib/esm/mastra/nodes/index.js.map +1 -0
- package/lib/esm/mastra/nodes/types.js +2 -0
- package/lib/esm/mastra/nodes/types.js.map +1 -0
- package/lib/esm/mastra/types.js +125 -0
- package/lib/esm/mastra/types.js.map +1 -1
- package/lib/esm/nest/graph/GraphBackendHost.js +10 -2
- package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
- package/lib/esm/nest/graph/GraphExecutionModule.js +35 -1
- package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
- package/lib/esm/nest/graph/GraphRunController.js +47 -6
- package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
- package/lib/esm/nest/graph/main.js +83 -1
- package/lib/esm/nest/graph/main.js.map +1 -1
- package/lib/esm/node/agents/agent/node.js +189 -31
- package/lib/esm/node/agents/agent/node.js.map +1 -1
- package/lib/esm/node/agents/hitl/node.js +106 -0
- package/lib/esm/node/agents/hitl/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
- package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/hook/node.js +111 -0
- package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
- package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
- package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
- package/lib/esm/node/agents/memory/memory/node.js +222 -0
- package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
- package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
- package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
- package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
- package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
- package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
- package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
- package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
- package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
- package/lib/esm/node/agents/processors/types.js +64 -0
- package/lib/esm/node/agents/processors/types.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
- package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
- package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
- package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
- package/lib/esm/node/agents/rag/chunking/node.js +211 -0
- package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
- package/lib/esm/node/agents/rag/embedding/node.js +101 -0
- package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
- package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
- package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
- package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
- package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
- package/lib/esm/node/agents/rag/rerank/node.js +103 -0
- package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
- package/lib/esm/node/agents/rag/retriever/node.js +111 -0
- package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
- package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
- package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
- package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
- package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
- package/lib/esm/node/agents/responses/discord/node.js +92 -0
- package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
- package/lib/esm/node/agents/responses/slack/node.js +92 -0
- package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
- package/lib/esm/node/agents/responses/teams/node.js +92 -0
- package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
- package/lib/esm/node/agents/responses/telegram/node.js +92 -0
- package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
- package/lib/esm/node/agents/sandbox/node.js +125 -0
- package/lib/esm/node/agents/sandbox/node.js.map +1 -0
- package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
- package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
- package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
- package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
- package/lib/esm/node/agents/skills/skill/node.js +96 -0
- package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
- package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
- package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
- package/lib/esm/node/agents/tools/tool/node.js +91 -0
- package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
- package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
- package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/discord/node.js +92 -0
- package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
- package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/slack/node.js +92 -0
- package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/teams/node.js +92 -0
- package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
- package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
- package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
- package/lib/esm/node/agents/voice/node.js +98 -0
- package/lib/esm/node/agents/voice/node.js.map +1 -0
- package/lib/esm/node/agents/zones.js +39 -0
- package/lib/esm/node/agents/zones.js.map +1 -0
- package/lib/esm/node/comms/email-send/node.js +331 -0
- package/lib/esm/node/comms/email-send/node.js.map +1 -0
- package/lib/esm/node/comms/gmail/node.js +278 -0
- package/lib/esm/node/comms/gmail/node.js.map +1 -0
- package/lib/esm/node/comms/slack/node.js +267 -0
- package/lib/esm/node/comms/slack/node.js.map +1 -0
- package/lib/esm/node/comms/teams/node.js +222 -0
- package/lib/esm/node/comms/teams/node.js.map +1 -0
- package/lib/esm/node/comms/telegram/node.js +251 -0
- package/lib/esm/node/comms/telegram/node.js.map +1 -0
- package/lib/esm/node/credentials.js +96 -0
- package/lib/esm/node/credentials.js.map +1 -0
- package/lib/esm/node/data/data-table/node.js +256 -0
- package/lib/esm/node/data/data-table/node.js.map +1 -0
- package/lib/esm/node/data/date-time/node.js +171 -0
- package/lib/esm/node/data/date-time/node.js.map +1 -0
- package/lib/esm/node/data/filter/node.js +125 -0
- package/lib/esm/node/data/filter/node.js.map +1 -0
- package/lib/esm/node/data/limit/node.js +95 -0
- package/lib/esm/node/data/limit/node.js.map +1 -0
- package/lib/esm/node/data/merge/node.js +242 -0
- package/lib/esm/node/data/merge/node.js.map +1 -0
- package/lib/esm/node/data/rename-keys/node.js +130 -0
- package/lib/esm/node/data/rename-keys/node.js.map +1 -0
- package/lib/esm/node/data/set/node.js +139 -0
- package/lib/esm/node/data/set/node.js.map +1 -0
- package/lib/esm/node/data/sort/node.js +116 -0
- package/lib/esm/node/data/sort/node.js.map +1 -0
- package/lib/esm/node/data/split-out/node.js +131 -0
- package/lib/esm/node/data/split-out/node.js.map +1 -0
- package/lib/esm/node/data/support.js +382 -0
- package/lib/esm/node/data/support.js.map +1 -0
- package/lib/esm/node/devops/crypto/node.js +355 -0
- package/lib/esm/node/devops/crypto/node.js.map +1 -0
- package/lib/esm/node/devops/execute-command/node.js +192 -0
- package/lib/esm/node/devops/execute-command/node.js.map +1 -0
- package/lib/esm/node/devops/ftp/node.js +232 -0
- package/lib/esm/node/devops/ftp/node.js.map +1 -0
- package/lib/esm/node/devops/github/node.js +273 -0
- package/lib/esm/node/devops/github/node.js.map +1 -0
- package/lib/esm/node/devops/gitlab/node.js +264 -0
- package/lib/esm/node/devops/gitlab/node.js.map +1 -0
- package/lib/esm/node/devops/jwt/node.js +195 -0
- package/lib/esm/node/devops/jwt/node.js.map +1 -0
- package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
- package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
- package/lib/esm/node/index.js +338 -2
- package/lib/esm/node/index.js.map +1 -1
- package/lib/esm/node/io/airtable/node.js +309 -0
- package/lib/esm/node/io/airtable/node.js.map +1 -0
- package/lib/esm/node/io/extract-from-file/node.js +260 -0
- package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
- package/lib/esm/node/io/google-sheets/node.js +258 -0
- package/lib/esm/node/io/google-sheets/node.js.map +1 -0
- package/lib/esm/node/io/graphql/node.js +160 -0
- package/lib/esm/node/io/graphql/node.js.map +1 -0
- package/lib/esm/node/io/http-request/node.js +406 -0
- package/lib/esm/node/io/http-request/node.js.map +1 -0
- package/lib/esm/node/io/read-pdf/node.js +164 -0
- package/lib/esm/node/io/read-pdf/node.js.map +1 -0
- package/lib/esm/node/io/read-write-file/node.js +305 -0
- package/lib/esm/node/io/read-write-file/node.js.map +1 -0
- package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
- package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
- package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
- package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
- package/lib/esm/node/manifests.js +228 -0
- package/lib/esm/node/manifests.js.map +1 -1
- package/lib/esm/node/storage/blob/azure/node.js +129 -0
- package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
- package/lib/esm/node/storage/blob/base.js +311 -0
- package/lib/esm/node/storage/blob/base.js.map +1 -0
- package/lib/esm/node/storage/blob/gcs/node.js +117 -0
- package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
- package/lib/esm/node/storage/blob/s3/node.js +176 -0
- package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
- package/lib/esm/node/storage/database/base.js +291 -0
- package/lib/esm/node/storage/database/base.js.map +1 -0
- package/lib/esm/node/storage/database/mssql/node.js +42 -0
- package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
- package/lib/esm/node/storage/database/mysql/node.js +42 -0
- package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
- package/lib/esm/node/storage/database/postgres/node.js +42 -0
- package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
- package/lib/esm/node/storage/redis/node.js +331 -0
- package/lib/esm/node/storage/redis/node.js.map +1 -0
- package/lib/esm/node/storage/support.js +69 -0
- package/lib/esm/node/storage/support.js.map +1 -0
- package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
- package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
- package/lib/esm/ram/GraphRunEventModel.js +5 -1
- package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
- package/lib/esm/shared/graph/GraphNodeModel.js +5 -1
- package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -1
- package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
- package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
- package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
- package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
- package/lib/esm/shared/graph/category-styles.js +12 -0
- package/lib/esm/shared/graph/category-styles.js.map +1 -1
- package/lib/esm/shared/graph/constants.js.map +1 -1
- package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
- package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
- package/lib/esm/typeorm/index.js +12 -0
- package/lib/esm/typeorm/index.js.map +1 -0
- package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
- package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
- package/lib/types/engine/constants.d.cts +60 -0
- package/lib/types/engine/constants.d.mts +60 -0
- package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
- package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +88 -1
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +88 -1
- package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
- package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
- package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
- package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +12 -3
- package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +12 -3
- package/lib/types/engine/execution/index.d.cts +1 -0
- package/lib/types/engine/execution/index.d.mts +1 -0
- package/lib/types/engine/index.d.cts +4 -0
- package/lib/types/engine/index.d.mts +4 -0
- package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
- package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
- package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
- package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
- package/lib/types/engine/store/index.d.cts +2 -0
- package/lib/types/engine/store/index.d.mts +2 -0
- package/lib/types/engine/types.d.cts +12 -0
- package/lib/types/engine/types.d.mts +12 -0
- package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
- package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
- package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
- package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
- package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
- package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
- package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
- package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
- package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
- package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
- package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
- package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
- package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
- package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
- package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
- package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
- package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
- package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
- package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
- package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
- package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +53 -6
- package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +53 -6
- package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
- package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
- package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
- package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
- package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
- package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
- package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +108 -1
- package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +108 -1
- package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
- package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
- package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
- package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
- package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
- package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
- package/lib/types/mastra/MastraMemory.d.cts +362 -0
- package/lib/types/mastra/MastraMemory.d.mts +362 -0
- package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
- package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
- package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
- package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
- package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
- package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
- package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
- package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
- package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
- package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
- package/lib/types/mastra/MastraObservability.d.cts +197 -0
- package/lib/types/mastra/MastraObservability.d.mts +197 -0
- package/lib/types/mastra/MastraPersistence.d.cts +241 -0
- package/lib/types/mastra/MastraPersistence.d.mts +241 -0
- package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
- package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
- package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
- package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
- package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
- package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
- package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
- package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
- package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
- package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
- package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
- package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
- package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
- package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
- package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
- package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
- package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
- package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
- package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
- package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
- package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
- package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
- package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
- package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
- package/lib/types/mastra/index.d.cts +40 -1
- package/lib/types/mastra/index.d.mts +40 -1
- package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
- package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
- package/lib/types/mastra/nodes/index.d.cts +11 -0
- package/lib/types/mastra/nodes/index.d.mts +11 -0
- package/lib/types/mastra/nodes/types.d.cts +57 -0
- package/lib/types/mastra/nodes/types.d.mts +57 -0
- package/lib/types/mastra/types.d.cts +365 -6
- package/lib/types/mastra/types.d.mts +365 -6
- package/lib/types/nest/graph/GraphExecutionModule.d.cts +17 -0
- package/lib/types/nest/graph/GraphExecutionModule.d.mts +17 -0
- package/lib/types/nest/graph/GraphRunController.d.cts +24 -4
- package/lib/types/nest/graph/GraphRunController.d.mts +24 -4
- package/lib/types/node/agents/agent/node.d.cts +72 -16
- package/lib/types/node/agents/agent/node.d.mts +72 -16
- package/lib/types/node/agents/hitl/node.d.cts +45 -0
- package/lib/types/node/agents/hitl/node.d.mts +45 -0
- package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
- package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
- package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
- package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
- package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
- package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
- package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
- package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
- package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
- package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
- package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
- package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
- package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
- package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
- package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
- package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
- package/lib/types/node/agents/processors/types.d.cts +45 -0
- package/lib/types/node/agents/processors/types.d.mts +45 -0
- package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
- package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
- package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
- package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
- package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
- package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
- package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
- package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
- package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
- package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
- package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
- package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
- package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
- package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
- package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
- package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
- package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
- package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
- package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
- package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
- package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
- package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
- package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
- package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
- package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
- package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
- package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
- package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
- package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
- package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
- package/lib/types/node/agents/sandbox/node.d.cts +47 -0
- package/lib/types/node/agents/sandbox/node.d.mts +47 -0
- package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
- package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
- package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
- package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
- package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
- package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
- package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
- package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
- package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
- package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
- package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
- package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
- package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
- package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
- package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
- package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
- package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
- package/lib/types/node/agents/voice/node.d.cts +34 -0
- package/lib/types/node/agents/voice/node.d.mts +34 -0
- package/lib/types/node/agents/zones.d.cts +30 -0
- package/lib/types/node/agents/zones.d.mts +30 -0
- package/lib/types/node/comms/email-send/node.d.cts +85 -0
- package/lib/types/node/comms/email-send/node.d.mts +85 -0
- package/lib/types/node/comms/gmail/node.d.cts +67 -0
- package/lib/types/node/comms/gmail/node.d.mts +67 -0
- package/lib/types/node/comms/slack/node.d.cts +65 -0
- package/lib/types/node/comms/slack/node.d.mts +65 -0
- package/lib/types/node/comms/teams/node.d.cts +49 -0
- package/lib/types/node/comms/teams/node.d.mts +49 -0
- package/lib/types/node/comms/telegram/node.d.cts +61 -0
- package/lib/types/node/comms/telegram/node.d.mts +61 -0
- package/lib/types/node/credentials.d.cts +43 -0
- package/lib/types/node/credentials.d.mts +43 -0
- package/lib/types/node/data/data-table/node.d.cts +86 -0
- package/lib/types/node/data/data-table/node.d.mts +86 -0
- package/lib/types/node/data/date-time/node.d.cts +49 -0
- package/lib/types/node/data/date-time/node.d.mts +49 -0
- package/lib/types/node/data/filter/node.d.cts +31 -0
- package/lib/types/node/data/filter/node.d.mts +31 -0
- package/lib/types/node/data/limit/node.d.cts +28 -0
- package/lib/types/node/data/limit/node.d.mts +28 -0
- package/lib/types/node/data/merge/node.d.cts +63 -0
- package/lib/types/node/data/merge/node.d.mts +63 -0
- package/lib/types/node/data/rename-keys/node.d.cts +35 -0
- package/lib/types/node/data/rename-keys/node.d.mts +35 -0
- package/lib/types/node/data/set/node.d.cts +52 -0
- package/lib/types/node/data/set/node.d.mts +52 -0
- package/lib/types/node/data/sort/node.d.cts +40 -0
- package/lib/types/node/data/sort/node.d.mts +40 -0
- package/lib/types/node/data/split-out/node.d.cts +30 -0
- package/lib/types/node/data/split-out/node.d.mts +30 -0
- package/lib/types/node/data/support.d.cts +164 -0
- package/lib/types/node/data/support.d.mts +164 -0
- package/lib/types/node/devops/crypto/node.d.cts +65 -0
- package/lib/types/node/devops/crypto/node.d.mts +65 -0
- package/lib/types/node/devops/execute-command/node.d.cts +55 -0
- package/lib/types/node/devops/execute-command/node.d.mts +55 -0
- package/lib/types/node/devops/ftp/node.d.cts +55 -0
- package/lib/types/node/devops/ftp/node.d.mts +55 -0
- package/lib/types/node/devops/github/node.d.cts +61 -0
- package/lib/types/node/devops/github/node.d.mts +61 -0
- package/lib/types/node/devops/gitlab/node.d.cts +61 -0
- package/lib/types/node/devops/gitlab/node.d.mts +61 -0
- package/lib/types/node/devops/jwt/node.d.cts +53 -0
- package/lib/types/node/devops/jwt/node.d.mts +53 -0
- package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
- package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
- package/lib/types/node/index.d.cts +182 -2
- package/lib/types/node/index.d.mts +182 -2
- package/lib/types/node/io/airtable/node.d.cts +73 -0
- package/lib/types/node/io/airtable/node.d.mts +73 -0
- package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
- package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
- package/lib/types/node/io/google-sheets/node.d.cts +77 -0
- package/lib/types/node/io/google-sheets/node.d.mts +77 -0
- package/lib/types/node/io/graphql/node.d.cts +46 -0
- package/lib/types/node/io/graphql/node.d.mts +46 -0
- package/lib/types/node/io/http-request/node.d.cts +107 -0
- package/lib/types/node/io/http-request/node.d.mts +107 -0
- package/lib/types/node/io/read-pdf/node.d.cts +40 -0
- package/lib/types/node/io/read-pdf/node.d.mts +40 -0
- package/lib/types/node/io/read-write-file/node.d.cts +41 -0
- package/lib/types/node/io/read-write-file/node.d.mts +41 -0
- package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
- package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
- package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
- package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
- package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
- package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
- package/lib/types/node/storage/blob/base.d.cts +83 -0
- package/lib/types/node/storage/blob/base.d.mts +83 -0
- package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
- package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
- package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
- package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
- package/lib/types/node/storage/database/base.d.cts +97 -0
- package/lib/types/node/storage/database/base.d.mts +97 -0
- package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
- package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
- package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
- package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
- package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
- package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
- package/lib/types/node/storage/redis/node.d.cts +68 -0
- package/lib/types/node/storage/redis/node.d.mts +68 -0
- package/lib/types/node/storage/support.d.cts +36 -0
- package/lib/types/node/storage/support.d.mts +36 -0
- package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
- package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
- package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
- package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
- package/lib/types/shared/graph/GraphNodeModel.d.cts +6 -0
- package/lib/types/shared/graph/GraphNodeModel.d.mts +6 -0
- package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
- package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
- package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
- package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
- package/lib/types/shared/graph/constants.d.cts +39 -0
- package/lib/types/shared/graph/constants.d.mts +39 -0
- package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
- package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
- package/lib/types/typeorm/index.d.cts +11 -0
- package/lib/types/typeorm/index.d.mts +11 -0
- package/package.json +51 -11
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module as-graph/mastra/MastraAgentModelAdapter
|
|
3
|
+
* @summary Model-adapter-in-config for the mastra agent node (SAA-837 M1, R1).
|
|
4
|
+
* @description The agent node carries its LLM as **configuration** — a provider
|
|
5
|
+
* id, a model id, and an optional credential reference — instead of as a
|
|
6
|
+
* dedicated model-provider node kind (R1: no model-provider kinds). This module
|
|
7
|
+
* is the single authority for that config shape, its structural guard, and the
|
|
8
|
+
* translation into the `@mastra/core` model config the agent is constructed with.
|
|
9
|
+
* The credential **reference** is validated by the existing credential-reference
|
|
10
|
+
* validation (document validation stage 8); this module never resolves a secret
|
|
11
|
+
* value and never persists one.
|
|
12
|
+
*/
|
|
13
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
|
|
14
|
+
import { type GraphCredentialReference } from "../shared/graph/catalog/GraphCredentialReference.d.mts";
|
|
15
|
+
/**
|
|
16
|
+
* The model-adapter configuration an agent node carries in its `modelAdapter`
|
|
17
|
+
* parameter (R1). `provider` and `modelId` compose the mastra model id
|
|
18
|
+
* (`<provider>/<modelId>`); `credentialRef` is a reference resolved by the
|
|
19
|
+
* existing credential-reference validation, never a plain secret. It is named
|
|
20
|
+
* `credentialRef` (not `credentials`) because a `credentials` key is on the
|
|
21
|
+
* stage-8 plain-secret deny-list — the reference object itself
|
|
22
|
+
* (`credentialId`/`credentialType`) passes the same scan.
|
|
23
|
+
*/
|
|
24
|
+
export interface MastraModelAdapterConfig {
|
|
25
|
+
/** Provider discriminator (e.g. `openai`, `anthropic`). */
|
|
26
|
+
provider: string;
|
|
27
|
+
/** Provider-specific model id (e.g. `gpt-4o-mini`). */
|
|
28
|
+
modelId: string;
|
|
29
|
+
/** Optional credential reference validated by document validation stage 8. */
|
|
30
|
+
credentialRef?: GraphCredentialReference;
|
|
31
|
+
/** Optional per-model retry budget forwarded to mastra. */
|
|
32
|
+
maxRetries?: number;
|
|
33
|
+
/** Optional model settings forwarded to mastra (temperature, …). */
|
|
34
|
+
modelSettings?: Record<string, unknown>;
|
|
35
|
+
/** Optional provider-specific options forwarded to mastra. */
|
|
36
|
+
providerOptions?: Record<string, unknown>;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Structural guard for {@link MastraModelAdapterConfig}: requires non-empty
|
|
40
|
+
* `provider` and `modelId` strings and, when present, a well-formed credential
|
|
41
|
+
* reference.
|
|
42
|
+
*
|
|
43
|
+
* @param value - The candidate adapter config.
|
|
44
|
+
* @returns `true` when the value is a valid model-adapter configuration.
|
|
45
|
+
*/
|
|
46
|
+
export declare function isMastraModelAdapterConfig(value: unknown): value is MastraModelAdapterConfig;
|
|
47
|
+
/**
|
|
48
|
+
* Reads the model-adapter config carried by a document node. Looks at the
|
|
49
|
+
* canonical `modelAdapter` parameter only; an absent or malformed value returns
|
|
50
|
+
* `undefined` so the caller fails closed instead of constructing a bogus model.
|
|
51
|
+
*
|
|
52
|
+
* @param node - The canonical node instance.
|
|
53
|
+
* @returns The validated adapter config, or `undefined` when none is present.
|
|
54
|
+
*/
|
|
55
|
+
export declare function graphModelAdapterOf(node: GraphNodeInstance): MastraModelAdapterConfig | undefined;
|
|
56
|
+
/** The `@mastra/core` model config derived from a {@link MastraModelAdapterConfig}. */
|
|
57
|
+
export interface MastraModelConfig {
|
|
58
|
+
/** The composed `<provider>/<modelId>` model id mastra resolves. */
|
|
59
|
+
id: string;
|
|
60
|
+
/** Optional per-model retry budget forwarded to mastra. */
|
|
61
|
+
maxRetries?: number;
|
|
62
|
+
/** Optional model settings forwarded to mastra. */
|
|
63
|
+
modelSettings?: Record<string, unknown>;
|
|
64
|
+
/** Optional provider-specific options forwarded to mastra. */
|
|
65
|
+
providerOptions?: Record<string, unknown>;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Translates a {@link MastraModelAdapterConfig} into the `@mastra/core` model
|
|
69
|
+
* config. Never injects an API key: the provider reads its own environment
|
|
70
|
+
* (`.env.secret`, gate C) at call time, so no secret is ever held in the graph
|
|
71
|
+
* document, node parameters, or this translation.
|
|
72
|
+
*
|
|
73
|
+
* @param adapter - The validated adapter config.
|
|
74
|
+
* @returns The mastra model config the agent is constructed with.
|
|
75
|
+
*/
|
|
76
|
+
export declare function mastraModelConfigOf(adapter: MastraModelAdapterConfig): MastraModelConfig;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.cts";
|
|
2
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.cts";
|
|
3
|
+
import { type MastraModelAdapterConfig } from "./MastraAgentModelAdapter.d.cts";
|
|
4
|
+
/** A document node kind the mastra processor resolution consumes. */
|
|
5
|
+
export declare const MASTRA_AGENT_PROCESSOR_KINDS: readonly ["core.agent.inputProcessor", "core.agent.outputProcessor", "core.agent.guardrail"];
|
|
6
|
+
/** The mastra-native processor/guardrail types (mirrors the node vocabulary). */
|
|
7
|
+
export type { MastraGuardrailType, MastraInputProcessorType, MastraOutputProcessorType, } from "../node/agents/processors/types.d.cts";
|
|
8
|
+
/** The wired processor set an agent node's zones resolve to. */
|
|
9
|
+
export interface MastraAgentWiredProcessors {
|
|
10
|
+
/** Mastra input processors applied as the per-run `inputProcessors` override. */
|
|
11
|
+
inputProcessors: unknown[];
|
|
12
|
+
/** Mastra output processors (incl. guardrails) applied as the per-run `outputProcessors` override. */
|
|
13
|
+
outputProcessors: unknown[];
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Host hook resolving the classifier model a model-carrying processor type
|
|
17
|
+
* runs on (R1 — adapter-in-config). Receives the wired node's validated
|
|
18
|
+
* model-adapter config, when present. Returning `undefined` fails closed.
|
|
19
|
+
*/
|
|
20
|
+
export type MastraProcessorModelResolver = (adapter: MastraModelAdapterConfig | undefined) => unknown | Promise<unknown>;
|
|
21
|
+
/**
|
|
22
|
+
* Builds the real mastra processor instance one wired processor node resolves
|
|
23
|
+
* to. The mapping is mastra-native (R3): every type names a real
|
|
24
|
+
* `@mastra/core/processors` class and the node's `options` are forwarded
|
|
25
|
+
* verbatim to its constructor; model-carrying types receive the resolved
|
|
26
|
+
* classifier model.
|
|
27
|
+
*
|
|
28
|
+
* @param node - The wired processor/guardrail document node.
|
|
29
|
+
* @param resolveModel - The host model resolver, when supplied.
|
|
30
|
+
* @returns The mastra processor instance.
|
|
31
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_PROCESSOR_UNAVAILABLE} when
|
|
32
|
+
* the node declares an unknown type or a model-carrying type without a
|
|
33
|
+
* resolvable model.
|
|
34
|
+
*/
|
|
35
|
+
export declare function mastraProcessorInstanceOf(node: GraphNodeInstance, resolveModel?: MastraProcessorModelResolver): Promise<unknown>;
|
|
36
|
+
/**
|
|
37
|
+
* Resolves the processor and guardrail nodes wired onto one agent node's
|
|
38
|
+
* `inputProcessors`/`outputProcessors` zones into the real mastra processor
|
|
39
|
+
* instances. Connection edges are scanned in document order, so the resolved
|
|
40
|
+
* processor order is deterministic; guardrail nodes compose with the output
|
|
41
|
+
* processors on the `outputProcessors` zone. Nodes whose instance construction
|
|
42
|
+
* fails propagate the fail-closed error — a wired but unresolvable processor
|
|
43
|
+
* never silently disappears from the pipeline.
|
|
44
|
+
*
|
|
45
|
+
* @param document - The canonical document being compiled.
|
|
46
|
+
* @param agentNodeId - The agent node id whose zones to resolve.
|
|
47
|
+
* @param resolveModel - The host model resolver, when supplied.
|
|
48
|
+
* @returns The wired mastra processor instances per pipeline.
|
|
49
|
+
*/
|
|
50
|
+
export declare function resolveAgentWiredProcessors(document: GraphWorkflowDocument, agentNodeId: string, resolveModel?: MastraProcessorModelResolver): Promise<MastraAgentWiredProcessors>;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.mts";
|
|
2
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
|
|
3
|
+
import { type MastraModelAdapterConfig } from "./MastraAgentModelAdapter.d.mts";
|
|
4
|
+
/** A document node kind the mastra processor resolution consumes. */
|
|
5
|
+
export declare const MASTRA_AGENT_PROCESSOR_KINDS: readonly ["core.agent.inputProcessor", "core.agent.outputProcessor", "core.agent.guardrail"];
|
|
6
|
+
/** The mastra-native processor/guardrail types (mirrors the node vocabulary). */
|
|
7
|
+
export type { MastraGuardrailType, MastraInputProcessorType, MastraOutputProcessorType, } from "../node/agents/processors/types.d.mts";
|
|
8
|
+
/** The wired processor set an agent node's zones resolve to. */
|
|
9
|
+
export interface MastraAgentWiredProcessors {
|
|
10
|
+
/** Mastra input processors applied as the per-run `inputProcessors` override. */
|
|
11
|
+
inputProcessors: unknown[];
|
|
12
|
+
/** Mastra output processors (incl. guardrails) applied as the per-run `outputProcessors` override. */
|
|
13
|
+
outputProcessors: unknown[];
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Host hook resolving the classifier model a model-carrying processor type
|
|
17
|
+
* runs on (R1 — adapter-in-config). Receives the wired node's validated
|
|
18
|
+
* model-adapter config, when present. Returning `undefined` fails closed.
|
|
19
|
+
*/
|
|
20
|
+
export type MastraProcessorModelResolver = (adapter: MastraModelAdapterConfig | undefined) => unknown | Promise<unknown>;
|
|
21
|
+
/**
|
|
22
|
+
* Builds the real mastra processor instance one wired processor node resolves
|
|
23
|
+
* to. The mapping is mastra-native (R3): every type names a real
|
|
24
|
+
* `@mastra/core/processors` class and the node's `options` are forwarded
|
|
25
|
+
* verbatim to its constructor; model-carrying types receive the resolved
|
|
26
|
+
* classifier model.
|
|
27
|
+
*
|
|
28
|
+
* @param node - The wired processor/guardrail document node.
|
|
29
|
+
* @param resolveModel - The host model resolver, when supplied.
|
|
30
|
+
* @returns The mastra processor instance.
|
|
31
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_PROCESSOR_UNAVAILABLE} when
|
|
32
|
+
* the node declares an unknown type or a model-carrying type without a
|
|
33
|
+
* resolvable model.
|
|
34
|
+
*/
|
|
35
|
+
export declare function mastraProcessorInstanceOf(node: GraphNodeInstance, resolveModel?: MastraProcessorModelResolver): Promise<unknown>;
|
|
36
|
+
/**
|
|
37
|
+
* Resolves the processor and guardrail nodes wired onto one agent node's
|
|
38
|
+
* `inputProcessors`/`outputProcessors` zones into the real mastra processor
|
|
39
|
+
* instances. Connection edges are scanned in document order, so the resolved
|
|
40
|
+
* processor order is deterministic; guardrail nodes compose with the output
|
|
41
|
+
* processors on the `outputProcessors` zone. Nodes whose instance construction
|
|
42
|
+
* fails propagate the fail-closed error — a wired but unresolvable processor
|
|
43
|
+
* never silently disappears from the pipeline.
|
|
44
|
+
*
|
|
45
|
+
* @param document - The canonical document being compiled.
|
|
46
|
+
* @param agentNodeId - The agent node id whose zones to resolve.
|
|
47
|
+
* @param resolveModel - The host model resolver, when supplied.
|
|
48
|
+
* @returns The wired mastra processor instances per pipeline.
|
|
49
|
+
*/
|
|
50
|
+
export declare function resolveAgentWiredProcessors(document: GraphWorkflowDocument, agentNodeId: string, resolveModel?: MastraProcessorModelResolver): Promise<MastraAgentWiredProcessors>;
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import type { MastraVector } from "@mastra/core/vector";
|
|
2
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.cts";
|
|
3
|
+
import { type MastraNodeStepHandler } from "./types.d.cts";
|
|
4
|
+
import { type MastraModelAdapterConfig } from "./MastraAgentModelAdapter.d.cts";
|
|
5
|
+
import { type MastraAgentMemoryWiring, type MastraMemoryConfig, type MastraMemoryEmbedder, type MastraMemoryStorageBindings } from "./MastraMemory.d.cts";
|
|
6
|
+
import { type MastraAgentWiredProcessors, type MastraProcessorModelResolver } from "./MastraAgentProcessors.d.cts";
|
|
7
|
+
import { type MastraDecafModelResolver, type MastraResolvedStructuredOutput } from "./MastraStructuredOutput.d.cts";
|
|
8
|
+
/**
|
|
9
|
+
* Host port that performs the actual agent invocation for one `core.agent` node.
|
|
10
|
+
* The backend supplies a config-backed implementation; tests supply a fake.
|
|
11
|
+
*/
|
|
12
|
+
export interface MastraAgentRuntime {
|
|
13
|
+
/**
|
|
14
|
+
* Runs the agent configured for `node` against the node's resolved inputs.
|
|
15
|
+
*
|
|
16
|
+
* @param node - The canonical node instance (carries the model-adapter config).
|
|
17
|
+
* @param inputData - The resolved node input values (`prompt`, …).
|
|
18
|
+
* @param signal - The step's abort signal, when the runtime supplies one.
|
|
19
|
+
* @param processors - The wired processor pipelines (SAA-836 M5) resolved
|
|
20
|
+
* from the agent node's `inputProcessors`/`outputProcessors` zones, when
|
|
21
|
+
* the document declares any. Applied by the config-backed runtime as
|
|
22
|
+
* mastra's per-run processor overrides (R3).
|
|
23
|
+
* @param memories - The live mastra memories resolved from the agent node's
|
|
24
|
+
* wired `memory` zone (SAA-836 M2), when any memory provider is connected.
|
|
25
|
+
* @param structuredOutput - The structured-output option resolved from the
|
|
26
|
+
* node's `structuredOutput` definition (SAA-836 S1), when the node
|
|
27
|
+
* declares one. Applied by the config-backed runtime as mastra's
|
|
28
|
+
* per-run `structuredOutput` option.
|
|
29
|
+
* @returns The canonical agent outputs (`response`, `actions`).
|
|
30
|
+
*/
|
|
31
|
+
execute(node: GraphNodeInstance, inputData: Record<string, unknown>, signal?: AbortSignal, processors?: MastraAgentWiredProcessors, memories?: readonly MastraAgentMemoryWiring[], structuredOutput?: MastraResolvedStructuredOutput): Promise<Record<string, unknown>>;
|
|
32
|
+
}
|
|
33
|
+
/** Options a {@link createMastraAgentStepHandler} handler set is built with. */
|
|
34
|
+
export interface MastraAgentStepHandlerOptions {
|
|
35
|
+
/** The agent runtime; when omitted, `core.agent` fails closed. */
|
|
36
|
+
runtime?: MastraAgentRuntime;
|
|
37
|
+
/**
|
|
38
|
+
* Host hook resolving the classifier model a model-carrying wired processor
|
|
39
|
+
* or guardrail runs on (SAA-836 M5, R1). Forwarded to the processor
|
|
40
|
+
* resolution; when omitted, the composed `<provider>/<modelId>` id is used
|
|
41
|
+
* for model-carrying processors that accept one. `modelSelection` requires
|
|
42
|
+
* this hook (mastra validates a structural decision model).
|
|
43
|
+
*/
|
|
44
|
+
resolveProcessorModel?: MastraProcessorModelResolver;
|
|
45
|
+
/**
|
|
46
|
+
* Host decaf-model registry resolving a structured-output definition's model
|
|
47
|
+
* name to its constructor (SAA-836 S1). The resolved model converts to the
|
|
48
|
+
* mastra Zod schema through `@decaf-ts/as-zod` (the single conversion path).
|
|
49
|
+
* When omitted, a definition that references a model by name fails closed.
|
|
50
|
+
*/
|
|
51
|
+
resolveModel?: MastraDecafModelResolver;
|
|
52
|
+
/**
|
|
53
|
+
* Host bindings for mastra-native memory storage backends beyond the built-in
|
|
54
|
+
* in-memory/LibSQL/Postgres resolution (SAA-749 Stage 4).
|
|
55
|
+
*/
|
|
56
|
+
memoryStorageBindings?: MastraMemoryStorageBindings;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Host-provided resolution of a live `@mastra/core` agent. Either a named agent
|
|
60
|
+
* map (keyed by `<provider>/<modelId>`, model id, or node id) or a factory that
|
|
61
|
+
* builds one from the node's model-adapter config, or both.
|
|
62
|
+
*/
|
|
63
|
+
export interface MastraAgentFactoryOptions {
|
|
64
|
+
/** Named mastra agents keyed by model id or node id. */
|
|
65
|
+
agents?: Record<string, unknown>;
|
|
66
|
+
/**
|
|
67
|
+
* Builds a live agent from the node's model-adapter config. Called only when
|
|
68
|
+
* the named map has no matching entry.
|
|
69
|
+
*
|
|
70
|
+
* @param adapter - The validated model-adapter config, when present.
|
|
71
|
+
* @param node - The canonical node instance.
|
|
72
|
+
* @param memories - The live mastra memories resolved from the agent node's
|
|
73
|
+
* wired `memory` zone (SAA-836 M2), for factories that attach memory at
|
|
74
|
+
* construction; absent when no memory provider is wired.
|
|
75
|
+
* @returns The live mastra agent (or a thenable of one).
|
|
76
|
+
*/
|
|
77
|
+
createAgent?: (adapter: MastraModelAdapterConfig | undefined, node: GraphNodeInstance, memories?: readonly unknown[]) => unknown | Promise<unknown>;
|
|
78
|
+
/**
|
|
79
|
+
* Optional named memory map (SAA-836 M2), keyed by the wiring memory node's
|
|
80
|
+
* id, its config id, or its provider. Consulted before {@link createMemory}
|
|
81
|
+
* and the built-in resolution.
|
|
82
|
+
*/
|
|
83
|
+
memories?: Record<string, unknown>;
|
|
84
|
+
/**
|
|
85
|
+
* Optional factory building a live mastra memory from a wired memory node's
|
|
86
|
+
* config (SAA-836 M2). Consulted after the {@link memories} map and before
|
|
87
|
+
* the built-in mastra-native wrap.
|
|
88
|
+
*/
|
|
89
|
+
createMemory?: (config: MastraMemoryConfig, node: GraphNodeInstance) => unknown | Promise<unknown>;
|
|
90
|
+
/**
|
|
91
|
+
* Host bindings for the mastra-native storage backends of the memory matrix
|
|
92
|
+
* (SAA-749 Stage 4); forwarded to the built-in memory resolution.
|
|
93
|
+
*/
|
|
94
|
+
memoryStorageBindings?: MastraMemoryStorageBindings;
|
|
95
|
+
/**
|
|
96
|
+
* Host-supplied mastra vector store for memories that enable semantic recall
|
|
97
|
+
* (SAA-749 Stage 4); forwarded to the built-in memory resolution. Without it
|
|
98
|
+
* a semantic-recall memory fails closed with
|
|
99
|
+
* `GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED`.
|
|
100
|
+
*/
|
|
101
|
+
memoryVectorStore?: MastraVector;
|
|
102
|
+
/** Host-supplied embedding model used by semantic recall, when needed. */
|
|
103
|
+
memoryEmbedder?: MastraMemoryEmbedder;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Builds the config-backed {@link MastraAgentRuntime}: resolves the node's agent
|
|
107
|
+
* and invokes it via `agent.generate(prompt, options)`, where the options carry
|
|
108
|
+
* the caller's `abortSignal` plus the per-run mastra options the step resolved —
|
|
109
|
+
* wired `inputProcessors`/`outputProcessors` overrides (SAA-836 M5), the wired
|
|
110
|
+
* memory thread binding (SAA-836 M2), and the `structuredOutput` option
|
|
111
|
+
* (SAA-836 S1) with the as-zod-derived Zod schema. The result is projected onto
|
|
112
|
+
* the canonical outputs. Fails closed when the resolved agent is missing or
|
|
113
|
+
* exposes no `generate` method.
|
|
114
|
+
*
|
|
115
|
+
* @param options - The named-agent map and/or agent factory.
|
|
116
|
+
* @returns The runtime the agent step delegates to.
|
|
117
|
+
*/
|
|
118
|
+
export declare function createMastraAgentRuntimeFromConfig(options?: MastraAgentFactoryOptions): MastraAgentRuntime;
|
|
119
|
+
/**
|
|
120
|
+
* Builds the schema-agnostic {@link MastraNodeStepHandler} registered for the
|
|
121
|
+
* `core.agent` kind. The step coerces the runtime's input data to a record,
|
|
122
|
+
* delegates to the configured runtime, and coerces the result back to a record
|
|
123
|
+
* so untyped document parameters never break the mastra runtime.
|
|
124
|
+
*
|
|
125
|
+
* @param options - The handler-set options (the agent runtime).
|
|
126
|
+
* @returns The `core.agent` step handler.
|
|
127
|
+
*/
|
|
128
|
+
export declare function createMastraAgentStepHandler(options?: MastraAgentStepHandlerOptions): MastraNodeStepHandler;
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import type { MastraVector } from "@mastra/core/vector";
|
|
2
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
|
|
3
|
+
import { type MastraNodeStepHandler } from "./types.d.mts";
|
|
4
|
+
import { type MastraModelAdapterConfig } from "./MastraAgentModelAdapter.d.mts";
|
|
5
|
+
import { type MastraAgentMemoryWiring, type MastraMemoryConfig, type MastraMemoryEmbedder, type MastraMemoryStorageBindings } from "./MastraMemory.d.mts";
|
|
6
|
+
import { type MastraAgentWiredProcessors, type MastraProcessorModelResolver } from "./MastraAgentProcessors.d.mts";
|
|
7
|
+
import { type MastraDecafModelResolver, type MastraResolvedStructuredOutput } from "./MastraStructuredOutput.d.mts";
|
|
8
|
+
/**
|
|
9
|
+
* Host port that performs the actual agent invocation for one `core.agent` node.
|
|
10
|
+
* The backend supplies a config-backed implementation; tests supply a fake.
|
|
11
|
+
*/
|
|
12
|
+
export interface MastraAgentRuntime {
|
|
13
|
+
/**
|
|
14
|
+
* Runs the agent configured for `node` against the node's resolved inputs.
|
|
15
|
+
*
|
|
16
|
+
* @param node - The canonical node instance (carries the model-adapter config).
|
|
17
|
+
* @param inputData - The resolved node input values (`prompt`, …).
|
|
18
|
+
* @param signal - The step's abort signal, when the runtime supplies one.
|
|
19
|
+
* @param processors - The wired processor pipelines (SAA-836 M5) resolved
|
|
20
|
+
* from the agent node's `inputProcessors`/`outputProcessors` zones, when
|
|
21
|
+
* the document declares any. Applied by the config-backed runtime as
|
|
22
|
+
* mastra's per-run processor overrides (R3).
|
|
23
|
+
* @param memories - The live mastra memories resolved from the agent node's
|
|
24
|
+
* wired `memory` zone (SAA-836 M2), when any memory provider is connected.
|
|
25
|
+
* @param structuredOutput - The structured-output option resolved from the
|
|
26
|
+
* node's `structuredOutput` definition (SAA-836 S1), when the node
|
|
27
|
+
* declares one. Applied by the config-backed runtime as mastra's
|
|
28
|
+
* per-run `structuredOutput` option.
|
|
29
|
+
* @returns The canonical agent outputs (`response`, `actions`).
|
|
30
|
+
*/
|
|
31
|
+
execute(node: GraphNodeInstance, inputData: Record<string, unknown>, signal?: AbortSignal, processors?: MastraAgentWiredProcessors, memories?: readonly MastraAgentMemoryWiring[], structuredOutput?: MastraResolvedStructuredOutput): Promise<Record<string, unknown>>;
|
|
32
|
+
}
|
|
33
|
+
/** Options a {@link createMastraAgentStepHandler} handler set is built with. */
|
|
34
|
+
export interface MastraAgentStepHandlerOptions {
|
|
35
|
+
/** The agent runtime; when omitted, `core.agent` fails closed. */
|
|
36
|
+
runtime?: MastraAgentRuntime;
|
|
37
|
+
/**
|
|
38
|
+
* Host hook resolving the classifier model a model-carrying wired processor
|
|
39
|
+
* or guardrail runs on (SAA-836 M5, R1). Forwarded to the processor
|
|
40
|
+
* resolution; when omitted, the composed `<provider>/<modelId>` id is used
|
|
41
|
+
* for model-carrying processors that accept one. `modelSelection` requires
|
|
42
|
+
* this hook (mastra validates a structural decision model).
|
|
43
|
+
*/
|
|
44
|
+
resolveProcessorModel?: MastraProcessorModelResolver;
|
|
45
|
+
/**
|
|
46
|
+
* Host decaf-model registry resolving a structured-output definition's model
|
|
47
|
+
* name to its constructor (SAA-836 S1). The resolved model converts to the
|
|
48
|
+
* mastra Zod schema through `@decaf-ts/as-zod` (the single conversion path).
|
|
49
|
+
* When omitted, a definition that references a model by name fails closed.
|
|
50
|
+
*/
|
|
51
|
+
resolveModel?: MastraDecafModelResolver;
|
|
52
|
+
/**
|
|
53
|
+
* Host bindings for mastra-native memory storage backends beyond the built-in
|
|
54
|
+
* in-memory/LibSQL/Postgres resolution (SAA-749 Stage 4).
|
|
55
|
+
*/
|
|
56
|
+
memoryStorageBindings?: MastraMemoryStorageBindings;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Host-provided resolution of a live `@mastra/core` agent. Either a named agent
|
|
60
|
+
* map (keyed by `<provider>/<modelId>`, model id, or node id) or a factory that
|
|
61
|
+
* builds one from the node's model-adapter config, or both.
|
|
62
|
+
*/
|
|
63
|
+
export interface MastraAgentFactoryOptions {
|
|
64
|
+
/** Named mastra agents keyed by model id or node id. */
|
|
65
|
+
agents?: Record<string, unknown>;
|
|
66
|
+
/**
|
|
67
|
+
* Builds a live agent from the node's model-adapter config. Called only when
|
|
68
|
+
* the named map has no matching entry.
|
|
69
|
+
*
|
|
70
|
+
* @param adapter - The validated model-adapter config, when present.
|
|
71
|
+
* @param node - The canonical node instance.
|
|
72
|
+
* @param memories - The live mastra memories resolved from the agent node's
|
|
73
|
+
* wired `memory` zone (SAA-836 M2), for factories that attach memory at
|
|
74
|
+
* construction; absent when no memory provider is wired.
|
|
75
|
+
* @returns The live mastra agent (or a thenable of one).
|
|
76
|
+
*/
|
|
77
|
+
createAgent?: (adapter: MastraModelAdapterConfig | undefined, node: GraphNodeInstance, memories?: readonly unknown[]) => unknown | Promise<unknown>;
|
|
78
|
+
/**
|
|
79
|
+
* Optional named memory map (SAA-836 M2), keyed by the wiring memory node's
|
|
80
|
+
* id, its config id, or its provider. Consulted before {@link createMemory}
|
|
81
|
+
* and the built-in resolution.
|
|
82
|
+
*/
|
|
83
|
+
memories?: Record<string, unknown>;
|
|
84
|
+
/**
|
|
85
|
+
* Optional factory building a live mastra memory from a wired memory node's
|
|
86
|
+
* config (SAA-836 M2). Consulted after the {@link memories} map and before
|
|
87
|
+
* the built-in mastra-native wrap.
|
|
88
|
+
*/
|
|
89
|
+
createMemory?: (config: MastraMemoryConfig, node: GraphNodeInstance) => unknown | Promise<unknown>;
|
|
90
|
+
/**
|
|
91
|
+
* Host bindings for the mastra-native storage backends of the memory matrix
|
|
92
|
+
* (SAA-749 Stage 4); forwarded to the built-in memory resolution.
|
|
93
|
+
*/
|
|
94
|
+
memoryStorageBindings?: MastraMemoryStorageBindings;
|
|
95
|
+
/**
|
|
96
|
+
* Host-supplied mastra vector store for memories that enable semantic recall
|
|
97
|
+
* (SAA-749 Stage 4); forwarded to the built-in memory resolution. Without it
|
|
98
|
+
* a semantic-recall memory fails closed with
|
|
99
|
+
* `GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED`.
|
|
100
|
+
*/
|
|
101
|
+
memoryVectorStore?: MastraVector;
|
|
102
|
+
/** Host-supplied embedding model used by semantic recall, when needed. */
|
|
103
|
+
memoryEmbedder?: MastraMemoryEmbedder;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Builds the config-backed {@link MastraAgentRuntime}: resolves the node's agent
|
|
107
|
+
* and invokes it via `agent.generate(prompt, options)`, where the options carry
|
|
108
|
+
* the caller's `abortSignal` plus the per-run mastra options the step resolved —
|
|
109
|
+
* wired `inputProcessors`/`outputProcessors` overrides (SAA-836 M5), the wired
|
|
110
|
+
* memory thread binding (SAA-836 M2), and the `structuredOutput` option
|
|
111
|
+
* (SAA-836 S1) with the as-zod-derived Zod schema. The result is projected onto
|
|
112
|
+
* the canonical outputs. Fails closed when the resolved agent is missing or
|
|
113
|
+
* exposes no `generate` method.
|
|
114
|
+
*
|
|
115
|
+
* @param options - The named-agent map and/or agent factory.
|
|
116
|
+
* @returns The runtime the agent step delegates to.
|
|
117
|
+
*/
|
|
118
|
+
export declare function createMastraAgentRuntimeFromConfig(options?: MastraAgentFactoryOptions): MastraAgentRuntime;
|
|
119
|
+
/**
|
|
120
|
+
* Builds the schema-agnostic {@link MastraNodeStepHandler} registered for the
|
|
121
|
+
* `core.agent` kind. The step coerces the runtime's input data to a record,
|
|
122
|
+
* delegates to the configured runtime, and coerces the result back to a record
|
|
123
|
+
* so untyped document parameters never break the mastra runtime.
|
|
124
|
+
*
|
|
125
|
+
* @param options - The handler-set options (the agent runtime).
|
|
126
|
+
* @returns The `core.agent` step handler.
|
|
127
|
+
*/
|
|
128
|
+
export declare function createMastraAgentStepHandler(options?: MastraAgentStepHandlerOptions): MastraNodeStepHandler;
|
|
@@ -56,9 +56,29 @@ export interface MastraWorkflowManagementCapabilities {
|
|
|
56
56
|
/** Native workflow versioning support. */
|
|
57
57
|
version: MastraWorkflowCapabilityStatus;
|
|
58
58
|
}
|
|
59
|
+
/**
|
|
60
|
+
* The Mastra metrics-read capability projection (SAA-836 S2): the read-only
|
|
61
|
+
* metrics families the backend serves over the host-provided mastra storage,
|
|
62
|
+
* each resolved honestly from the exported feature table.
|
|
63
|
+
*/
|
|
64
|
+
export interface MastraMetricsReadCapabilities {
|
|
65
|
+
/** Agent run metrics (list/get) support. */
|
|
66
|
+
runs: MastraWorkflowCapabilityStatus;
|
|
67
|
+
/** Per-run score metrics support. */
|
|
68
|
+
scores: MastraWorkflowCapabilityStatus;
|
|
69
|
+
/** Per-run trace span metrics support. */
|
|
70
|
+
traces: MastraWorkflowCapabilityStatus;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The full capability projection of the Mastra backend: the engine-agnostic
|
|
74
|
+
* engine surface extended with the SAA-346 workflow-management statuses and the
|
|
75
|
+
* SAA-836 S2 read-only metrics families.
|
|
76
|
+
*/
|
|
59
77
|
export interface MastraBackendCapabilities extends GraphBackendCapabilities {
|
|
60
78
|
/** Workflow list/lookup plus the management statuses. */
|
|
61
79
|
workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
|
|
80
|
+
/** Read-only metrics families (SAA-836 S2). */
|
|
81
|
+
metrics: MastraMetricsReadCapabilities;
|
|
62
82
|
}
|
|
63
83
|
/**
|
|
64
84
|
* Resolves a feature row's three-valued management status from the exported
|
|
@@ -56,9 +56,29 @@ export interface MastraWorkflowManagementCapabilities {
|
|
|
56
56
|
/** Native workflow versioning support. */
|
|
57
57
|
version: MastraWorkflowCapabilityStatus;
|
|
58
58
|
}
|
|
59
|
+
/**
|
|
60
|
+
* The Mastra metrics-read capability projection (SAA-836 S2): the read-only
|
|
61
|
+
* metrics families the backend serves over the host-provided mastra storage,
|
|
62
|
+
* each resolved honestly from the exported feature table.
|
|
63
|
+
*/
|
|
64
|
+
export interface MastraMetricsReadCapabilities {
|
|
65
|
+
/** Agent run metrics (list/get) support. */
|
|
66
|
+
runs: MastraWorkflowCapabilityStatus;
|
|
67
|
+
/** Per-run score metrics support. */
|
|
68
|
+
scores: MastraWorkflowCapabilityStatus;
|
|
69
|
+
/** Per-run trace span metrics support. */
|
|
70
|
+
traces: MastraWorkflowCapabilityStatus;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The full capability projection of the Mastra backend: the engine-agnostic
|
|
74
|
+
* engine surface extended with the SAA-346 workflow-management statuses and the
|
|
75
|
+
* SAA-836 S2 read-only metrics families.
|
|
76
|
+
*/
|
|
59
77
|
export interface MastraBackendCapabilities extends GraphBackendCapabilities {
|
|
60
78
|
/** Workflow list/lookup plus the management statuses. */
|
|
61
79
|
workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
|
|
80
|
+
/** Read-only metrics families (SAA-836 S2). */
|
|
81
|
+
metrics: MastraMetricsReadCapabilities;
|
|
62
82
|
}
|
|
63
83
|
/**
|
|
64
84
|
* Resolves a feature row's three-valued management status from the exported
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.cts";
|
|
2
|
+
import { type MastraChannelPlatform, type MastraChannelResponseDescriptor, type MastraNodeStepHandler } from "./types.d.cts";
|
|
3
|
+
/** The document node kind prefix every built-in channel response kind carries. */
|
|
4
|
+
export declare const GRAPH_MASTRA_CHANNEL_RESPONSE_KIND_PREFIX = "core.agent.response.";
|
|
5
|
+
/** Length cap for a wired thread-id override (SAA-911 F5): a conversation
|
|
6
|
+
* binding is a platform identifier, not free-form upstream data; the cap
|
|
7
|
+
* bounds what an upstream (potentially attacker-influenced) value can inject
|
|
8
|
+
* into the delivery payload. */
|
|
9
|
+
export declare const GRAPH_MASTRA_CHANNEL_THREAD_ID_MAX_LENGTH = 512;
|
|
10
|
+
/**
|
|
11
|
+
* The document node kind a channel response node declares for `platform`
|
|
12
|
+
* (SAA-836 M6).
|
|
13
|
+
*
|
|
14
|
+
* @param platform - The channel platform.
|
|
15
|
+
* @returns The response kind, e.g. `core.agent.response.slack`.
|
|
16
|
+
*/
|
|
17
|
+
export declare function mastraChannelResponseKindOf(platform: MastraChannelPlatform): string;
|
|
18
|
+
/** Every built-in channel response kind, in platform order. */
|
|
19
|
+
export declare const GRAPH_MASTRA_CHANNEL_RESPONSE_KINDS: readonly string[];
|
|
20
|
+
/** Options a {@link createMastraChannelResponseStepHandler} handler is built with. */
|
|
21
|
+
export interface MastraChannelResponseStepHandlerOptions {
|
|
22
|
+
/**
|
|
23
|
+
* Host factory posting the reply payload to the platform conversation bound
|
|
24
|
+
* by the descriptor. When omitted, the response fails closed.
|
|
25
|
+
*/
|
|
26
|
+
sendChannelResponse?: (descriptor: MastraChannelResponseDescriptor, payload: Record<string, unknown>) => unknown | Promise<unknown>;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Reads the {@link MastraChannelResponseDescriptor} a channel response node
|
|
30
|
+
* resolves from its kind and parameters (R9 descriptor shape).
|
|
31
|
+
*
|
|
32
|
+
* @param node - The response node.
|
|
33
|
+
* @param workflowId - The canonical workflow id the response belongs to.
|
|
34
|
+
* @returns The channel response descriptor.
|
|
35
|
+
* @throws {GraphExecutionError} when the node's kind names no built-in
|
|
36
|
+
* channel platform.
|
|
37
|
+
*/
|
|
38
|
+
export declare function mastraChannelResponseDescriptorOf(node: GraphNodeInstance, workflowId?: string): MastraChannelResponseDescriptor;
|
|
39
|
+
/**
|
|
40
|
+
* Builds the {@link MastraNodeStepHandler} registered for one built-in
|
|
41
|
+
* channel response kind. The step resolves the response's channel descriptor,
|
|
42
|
+
* takes the reply from the wired `response` input, and binds the delivery to
|
|
43
|
+
* the configured conversation binding; a wired `threadId` is honored only
|
|
44
|
+
* when it is the sole binding known — it never overrides the configured
|
|
45
|
+
* binding, and an override attempt (or an overlong wired value) fails closed
|
|
46
|
+
* (SAA-911 F5). Delivery is delegated to the host factory, and the posted
|
|
47
|
+
* reply descriptor is returned on the `resource` output. Without a host
|
|
48
|
+
* factory the step fails closed — no reply is ever fabricated as delivered.
|
|
49
|
+
*
|
|
50
|
+
* @param kind - The channel response kind to translate.
|
|
51
|
+
* @param options - The handler options (the host delivery factory).
|
|
52
|
+
* @returns The channel response step handler.
|
|
53
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_CHANNEL_UNAVAILABLE} when
|
|
54
|
+
* no host factory is configured or it yields nothing.
|
|
55
|
+
*/
|
|
56
|
+
export declare function createMastraChannelResponseStepHandler(kind: string, options?: MastraChannelResponseStepHandlerOptions): MastraNodeStepHandler;
|
|
57
|
+
/**
|
|
58
|
+
* Builds the {@link MastraNodeStepHandler} set for every built-in channel
|
|
59
|
+
* response kind.
|
|
60
|
+
*
|
|
61
|
+
* @param options - The handler options (the host delivery factory).
|
|
62
|
+
* @returns One handler per channel response kind.
|
|
63
|
+
*/
|
|
64
|
+
export declare function createMastraChannelResponseStepHandlers(options?: MastraChannelResponseStepHandlerOptions): MastraNodeStepHandler[];
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
|
|
2
|
+
import { type MastraChannelPlatform, type MastraChannelResponseDescriptor, type MastraNodeStepHandler } from "./types.d.mts";
|
|
3
|
+
/** The document node kind prefix every built-in channel response kind carries. */
|
|
4
|
+
export declare const GRAPH_MASTRA_CHANNEL_RESPONSE_KIND_PREFIX = "core.agent.response.";
|
|
5
|
+
/** Length cap for a wired thread-id override (SAA-911 F5): a conversation
|
|
6
|
+
* binding is a platform identifier, not free-form upstream data; the cap
|
|
7
|
+
* bounds what an upstream (potentially attacker-influenced) value can inject
|
|
8
|
+
* into the delivery payload. */
|
|
9
|
+
export declare const GRAPH_MASTRA_CHANNEL_THREAD_ID_MAX_LENGTH = 512;
|
|
10
|
+
/**
|
|
11
|
+
* The document node kind a channel response node declares for `platform`
|
|
12
|
+
* (SAA-836 M6).
|
|
13
|
+
*
|
|
14
|
+
* @param platform - The channel platform.
|
|
15
|
+
* @returns The response kind, e.g. `core.agent.response.slack`.
|
|
16
|
+
*/
|
|
17
|
+
export declare function mastraChannelResponseKindOf(platform: MastraChannelPlatform): string;
|
|
18
|
+
/** Every built-in channel response kind, in platform order. */
|
|
19
|
+
export declare const GRAPH_MASTRA_CHANNEL_RESPONSE_KINDS: readonly string[];
|
|
20
|
+
/** Options a {@link createMastraChannelResponseStepHandler} handler is built with. */
|
|
21
|
+
export interface MastraChannelResponseStepHandlerOptions {
|
|
22
|
+
/**
|
|
23
|
+
* Host factory posting the reply payload to the platform conversation bound
|
|
24
|
+
* by the descriptor. When omitted, the response fails closed.
|
|
25
|
+
*/
|
|
26
|
+
sendChannelResponse?: (descriptor: MastraChannelResponseDescriptor, payload: Record<string, unknown>) => unknown | Promise<unknown>;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Reads the {@link MastraChannelResponseDescriptor} a channel response node
|
|
30
|
+
* resolves from its kind and parameters (R9 descriptor shape).
|
|
31
|
+
*
|
|
32
|
+
* @param node - The response node.
|
|
33
|
+
* @param workflowId - The canonical workflow id the response belongs to.
|
|
34
|
+
* @returns The channel response descriptor.
|
|
35
|
+
* @throws {GraphExecutionError} when the node's kind names no built-in
|
|
36
|
+
* channel platform.
|
|
37
|
+
*/
|
|
38
|
+
export declare function mastraChannelResponseDescriptorOf(node: GraphNodeInstance, workflowId?: string): MastraChannelResponseDescriptor;
|
|
39
|
+
/**
|
|
40
|
+
* Builds the {@link MastraNodeStepHandler} registered for one built-in
|
|
41
|
+
* channel response kind. The step resolves the response's channel descriptor,
|
|
42
|
+
* takes the reply from the wired `response` input, and binds the delivery to
|
|
43
|
+
* the configured conversation binding; a wired `threadId` is honored only
|
|
44
|
+
* when it is the sole binding known — it never overrides the configured
|
|
45
|
+
* binding, and an override attempt (or an overlong wired value) fails closed
|
|
46
|
+
* (SAA-911 F5). Delivery is delegated to the host factory, and the posted
|
|
47
|
+
* reply descriptor is returned on the `resource` output. Without a host
|
|
48
|
+
* factory the step fails closed — no reply is ever fabricated as delivered.
|
|
49
|
+
*
|
|
50
|
+
* @param kind - The channel response kind to translate.
|
|
51
|
+
* @param options - The handler options (the host delivery factory).
|
|
52
|
+
* @returns The channel response step handler.
|
|
53
|
+
* @throws {GraphExecutionError} {@link GRAPH_MASTRA_CHANNEL_UNAVAILABLE} when
|
|
54
|
+
* no host factory is configured or it yields nothing.
|
|
55
|
+
*/
|
|
56
|
+
export declare function createMastraChannelResponseStepHandler(kind: string, options?: MastraChannelResponseStepHandlerOptions): MastraNodeStepHandler;
|
|
57
|
+
/**
|
|
58
|
+
* Builds the {@link MastraNodeStepHandler} set for every built-in channel
|
|
59
|
+
* response kind.
|
|
60
|
+
*
|
|
61
|
+
* @param options - The handler options (the host delivery factory).
|
|
62
|
+
* @returns One handler per channel response kind.
|
|
63
|
+
*/
|
|
64
|
+
export declare function createMastraChannelResponseStepHandlers(options?: MastraChannelResponseStepHandlerOptions): MastraNodeStepHandler[];
|