@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.1
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/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md +1 -0
- package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +0 -10
- package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +0 -10
- package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +36 -36
- package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +0 -10
- package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +70 -70
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +40 -40
- package/.docs/organized/changelogs/%40mastra%2Fastra.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fauth.md +4 -14
- package/.docs/organized/changelogs/%40mastra%2Fchroma.md +18 -18
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +199 -199
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +220 -220
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +190 -190
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +199 -199
- package/.docs/organized/changelogs/%40mastra%2Fcodemod.md +7 -0
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +210 -210
- package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +69 -69
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +67 -67
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +70 -70
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +67 -67
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +209 -209
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +191 -191
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +34 -34
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +5 -13
- package/.docs/organized/changelogs/%40mastra%2Flance.md +182 -182
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +199 -199
- package/.docs/organized/changelogs/%40mastra%2Floggers.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +56 -56
- package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +65 -65
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +228 -228
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +199 -199
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +206 -206
- package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +197 -197
- package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +216 -216
- package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Frag.md +61 -61
- package/.docs/organized/changelogs/%40mastra%2Freact.md +66 -66
- package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +9 -17
- package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -30
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +203 -203
- package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +190 -190
- package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +18 -18
- package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +21 -21
- package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +56 -56
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +56 -56
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +20 -20
- package/.docs/organized/changelogs/create-mastra.md +29 -29
- package/.docs/organized/changelogs/mastra.md +93 -93
- package/.docs/organized/code-examples/a2a.md +4 -2
- package/.docs/organized/code-examples/agui.md +12 -9
- package/.docs/organized/code-examples/ai-sdk-useChat.md +12 -18
- package/.docs/organized/code-examples/ai-sdk-v5.md +4 -2
- package/.docs/organized/code-examples/bird-checker-with-express.md +5 -4
- package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +4 -3
- package/.docs/organized/code-examples/bird-checker-with-nextjs.md +4 -3
- package/.docs/organized/code-examples/client-side-tools.md +1 -0
- package/.docs/organized/code-examples/crypto-chatbot.md +1 -1
- package/.docs/organized/code-examples/experimental-auth-weather-agent.md +8 -177
- package/.docs/organized/code-examples/fireworks-r1.md +2 -2
- package/.docs/organized/code-examples/heads-up-game.md +10 -7
- package/.docs/organized/code-examples/mcp-configuration.md +5 -3
- package/.docs/organized/code-examples/mcp-registry-registry.md +3 -2
- package/.docs/organized/code-examples/memory-per-resource-example.md +4 -2
- package/.docs/organized/code-examples/memory-todo-agent.md +1 -0
- package/.docs/organized/code-examples/memory-with-context.md +2 -1
- package/.docs/organized/code-examples/memory-with-libsql.md +4 -2
- package/.docs/organized/code-examples/memory-with-mongodb.md +4 -2
- package/.docs/organized/code-examples/memory-with-pg.md +4 -2
- package/.docs/organized/code-examples/memory-with-processors.md +13 -8
- package/.docs/organized/code-examples/memory-with-upstash.md +5 -3
- package/.docs/organized/code-examples/openapi-spec-writer.md +32 -41
- package/.docs/organized/code-examples/quick-start.md +5 -32
- package/.docs/organized/code-examples/stock-price-tool.md +6 -5
- package/.docs/organized/code-examples/weather-agent.md +21 -16
- package/.docs/organized/code-examples/workflow-ai-recruiter.md +3 -2
- package/.docs/organized/code-examples/workflow-with-inline-steps.md +9 -12
- package/.docs/organized/code-examples/workflow-with-memory.md +16 -15
- package/.docs/organized/code-examples/workflow-with-separate-steps.md +2 -2
- package/.docs/organized/code-examples/workflow-with-suspend-resume.md +3 -2
- package/.docs/raw/agents/adding-voice.mdx +27 -22
- package/.docs/raw/agents/agent-memory.mdx +24 -16
- package/.docs/raw/agents/guardrails.mdx +33 -12
- package/.docs/raw/agents/networks.mdx +8 -4
- package/.docs/raw/agents/overview.mdx +23 -17
- package/.docs/raw/agents/using-tools.mdx +11 -8
- package/.docs/raw/auth/auth0.mdx +9 -9
- package/.docs/raw/auth/clerk.mdx +7 -7
- package/.docs/raw/auth/firebase.mdx +9 -9
- package/.docs/raw/auth/index.mdx +6 -6
- package/.docs/raw/auth/jwt.mdx +7 -7
- package/.docs/raw/auth/supabase.mdx +8 -8
- package/.docs/raw/auth/workos.mdx +9 -9
- package/.docs/raw/community/contributing-templates.mdx +3 -3
- package/.docs/raw/community/discord.mdx +1 -1
- package/.docs/raw/course/01-first-agent/03-verifying-installation.md +1 -1
- package/.docs/raw/course/01-first-agent/08-exporting-your-agent.md +2 -1
- package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +2 -1
- package/.docs/raw/course/02-agent-tools-mcp/02-installing-mcp.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md +2 -0
- package/.docs/raw/course/03-agent-memory/03-installing-memory.md +1 -1
- package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -0
- package/.docs/raw/course/03-agent-memory/10-storage-configuration.md +2 -3
- package/.docs/raw/course/03-agent-memory/13-vector-store-configuration.md +2 -0
- package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +2 -0
- package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +1 -0
- package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +2 -0
- package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +1 -0
- package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +1 -0
- package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +1 -0
- package/.docs/raw/course/04-workflows/08-running-workflows-programmatically.md +2 -2
- package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx +6 -6
- package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx +8 -6
- package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx +5 -5
- package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx +5 -5
- package/.docs/raw/deployment/cloud-providers/index.mdx +11 -8
- package/.docs/raw/deployment/monorepo.mdx +2 -2
- package/.docs/raw/deployment/overview.mdx +2 -2
- package/.docs/raw/deployment/server-deployment.mdx +2 -10
- package/.docs/raw/deployment/serverless-platforms/cloudflare-deployer.mdx +5 -5
- package/.docs/raw/deployment/serverless-platforms/index.mdx +10 -7
- package/.docs/raw/deployment/serverless-platforms/netlify-deployer.mdx +5 -5
- package/.docs/raw/deployment/serverless-platforms/vercel-deployer.mdx +5 -5
- package/.docs/raw/deployment/web-framework.mdx +8 -8
- package/.docs/raw/{scorers → evals}/custom-scorers.mdx +6 -6
- package/.docs/raw/evals/off-the-shelf-scorers.mdx +50 -0
- package/.docs/raw/{scorers → evals}/overview.mdx +9 -9
- package/.docs/raw/evals/running-in-ci.mdx +113 -0
- package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +26 -25
- package/.docs/raw/frameworks/agentic-uis/assistant-ui.mdx +1 -1
- package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx +17 -17
- package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +4 -1
- package/.docs/raw/frameworks/servers/express.mdx +11 -10
- package/.docs/raw/frameworks/web-frameworks/astro.mdx +18 -18
- package/.docs/raw/frameworks/web-frameworks/next-js.mdx +7 -7
- package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx +16 -16
- package/.docs/raw/frameworks/web-frameworks/vite-react.mdx +7 -7
- package/.docs/raw/getting-started/installation.mdx +26 -25
- package/.docs/raw/getting-started/mcp-docs-server.mdx +1 -1
- package/.docs/raw/getting-started/project-structure.mdx +4 -4
- package/.docs/raw/getting-started/studio.mdx +8 -8
- package/.docs/raw/getting-started/templates.mdx +6 -6
- package/.docs/raw/guides/guide/ai-recruiter.mdx +264 -0
- package/.docs/raw/guides/guide/chef-michel.mdx +271 -0
- package/.docs/raw/guides/guide/notes-mcp-server.mdx +450 -0
- package/.docs/raw/guides/guide/research-assistant.mdx +380 -0
- package/.docs/raw/guides/guide/stock-agent.mdx +185 -0
- package/.docs/raw/guides/guide/web-search.mdx +291 -0
- package/.docs/raw/guides/index.mdx +43 -0
- package/.docs/raw/guides/migrations/agentnetwork.mdx +114 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/_template.mdx +50 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +265 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/cli.mdx +48 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +153 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/evals.mdx +230 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/mastra.mdx +171 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/mcp.mdx +114 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +241 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +83 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +62 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +270 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/tools.mdx +115 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/tracing.mdx +280 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/vectors.mdx +23 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/voice.mdx +39 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +178 -0
- package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +367 -0
- package/.docs/raw/guides/quickstarts/nextjs.mdx +275 -0
- package/.docs/raw/index.mdx +9 -9
- package/.docs/raw/{observability/logging.mdx → logging.mdx} +4 -4
- package/.docs/raw/mastra-cloud/dashboard.mdx +2 -2
- package/.docs/raw/mastra-cloud/observability.mdx +6 -6
- package/.docs/raw/mastra-cloud/overview.mdx +2 -2
- package/.docs/raw/mastra-cloud/setting-up.mdx +4 -4
- package/.docs/raw/memory/conversation-history.mdx +1 -0
- package/.docs/raw/memory/memory-processors.mdx +4 -3
- package/.docs/raw/memory/overview.mdx +10 -6
- package/.docs/raw/memory/semantic-recall.mdx +13 -8
- package/.docs/raw/memory/storage/memory-with-libsql.mdx +12 -7
- package/.docs/raw/memory/storage/memory-with-pg.mdx +11 -6
- package/.docs/raw/memory/storage/memory-with-upstash.mdx +11 -6
- package/.docs/raw/memory/threads-and-resources.mdx +11 -13
- package/.docs/raw/memory/working-memory.mdx +30 -14
- package/.docs/raw/observability/overview.mdx +13 -30
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/arize.mdx +11 -19
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/braintrust.mdx +8 -17
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/cloud.mdx +11 -17
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/default.mdx +16 -20
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/langfuse.mdx +8 -17
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/langsmith.mdx +8 -17
- package/.docs/raw/observability/{ai-tracing → tracing}/exporters/otel.mdx +12 -21
- package/.docs/raw/observability/{ai-tracing → tracing}/overview.mdx +107 -142
- package/.docs/raw/observability/{ai-tracing → tracing}/processors/sensitive-data-filter.mdx +14 -13
- package/.docs/raw/rag/chunking-and-embedding.mdx +5 -5
- package/.docs/raw/rag/overview.mdx +3 -13
- package/.docs/raw/rag/retrieval.mdx +24 -12
- package/.docs/raw/rag/vector-databases.mdx +7 -1
- package/.docs/raw/reference/agents/agent.mdx +35 -30
- package/.docs/raw/reference/agents/generate.mdx +10 -10
- package/.docs/raw/reference/agents/generateLegacy.mdx +8 -8
- package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +21 -15
- package/.docs/raw/reference/agents/getDefaultOptions.mdx +69 -0
- package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +22 -16
- package/.docs/raw/reference/agents/getDescription.mdx +1 -1
- package/.docs/raw/reference/agents/getInstructions.mdx +8 -8
- package/.docs/raw/reference/agents/getLLM.mdx +9 -9
- package/.docs/raw/reference/agents/getMemory.mdx +9 -9
- package/.docs/raw/reference/agents/getModel.mdx +10 -10
- package/.docs/raw/reference/agents/getVoice.mdx +8 -8
- package/.docs/raw/reference/agents/listAgents.mdx +9 -9
- package/.docs/raw/reference/agents/listScorers.mdx +7 -7
- package/.docs/raw/reference/agents/listTools.mdx +7 -7
- package/.docs/raw/reference/agents/listWorkflows.mdx +7 -7
- package/.docs/raw/reference/agents/network.mdx +11 -10
- package/.docs/raw/reference/auth/auth0.mdx +4 -4
- package/.docs/raw/reference/auth/clerk.mdx +4 -4
- package/.docs/raw/reference/auth/firebase.mdx +6 -6
- package/.docs/raw/reference/auth/jwt.mdx +4 -4
- package/.docs/raw/reference/auth/supabase.mdx +4 -4
- package/.docs/raw/reference/auth/workos.mdx +4 -4
- package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
- package/.docs/raw/reference/cli/mastra.mdx +7 -7
- package/.docs/raw/reference/client-js/agents.mdx +6 -2
- package/.docs/raw/reference/client-js/mastra-client.mdx +7 -7
- package/.docs/raw/reference/client-js/memory.mdx +24 -16
- package/.docs/raw/reference/client-js/observability.mdx +11 -11
- package/.docs/raw/reference/client-js/workflows.mdx +6 -34
- package/.docs/raw/reference/core/getAgent.mdx +1 -1
- package/.docs/raw/reference/core/getAgentById.mdx +1 -1
- package/.docs/raw/reference/core/getDeployer.mdx +2 -2
- package/.docs/raw/reference/core/getLogger.mdx +2 -2
- package/.docs/raw/reference/core/getMCPServer.mdx +31 -15
- package/.docs/raw/reference/core/getMCPServerById.mdx +81 -0
- package/.docs/raw/reference/core/getScorer.mdx +3 -3
- package/.docs/raw/reference/core/getScorerById.mdx +79 -0
- package/.docs/raw/reference/core/getServer.mdx +2 -2
- package/.docs/raw/reference/core/getStorage.mdx +2 -2
- package/.docs/raw/reference/core/getTelemetry.mdx +2 -2
- package/.docs/raw/reference/core/getVector.mdx +2 -2
- package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
- package/.docs/raw/reference/core/listAgents.mdx +1 -1
- package/.docs/raw/reference/core/listLogs.mdx +2 -2
- package/.docs/raw/reference/core/listLogsByRunId.mdx +2 -2
- package/.docs/raw/reference/core/listMCPServers.mdx +65 -0
- package/.docs/raw/reference/core/listScorers.mdx +3 -3
- package/.docs/raw/reference/core/listVectors.mdx +36 -0
- package/.docs/raw/reference/core/listWorkflows.mdx +6 -6
- package/.docs/raw/reference/core/mastra-class.mdx +3 -2
- package/.docs/raw/reference/core/setLogger.mdx +2 -2
- package/.docs/raw/reference/core/setStorage.mdx +3 -2
- package/.docs/raw/reference/core/setTelemetry.mdx +2 -2
- package/.docs/raw/reference/deployer/cloudflare.mdx +2 -2
- package/.docs/raw/reference/deployer/deployer.mdx +0 -6
- package/.docs/raw/reference/deployer/netlify.mdx +2 -2
- package/.docs/raw/reference/deployer/vercel.mdx +3 -3
- package/.docs/raw/reference/evals/answer-relevancy.mdx +164 -126
- package/.docs/raw/reference/{scorers → evals}/answer-similarity.mdx +27 -27
- package/.docs/raw/reference/evals/bias.mdx +149 -115
- package/.docs/raw/reference/evals/completeness.mdx +148 -117
- package/.docs/raw/reference/evals/content-similarity.mdx +126 -113
- package/.docs/raw/reference/evals/context-precision.mdx +290 -133
- package/.docs/raw/reference/{scorers → evals}/context-relevance.mdx +6 -6
- package/.docs/raw/reference/{scorers → evals}/create-scorer.mdx +69 -60
- package/.docs/raw/reference/evals/faithfulness.mdx +163 -121
- package/.docs/raw/reference/evals/hallucination.mdx +159 -132
- package/.docs/raw/reference/evals/keyword-coverage.mdx +169 -125
- package/.docs/raw/reference/{scorers → evals}/mastra-scorer.mdx +7 -5
- package/.docs/raw/reference/{scorers → evals}/noise-sensitivity.mdx +9 -9
- package/.docs/raw/reference/evals/prompt-alignment.mdx +604 -182
- package/.docs/raw/reference/{scorers/run-experiment.mdx → evals/run-evals.mdx} +17 -18
- package/.docs/raw/reference/evals/textual-difference.mdx +149 -117
- package/.docs/raw/reference/evals/tone-consistency.mdx +149 -125
- package/.docs/raw/reference/{scorers → evals}/tool-call-accuracy.mdx +8 -6
- package/.docs/raw/reference/evals/toxicity.mdx +152 -96
- package/.docs/raw/reference/{observability/logging → logging}/pino-logger.mdx +2 -2
- package/.docs/raw/reference/memory/createThread.mdx +5 -5
- package/.docs/raw/reference/memory/deleteMessages.mdx +7 -7
- package/.docs/raw/reference/memory/getThreadById.mdx +4 -4
- package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +110 -0
- package/.docs/raw/reference/memory/memory-class.mdx +13 -9
- package/.docs/raw/reference/memory/query.mdx +58 -57
- package/.docs/raw/reference/memory/recall.mdx +185 -0
- package/.docs/raw/reference/observability/tracing/configuration.mdx +245 -0
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/arize.mdx +13 -13
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/braintrust.mdx +11 -8
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/cloud-exporter.mdx +21 -19
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/console-exporter.mdx +49 -17
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/default-exporter.mdx +42 -41
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/langfuse.mdx +10 -7
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/langsmith.mdx +10 -7
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/otel.mdx +5 -5
- package/.docs/raw/reference/observability/tracing/instances.mdx +168 -0
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/interfaces.mdx +115 -89
- package/.docs/raw/reference/observability/{ai-tracing → tracing}/processors/sensitive-data-filter.mdx +3 -3
- package/.docs/raw/reference/observability/{ai-tracing/span.mdx → tracing/spans.mdx} +59 -41
- package/.docs/raw/reference/processors/batch-parts-processor.mdx +9 -3
- package/.docs/raw/reference/processors/language-detector.mdx +9 -3
- package/.docs/raw/reference/processors/moderation-processor.mdx +9 -3
- package/.docs/raw/reference/processors/pii-detector.mdx +9 -3
- package/.docs/raw/reference/processors/prompt-injection-detector.mdx +9 -3
- package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +9 -3
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +9 -3
- package/.docs/raw/reference/processors/unicode-normalizer.mdx +9 -3
- package/.docs/raw/reference/rag/chunk.mdx +1 -8
- package/.docs/raw/reference/rag/database-config.mdx +7 -7
- package/.docs/raw/reference/rag/metadata-filters.mdx +14 -11
- package/.docs/raw/reference/storage/cloudflare-d1.mdx +1 -1
- package/.docs/raw/reference/storage/cloudflare.mdx +1 -1
- package/.docs/raw/reference/storage/dynamodb.mdx +3 -3
- package/.docs/raw/reference/storage/lance.mdx +1 -1
- package/.docs/raw/reference/storage/libsql.mdx +3 -1
- package/.docs/raw/reference/storage/mongodb.mdx +1 -1
- package/.docs/raw/reference/storage/mssql.mdx +6 -1
- package/.docs/raw/reference/storage/postgresql.mdx +7 -1
- package/.docs/raw/reference/storage/upstash.mdx +2 -1
- package/.docs/raw/reference/streaming/agents/stream.mdx +12 -12
- package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +8 -8
- package/.docs/raw/reference/streaming/workflows/observeStream.mdx +3 -3
- package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx +3 -3
- package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx +6 -6
- package/.docs/raw/reference/streaming/workflows/stream.mdx +10 -10
- package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +11 -11
- package/.docs/raw/reference/templates/overview.mdx +3 -3
- package/.docs/raw/reference/tools/create-tool.mdx +52 -35
- package/.docs/raw/reference/tools/graph-rag-tool.mdx +15 -15
- package/.docs/raw/reference/tools/mcp-client.mdx +1 -1
- package/.docs/raw/reference/tools/mcp-server.mdx +119 -35
- package/.docs/raw/reference/tools/vector-query-tool.mdx +27 -26
- package/.docs/raw/reference/vectors/couchbase.mdx +8 -2
- package/.docs/raw/reference/vectors/libsql.mdx +2 -1
- package/.docs/raw/reference/vectors/mongodb.mdx +7 -1
- package/.docs/raw/reference/vectors/pg.mdx +3 -0
- package/.docs/raw/reference/vectors/s3vectors.mdx +1 -1
- package/.docs/raw/reference/vectors/upstash.mdx +1 -0
- package/.docs/raw/reference/voice/google-gemini-live.mdx +1 -1
- package/.docs/raw/reference/voice/voice.addTools.mdx +3 -3
- package/.docs/raw/reference/workflows/run-methods/cancel.mdx +4 -4
- package/.docs/raw/reference/workflows/run-methods/resume.mdx +14 -14
- package/.docs/raw/reference/workflows/run-methods/start.mdx +17 -17
- package/.docs/raw/reference/workflows/run.mdx +1 -8
- package/.docs/raw/reference/workflows/step.mdx +5 -5
- package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +7 -13
- package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/map.mdx +5 -0
- package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow.mdx +1 -1
- package/.docs/raw/server-db/custom-api-routes.mdx +2 -2
- package/.docs/raw/server-db/mastra-client.mdx +23 -22
- package/.docs/raw/server-db/middleware.mdx +7 -7
- package/.docs/raw/server-db/production-server.mdx +4 -4
- package/.docs/raw/server-db/{runtime-context.mdx → request-context.mdx} +46 -45
- package/.docs/raw/server-db/storage.mdx +29 -21
- package/.docs/raw/streaming/events.mdx +3 -3
- package/.docs/raw/streaming/overview.mdx +5 -5
- package/.docs/raw/streaming/tool-streaming.mdx +18 -17
- package/.docs/raw/streaming/workflow-streaming.mdx +1 -1
- package/.docs/raw/tools-mcp/advanced-usage.mdx +5 -4
- package/.docs/raw/tools-mcp/mcp-overview.mdx +33 -20
- package/.docs/raw/tools-mcp/overview.mdx +11 -11
- package/.docs/raw/voice/overview.mdx +63 -43
- package/.docs/raw/voice/speech-to-speech.mdx +5 -3
- package/.docs/raw/voice/speech-to-text.mdx +10 -9
- package/.docs/raw/voice/text-to-speech.mdx +13 -12
- package/.docs/raw/workflows/agents-and-tools.mdx +9 -5
- package/.docs/raw/workflows/control-flow.mdx +3 -3
- package/.docs/raw/workflows/error-handling.mdx +2 -21
- package/.docs/raw/workflows/human-in-the-loop.mdx +7 -4
- package/.docs/raw/workflows/inngest-workflow.mdx +3 -3
- package/.docs/raw/workflows/input-data-mapping.mdx +107 -0
- package/.docs/raw/workflows/overview.mdx +17 -16
- package/.docs/raw/workflows/snapshots.mdx +13 -11
- package/.docs/raw/workflows/suspend-and-resume.mdx +23 -15
- package/CHANGELOG.md +55 -53
- package/README.md +11 -2
- package/dist/{chunk-TUAHUTTB.js → chunk-5NJC7NRO.js} +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/prepare-docs/copy-raw.d.ts.map +1 -1
- package/dist/prepare-docs/prepare.js +1 -1
- package/dist/prompts/migration.d.ts +6 -0
- package/dist/prompts/migration.d.ts.map +1 -0
- package/dist/stdio.js +402 -30
- package/dist/tools/migration.d.ts +40 -0
- package/dist/tools/migration.d.ts.map +1 -0
- package/package.json +8 -12
- package/.docs/organized/changelogs/%40mastra%2Fcloud.md +0 -302
- package/.docs/raw/observability/nextjs-tracing.mdx +0 -109
- package/.docs/raw/observability/otel-tracing.mdx +0 -189
- package/.docs/raw/reference/agents/getScorers.mdx +0 -69
- package/.docs/raw/reference/agents/getTools.mdx +0 -69
- package/.docs/raw/reference/agents/getWorkflows.mdx +0 -69
- package/.docs/raw/reference/client-js/workflows-legacy.mdx +0 -143
- package/.docs/raw/reference/core/getAgents.mdx +0 -35
- package/.docs/raw/reference/core/getLogs.mdx +0 -96
- package/.docs/raw/reference/core/getLogsByRunId.mdx +0 -87
- package/.docs/raw/reference/core/getMCPServers.mdx +0 -36
- package/.docs/raw/reference/core/getMemory.mdx +0 -36
- package/.docs/raw/reference/core/getScorerByName.mdx +0 -78
- package/.docs/raw/reference/core/getScorers.mdx +0 -43
- package/.docs/raw/reference/core/getVectors.mdx +0 -36
- package/.docs/raw/reference/core/getWorkflows.mdx +0 -45
- package/.docs/raw/reference/evals/context-position.mdx +0 -197
- package/.docs/raw/reference/evals/context-relevancy.mdx +0 -196
- package/.docs/raw/reference/evals/contextual-recall.mdx +0 -196
- package/.docs/raw/reference/evals/summarization.mdx +0 -212
- package/.docs/raw/reference/legacyWorkflows/after.mdx +0 -89
- package/.docs/raw/reference/legacyWorkflows/afterEvent.mdx +0 -79
- package/.docs/raw/reference/legacyWorkflows/commit.mdx +0 -33
- package/.docs/raw/reference/legacyWorkflows/createRun.mdx +0 -76
- package/.docs/raw/reference/legacyWorkflows/else.mdx +0 -68
- package/.docs/raw/reference/legacyWorkflows/events.mdx +0 -305
- package/.docs/raw/reference/legacyWorkflows/execute.mdx +0 -110
- package/.docs/raw/reference/legacyWorkflows/if.mdx +0 -108
- package/.docs/raw/reference/legacyWorkflows/resume.mdx +0 -158
- package/.docs/raw/reference/legacyWorkflows/resumeWithEvent.mdx +0 -133
- package/.docs/raw/reference/legacyWorkflows/snapshots.mdx +0 -207
- package/.docs/raw/reference/legacyWorkflows/start.mdx +0 -87
- package/.docs/raw/reference/legacyWorkflows/step-class.mdx +0 -100
- package/.docs/raw/reference/legacyWorkflows/step-condition.mdx +0 -137
- package/.docs/raw/reference/legacyWorkflows/step-function.mdx +0 -93
- package/.docs/raw/reference/legacyWorkflows/step-options.mdx +0 -69
- package/.docs/raw/reference/legacyWorkflows/step-retries.mdx +0 -196
- package/.docs/raw/reference/legacyWorkflows/suspend.mdx +0 -70
- package/.docs/raw/reference/legacyWorkflows/then.mdx +0 -72
- package/.docs/raw/reference/legacyWorkflows/until.mdx +0 -168
- package/.docs/raw/reference/legacyWorkflows/watch.mdx +0 -124
- package/.docs/raw/reference/legacyWorkflows/while.mdx +0 -168
- package/.docs/raw/reference/legacyWorkflows/workflow.mdx +0 -234
- package/.docs/raw/reference/memory/getThreadsByResourceId.mdx +0 -79
- package/.docs/raw/reference/memory/getThreadsByResourceIdPaginated.mdx +0 -110
- package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx +0 -185
- package/.docs/raw/reference/observability/ai-tracing/configuration.mdx +0 -238
- package/.docs/raw/reference/observability/otel-tracing/otel-config.mdx +0 -117
- package/.docs/raw/reference/observability/otel-tracing/providers/arize-ax.mdx +0 -81
- package/.docs/raw/reference/observability/otel-tracing/providers/arize-phoenix.mdx +0 -121
- package/.docs/raw/reference/observability/otel-tracing/providers/braintrust.mdx +0 -40
- package/.docs/raw/reference/observability/otel-tracing/providers/dash0.mdx +0 -40
- package/.docs/raw/reference/observability/otel-tracing/providers/index.mdx +0 -20
- package/.docs/raw/reference/observability/otel-tracing/providers/keywordsai.mdx +0 -73
- package/.docs/raw/reference/observability/otel-tracing/providers/laminar.mdx +0 -41
- package/.docs/raw/reference/observability/otel-tracing/providers/langfuse.mdx +0 -84
- package/.docs/raw/reference/observability/otel-tracing/providers/langsmith.mdx +0 -48
- package/.docs/raw/reference/observability/otel-tracing/providers/langwatch.mdx +0 -43
- package/.docs/raw/reference/observability/otel-tracing/providers/new-relic.mdx +0 -40
- package/.docs/raw/reference/observability/otel-tracing/providers/signoz.mdx +0 -40
- package/.docs/raw/reference/observability/otel-tracing/providers/traceloop.mdx +0 -40
- package/.docs/raw/reference/scorers/answer-relevancy.mdx +0 -227
- package/.docs/raw/reference/scorers/bias.mdx +0 -228
- package/.docs/raw/reference/scorers/completeness.mdx +0 -214
- package/.docs/raw/reference/scorers/content-similarity.mdx +0 -197
- package/.docs/raw/reference/scorers/context-precision.mdx +0 -352
- package/.docs/raw/reference/scorers/faithfulness.mdx +0 -241
- package/.docs/raw/reference/scorers/hallucination.mdx +0 -252
- package/.docs/raw/reference/scorers/keyword-coverage.mdx +0 -229
- package/.docs/raw/reference/scorers/prompt-alignment.mdx +0 -668
- package/.docs/raw/reference/scorers/textual-difference.mdx +0 -203
- package/.docs/raw/reference/scorers/tone-consistency.mdx +0 -211
- package/.docs/raw/reference/scorers/toxicity.mdx +0 -228
- package/.docs/raw/reference/workflows/run-methods/watch.mdx +0 -73
- package/.docs/raw/scorers/evals-old-api/custom-eval.mdx +0 -24
- package/.docs/raw/scorers/evals-old-api/overview.mdx +0 -106
- package/.docs/raw/scorers/evals-old-api/running-in-ci.mdx +0 -85
- package/.docs/raw/scorers/evals-old-api/textual-evals.mdx +0 -58
- package/.docs/raw/scorers/off-the-shelf-scorers.mdx +0 -50
- package/.docs/raw/workflows-legacy/control-flow.mdx +0 -774
- package/.docs/raw/workflows-legacy/dynamic-workflows.mdx +0 -239
- package/.docs/raw/workflows-legacy/error-handling.mdx +0 -187
- package/.docs/raw/workflows-legacy/nested-workflows.mdx +0 -360
- package/.docs/raw/workflows-legacy/overview.mdx +0 -182
- package/.docs/raw/workflows-legacy/runtime-variables.mdx +0 -156
- package/.docs/raw/workflows-legacy/steps.mdx +0 -115
- package/.docs/raw/workflows-legacy/suspend-and-resume.mdx +0 -406
- package/.docs/raw/workflows-legacy/variables.mdx +0 -318
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Agent.getScorers() | Agents | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Agent.getScorers()` method in Mastra agents, which retrieves the scoring configuration."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Agent.getScorers()
|
|
7
|
-
|
|
8
|
-
The `.getScorers()` method retrieves the scoring configuration configured for an agent, resolving it if it's a function. This method provides access to the scoring system used for evaluating agent responses and performance.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
await agent.getScorers();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
<PropertiesTable
|
|
19
|
-
content={[
|
|
20
|
-
{
|
|
21
|
-
name: "options",
|
|
22
|
-
type: "{ runtimeContext?: RuntimeContext }",
|
|
23
|
-
isOptional: true,
|
|
24
|
-
defaultValue: "{}",
|
|
25
|
-
description: "Optional configuration object containing runtime context.",
|
|
26
|
-
},
|
|
27
|
-
]}
|
|
28
|
-
/>
|
|
29
|
-
|
|
30
|
-
## Returns
|
|
31
|
-
|
|
32
|
-
<PropertiesTable
|
|
33
|
-
content={[
|
|
34
|
-
{
|
|
35
|
-
name: "scorers",
|
|
36
|
-
type: "MastraScorers | Promise<MastraScorers>",
|
|
37
|
-
description:
|
|
38
|
-
"The scoring configuration configured for the agent, either as a direct object or a promise that resolves to the scorers.",
|
|
39
|
-
},
|
|
40
|
-
]}
|
|
41
|
-
/>
|
|
42
|
-
|
|
43
|
-
## Extended usage example
|
|
44
|
-
|
|
45
|
-
```typescript copy
|
|
46
|
-
await agent.getScorers({
|
|
47
|
-
runtimeContext: new RuntimeContext(),
|
|
48
|
-
});
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Options parameters
|
|
52
|
-
|
|
53
|
-
<PropertiesTable
|
|
54
|
-
content={[
|
|
55
|
-
{
|
|
56
|
-
name: "runtimeContext",
|
|
57
|
-
type: "RuntimeContext",
|
|
58
|
-
isOptional: true,
|
|
59
|
-
defaultValue: "new RuntimeContext()",
|
|
60
|
-
description:
|
|
61
|
-
"Runtime context for dependency injection and contextual information.",
|
|
62
|
-
},
|
|
63
|
-
]}
|
|
64
|
-
/>
|
|
65
|
-
|
|
66
|
-
## Related
|
|
67
|
-
|
|
68
|
-
- [Agents overview](/docs/agents/overview)
|
|
69
|
-
- [Runtime Context](/docs/server-db/runtime-context)
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Agent.getTools() | Agents | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Agent.getTools()` method in Mastra agents, which retrieves the tools that the agent can use."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Agent.getTools()
|
|
7
|
-
|
|
8
|
-
The `.getTools()` method retrieves the tools configured for an agent, resolving them if they're a function. These tools extend the agent's capabilities, allowing it to perform specific actions or access external systems.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
await agent.getTools();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
<PropertiesTable
|
|
19
|
-
content={[
|
|
20
|
-
{
|
|
21
|
-
name: "options",
|
|
22
|
-
type: "{ runtimeContext?: RuntimeContext }",
|
|
23
|
-
isOptional: true,
|
|
24
|
-
defaultValue: "{}",
|
|
25
|
-
description: "Optional configuration object containing runtime context.",
|
|
26
|
-
},
|
|
27
|
-
]}
|
|
28
|
-
/>
|
|
29
|
-
|
|
30
|
-
## Returns
|
|
31
|
-
|
|
32
|
-
<PropertiesTable
|
|
33
|
-
content={[
|
|
34
|
-
{
|
|
35
|
-
name: "tools",
|
|
36
|
-
type: "TTools | Promise<TTools>",
|
|
37
|
-
description:
|
|
38
|
-
"The tools configured for the agent, either as a direct object or a promise that resolves to the tools.",
|
|
39
|
-
},
|
|
40
|
-
]}
|
|
41
|
-
/>
|
|
42
|
-
|
|
43
|
-
## Extended usage example
|
|
44
|
-
|
|
45
|
-
```typescript copy
|
|
46
|
-
await agent.getTools({
|
|
47
|
-
runtimeContext: new RuntimeContext(),
|
|
48
|
-
});
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Options parameters
|
|
52
|
-
|
|
53
|
-
<PropertiesTable
|
|
54
|
-
content={[
|
|
55
|
-
{
|
|
56
|
-
name: "runtimeContext",
|
|
57
|
-
type: "RuntimeContext",
|
|
58
|
-
isOptional: true,
|
|
59
|
-
defaultValue: "new RuntimeContext()",
|
|
60
|
-
description:
|
|
61
|
-
"Runtime context for dependency injection and contextual information.",
|
|
62
|
-
},
|
|
63
|
-
]}
|
|
64
|
-
/>
|
|
65
|
-
|
|
66
|
-
## Related
|
|
67
|
-
|
|
68
|
-
- [Using tools with agents](/docs/agents/using-tools)
|
|
69
|
-
- [Creating tools](/docs/tools-mcp/overview)
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Agent.getWorkflows() | Agents | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Agent.getWorkflows()` method in Mastra agents, which retrieves the workflows that the agent can execute."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Agent.getWorkflows()
|
|
7
|
-
|
|
8
|
-
The `.getWorkflows()` method retrieves the workflows configured for an agent, resolving them if they're a function. These workflows enable the agent to execute complex, multi-step processes with defined execution paths.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
await agent.getWorkflows();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
<PropertiesTable
|
|
19
|
-
content={[
|
|
20
|
-
{
|
|
21
|
-
name: "options",
|
|
22
|
-
type: "{ runtimeContext?: RuntimeContext }",
|
|
23
|
-
isOptional: true,
|
|
24
|
-
defaultValue: "{}",
|
|
25
|
-
description: "Optional configuration object containing runtime context.",
|
|
26
|
-
},
|
|
27
|
-
]}
|
|
28
|
-
/>
|
|
29
|
-
|
|
30
|
-
## Returns
|
|
31
|
-
|
|
32
|
-
<PropertiesTable
|
|
33
|
-
content={[
|
|
34
|
-
{
|
|
35
|
-
name: "workflows",
|
|
36
|
-
type: "Promise<Record<string, Workflow>>",
|
|
37
|
-
description:
|
|
38
|
-
"A promise that resolves to a record of workflow names to their corresponding Workflow instances.",
|
|
39
|
-
},
|
|
40
|
-
]}
|
|
41
|
-
/>
|
|
42
|
-
|
|
43
|
-
## Extended usage example
|
|
44
|
-
|
|
45
|
-
```typescript copy
|
|
46
|
-
await agent.getWorkflows({
|
|
47
|
-
runtimeContext: new RuntimeContext(),
|
|
48
|
-
});
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Options parameters
|
|
52
|
-
|
|
53
|
-
<PropertiesTable
|
|
54
|
-
content={[
|
|
55
|
-
{
|
|
56
|
-
name: "runtimeContext",
|
|
57
|
-
type: "RuntimeContext",
|
|
58
|
-
isOptional: true,
|
|
59
|
-
defaultValue: "new RuntimeContext()",
|
|
60
|
-
description:
|
|
61
|
-
"Runtime context for dependency injection and contextual information.",
|
|
62
|
-
},
|
|
63
|
-
]}
|
|
64
|
-
/>
|
|
65
|
-
|
|
66
|
-
## Related
|
|
67
|
-
|
|
68
|
-
- [Agents overview](/docs/agents/overview)
|
|
69
|
-
- [Workflows overview](/docs/workflows/overview)
|
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Workflows (Legacy) API | Client SDK | Mastra Docs"
|
|
3
|
-
description: Learn how to interact with and execute automated legacy workflows in Mastra using the client-js SDK.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Workflows (Legacy) API
|
|
7
|
-
|
|
8
|
-
The Workflows (Legacy) API provides methods to interact with and execute automated legacy workflows in Mastra.
|
|
9
|
-
|
|
10
|
-
## Getting All Legacy Workflows
|
|
11
|
-
|
|
12
|
-
Retrieve a list of all available legacy workflows:
|
|
13
|
-
|
|
14
|
-
```typescript
|
|
15
|
-
const workflows = await mastraClient.getLegacyWorkflows();
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
## Working with a Specific Legacy Workflow
|
|
19
|
-
|
|
20
|
-
Get an instance of a specific legacy workflow:
|
|
21
|
-
|
|
22
|
-
```typescript
|
|
23
|
-
const workflow = mastraClient.getLegacyWorkflow("workflow-id");
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Legacy Workflow Methods
|
|
27
|
-
|
|
28
|
-
### Get Legacy Workflow Details
|
|
29
|
-
|
|
30
|
-
Retrieve detailed information about a legacy workflow:
|
|
31
|
-
|
|
32
|
-
```typescript
|
|
33
|
-
const details = await workflow.details();
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### Start Legacy Workflow run asynchronously
|
|
37
|
-
|
|
38
|
-
Start a legacy workflow run with triggerData and await full run results:
|
|
39
|
-
|
|
40
|
-
```typescript
|
|
41
|
-
const { runId } = workflow.createRun();
|
|
42
|
-
|
|
43
|
-
const result = await workflow.startAsync({
|
|
44
|
-
runId,
|
|
45
|
-
triggerData: {
|
|
46
|
-
param1: "value1",
|
|
47
|
-
param2: "value2",
|
|
48
|
-
},
|
|
49
|
-
});
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### Resume Legacy Workflow run asynchronously
|
|
53
|
-
|
|
54
|
-
Resume a suspended legacy workflow step and await full run result:
|
|
55
|
-
|
|
56
|
-
```typescript
|
|
57
|
-
const { runId } = createRun({ runId: prevRunId });
|
|
58
|
-
|
|
59
|
-
const result = await workflow.resumeAsync({
|
|
60
|
-
runId,
|
|
61
|
-
stepId: "step-id",
|
|
62
|
-
contextData: { key: "value" },
|
|
63
|
-
});
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
### Watch Legacy Workflow
|
|
67
|
-
|
|
68
|
-
Watch legacy workflow transitions
|
|
69
|
-
|
|
70
|
-
```typescript
|
|
71
|
-
try {
|
|
72
|
-
// Get workflow instance
|
|
73
|
-
const workflow = mastraClient.getLegacyWorkflow("workflow-id");
|
|
74
|
-
|
|
75
|
-
// Create a workflow run
|
|
76
|
-
const { runId } = workflow.createRun();
|
|
77
|
-
|
|
78
|
-
// Watch workflow run
|
|
79
|
-
workflow.watch({ runId }, (record) => {
|
|
80
|
-
// Every new record is the latest transition state of the workflow run
|
|
81
|
-
|
|
82
|
-
console.log({
|
|
83
|
-
activePaths: record.activePaths,
|
|
84
|
-
results: record.results,
|
|
85
|
-
timestamp: record.timestamp,
|
|
86
|
-
runId: record.runId,
|
|
87
|
-
});
|
|
88
|
-
});
|
|
89
|
-
|
|
90
|
-
// Start workflow run
|
|
91
|
-
workflow.start({
|
|
92
|
-
runId,
|
|
93
|
-
triggerData: {
|
|
94
|
-
city: "New York",
|
|
95
|
-
},
|
|
96
|
-
});
|
|
97
|
-
} catch (e) {
|
|
98
|
-
console.error(e);
|
|
99
|
-
}
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### Resume Legacy Workflow
|
|
103
|
-
|
|
104
|
-
Resume legacy workflow run and watch legacy workflow step transitions
|
|
105
|
-
|
|
106
|
-
```typescript
|
|
107
|
-
try {
|
|
108
|
-
//To resume a workflow run, when a step is suspended
|
|
109
|
-
const { run } = createRun({ runId: prevRunId });
|
|
110
|
-
|
|
111
|
-
//Watch run
|
|
112
|
-
workflow.watch({ runId }, (record) => {
|
|
113
|
-
// Every new record is the latest transition state of the workflow run
|
|
114
|
-
|
|
115
|
-
console.log({
|
|
116
|
-
activePaths: record.activePaths,
|
|
117
|
-
results: record.results,
|
|
118
|
-
timestamp: record.timestamp,
|
|
119
|
-
runId: record.runId,
|
|
120
|
-
});
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
//resume run
|
|
124
|
-
workflow.resume({
|
|
125
|
-
runId,
|
|
126
|
-
stepId: "step-id",
|
|
127
|
-
contextData: { key: "value" },
|
|
128
|
-
});
|
|
129
|
-
} catch (e) {
|
|
130
|
-
console.error(e);
|
|
131
|
-
}
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
### Legacy Workflow run result
|
|
135
|
-
|
|
136
|
-
A legacy workflow run result yields the following:
|
|
137
|
-
|
|
138
|
-
| Field | Type | Description |
|
|
139
|
-
| ------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
|
|
140
|
-
| `activePaths` | `Record<string, { status: string; suspendPayload?: any; stepPath: string[] }>` | Currently active paths in the workflow with their execution status |
|
|
141
|
-
| `results` | `LegacyWorkflowRunResult<any, any, any>['results']` | Results from the workflow execution |
|
|
142
|
-
| `timestamp` | `number` | Unix timestamp of when this transition occurred |
|
|
143
|
-
| `runId` | `string` | Unique identifier for this workflow run instance |
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Mastra.getAgents() | Core | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Mastra.getAgents()` method in Mastra, which retrieves all configured agents."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Mastra.getAgents()
|
|
7
|
-
|
|
8
|
-
The `.getAgents()` method is used to retrieve all agents that have been configured in the Mastra instance.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
mastra.getAgents();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
This method does not accept any parameters.
|
|
19
|
-
|
|
20
|
-
## Returns
|
|
21
|
-
|
|
22
|
-
<PropertiesTable
|
|
23
|
-
content={[
|
|
24
|
-
{
|
|
25
|
-
name: "agents",
|
|
26
|
-
type: "TAgents",
|
|
27
|
-
description:
|
|
28
|
-
"A record of all configured agents, where keys are agent names and values are agent instances.",
|
|
29
|
-
},
|
|
30
|
-
]}
|
|
31
|
-
/>
|
|
32
|
-
|
|
33
|
-
## Related
|
|
34
|
-
|
|
35
|
-
- [Agents overview](/docs/agents/overview)
|
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Mastra.getLogs() | Core | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Mastra.getLogs()` method in Mastra, which retrieves all logs for a specific transport ID."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Mastra.getLogs()
|
|
7
|
-
|
|
8
|
-
The `.getLogs()` method is used to retrieve all logs for a specific transport ID. This method requires a configured logger that supports the `getLogs` operation.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
mastra.getLogs("456");
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
<PropertiesTable
|
|
19
|
-
content={[
|
|
20
|
-
{
|
|
21
|
-
name: "transportId",
|
|
22
|
-
type: "string",
|
|
23
|
-
description: "The transport ID to retrieve logs from.",
|
|
24
|
-
},
|
|
25
|
-
{
|
|
26
|
-
name: "options",
|
|
27
|
-
type: "object",
|
|
28
|
-
description:
|
|
29
|
-
"Optional parameters for filtering and pagination. See Options section below for details.",
|
|
30
|
-
optional: true,
|
|
31
|
-
},
|
|
32
|
-
]}
|
|
33
|
-
/>
|
|
34
|
-
|
|
35
|
-
### Options
|
|
36
|
-
|
|
37
|
-
<PropertiesTable
|
|
38
|
-
content={[
|
|
39
|
-
{
|
|
40
|
-
name: "fromDate",
|
|
41
|
-
type: "Date",
|
|
42
|
-
description:
|
|
43
|
-
"Optional start date for filtering logs. e.g., new Date('2024-01-01').",
|
|
44
|
-
optional: true,
|
|
45
|
-
},
|
|
46
|
-
{
|
|
47
|
-
name: "toDate",
|
|
48
|
-
type: "Date",
|
|
49
|
-
description:
|
|
50
|
-
"Optional end date for filtering logs. e.g., new Date('2024-01-31').",
|
|
51
|
-
optional: true,
|
|
52
|
-
},
|
|
53
|
-
{
|
|
54
|
-
name: "logLevel",
|
|
55
|
-
type: "LogLevel",
|
|
56
|
-
description: "Optional log level to filter by.",
|
|
57
|
-
optional: true,
|
|
58
|
-
},
|
|
59
|
-
{
|
|
60
|
-
name: "filters",
|
|
61
|
-
type: "Record<string, any>",
|
|
62
|
-
description: "Optional additional filters to apply to the log query.",
|
|
63
|
-
optional: true,
|
|
64
|
-
},
|
|
65
|
-
{
|
|
66
|
-
name: "page",
|
|
67
|
-
type: "number",
|
|
68
|
-
description: "Optional page number for pagination.",
|
|
69
|
-
optional: true,
|
|
70
|
-
},
|
|
71
|
-
{
|
|
72
|
-
name: "perPage",
|
|
73
|
-
type: "number",
|
|
74
|
-
description: "Optional number of logs per page for pagination.",
|
|
75
|
-
optional: true,
|
|
76
|
-
},
|
|
77
|
-
]}
|
|
78
|
-
/>
|
|
79
|
-
|
|
80
|
-
## Returns
|
|
81
|
-
|
|
82
|
-
<PropertiesTable
|
|
83
|
-
content={[
|
|
84
|
-
{
|
|
85
|
-
name: "logs",
|
|
86
|
-
type: "Promise<any>",
|
|
87
|
-
description:
|
|
88
|
-
"A promise that resolves to the logs for the specified transport ID.",
|
|
89
|
-
},
|
|
90
|
-
]}
|
|
91
|
-
/>
|
|
92
|
-
|
|
93
|
-
## Related
|
|
94
|
-
|
|
95
|
-
- [Logging overview](/docs/observability/logging)
|
|
96
|
-
- [Logger reference](/reference/observability/logging/pino-logger)
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Mastra.getLogsByRunId() | Core | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Mastra.getLogsByRunId()` method in Mastra, which retrieves logs for a specific run ID and transport ID."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Mastra.getLogsByRunId()
|
|
7
|
-
|
|
8
|
-
The `.getLogsByRunId()` method is used to retrieve logs for a specific run ID and transport ID. This method requires a configured logger that supports the `getLogsByRunId` operation.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
mastra.getLogsByRunId({ runId: "123", transportId: "456" });
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
<PropertiesTable
|
|
19
|
-
content={[
|
|
20
|
-
{
|
|
21
|
-
name: "runId",
|
|
22
|
-
type: "string",
|
|
23
|
-
description: "The run ID to retrieve logs for.",
|
|
24
|
-
},
|
|
25
|
-
{
|
|
26
|
-
name: "transportId",
|
|
27
|
-
type: "string",
|
|
28
|
-
description: "The transport ID to retrieve logs from.",
|
|
29
|
-
},
|
|
30
|
-
{
|
|
31
|
-
name: "fromDate",
|
|
32
|
-
type: "Date",
|
|
33
|
-
description:
|
|
34
|
-
"Optional start date for filtering logs. e.g., new Date('2024-01-01').",
|
|
35
|
-
optional: true,
|
|
36
|
-
},
|
|
37
|
-
{
|
|
38
|
-
name: "toDate",
|
|
39
|
-
type: "Date",
|
|
40
|
-
description:
|
|
41
|
-
"Optional end date for filtering logs. e.g., new Date('2024-01-31').",
|
|
42
|
-
optional: true,
|
|
43
|
-
},
|
|
44
|
-
{
|
|
45
|
-
name: "logLevel",
|
|
46
|
-
type: "LogLevel",
|
|
47
|
-
description: "Optional log level to filter by.",
|
|
48
|
-
optional: true,
|
|
49
|
-
},
|
|
50
|
-
{
|
|
51
|
-
name: "filters",
|
|
52
|
-
type: "Record<string, any>",
|
|
53
|
-
description: "Optional additional filters to apply to the log query.",
|
|
54
|
-
optional: true,
|
|
55
|
-
},
|
|
56
|
-
{
|
|
57
|
-
name: "page",
|
|
58
|
-
type: "number",
|
|
59
|
-
description: "Optional page number for pagination.",
|
|
60
|
-
optional: true,
|
|
61
|
-
},
|
|
62
|
-
{
|
|
63
|
-
name: "perPage",
|
|
64
|
-
type: "number",
|
|
65
|
-
description: "Optional number of logs per page for pagination.",
|
|
66
|
-
optional: true,
|
|
67
|
-
},
|
|
68
|
-
]}
|
|
69
|
-
/>
|
|
70
|
-
|
|
71
|
-
## Returns
|
|
72
|
-
|
|
73
|
-
<PropertiesTable
|
|
74
|
-
content={[
|
|
75
|
-
{
|
|
76
|
-
name: "logs",
|
|
77
|
-
type: "Promise<any>",
|
|
78
|
-
description:
|
|
79
|
-
"A promise that resolves to the logs for the specified run ID and transport ID.",
|
|
80
|
-
},
|
|
81
|
-
]}
|
|
82
|
-
/>
|
|
83
|
-
|
|
84
|
-
## Related
|
|
85
|
-
|
|
86
|
-
- [Logging overview](/docs/observability/logging)
|
|
87
|
-
- [Logger reference](/reference/observability/logging/pino-logger)
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Mastra.getMCPServers() | Core | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Mastra.getMCPServers()` method in Mastra, which retrieves all registered MCP server instances."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Mastra.getMCPServers()
|
|
7
|
-
|
|
8
|
-
The `.getMCPServers()` method is used to retrieve all MCP server instances that have been registered in the Mastra instance.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
mastra.getMCPServers();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
This method does not accept any parameters.
|
|
19
|
-
|
|
20
|
-
## Returns
|
|
21
|
-
|
|
22
|
-
<PropertiesTable
|
|
23
|
-
content={[
|
|
24
|
-
{
|
|
25
|
-
name: "servers",
|
|
26
|
-
type: "Record<string, MCPServerBase> | undefined",
|
|
27
|
-
description:
|
|
28
|
-
"A record of all registered MCP server instances, where keys are server IDs and values are MCPServerBase instances, or undefined if no servers are registered.",
|
|
29
|
-
},
|
|
30
|
-
]}
|
|
31
|
-
/>
|
|
32
|
-
|
|
33
|
-
## Related
|
|
34
|
-
|
|
35
|
-
- [MCP overview](/docs/tools-mcp/mcp-overview)
|
|
36
|
-
- [MCP server reference](/reference/tools/mcp-server)
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Reference: Mastra.getMemory() | Core | Mastra Docs"
|
|
3
|
-
description: "Documentation for the `Mastra.getMemory()` method in Mastra, which retrieves the configured memory instance."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Mastra.getMemory()
|
|
7
|
-
|
|
8
|
-
The `.getMemory()` method is used to retrieve the memory instance that has been configured in the Mastra instance.
|
|
9
|
-
|
|
10
|
-
## Usage example
|
|
11
|
-
|
|
12
|
-
```typescript copy
|
|
13
|
-
mastra.getMemory();
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
|
|
18
|
-
This method does not accept any parameters.
|
|
19
|
-
|
|
20
|
-
## Returns
|
|
21
|
-
|
|
22
|
-
<PropertiesTable
|
|
23
|
-
content={[
|
|
24
|
-
{
|
|
25
|
-
name: "memory",
|
|
26
|
-
type: "MastraMemory | undefined",
|
|
27
|
-
description:
|
|
28
|
-
"The configured memory instance, or undefined if no memory has been configured.",
|
|
29
|
-
},
|
|
30
|
-
]}
|
|
31
|
-
/>
|
|
32
|
-
|
|
33
|
-
## Related
|
|
34
|
-
|
|
35
|
-
- [Memory overview](/docs/memory/overview)
|
|
36
|
-
- [Memory reference](/reference/memory/memory-class)
|