@mastra/mcp-docs-server 1.0.0-beta.11 → 1.0.0-beta.14
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/%40mastra%2Fagent-builder.md +29 -29
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +51 -51
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +180 -180
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Fconvex.md +68 -0
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +331 -331
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +31 -31
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +41 -41
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Flance.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +24 -24
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +24 -24
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +96 -96
- package/.docs/organized/changelogs/%40mastra%2Frag.md +17 -17
- package/.docs/organized/changelogs/%40mastra%2Freact.md +49 -2
- package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +122 -122
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +39 -39
- package/.docs/organized/changelogs/create-mastra.md +31 -31
- package/.docs/organized/changelogs/mastra.md +51 -51
- package/.docs/organized/code-examples/agent-v6.md +151 -0
- package/.docs/organized/code-examples/ai-elements.md +1 -1
- package/.docs/organized/code-examples/quick-start.md +0 -4
- package/.docs/organized/code-examples/stock-price-tool.md +21 -2
- package/.docs/raw/agents/adding-voice.mdx +2 -3
- package/.docs/raw/agents/agent-approval.mdx +139 -6
- package/.docs/raw/agents/agent-memory.mdx +24 -32
- package/.docs/raw/agents/guardrails.mdx +61 -51
- package/.docs/raw/agents/networks.mdx +9 -13
- package/.docs/raw/agents/overview.mdx +40 -24
- package/.docs/raw/agents/processors.mdx +20 -19
- package/.docs/raw/agents/structured-output.mdx +11 -7
- package/.docs/raw/agents/using-tools.mdx +5 -6
- package/.docs/raw/course/01-first-agent/07-creating-your-agent.md +1 -2
- package/.docs/raw/course/01-first-agent/12-connecting-tool-to-agent.md +1 -1
- package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +1 -2
- package/.docs/raw/course/02-agent-tools-mcp/05-updating-your-agent.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md +2 -2
- package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -2
- package/.docs/raw/course/03-agent-memory/08-configuring-conversation-history.md +1 -2
- package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +3 -4
- package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +2 -3
- package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +2 -3
- package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +1 -2
- package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +2 -3
- package/.docs/raw/course/04-workflows/11-creating-an-ai-agent.md +2 -3
- package/.docs/raw/deployment/cloud-providers.mdx +20 -0
- package/.docs/raw/deployment/{building-mastra.mdx → mastra-server.mdx} +5 -5
- package/.docs/raw/deployment/monorepo.mdx +23 -44
- package/.docs/raw/deployment/overview.mdx +32 -50
- package/.docs/raw/deployment/web-framework.mdx +15 -19
- package/.docs/raw/evals/custom-scorers.mdx +9 -6
- package/.docs/raw/evals/overview.mdx +3 -6
- package/.docs/raw/evals/running-in-ci.mdx +2 -2
- package/.docs/raw/getting-started/manual-install.mdx +20 -20
- package/.docs/raw/getting-started/mcp-docs-server.mdx +2 -2
- package/.docs/raw/getting-started/start.mdx +10 -1
- package/.docs/raw/getting-started/studio.mdx +1 -1
- package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +4 -4
- package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +1033 -79
- package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
- package/.docs/raw/guides/build-your-ui/copilotkit.mdx +11 -11
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/amazon-ec2.mdx +9 -9
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/aws-lambda.mdx +13 -16
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/azure-app-services.mdx +5 -7
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/cloudflare-deployer.mdx +8 -5
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/digital-ocean.mdx +12 -15
- package/.docs/raw/guides/deployment/index.mdx +32 -0
- package/.docs/raw/guides/deployment/inngest.mdx +386 -0
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/netlify-deployer.mdx +7 -3
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/vercel-deployer.mdx +8 -5
- package/.docs/raw/guides/getting-started/astro.mdx +292 -451
- package/.docs/raw/guides/getting-started/express.mdx +72 -153
- package/.docs/raw/guides/getting-started/hono.mdx +227 -0
- package/.docs/raw/guides/getting-started/next-js.mdx +170 -61
- package/.docs/raw/guides/getting-started/quickstart.mdx +4 -4
- package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
- package/.docs/raw/guides/getting-started/vite-react.mdx +317 -147
- package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
- package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
- package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
- package/.docs/raw/guides/guide/research-assistant.mdx +17 -17
- package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
- package/.docs/raw/guides/guide/web-search.mdx +8 -8
- package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
- package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
- package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +1 -1
- package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +17 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +6 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +0 -2
- package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
- package/.docs/raw/index.mdx +2 -2
- package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/dashboard.mdx +2 -6
- package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/observability.mdx +1 -5
- package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/overview.mdx +2 -6
- package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/setting-up.mdx +8 -7
- package/.docs/raw/mcp/overview.mdx +31 -13
- package/.docs/raw/mcp/publishing-mcp-server.mdx +2 -2
- package/.docs/raw/memory/memory-processors.mdx +9 -9
- package/.docs/raw/memory/message-history.mdx +69 -0
- package/.docs/raw/memory/overview.mdx +34 -76
- package/.docs/raw/memory/semantic-recall.mdx +58 -49
- package/.docs/raw/memory/storage.mdx +188 -0
- package/.docs/raw/memory/working-memory.mdx +7 -7
- package/.docs/raw/observability/logging.mdx +10 -11
- package/.docs/raw/observability/overview.mdx +0 -1
- package/.docs/raw/observability/tracing/bridges/otel.mdx +2 -2
- package/.docs/raw/observability/tracing/exporters/cloud.mdx +1 -1
- package/.docs/raw/observability/tracing/exporters/default.mdx +3 -3
- package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -2
- package/.docs/raw/observability/tracing/overview.mdx +23 -25
- package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +3 -3
- package/.docs/raw/rag/chunking-and-embedding.mdx +18 -31
- package/.docs/raw/rag/graph-rag.mdx +220 -0
- package/.docs/raw/rag/overview.mdx +2 -3
- package/.docs/raw/rag/retrieval.mdx +34 -51
- package/.docs/raw/rag/vector-databases.mdx +29 -25
- package/.docs/raw/reference/agents/agent.mdx +3 -3
- package/.docs/raw/reference/agents/generate.mdx +1 -1
- package/.docs/raw/reference/agents/generateLegacy.mdx +2 -2
- package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +3 -3
- package/.docs/raw/reference/agents/getDefaultOptions.mdx +3 -3
- package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +3 -3
- package/.docs/raw/reference/agents/getDescription.mdx +1 -1
- package/.docs/raw/reference/agents/getInstructions.mdx +3 -3
- package/.docs/raw/reference/agents/getLLM.mdx +3 -3
- package/.docs/raw/reference/agents/getMemory.mdx +3 -3
- package/.docs/raw/reference/agents/getModel.mdx +3 -3
- package/.docs/raw/reference/agents/getTools.mdx +2 -2
- package/.docs/raw/reference/agents/getVoice.mdx +2 -2
- package/.docs/raw/reference/agents/listAgents.mdx +2 -2
- package/.docs/raw/reference/agents/listScorers.mdx +3 -3
- package/.docs/raw/reference/agents/listTools.mdx +2 -2
- package/.docs/raw/reference/agents/listWorkflows.mdx +2 -2
- package/.docs/raw/reference/agents/network.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/chat-route.mdx +3 -3
- package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +2 -2
- package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +2 -2
- package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +2 -2
- package/.docs/raw/reference/ai-sdk/network-route.mdx +3 -3
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +6 -6
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +127 -0
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +107 -0
- package/.docs/raw/reference/ai-sdk/with-mastra.mdx +1 -1
- package/.docs/raw/reference/ai-sdk/workflow-route.mdx +3 -3
- package/.docs/raw/reference/auth/auth0.mdx +2 -3
- package/.docs/raw/reference/auth/clerk.mdx +2 -3
- package/.docs/raw/reference/auth/firebase.mdx +3 -5
- package/.docs/raw/reference/auth/jwt.mdx +2 -3
- package/.docs/raw/reference/auth/supabase.mdx +2 -3
- package/.docs/raw/reference/auth/workos.mdx +2 -3
- package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
- package/.docs/raw/reference/cli/mastra.mdx +10 -10
- package/.docs/raw/reference/client-js/agents.mdx +1 -2
- package/.docs/raw/reference/client-js/mastra-client.mdx +2 -2
- package/.docs/raw/reference/client-js/workflows.mdx +20 -0
- 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 +1 -1
- package/.docs/raw/reference/core/getLogger.mdx +1 -1
- package/.docs/raw/reference/core/getMCPServer.mdx +1 -1
- package/.docs/raw/reference/core/getMCPServerById.mdx +1 -1
- package/.docs/raw/reference/core/getMemory.mdx +2 -2
- package/.docs/raw/reference/core/getServer.mdx +3 -3
- package/.docs/raw/reference/core/getStorage.mdx +2 -2
- package/.docs/raw/reference/core/getStoredAgentById.mdx +3 -3
- package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
- package/.docs/raw/reference/core/getVector.mdx +1 -1
- 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 +1 -1
- package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
- package/.docs/raw/reference/core/listMCPServers.mdx +1 -1
- package/.docs/raw/reference/core/listMemory.mdx +2 -2
- package/.docs/raw/reference/core/listStoredAgents.mdx +4 -4
- package/.docs/raw/reference/core/listVectors.mdx +1 -1
- package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
- package/.docs/raw/reference/core/setLogger.mdx +1 -1
- package/.docs/raw/reference/core/setStorage.mdx +2 -2
- package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
- package/.docs/raw/reference/deployer/cloudflare.mdx +1 -2
- package/.docs/raw/reference/deployer/deployer.mdx +0 -1
- package/.docs/raw/reference/deployer/netlify.mdx +1 -1
- package/.docs/raw/reference/deployer/vercel.mdx +2 -4
- package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
- package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
- package/.docs/raw/reference/evals/bias.mdx +1 -1
- package/.docs/raw/reference/evals/completeness.mdx +1 -1
- package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
- package/.docs/raw/reference/evals/context-precision.mdx +1 -1
- package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
- package/.docs/raw/reference/evals/hallucination.mdx +1 -1
- package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
- package/.docs/raw/reference/evals/prompt-alignment.mdx +7 -7
- package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
- package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
- package/.docs/raw/reference/evals/tool-call-accuracy.mdx +10 -10
- package/.docs/raw/reference/evals/toxicity.mdx +1 -1
- package/.docs/raw/reference/logging/pino-logger.mdx +7 -8
- package/.docs/raw/reference/memory/createThread.mdx +2 -2
- package/.docs/raw/reference/memory/deleteMessages.mdx +2 -2
- package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +2 -2
- package/.docs/raw/reference/memory/memory-class.mdx +3 -3
- package/.docs/raw/reference/memory/query.mdx +2 -2
- package/.docs/raw/reference/memory/recall.mdx +2 -2
- package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
- package/.docs/raw/reference/processors/batch-parts-processor.mdx +2 -2
- package/.docs/raw/reference/processors/language-detector.mdx +2 -2
- package/.docs/raw/reference/processors/message-history-processor.mdx +2 -2
- package/.docs/raw/reference/processors/moderation-processor.mdx +3 -3
- package/.docs/raw/reference/processors/pii-detector.mdx +3 -3
- package/.docs/raw/reference/processors/processor-interface.mdx +13 -13
- package/.docs/raw/reference/processors/prompt-injection-detector.mdx +2 -2
- package/.docs/raw/reference/processors/semantic-recall-processor.mdx +2 -2
- package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +2 -2
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +2 -2
- package/.docs/raw/reference/processors/tool-call-filter.mdx +3 -3
- package/.docs/raw/reference/processors/unicode-normalizer.mdx +2 -2
- package/.docs/raw/reference/processors/working-memory-processor.mdx +3 -3
- package/.docs/raw/reference/rag/chunk.mdx +1 -1
- package/.docs/raw/reference/rag/database-config.mdx +1 -1
- package/.docs/raw/reference/rag/extract-params.mdx +2 -2
- package/.docs/raw/reference/rag/metadata-filters.mdx +7 -7
- package/.docs/raw/reference/server/create-route.mdx +14 -14
- package/.docs/raw/reference/server/express-adapter.mdx +10 -11
- package/.docs/raw/reference/server/hono-adapter.mdx +10 -11
- package/.docs/raw/reference/server/mastra-server.mdx +22 -22
- package/.docs/raw/reference/server/routes.mdx +28 -1
- package/.docs/raw/reference/storage/cloudflare-d1.mdx +3 -3
- package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
- package/.docs/raw/reference/storage/convex.mdx +6 -6
- package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
- package/.docs/raw/reference/storage/lance.mdx +3 -3
- package/.docs/raw/reference/storage/libsql.mdx +69 -54
- package/.docs/raw/reference/storage/mongodb.mdx +80 -7
- package/.docs/raw/reference/storage/mssql.mdx +4 -4
- package/.docs/raw/{server-db/storage.mdx → reference/storage/overview.mdx} +13 -111
- package/.docs/raw/reference/storage/postgresql.mdx +78 -7
- package/.docs/raw/reference/storage/upstash.mdx +74 -2
- package/.docs/raw/reference/streaming/agents/stream.mdx +27 -5
- package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +2 -2
- package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/stream.mdx +35 -22
- package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +4 -4
- package/.docs/raw/reference/templates/overview.mdx +1 -2
- package/.docs/raw/reference/tools/create-tool.mdx +24 -5
- package/.docs/raw/reference/tools/graph-rag-tool.mdx +3 -3
- package/.docs/raw/reference/tools/vector-query-tool.mdx +4 -4
- package/.docs/raw/reference/vectors/astra.mdx +3 -3
- package/.docs/raw/reference/vectors/chroma.mdx +3 -3
- package/.docs/raw/reference/vectors/convex.mdx +12 -12
- package/.docs/raw/reference/vectors/couchbase.mdx +5 -5
- package/.docs/raw/reference/vectors/duckdb.mdx +10 -10
- package/.docs/raw/reference/vectors/elasticsearch.mdx +4 -4
- package/.docs/raw/reference/vectors/lance.mdx +4 -4
- package/.docs/raw/reference/vectors/libsql.mdx +61 -11
- package/.docs/raw/reference/vectors/mongodb.mdx +58 -5
- package/.docs/raw/reference/vectors/pg.mdx +53 -6
- package/.docs/raw/reference/vectors/pinecone.mdx +3 -3
- package/.docs/raw/reference/vectors/qdrant.mdx +3 -3
- package/.docs/raw/reference/vectors/s3vectors.mdx +6 -6
- package/.docs/raw/reference/vectors/turbopuffer.mdx +4 -4
- package/.docs/raw/reference/vectors/upstash.mdx +55 -6
- package/.docs/raw/reference/vectors/vectorize.mdx +3 -3
- package/.docs/raw/reference/workflows/run-methods/cancel.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/restart.mdx +1 -3
- package/.docs/raw/reference/workflows/run-methods/resume.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/start.mdx +2 -2
- package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +143 -0
- package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +5 -5
- package/.docs/raw/reference/workflows/run.mdx +1 -1
- package/.docs/raw/reference/workflows/step.mdx +3 -3
- package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +37 -2
- 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 +6 -6
- package/.docs/raw/reference/workflows/workflow-methods/map.mdx +7 -7
- 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 +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +2 -2
- package/.docs/raw/reference/workflows/workflow.mdx +17 -3
- package/.docs/raw/{auth → server/auth}/auth0.mdx +20 -14
- package/.docs/raw/{auth → server/auth}/clerk.mdx +16 -9
- package/.docs/raw/{auth → server/auth}/firebase.mdx +21 -15
- package/.docs/raw/{auth → server/auth}/index.mdx +6 -6
- package/.docs/raw/{auth → server/auth}/jwt.mdx +14 -7
- package/.docs/raw/{auth → server/auth}/supabase.mdx +16 -9
- package/.docs/raw/{auth → server/auth}/workos.mdx +19 -13
- package/.docs/raw/{server-db → server}/custom-adapters.mdx +13 -13
- package/.docs/raw/{server-db → server}/custom-api-routes.mdx +3 -5
- package/.docs/raw/{server-db → server}/mastra-client.mdx +26 -15
- package/.docs/raw/{server-db → server}/mastra-server.mdx +8 -8
- package/.docs/raw/{server-db → server}/middleware.mdx +9 -9
- package/.docs/raw/{server-db → server}/request-context.mdx +33 -32
- package/.docs/raw/{server-db → server}/server-adapters.mdx +12 -12
- package/.docs/raw/streaming/events.mdx +14 -7
- package/.docs/raw/streaming/overview.mdx +21 -10
- package/.docs/raw/streaming/tool-streaming.mdx +6 -6
- package/.docs/raw/streaming/workflow-streaming.mdx +6 -8
- package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
- package/.docs/raw/tools-mcp/mcp-overview.mdx +31 -12
- package/.docs/raw/tools-mcp/overview.mdx +10 -11
- package/.docs/raw/voice/overview.mdx +1 -1
- package/.docs/raw/workflows/agents-and-tools.mdx +28 -19
- package/.docs/raw/workflows/control-flow.mdx +27 -40
- package/.docs/raw/workflows/error-handling.mdx +172 -18
- package/.docs/raw/workflows/human-in-the-loop.mdx +6 -7
- package/.docs/raw/workflows/inngest-workflow.mdx +8 -9
- package/.docs/raw/workflows/input-data-mapping.mdx +7 -7
- package/.docs/raw/workflows/overview.mdx +34 -23
- package/.docs/raw/workflows/snapshots.mdx +14 -44
- package/.docs/raw/workflows/suspend-and-resume.mdx +7 -7
- package/.docs/raw/workflows/time-travel.mdx +16 -16
- package/.docs/raw/workflows/workflow-state.mdx +5 -8
- package/CHANGELOG.md +23 -0
- package/dist/logger.d.ts +3 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/stdio.js +53 -0
- package/package.json +4 -4
- package/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md +0 -1
- package/.docs/raw/deployment/cloud-providers/index.mdx +0 -55
- package/.docs/raw/memory/conversation-history.mdx +0 -24
- package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
- package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
- package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
- package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
- package/.docs/raw/memory/threads-and-resources.mdx +0 -95
|
@@ -9,7 +9,7 @@ The `.listMemory()` method returns all memory instances registered with the Mast
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
const memoryInstances = mastra.listMemory();
|
|
14
14
|
|
|
15
15
|
for (const [key, memory] of Object.entries(memoryInstances)) {
|
|
@@ -36,7 +36,7 @@ This method takes no parameters.
|
|
|
36
36
|
|
|
37
37
|
## Example: Checking Registered Memory
|
|
38
38
|
|
|
39
|
-
```typescript
|
|
39
|
+
```typescript
|
|
40
40
|
import { Mastra } from "@mastra/core";
|
|
41
41
|
import { Memory } from "@mastra/memory";
|
|
42
42
|
import { LibSQLStore } from "@mastra/libsql";
|
|
@@ -9,7 +9,7 @@ The `.listStoredAgents()` method retrieves a paginated list of agent configurati
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
// Get Agent instances from storage
|
|
14
14
|
const { agents, total, hasMore } = await mastra.listStoredAgents();
|
|
15
15
|
|
|
@@ -20,7 +20,7 @@ for (const agent of agents) {
|
|
|
20
20
|
}
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
```typescript
|
|
23
|
+
```typescript
|
|
24
24
|
// Get paginated results with raw storage data
|
|
25
25
|
const result = await mastra.listStoredAgents({
|
|
26
26
|
page: 0,
|
|
@@ -127,7 +127,7 @@ If a referenced primitive is not found, a warning is logged but the agent is sti
|
|
|
127
127
|
|
|
128
128
|
## Example: Iterating Through All Stored Agents
|
|
129
129
|
|
|
130
|
-
```typescript
|
|
130
|
+
```typescript
|
|
131
131
|
async function getAllStoredAgents(mastra: Mastra) {
|
|
132
132
|
const allAgents: Agent[] = [];
|
|
133
133
|
let page = 0;
|
|
@@ -147,5 +147,5 @@ async function getAllStoredAgents(mastra: Mastra) {
|
|
|
147
147
|
## Related
|
|
148
148
|
|
|
149
149
|
- [Mastra.getStoredAgentById()](/reference/v1/core/getStoredAgentById)
|
|
150
|
-
- [Storage overview](/
|
|
150
|
+
- [Storage overview](/reference/v1/storage/overview)
|
|
151
151
|
- [Agents overview](/docs/v1/agents/overview)
|
|
@@ -9,7 +9,7 @@ The `.setStorage()` method is used to set the storage instance for the Mastra in
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
mastra.setStorage(
|
|
14
14
|
new LibSQLStore({
|
|
15
15
|
id: 'mastra-storage',
|
|
@@ -36,5 +36,5 @@ This method does not return a value.
|
|
|
36
36
|
|
|
37
37
|
## Related
|
|
38
38
|
|
|
39
|
-
- [Storage overview](/
|
|
39
|
+
- [Storage overview](/reference/v1/storage/overview)
|
|
40
40
|
- [Storage reference](/reference/v1/storage/libsql)
|
|
@@ -9,12 +9,11 @@ The `CloudflareDeployer` class handles deployment of standalone Mastra applicati
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript title="src/mastra/index.ts"
|
|
12
|
+
```typescript title="src/mastra/index.ts"
|
|
13
13
|
import { Mastra } from "@mastra/core";
|
|
14
14
|
import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
|
|
15
15
|
|
|
16
16
|
export const mastra = new Mastra({
|
|
17
|
-
// ...
|
|
18
17
|
deployer: new CloudflareDeployer({
|
|
19
18
|
projectName: "hello-mastra",
|
|
20
19
|
routes: [
|
|
@@ -9,7 +9,7 @@ The `NetlifyDeployer` class handles deployment of standalone Mastra applications
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript title="src/mastra/index.ts"
|
|
12
|
+
```typescript title="src/mastra/index.ts"
|
|
13
13
|
import { Mastra } from "@mastra/core";
|
|
14
14
|
import { NetlifyDeployer } from "@mastra/deployer-netlify";
|
|
15
15
|
|
|
@@ -9,12 +9,11 @@ The `VercelDeployer` class handles deployment of standalone Mastra applications
|
|
|
9
9
|
|
|
10
10
|
## Usage example
|
|
11
11
|
|
|
12
|
-
```typescript title="src/mastra/index.ts"
|
|
12
|
+
```typescript title="src/mastra/index.ts"
|
|
13
13
|
import { Mastra } from "@mastra/core";
|
|
14
14
|
import { VercelDeployer } from "@mastra/deployer-vercel";
|
|
15
15
|
|
|
16
16
|
export const mastra = new Mastra({
|
|
17
|
-
// ...
|
|
18
17
|
deployer: new VercelDeployer(),
|
|
19
18
|
});
|
|
20
19
|
```
|
|
@@ -31,12 +30,11 @@ These options are merged into `.vercel/output/functions/index.func/.vc-config.js
|
|
|
31
30
|
|
|
32
31
|
### Example with overrides
|
|
33
32
|
|
|
34
|
-
```typescript title="src/mastra/index.ts"
|
|
33
|
+
```typescript title="src/mastra/index.ts"
|
|
35
34
|
import { Mastra } from "@mastra/core";
|
|
36
35
|
import { VercelDeployer } from "@mastra/deployer-vercel";
|
|
37
36
|
|
|
38
37
|
export const mastra = new Mastra({
|
|
39
|
-
// ...
|
|
40
38
|
deployer: new VercelDeployer({
|
|
41
39
|
maxDuration: 600,
|
|
42
40
|
memory: 1536,
|
|
@@ -116,7 +116,7 @@ A relevancy score between 0 and 1:
|
|
|
116
116
|
|
|
117
117
|
Evaluate agent responses for relevancy across different scenarios:
|
|
118
118
|
|
|
119
|
-
```typescript title="src/example-answer-relevancy.ts"
|
|
119
|
+
```typescript title="src/example-answer-relevancy.ts"
|
|
120
120
|
import { runEvals } from "@mastra/core/evals";
|
|
121
121
|
import { createAnswerRelevancyScorer } from "@mastra/evals/scorers/prebuilt";
|
|
122
122
|
import { myAgent } from "./agent";
|
|
@@ -153,7 +153,7 @@ Score calculation: `max(0, base_score - contradiction_penalty - missing_penalty
|
|
|
153
153
|
|
|
154
154
|
Evaluate agent responses for similarity to ground truth across different scenarios:
|
|
155
155
|
|
|
156
|
-
```typescript title="src/example-answer-similarity.ts"
|
|
156
|
+
```typescript title="src/example-answer-similarity.ts"
|
|
157
157
|
import { runEvals } from "@mastra/core/evals";
|
|
158
158
|
import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
|
|
159
159
|
import { myAgent } from "./agent";
|
|
@@ -127,7 +127,7 @@ A bias score between 0 and 1:
|
|
|
127
127
|
|
|
128
128
|
Evaluate agent responses for bias across different types of questions:
|
|
129
129
|
|
|
130
|
-
```typescript title="src/example-bias.ts"
|
|
130
|
+
```typescript title="src/example-bias.ts"
|
|
131
131
|
import { runEvals } from "@mastra/core/evals";
|
|
132
132
|
import { createBiasScorer } from "@mastra/evals/scorers/prebuilt";
|
|
133
133
|
import { myAgent } from "./agent";
|
|
@@ -109,7 +109,7 @@ A completeness score between 0 and 1:
|
|
|
109
109
|
|
|
110
110
|
Evaluate agent responses for completeness across different query complexities:
|
|
111
111
|
|
|
112
|
-
```typescript title="src/example-completeness.ts"
|
|
112
|
+
```typescript title="src/example-completeness.ts"
|
|
113
113
|
import { runEvals } from "@mastra/core/evals";
|
|
114
114
|
import { createCompletenessScorer } from "@mastra/evals/scorers/prebuilt";
|
|
115
115
|
import { myAgent } from "./agent";
|
|
@@ -82,7 +82,7 @@ Final score: `similarity_value * scale`
|
|
|
82
82
|
|
|
83
83
|
Evaluate textual similarity between expected and actual agent outputs:
|
|
84
84
|
|
|
85
|
-
```typescript title="src/example-content-similarity.ts"
|
|
85
|
+
```typescript title="src/example-content-similarity.ts"
|
|
86
86
|
import { runEvals } from "@mastra/core/evals";
|
|
87
87
|
import { createContentSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
|
|
88
88
|
import { myAgent } from "./agent";
|
|
@@ -190,7 +190,7 @@ const scorer = createContextPrecisionScorer({
|
|
|
190
190
|
|
|
191
191
|
Evaluate RAG system context retrieval precision for different queries:
|
|
192
192
|
|
|
193
|
-
```typescript title="src/example-context-precision.ts"
|
|
193
|
+
```typescript title="src/example-context-precision.ts"
|
|
194
194
|
import { runEvals } from "@mastra/core/evals";
|
|
195
195
|
import { createContextPrecisionScorer } from "@mastra/evals/scorers/prebuilt";
|
|
196
196
|
import { myAgent } from "./agent";
|
|
@@ -126,7 +126,7 @@ A faithfulness score between 0 and 1:
|
|
|
126
126
|
|
|
127
127
|
Evaluate agent responses for faithfulness to provided context:
|
|
128
128
|
|
|
129
|
-
```typescript title="src/example-faithfulness.ts"
|
|
129
|
+
```typescript title="src/example-faithfulness.ts"
|
|
130
130
|
import { runEvals } from "@mastra/core/evals";
|
|
131
131
|
import { createFaithfulnessScorer } from "@mastra/evals/scorers/prebuilt";
|
|
132
132
|
import { myAgent } from "./agent";
|
|
@@ -135,7 +135,7 @@ A hallucination score between 0 and 1:
|
|
|
135
135
|
|
|
136
136
|
Evaluate agent responses for hallucinations against provided context:
|
|
137
137
|
|
|
138
|
-
```typescript title="src/example-hallucination.ts"
|
|
138
|
+
```typescript title="src/example-hallucination.ts"
|
|
139
139
|
import { runEvals } from "@mastra/core/evals";
|
|
140
140
|
import { createHallucinationScorer } from "@mastra/evals/scorers/prebuilt";
|
|
141
141
|
import { myAgent } from "./agent";
|
|
@@ -106,7 +106,7 @@ The scorer handles several special cases:
|
|
|
106
106
|
|
|
107
107
|
Evaluate keyword coverage between input queries and agent responses:
|
|
108
108
|
|
|
109
|
-
```typescript title="src/example-keyword-coverage.ts"
|
|
109
|
+
```typescript title="src/example-keyword-coverage.ts"
|
|
110
110
|
import { runEvals } from "@mastra/core/evals";
|
|
111
111
|
import { createKeywordCoverageScorer } from "@mastra/evals/scorers/prebuilt";
|
|
112
112
|
import { myAgent } from "./agent";
|
|
@@ -107,7 +107,7 @@ The `createPromptAlignmentScorerLLM()` function creates a scorer that evaluates
|
|
|
107
107
|
|
|
108
108
|
You can customize the Prompt Alignment Scorer by adjusting the scale parameter and evaluation mode to fit your scoring needs.
|
|
109
109
|
|
|
110
|
-
```typescript
|
|
110
|
+
```typescript
|
|
111
111
|
const scorer = createPromptAlignmentScorerLLM({
|
|
112
112
|
model: "openai/gpt-5.1",
|
|
113
113
|
options: {
|
|
@@ -417,7 +417,7 @@ const result = await scorer.run({
|
|
|
417
417
|
|
|
418
418
|
In this example, the response fully addresses the user's prompt with all requirements met.
|
|
419
419
|
|
|
420
|
-
```typescript title="src/example-excellent-prompt-alignment.ts"
|
|
420
|
+
```typescript title="src/example-excellent-prompt-alignment.ts"
|
|
421
421
|
import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
|
|
422
422
|
|
|
423
423
|
const scorer = createPromptAlignmentScorerLLM({
|
|
@@ -465,7 +465,7 @@ The output receives a high score because it perfectly addresses the intent, fulf
|
|
|
465
465
|
|
|
466
466
|
In this example, the response addresses the core intent but misses some requirements or has format issues.
|
|
467
467
|
|
|
468
|
-
```typescript title="src/example-partial-prompt-alignment.ts"
|
|
468
|
+
```typescript title="src/example-partial-prompt-alignment.ts"
|
|
469
469
|
import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
|
|
470
470
|
|
|
471
471
|
const scorer = createPromptAlignmentScorerLLM({
|
|
@@ -506,7 +506,7 @@ The output receives a lower score because while the content is accurate, it does
|
|
|
506
506
|
|
|
507
507
|
In this example, the response fails to address the user's specific requirements.
|
|
508
508
|
|
|
509
|
-
```typescript title="src/example-poor-prompt-alignment.ts"
|
|
509
|
+
```typescript title="src/example-poor-prompt-alignment.ts"
|
|
510
510
|
import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
|
|
511
511
|
|
|
512
512
|
const scorer = createPromptAlignmentScorerLLM({
|
|
@@ -552,7 +552,7 @@ The output receives a low score because it only partially fulfills the requireme
|
|
|
552
552
|
|
|
553
553
|
Evaluates how well the response addresses the user's request, ignoring system instructions:
|
|
554
554
|
|
|
555
|
-
```typescript title="src/example-user-mode.ts"
|
|
555
|
+
```typescript title="src/example-user-mode.ts"
|
|
556
556
|
const scorer = createPromptAlignmentScorerLLM({
|
|
557
557
|
model: "openai/gpt-5.1",
|
|
558
558
|
options: { evaluationMode: "user" },
|
|
@@ -584,7 +584,7 @@ const result = await scorer.run({
|
|
|
584
584
|
|
|
585
585
|
Evaluates compliance with system behavioral guidelines and constraints:
|
|
586
586
|
|
|
587
|
-
```typescript title="src/example-system-mode.ts"
|
|
587
|
+
```typescript title="src/example-system-mode.ts"
|
|
588
588
|
const scorer = createPromptAlignmentScorerLLM({
|
|
589
589
|
model: "openai/gpt-5.1",
|
|
590
590
|
options: { evaluationMode: "system" },
|
|
@@ -617,7 +617,7 @@ const result = await scorer.run({
|
|
|
617
617
|
|
|
618
618
|
Evaluates both user intent fulfillment and system compliance with weighted scoring (70% user, 30% system):
|
|
619
619
|
|
|
620
|
-
```typescript title="src/example-both-mode.ts"
|
|
620
|
+
```typescript title="src/example-both-mode.ts"
|
|
621
621
|
const scorer = createPromptAlignmentScorerLLM({
|
|
622
622
|
model: "openai/gpt-5.1",
|
|
623
623
|
options: { evaluationMode: "both" }, // This is the default
|
|
@@ -87,7 +87,7 @@ A textual difference score between 0 and 1:
|
|
|
87
87
|
|
|
88
88
|
Measure textual differences between expected and actual agent outputs:
|
|
89
89
|
|
|
90
|
-
```typescript title="src/example-textual-difference.ts"
|
|
90
|
+
```typescript title="src/example-textual-difference.ts"
|
|
91
91
|
import { runEvals } from "@mastra/core/evals";
|
|
92
92
|
import { createTextualDifferenceScorer } from "@mastra/evals/scorers/prebuilt";
|
|
93
93
|
import { myAgent } from "./agent";
|
|
@@ -98,7 +98,7 @@ Object with tone metrics:
|
|
|
98
98
|
|
|
99
99
|
Evaluate tone consistency between related agent responses:
|
|
100
100
|
|
|
101
|
-
```typescript title="src/example-tone-consistency.ts"
|
|
101
|
+
```typescript title="src/example-tone-consistency.ts"
|
|
102
102
|
import { runEvals } from "@mastra/core/evals";
|
|
103
103
|
import { createToneScorer } from "@mastra/evals/scorers/prebuilt";
|
|
104
104
|
import { myAgent } from "./agent";
|
|
@@ -89,7 +89,7 @@ When `expectedToolOrder` is provided, the scorer validates tool calling sequence
|
|
|
89
89
|
|
|
90
90
|
### Code-Based Scorer Options
|
|
91
91
|
|
|
92
|
-
```typescript
|
|
92
|
+
```typescript
|
|
93
93
|
// Standard mode - passes if expected tool is called
|
|
94
94
|
const lenientScorer = createCodeScorer({
|
|
95
95
|
expectedTool: "search-tool",
|
|
@@ -135,7 +135,7 @@ The code-based scorer provides deterministic, binary scoring (0 or 1) based on e
|
|
|
135
135
|
|
|
136
136
|
### Correct tool selection
|
|
137
137
|
|
|
138
|
-
```typescript title="src/example-correct-tool.ts"
|
|
138
|
+
```typescript title="src/example-correct-tool.ts"
|
|
139
139
|
const scorer = createToolCallAccuracyScorerCode({
|
|
140
140
|
expectedTool: "weather-tool",
|
|
141
141
|
});
|
|
@@ -177,7 +177,7 @@ console.log(result.preprocessStepResult?.correctToolCalled); // true
|
|
|
177
177
|
|
|
178
178
|
Only passes if exactly one tool is called:
|
|
179
179
|
|
|
180
|
-
```typescript title="src/example-strict-mode.ts"
|
|
180
|
+
```typescript title="src/example-strict-mode.ts"
|
|
181
181
|
const strictScorer = createToolCallAccuracyScorerCode({
|
|
182
182
|
expectedTool: "weather-tool",
|
|
183
183
|
strictMode: true,
|
|
@@ -216,7 +216,7 @@ console.log(result.score); // 0 - fails because multiple tools were called
|
|
|
216
216
|
|
|
217
217
|
Validates that tools are called in a specific sequence:
|
|
218
218
|
|
|
219
|
-
```typescript title="src/example-order-validation.ts"
|
|
219
|
+
```typescript title="src/example-order-validation.ts"
|
|
220
220
|
const orderScorer = createToolCallAccuracyScorerCode({
|
|
221
221
|
expectedTool: "auth-tool", // ignored when order is specified
|
|
222
222
|
expectedToolOrder: ["auth-tool", "fetch-tool"],
|
|
@@ -255,7 +255,7 @@ console.log(result.score); // 1 - correct order
|
|
|
255
255
|
|
|
256
256
|
Allows extra tools as long as expected tools maintain relative order:
|
|
257
257
|
|
|
258
|
-
```typescript title="src/example-flexible-order.ts"
|
|
258
|
+
```typescript title="src/example-flexible-order.ts"
|
|
259
259
|
const flexibleOrderScorer = createToolCallAccuracyScorerCode({
|
|
260
260
|
expectedTool: "auth-tool",
|
|
261
261
|
expectedToolOrder: ["auth-tool", "fetch-tool"],
|
|
@@ -346,7 +346,7 @@ The LLM-based scorer provides:
|
|
|
346
346
|
|
|
347
347
|
### LLM-Based Scorer Options
|
|
348
348
|
|
|
349
|
-
```typescript
|
|
349
|
+
```typescript
|
|
350
350
|
// Basic configuration
|
|
351
351
|
const basicLLMScorer = createLLMScorer({
|
|
352
352
|
model: 'openai/gpt-5.1',
|
|
@@ -387,7 +387,7 @@ The LLM-based scorer uses AI to evaluate whether tool selections are appropriate
|
|
|
387
387
|
|
|
388
388
|
### Basic LLM evaluation
|
|
389
389
|
|
|
390
|
-
```typescript title="src/example-llm-basic.ts"
|
|
390
|
+
```typescript title="src/example-llm-basic.ts"
|
|
391
391
|
const llmScorer = createToolCallAccuracyScorerLLM({
|
|
392
392
|
model: "openai/gpt-5.1",
|
|
393
393
|
availableTools: [
|
|
@@ -440,7 +440,7 @@ console.log(result.reason); // "The agent correctly used the weather-tool to add
|
|
|
440
440
|
|
|
441
441
|
### Handling inappropriate tool usage
|
|
442
442
|
|
|
443
|
-
```typescript title="src/example-llm-inappropriate.ts"
|
|
443
|
+
```typescript title="src/example-llm-inappropriate.ts"
|
|
444
444
|
const inputMessages = [
|
|
445
445
|
createUIMessage({
|
|
446
446
|
content: "What is the weather in Tokyo?",
|
|
@@ -477,7 +477,7 @@ console.log(result.reason); // "The agent used search-tool when weather-tool wou
|
|
|
477
477
|
|
|
478
478
|
The LLM scorer recognizes when agents appropriately ask for clarification:
|
|
479
479
|
|
|
480
|
-
```typescript title="src/example-llm-clarification.ts"
|
|
480
|
+
```typescript title="src/example-llm-clarification.ts"
|
|
481
481
|
const vagueInput = [
|
|
482
482
|
createUIMessage({
|
|
483
483
|
content: 'I need help with something',
|
|
@@ -509,7 +509,7 @@ console.log(result.reason); // "The agent appropriately asked for clarification
|
|
|
509
509
|
|
|
510
510
|
Here's an example using both scorers on the same data:
|
|
511
511
|
|
|
512
|
-
```typescript title="src/example-comparison.ts"
|
|
512
|
+
```typescript title="src/example-comparison.ts"
|
|
513
513
|
import {
|
|
514
514
|
createToolCallAccuracyScorerCode as createCodeScorer,
|
|
515
515
|
createToolCallAccuracyScorerLLM as createLLMScorer
|
|
@@ -123,7 +123,7 @@ A toxicity score between 0 and 1:
|
|
|
123
123
|
|
|
124
124
|
Evaluate agent responses for toxic, biased, or harmful content:
|
|
125
125
|
|
|
126
|
-
```typescript title="src/example-toxicity.ts"
|
|
126
|
+
```typescript title="src/example-toxicity.ts"
|
|
127
127
|
import { runEvals } from "@mastra/core/evals";
|
|
128
128
|
import { createToxicityScorer } from "@mastra/evals/scorers/prebuilt";
|
|
129
129
|
import { myAgent } from "./agent";
|
|
@@ -7,16 +7,15 @@ description: Documentation for PinoLogger, which provides methods to record even
|
|
|
7
7
|
|
|
8
8
|
A Logger instance is created using `new PinoLogger()` and provides methods to record events at various severity levels.
|
|
9
9
|
|
|
10
|
-
When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/
|
|
10
|
+
When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/mastra-cloud/dashboard#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
|
|
11
11
|
|
|
12
12
|
## Usage example
|
|
13
13
|
|
|
14
|
-
```typescript title="src/mastra/index.ts"
|
|
14
|
+
```typescript title="src/mastra/index.ts"
|
|
15
15
|
import { Mastra } from "@mastra/core";
|
|
16
16
|
import { PinoLogger } from "@mastra/loggers";
|
|
17
17
|
|
|
18
18
|
export const mastra = new Mastra({
|
|
19
|
-
// ...
|
|
20
19
|
logger: new PinoLogger({
|
|
21
20
|
name: "Mastra",
|
|
22
21
|
level: "info",
|
|
@@ -63,7 +62,7 @@ export const mastra = new Mastra({
|
|
|
63
62
|
|
|
64
63
|
Writes structured logs to a file using the `FileTransport`. The logger accepts a plain message as the first argument and structured metadata as the second argument. These are internally converted to a `BaseLogMessage` and persisted to the configured file path.
|
|
65
64
|
|
|
66
|
-
```typescript title="src/mastra/loggers/file-transport.ts"
|
|
65
|
+
```typescript title="src/mastra/loggers/file-transport.ts"
|
|
67
66
|
import { FileTransport } from "@mastra/loggers/file";
|
|
68
67
|
import { PinoLogger } from "@mastra/loggers/pino";
|
|
69
68
|
|
|
@@ -76,7 +75,7 @@ export const fileLogger = new PinoLogger({
|
|
|
76
75
|
|
|
77
76
|
### File transport usage
|
|
78
77
|
|
|
79
|
-
```typescript
|
|
78
|
+
```typescript
|
|
80
79
|
fileLogger.warn("Low disk space", {
|
|
81
80
|
destinationPath: "system",
|
|
82
81
|
type: "WORKFLOW",
|
|
@@ -87,7 +86,7 @@ fileLogger.warn("Low disk space", {
|
|
|
87
86
|
|
|
88
87
|
Streams structured logs to a remote Redis list using the `UpstashTransport`. The logger accepts a string message and a structured metadata object. This enables centralized logging for distributed environments, supporting filtering by `destinationPath`, `type`, and `runId`.
|
|
89
88
|
|
|
90
|
-
```typescript title="src/mastra/loggers/upstash-transport.ts"
|
|
89
|
+
```typescript title="src/mastra/loggers/upstash-transport.ts"
|
|
91
90
|
import { UpstashTransport } from "@mastra/loggers/upstash";
|
|
92
91
|
import { PinoLogger } from "@mastra/loggers/pino";
|
|
93
92
|
|
|
@@ -106,7 +105,7 @@ export const upstashLogger = new PinoLogger({
|
|
|
106
105
|
|
|
107
106
|
### Upstash transport usage
|
|
108
107
|
|
|
109
|
-
```typescript
|
|
108
|
+
```typescript
|
|
110
109
|
upstashLogger.info("User signed in", {
|
|
111
110
|
destinationPath: "auth",
|
|
112
111
|
type: "AGENT",
|
|
@@ -122,7 +121,7 @@ You can create custom transports using the `createCustomTransport` utility to in
|
|
|
122
121
|
|
|
123
122
|
Creates a custom transport using `createCustomTransport` and integrates it with a third-party logging stream such as `pino-sentry-transport`. This allows forwarding logs to an external system like Sentry for advanced monitoring and observability.
|
|
124
123
|
|
|
125
|
-
```typescript title="src/mastra/loggers/sentry-transport.ts"
|
|
124
|
+
```typescript title="src/mastra/loggers/sentry-transport.ts"
|
|
126
125
|
import { createCustomTransport } from "@mastra/core/loggers";
|
|
127
126
|
import { PinoLogger } from "@mastra/loggers/pino";
|
|
128
127
|
import pinoSentry from "pino-sentry-transport";
|
|
@@ -9,7 +9,7 @@ The `.createThread()` method creates a new conversation thread in the memory sys
|
|
|
9
9
|
|
|
10
10
|
## Usage Example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
await memory?.createThread({ resourceId: "user-123" });
|
|
14
14
|
```
|
|
15
15
|
|
|
@@ -85,7 +85,7 @@ await memory?.createThread({ resourceId: "user-123" });
|
|
|
85
85
|
|
|
86
86
|
## Extended usage example
|
|
87
87
|
|
|
88
|
-
```typescript title="src/test-memory.ts"
|
|
88
|
+
```typescript title="src/test-memory.ts"
|
|
89
89
|
import { mastra } from "./mastra";
|
|
90
90
|
|
|
91
91
|
const agent = mastra.getAgent("agent");
|
|
@@ -9,7 +9,7 @@ The `.deleteMessages()` method deletes multiple messages by their IDs.
|
|
|
9
9
|
|
|
10
10
|
## Usage Example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);
|
|
14
14
|
```
|
|
15
15
|
|
|
@@ -40,7 +40,7 @@ await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);
|
|
|
40
40
|
|
|
41
41
|
## Extended usage example
|
|
42
42
|
|
|
43
|
-
```typescript title="src/test-memory.ts"
|
|
43
|
+
```typescript title="src/test-memory.ts"
|
|
44
44
|
import { mastra } from "./mastra";
|
|
45
45
|
import { MastraDBMessage } from "@mastra/core";
|
|
46
46
|
|
|
@@ -9,7 +9,7 @@ The `.listThreadsByResourceId()` method retrieves threads associated with a spec
|
|
|
9
9
|
|
|
10
10
|
## Usage Example
|
|
11
11
|
|
|
12
|
-
```typescript
|
|
12
|
+
```typescript
|
|
13
13
|
await memory.listThreadsByResourceId({
|
|
14
14
|
resourceId: "user-123",
|
|
15
15
|
page: 0,
|
|
@@ -70,7 +70,7 @@ The return object contains:
|
|
|
70
70
|
|
|
71
71
|
## Extended usage example
|
|
72
72
|
|
|
73
|
-
```typescript title="src/test-memory.ts"
|
|
73
|
+
```typescript title="src/test-memory.ts"
|
|
74
74
|
import { mastra } from "./mastra";
|
|
75
75
|
|
|
76
76
|
const agent = mastra.getAgent("agent");
|