@mastra/mcp-docs-server 1.2.11 → 1.2.12-alpha.3
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/docs/agent-builder/access-control.md +3 -3
- package/.docs/docs/agent-builder/browser.md +1 -1
- package/.docs/docs/agent-builder/channels.md +1 -1
- package/.docs/docs/agent-builder/configuration.md +3 -3
- package/.docs/docs/agent-builder/deploying.md +2 -2
- package/.docs/docs/agent-builder/integrations.md +8 -8
- package/.docs/docs/agent-builder/memory.md +2 -2
- package/.docs/docs/agent-builder/overview.md +1 -1
- package/.docs/docs/agent-controller/channels.md +8 -6
- package/.docs/docs/agent-controller/modes.md +6 -6
- package/.docs/docs/agent-controller/overview.md +13 -9
- package/.docs/docs/agent-controller/session.md +27 -9
- package/.docs/docs/agent-controller/subagents.md +9 -6
- package/.docs/docs/agent-controller/threads-and-state.md +12 -8
- package/.docs/docs/agent-controller/tool-approvals.md +7 -3
- package/.docs/docs/agents/a2a.md +4 -2
- package/.docs/docs/agents/acp.md +5 -5
- package/.docs/docs/agents/agent-approval.md +13 -11
- package/.docs/docs/agents/code-mode.md +29 -6
- package/.docs/docs/agents/guardrails.md +8 -8
- package/.docs/docs/agents/networks.md +2 -2
- package/.docs/docs/agents/overview.md +9 -7
- package/.docs/docs/agents/processors.md +15 -15
- package/.docs/docs/agents/skills.md +6 -6
- package/.docs/docs/agents/structured-output.md +6 -6
- package/.docs/docs/agents/supervisor-agents.md +19 -13
- package/.docs/docs/agents/using-tools.md +48 -21
- package/.docs/docs/browser/agent-browser.md +4 -4
- package/.docs/docs/browser/browser-viewer.md +2 -2
- package/.docs/docs/browser/firecrawl.md +1 -1
- package/.docs/docs/browser/overview.md +2 -2
- package/.docs/docs/browser/recording.md +1 -1
- package/.docs/docs/browser/stagehand.md +7 -7
- package/.docs/docs/capabilities/channels/discord.md +1 -1
- package/.docs/docs/capabilities/channels/other-adapters.md +1 -1
- package/.docs/docs/capabilities/channels/overview.md +9 -5
- package/.docs/docs/capabilities/channels/slack.md +2 -2
- package/.docs/docs/capabilities/channels/teams.md +1 -1
- package/.docs/docs/capabilities/channels/telegram.md +1 -1
- package/.docs/docs/capabilities/channels/whatsapp.md +1 -1
- package/.docs/docs/deployment/mastra-server.md +1 -1
- package/.docs/docs/deployment/overview.md +6 -2
- package/.docs/docs/deployment/sandbox.md +3 -1
- package/.docs/docs/deployment/workers.md +137 -0
- package/.docs/docs/editor/overview.md +37 -31
- package/.docs/docs/editor/prompts.md +8 -4
- package/.docs/docs/editor/tools.md +3 -3
- package/.docs/docs/evals/built-in-scorers.md +4 -4
- package/.docs/docs/evals/custom-scorers.md +5 -5
- package/.docs/docs/evals/datasets/running-experiments.md +7 -7
- package/.docs/docs/evals/evals-with-memory.md +4 -4
- package/.docs/docs/evals/gates-and-verdicts.md +4 -4
- package/.docs/docs/evals/multi-turn.md +12 -12
- package/.docs/docs/evals/overview.md +6 -4
- package/.docs/docs/evals/quick-checks.md +2 -2
- package/.docs/docs/getting-started/build-with-ai.md +6 -4
- package/.docs/docs/getting-started/file-based-agents.md +6 -4
- package/.docs/docs/getting-started/manual-install.md +1 -1
- package/.docs/docs/index.md +9 -90
- package/.docs/docs/long-running-agents/background-tasks.md +10 -10
- package/.docs/docs/long-running-agents/durable-agents.md +46 -5
- package/.docs/docs/long-running-agents/goals.md +15 -11
- package/.docs/docs/long-running-agents/schedules.md +3 -3
- package/.docs/docs/long-running-agents/signal-providers.md +8 -6
- package/.docs/docs/long-running-agents/signals.md +9 -5
- package/.docs/docs/mastra-platform/configuration.md +3 -3
- package/.docs/docs/mastra-platform/database.md +8 -8
- package/.docs/docs/mastra-platform/deploy.md +8 -4
- package/.docs/docs/mastra-platform/environments.md +8 -4
- package/.docs/docs/mastra-platform/github.md +3 -1
- package/.docs/docs/mastra-platform/server.md +1 -1
- package/.docs/docs/mastra-platform/studio.md +2 -2
- package/.docs/docs/mastra-platform/workspace.md +6 -6
- package/.docs/docs/mcp/mcp-apps.md +1 -1
- package/.docs/docs/mcp/overview.md +9 -9
- package/.docs/docs/memory/memory-processors.md +10 -10
- package/.docs/docs/memory/message-history.md +11 -5
- package/.docs/docs/memory/multi-user-threads.md +6 -6
- package/.docs/docs/memory/observational-memory.md +27 -25
- package/.docs/docs/memory/overview.md +10 -10
- package/.docs/docs/memory/semantic-recall.md +3 -3
- package/.docs/docs/memory/working-memory.md +8 -8
- package/.docs/docs/observability/integrations/bridges/datadog.md +6 -6
- package/.docs/docs/observability/integrations/bridges/otel.md +5 -5
- package/.docs/docs/observability/integrations/exporters/datadog.md +1 -1
- package/.docs/docs/observability/integrations/exporters/laminar.md +1 -1
- package/.docs/docs/observability/integrations/exporters/langfuse.md +3 -3
- package/.docs/docs/observability/integrations/exporters/langsmith.md +4 -4
- package/.docs/docs/observability/integrations/exporters/mastra-platform.md +1 -1
- package/.docs/docs/observability/integrations/exporters/mastra-storage.md +1 -1
- package/.docs/docs/observability/integrations/exporters/otel.md +26 -4
- package/.docs/docs/observability/integrations/exporters/sentry.md +1 -1
- package/.docs/docs/observability/integrations/overview.md +1 -1
- package/.docs/docs/observability/integrations/processors/sensitive-data-filter.md +1 -1
- package/.docs/docs/observability/logging.md +1 -1
- package/.docs/docs/observability/metrics/overview.md +1 -1
- package/.docs/docs/observability/metrics/querying.md +8 -8
- package/.docs/docs/observability/overview.md +4 -4
- package/.docs/docs/observability/tracing/overview.md +18 -12
- package/.docs/docs/rag/chunking-and-embedding.md +1 -1
- package/.docs/docs/rag/graph-rag.md +7 -7
- package/.docs/docs/rag/overview.md +2 -2
- package/.docs/docs/rag/retrieval.md +18 -18
- package/.docs/docs/rag/vector-databases.md +2 -2
- package/.docs/docs/server/auth/composite-auth.md +2 -2
- package/.docs/docs/server/auth/fga.md +6 -6
- package/.docs/docs/server/auth/firebase.md +2 -2
- package/.docs/docs/server/auth/simple-auth.md +1 -1
- package/.docs/docs/server/auth/workers.md +133 -0
- package/.docs/docs/server/custom-adapters.md +4 -4
- package/.docs/docs/server/mastra-client.md +3 -3
- package/.docs/docs/server/mastra-server.md +2 -2
- package/.docs/docs/server/middleware.md +1 -1
- package/.docs/docs/server/pubsub.md +7 -4
- package/.docs/docs/server/request-context.md +11 -11
- package/.docs/docs/server/server-adapters.md +2 -2
- package/.docs/docs/storage/overview.md +2 -2
- package/.docs/docs/studio/auth.md +5 -5
- package/.docs/docs/studio/deployment.md +1 -1
- package/.docs/docs/studio/observability.md +2 -2
- package/.docs/docs/studio/overview.md +11 -9
- package/.docs/docs/voice/overview.md +26 -26
- package/.docs/docs/voice/realtime-voice.md +8 -8
- package/.docs/docs/voice/speech-to-speech.md +9 -9
- package/.docs/docs/voice/speech-to-text.md +3 -3
- package/.docs/docs/voice/text-to-speech.md +6 -6
- package/.docs/docs/what-is-mastra.md +161 -0
- package/.docs/docs/workflows/agents-and-tools.md +3 -3
- package/.docs/docs/workflows/control-flow.md +10 -8
- package/.docs/docs/workflows/error-handling.md +2 -2
- package/.docs/docs/workflows/overview.md +7 -6
- package/.docs/docs/workflows/scheduled-workflows.md +12 -12
- package/.docs/docs/workflows/snapshots.md +3 -3
- package/.docs/docs/workflows/suspend-and-resume.md +1 -1
- package/.docs/docs/workflows/time-travel.md +3 -1
- package/.docs/docs/workflows/workflow-state.md +1 -1
- package/.docs/docs/workspace/filesystem.md +10 -10
- package/.docs/docs/workspace/lsp.md +1 -1
- package/.docs/docs/workspace/overview.md +12 -12
- package/.docs/docs/workspace/sandbox.md +9 -7
- package/.docs/docs/workspace/search.md +3 -3
- package/.docs/docs/workspace/skills.md +7 -7
- package/.docs/guides/build-your-ui/ai-sdk-ui.md +6 -6
- package/.docs/guides/build-your-ui/copilotkit/generative-ui.md +9 -9
- package/.docs/guides/build-your-ui/copilotkit/overview.md +2 -2
- package/.docs/guides/build-your-ui/openui.md +2 -2
- package/.docs/guides/concepts/multi-agent-systems.md +5 -5
- package/.docs/guides/concepts/streaming.md +10 -10
- package/.docs/guides/deployment/amazon-ec2.md +1 -1
- package/.docs/guides/deployment/aws-lambda.md +1 -1
- package/.docs/guides/deployment/azure-app-services.md +1 -1
- package/.docs/guides/deployment/cloudflare.md +1 -1
- package/.docs/guides/deployment/inngest.md +6 -6
- package/.docs/guides/deployment/kubernetes.md +1 -1
- package/.docs/guides/deployment/mastra-workers.md +232 -0
- package/.docs/guides/deployment/temporal.md +1 -1
- package/.docs/guides/deployment/vercel.md +1 -1
- package/.docs/guides/getting-started/astro.md +1 -1
- package/.docs/guides/getting-started/electron.md +1 -1
- package/.docs/guides/getting-started/nestjs.md +5 -5
- package/.docs/guides/getting-started/vite-react.md +1 -1
- package/.docs/guides/guide/ai-recruiter.md +1 -1
- package/.docs/guides/guide/chef-michel.md +2 -2
- package/.docs/guides/guide/code-review-bot.md +2 -2
- package/.docs/guides/guide/coding-agent.md +5 -5
- package/.docs/guides/guide/dev-assistant.md +2 -2
- package/.docs/guides/guide/docs-manager.md +4 -4
- package/.docs/guides/guide/firecrawl.md +1 -1
- package/.docs/guides/guide/github-actions-pr-description.md +5 -5
- package/.docs/guides/guide/research-assistant.md +4 -4
- package/.docs/guides/guide/research-coordinator.md +5 -5
- package/.docs/guides/guide/signal-provider.md +1 -1
- package/.docs/guides/guide/slack-assistant.md +1 -1
- package/.docs/guides/guide/stock-agent.md +3 -3
- package/.docs/guides/guide/web-search.md +4 -4
- package/.docs/guides/guide/whatsapp-chat-bot.md +2 -2
- package/.docs/guides/index.md +1 -1
- package/.docs/guides/migrations/agentnetwork.md +4 -4
- package/.docs/guides/migrations/ai-sdk-v4-to-v5.md +1 -1
- package/.docs/guides/migrations/mastra-cloud.md +6 -6
- package/.docs/guides/migrations/network-to-supervisor.md +9 -9
- package/.docs/guides/migrations/upgrade-to-v1/agent.md +6 -6
- package/.docs/guides/migrations/upgrade-to-v1/cli.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/client.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/evals.md +2 -2
- package/.docs/guides/migrations/upgrade-to-v1/memory.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/overview.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/processors.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/storage.md +11 -11
- package/.docs/guides/migrations/upgrade-to-v1/tools.md +3 -3
- package/.docs/guides/migrations/upgrade-to-v1/tracing.md +2 -2
- package/.docs/guides/migrations/upgrade-to-v1/voice.md +1 -1
- package/.docs/guides/migrations/upgrade-to-v1/workflows.md +1 -1
- package/.docs/guides/migrations/vnext-to-standard-apis.md +2 -2
- package/.docs/models/environment-variables.md +1 -0
- package/.docs/models/gateways/custom-gateways.md +3 -3
- package/.docs/models/gateways/openrouter.md +1 -3
- package/.docs/models/gateways/vercel.md +2 -1
- package/.docs/models/index.md +6 -6
- package/.docs/models/providers/baseten.md +1 -1
- package/.docs/models/providers/chutes.md +2 -1
- package/.docs/models/providers/crossmodel.md +2 -2
- package/.docs/models/providers/deepinfra.md +1 -1
- package/.docs/models/providers/hyper.md +3 -3
- package/.docs/models/providers/llmgateway.md +4 -3
- package/.docs/models/providers/modal.md +73 -0
- package/.docs/models/providers/wandb.md +2 -1
- package/.docs/models/providers.md +1 -0
- package/.docs/reference/acp/acp-agent.md +4 -4
- package/.docs/reference/acp/create-acp-tool.md +3 -3
- package/.docs/reference/agent-controller/agent-controller-class.md +36 -36
- package/.docs/reference/agent-controller/session.md +6 -6
- package/.docs/reference/agents/agent.md +14 -14
- package/.docs/reference/agents/channels.md +29 -13
- package/.docs/reference/agents/durable-agent.md +54 -5
- package/.docs/reference/agents/generate.md +3 -3
- package/.docs/reference/agents/generateLegacy.md +1 -1
- package/.docs/reference/agents/getDefaultOptions.md +1 -1
- package/.docs/reference/agents/getDefaultStreamOptions.md +1 -1
- package/.docs/reference/agents/getLLM.md +2 -2
- package/.docs/reference/agents/getMetadata.md +2 -2
- package/.docs/reference/agents/inngest-agent.md +1 -1
- package/.docs/reference/agents/listScorers.md +1 -1
- package/.docs/reference/agents/listSkills.md +1 -1
- package/.docs/reference/agents/listSuspendedRuns.md +2 -2
- package/.docs/reference/agents/network.md +1 -1
- package/.docs/reference/ai-sdk/chat-route.md +1 -1
- package/.docs/reference/ai-sdk/network-route.md +1 -1
- package/.docs/reference/ai-sdk/to-ai-sdk-messages.md +1 -1
- package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +1 -1
- package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +1 -1
- package/.docs/reference/ai-sdk/workflow-route.md +1 -1
- package/.docs/reference/ai-sdk/workflow-snapshot-to-stream.md +2 -2
- package/.docs/reference/auth/auth0.md +1 -1
- package/.docs/reference/auth/fga.md +2 -2
- package/.docs/reference/auth/google.md +2 -2
- package/.docs/reference/auth/okta.md +1 -1
- package/.docs/reference/auth/workos.md +2 -2
- package/.docs/reference/browser/agent-browser.md +3 -3
- package/.docs/reference/browser/browser-viewer.md +4 -4
- package/.docs/reference/browser/firecrawl-browser.md +1 -1
- package/.docs/reference/browser/mastra-browser.md +4 -4
- package/.docs/reference/browser/stagehand-browser.md +8 -8
- package/.docs/reference/channels/slack-provider.md +2 -2
- package/.docs/reference/cli/create-mastra.md +1 -1
- package/.docs/reference/cli/mastra.md +155 -24
- package/.docs/reference/client-js/agents.md +26 -9
- package/.docs/reference/client-js/memory.md +2 -2
- package/.docs/reference/client-js/workflows.md +1 -1
- package/.docs/reference/coding-agent/build-base-prompt.md +2 -2
- package/.docs/reference/coding-agent/create-coding-agent.md +2 -2
- package/.docs/reference/configuration.md +7 -7
- package/.docs/reference/core/getAgentById.md +1 -1
- package/.docs/reference/core/getMCPServer.md +1 -1
- package/.docs/reference/core/getScorer.md +1 -1
- package/.docs/reference/core/mastra-class.md +48 -1
- package/.docs/reference/core/mastra-model-gateway.md +1 -1
- package/.docs/reference/datasets/addItem.md +1 -1
- package/.docs/reference/datasets/listItems.md +1 -1
- package/.docs/reference/deployer/netlify.md +4 -4
- package/.docs/reference/deployer/vercel.md +7 -7
- package/.docs/reference/editor/agent-builder/agent-builder-options.md +4 -4
- package/.docs/reference/editor/agent-builder/builder-agent-defaults.md +6 -6
- package/.docs/reference/editor/agent-builder/builder-models.md +3 -3
- package/.docs/reference/editor/blob-store-provider.md +1 -1
- package/.docs/reference/editor/browser-provider.md +3 -3
- package/.docs/reference/editor/filesystem-provider.md +4 -4
- package/.docs/reference/editor/mastra-editor.md +5 -5
- package/.docs/reference/editor/processor-provider.md +3 -3
- package/.docs/reference/editor/sandbox-provider.md +4 -4
- package/.docs/reference/editor/storage-browser-ref.md +6 -6
- package/.docs/reference/editor/storage-workspace-ref.md +4 -4
- package/.docs/reference/editor/tool-provider.md +1 -1
- package/.docs/reference/evals/answer-relevancy.md +5 -5
- package/.docs/reference/evals/answer-similarity.md +1 -1
- package/.docs/reference/evals/bias.md +4 -4
- package/.docs/reference/evals/checks.md +3 -3
- package/.docs/reference/evals/completeness.md +5 -5
- package/.docs/reference/evals/content-similarity.md +5 -5
- package/.docs/reference/evals/context-precision.md +5 -5
- package/.docs/reference/evals/context-recall.md +11 -11
- package/.docs/reference/evals/context-relevance.md +15 -15
- package/.docs/reference/evals/create-scorer.md +1 -1
- package/.docs/reference/evals/faithfulness.md +4 -4
- package/.docs/reference/evals/filter-run.md +2 -2
- package/.docs/reference/evals/hallucination.md +11 -11
- package/.docs/reference/evals/keyword-coverage.md +6 -6
- package/.docs/reference/evals/mastra-scorer.md +2 -2
- package/.docs/reference/evals/noise-sensitivity.md +15 -15
- package/.docs/reference/evals/prompt-alignment.md +20 -20
- package/.docs/reference/evals/rubric.md +2 -2
- package/.docs/reference/evals/run-evals.md +3 -3
- package/.docs/reference/evals/scorer-utils.md +4 -4
- package/.docs/reference/evals/textual-difference.md +4 -4
- package/.docs/reference/evals/tool-call-accuracy.md +4 -4
- package/.docs/reference/evals/toxicity.md +5 -5
- package/.docs/reference/evals/trajectory-accuracy.md +10 -10
- package/.docs/reference/file-based-agents/config.md +3 -3
- package/.docs/reference/file-based-agents/instructions.md +3 -3
- package/.docs/reference/file-based-agents/logger.md +1 -1
- package/.docs/reference/file-based-agents/observability.md +1 -1
- package/.docs/reference/file-based-agents/processors.md +1 -1
- package/.docs/reference/file-based-agents/skills.md +1 -1
- package/.docs/reference/file-based-agents/storage.md +1 -1
- package/.docs/reference/file-based-agents/studio.md +1 -1
- package/.docs/reference/file-based-agents/subagents.md +4 -4
- package/.docs/reference/file-based-agents/tools.md +1 -1
- package/.docs/reference/file-based-agents/workspace.md +1 -1
- package/.docs/reference/index.md +2 -0
- package/.docs/reference/logging/pino-logger.md +3 -3
- package/.docs/reference/memory/clone-utilities.md +1 -1
- package/.docs/reference/memory/cloneThread.md +3 -3
- package/.docs/reference/memory/listThreads.md +1 -1
- package/.docs/reference/memory/memory-class.md +4 -4
- package/.docs/reference/memory/observational-memory.md +15 -15
- package/.docs/reference/memory/recall.md +2 -2
- package/.docs/reference/memory/serialized-memory-config.md +4 -4
- package/.docs/reference/memory/summarizeConversation.md +3 -3
- package/.docs/reference/memory/summarizeThread.md +3 -3
- package/.docs/reference/observability/feedback.md +1 -1
- package/.docs/reference/observability/metrics/automatic-metrics.md +7 -7
- package/.docs/reference/observability/tracing/bridges/datadog.md +2 -2
- package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +3 -3
- package/.docs/reference/observability/tracing/exporters/default-exporter.md +1 -1
- package/.docs/reference/observability/tracing/exporters/langfuse.md +1 -1
- package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md +4 -4
- package/.docs/reference/observability/tracing/exporters/mastra-storage-exporter.md +1 -1
- package/.docs/reference/observability/tracing/interfaces.md +1 -1
- package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md +1 -1
- package/.docs/reference/observability/tracing/span-filtering.md +1 -1
- package/.docs/reference/processors/batch-parts-processor.md +1 -1
- package/.docs/reference/processors/cost-guard-processor.md +1 -1
- package/.docs/reference/processors/language-detector.md +1 -1
- package/.docs/reference/processors/message-history-processor.md +1 -1
- package/.docs/reference/processors/moderation-processor.md +2 -2
- package/.docs/reference/processors/pii-detector.md +3 -3
- package/.docs/reference/processors/processor-interface.md +13 -13
- package/.docs/reference/processors/prompt-injection-detector.md +2 -2
- package/.docs/reference/processors/provider-history-compat.md +1 -1
- package/.docs/reference/processors/regex-filter-processor.md +1 -1
- package/.docs/reference/processors/response-cache.md +8 -8
- package/.docs/reference/processors/semantic-recall-processor.md +1 -1
- package/.docs/reference/processors/skill-search-processor.md +1 -1
- package/.docs/reference/processors/system-prompt-scrubber.md +2 -2
- package/.docs/reference/processors/token-limiter-processor.md +4 -4
- package/.docs/reference/processors/tool-call-filter.md +2 -2
- package/.docs/reference/processors/tool-search-processor.md +9 -9
- package/.docs/reference/processors/unicode-normalizer.md +2 -2
- package/.docs/reference/processors/working-memory-processor.md +1 -1
- package/.docs/reference/project-structure.md +1 -1
- package/.docs/reference/pubsub/base.md +4 -4
- package/.docs/reference/pubsub/google-cloud-pubsub.md +2 -2
- package/.docs/reference/pubsub/lease-provider.md +4 -4
- package/.docs/reference/pubsub/redis-streams.md +1 -1
- package/.docs/reference/pubsub/unix-socket-pubsub.md +1 -1
- package/.docs/reference/rag/chunk.md +5 -5
- package/.docs/reference/rag/database-config.md +2 -2
- package/.docs/reference/rag/metadata-filters.md +2 -2
- package/.docs/reference/rag/rerank.md +1 -1
- package/.docs/reference/schedules/overview.md +1 -1
- package/.docs/reference/server/register-api-route.md +1 -1
- package/.docs/reference/server/routes.md +7 -7
- package/.docs/reference/signals/create-notification-inbox-tool.md +1 -1
- package/.docs/reference/signals/signal-provider.md +8 -8
- package/.docs/reference/storage/clickhouse.md +4 -4
- package/.docs/reference/storage/cloudflare-d1.md +4 -4
- package/.docs/reference/storage/convex.md +4 -4
- package/.docs/reference/storage/dsql.md +3 -3
- package/.docs/reference/storage/dynamodb.md +7 -7
- package/.docs/reference/storage/lance.md +1 -1
- package/.docs/reference/storage/mongodb.md +2 -2
- package/.docs/reference/storage/mssql.md +1 -1
- package/.docs/reference/storage/postgresql.md +2 -2
- package/.docs/reference/storage/redis.md +1 -1
- package/.docs/reference/storage/retention.md +33 -33
- package/.docs/reference/storage/spanner.md +8 -8
- package/.docs/reference/storage/upstash.md +1 -1
- package/.docs/reference/streaming/ChunkType.md +2 -2
- package/.docs/reference/streaming/agents/MastraModelOutput.md +1 -1
- package/.docs/reference/streaming/agents/stream.md +2 -2
- package/.docs/reference/streaming/agents/streamUntilIdle.md +2 -2
- package/.docs/reference/streaming/workflows/observeStream.md +1 -1
- package/.docs/reference/streaming/workflows/resumeStream.md +1 -1
- package/.docs/reference/streaming/workflows/stream.md +1 -1
- package/.docs/reference/streaming/workflows/timeTravelStream.md +2 -2
- package/.docs/reference/templates/overview.md +1 -1
- package/.docs/reference/tools/brightdata.md +1 -1
- package/.docs/reference/tools/create-code-mode.md +3 -3
- package/.docs/reference/tools/create-tool.md +1 -1
- package/.docs/reference/tools/graph-rag-tool.md +1 -1
- package/.docs/reference/tools/isolated-vm-transport.md +74 -0
- package/.docs/reference/tools/mcp-client.md +15 -15
- package/.docs/reference/tools/mcp-server.md +21 -21
- package/.docs/reference/tools/submit-plan-tool.md +1 -1
- package/.docs/reference/tools/tavily.md +1 -1
- package/.docs/reference/tools/vector-query-tool.md +5 -5
- package/.docs/reference/vectors/astra.md +1 -1
- package/.docs/reference/vectors/chroma.md +2 -2
- package/.docs/reference/vectors/convex.md +2 -2
- package/.docs/reference/vectors/couchbase.md +4 -4
- package/.docs/reference/vectors/libsql.md +2 -2
- package/.docs/reference/vectors/mongodb.md +3 -3
- package/.docs/reference/vectors/pg.md +5 -5
- package/.docs/reference/vectors/qdrant.md +2 -2
- package/.docs/reference/vectors/s3vectors.md +4 -4
- package/.docs/reference/vectors/turbopuffer.md +1 -1
- package/.docs/reference/vectors/upstash.md +1 -1
- package/.docs/reference/voice/aws-nova-sonic.md +1 -1
- package/.docs/reference/voice/azure.md +1 -1
- package/.docs/reference/voice/google-gemini-live.md +4 -4
- package/.docs/reference/voice/inworld-realtime.md +7 -7
- package/.docs/reference/voice/livekit.md +13 -13
- package/.docs/reference/voice/mistral.md +1 -1
- package/.docs/reference/voice/openai-realtime.md +1 -1
- package/.docs/reference/voice/sarvam.md +1 -1
- package/.docs/reference/voice/voice.addInstructions.md +1 -1
- package/.docs/reference/voice/voice.addTools.md +1 -1
- package/.docs/reference/voice/voice.events.md +1 -1
- package/.docs/reference/voice/voice.getSpeakers.md +2 -2
- package/.docs/reference/voice/voice.on.md +2 -2
- package/.docs/reference/voice/xai-realtime.md +2 -2
- package/.docs/reference/workers/overview.md +85 -0
- package/.docs/reference/workflows/run-methods/cancel.md +1 -1
- package/.docs/reference/workflows/run-methods/startAsync.md +1 -1
- package/.docs/reference/workflows/run-methods/timeTravel.md +1 -1
- package/.docs/reference/workflows/workflow-methods/foreach.md +1 -1
- package/.docs/reference/workflows/workflow-methods/sleep.md +1 -1
- package/.docs/reference/workflows/workflow-state-reader.md +2 -2
- package/.docs/reference/workspace/agentfs-filesystem.md +1 -1
- package/.docs/reference/workspace/apple-container-sandbox.md +2 -2
- package/.docs/reference/workspace/daytona-sandbox.md +3 -3
- package/.docs/reference/workspace/docker-sandbox.md +2 -2
- package/.docs/reference/workspace/e2b-sandbox.md +2 -2
- package/.docs/reference/workspace/files-sdk-filesystem.md +3 -3
- package/.docs/reference/workspace/google-drive-filesystem.md +4 -4
- package/.docs/reference/workspace/local-filesystem.md +3 -3
- package/.docs/reference/workspace/local-sandbox.md +3 -3
- package/.docs/reference/workspace/modal-sandbox.md +1 -1
- package/.docs/reference/workspace/platform-filesystem.md +3 -3
- package/.docs/reference/workspace/platform-sandbox.md +2 -2
- package/.docs/reference/workspace/process-manager.md +1 -1
- package/.docs/reference/workspace/railway-sandbox.md +4 -4
- package/.docs/reference/workspace/s3-filesystem.md +1 -1
- package/.docs/reference/workspace/sandbox.md +1 -1
- package/.docs/reference/workspace/vercel-sandbox.md +1 -1
- package/.docs/reference/workspace/workspace-class.md +10 -10
- package/CHANGELOG.md +21 -0
- package/package.json +3 -3
|
@@ -45,7 +45,7 @@ To migrate, replace all calls to `mastra.getAgents()` with `mastra.listAgents()`
|
|
|
45
45
|
|
|
46
46
|
### `RuntimeContext` to `RequestContext`
|
|
47
47
|
|
|
48
|
-
The `RuntimeContext` class has been renamed to `RequestContext` throughout the codebase.
|
|
48
|
+
The `RuntimeContext` class has been renamed to `RequestContext` throughout the codebase. The new name identifies the class as request-specific data and matches web framework conventions.
|
|
49
49
|
|
|
50
50
|
To migrate, update all imports and parameter names from `RuntimeContext`/`runtimeContext` to `RequestContext`/`requestContext`.
|
|
51
51
|
|
|
@@ -91,7 +91,7 @@ To migrate, replace property access with the corresponding getter methods.
|
|
|
91
91
|
|
|
92
92
|
### Voice methods moved to `agent.voice` namespace
|
|
93
93
|
|
|
94
|
-
Voice-related methods have
|
|
94
|
+
Voice-related methods have moved from the Agent class to the `agent.voice` namespace, which groups the voice APIs together.
|
|
95
95
|
|
|
96
96
|
To migrate, update voice method calls to use the `agent.voice` namespace.
|
|
97
97
|
|
|
@@ -112,7 +112,7 @@ To migrate, update voice method calls to use the `agent.voice` namespace.
|
|
|
112
112
|
|
|
113
113
|
### `agent.fetchMemory()` to `(await agent.getMemory()).recall()`
|
|
114
114
|
|
|
115
|
-
The `fetchMemory()` method has been replaced with
|
|
115
|
+
The `fetchMemory()` method has been replaced with an API that makes asynchronous memory access explicit.
|
|
116
116
|
|
|
117
117
|
To migrate, replace `fetchMemory()` calls with the new API.
|
|
118
118
|
|
|
@@ -167,7 +167,7 @@ Only update your imports if you want to standardize on one Zod version across yo
|
|
|
167
167
|
|
|
168
168
|
### Default options method renames for AI SDK versions
|
|
169
169
|
|
|
170
|
-
Default options methods have been renamed to
|
|
170
|
+
Default options methods have been renamed to distinguish legacy (AI SDK v4) APIs from AI SDK v5+ APIs. The method name now indicates which AI SDK version it targets.
|
|
171
171
|
|
|
172
172
|
To migrate, update method names based on which AI SDK version you're using.
|
|
173
173
|
|
|
@@ -184,7 +184,7 @@ To migrate, update method names based on which AI SDK version you're using.
|
|
|
184
184
|
|
|
185
185
|
### `modelSettings.abortSignal` to top-level `abortSignal`
|
|
186
186
|
|
|
187
|
-
The `abortSignal` option has
|
|
187
|
+
The `abortSignal` option has moved from `modelSettings` to the top level of stream and generate options. Execution control now sits outside model-specific settings.
|
|
188
188
|
|
|
189
189
|
To migrate, move `abortSignal` from `modelSettings` to the top level.
|
|
190
190
|
|
|
@@ -229,7 +229,7 @@ const agent = new Agent({
|
|
|
229
229
|
+ id: 'my-agent',
|
|
230
230
|
name: 'My Agent',
|
|
231
231
|
instructions: 'You are a helpful assistant',
|
|
232
|
-
model: 'openai/gpt-5.
|
|
232
|
+
model: 'openai/gpt-5.6-sol',
|
|
233
233
|
});
|
|
234
234
|
```
|
|
235
235
|
|
|
@@ -14,7 +14,7 @@ A new `mastra migrate` command helps run database migrations when upgrading Mast
|
|
|
14
14
|
npx mastra migrate
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
The command bundles your project
|
|
17
|
+
The command bundles your project and connects to your configured storage before running any necessary migrations. It currently supports migrating duplicate span entries that may prevent unique constraint creation.
|
|
18
18
|
|
|
19
19
|
See the [Storage migration guide](https://mastra.ai/guides/migrations/upgrade-to-v1/storage) for details on when this migration is needed.
|
|
20
20
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Client SDK
|
|
4
4
|
|
|
5
|
-
Client SDK changes align with server-side API updates including
|
|
5
|
+
Client SDK changes align with server-side API updates, including utility renames, updated pagination, and type naming conventions.
|
|
6
6
|
|
|
7
7
|
## Changed
|
|
8
8
|
|
|
@@ -126,7 +126,7 @@ To migrate, update type imports to use the new naming pattern.
|
|
|
126
126
|
|
|
127
127
|
### Pagination parameters from `offset/limit` to `page/perPage`
|
|
128
128
|
|
|
129
|
-
All client SDK methods that used `offset/limit` now use `page/perPage
|
|
129
|
+
All client SDK methods that used `offset/limit` now use `page/perPage`, matching page-based web pagination.
|
|
130
130
|
|
|
131
131
|
To migrate, update pagination parameters in all client SDK method calls. Example:
|
|
132
132
|
|
|
@@ -211,7 +211,7 @@ To migrate, use `runById()` instead, which now returns the same unified `Workflo
|
|
|
211
211
|
|
|
212
212
|
### `toAISdkFormat` function
|
|
213
213
|
|
|
214
|
-
The `toAISdkFormat()` function has been removed from `@mastra/ai-sdk`.
|
|
214
|
+
The `toAISdkFormat()` function has been removed from `@mastra/ai-sdk`. Use the stream conversion utilities shown below instead.
|
|
215
215
|
|
|
216
216
|
To migrate, use `toAISdkStream()` instead.
|
|
217
217
|
|
|
@@ -25,7 +25,7 @@ To migrate, replace all calls to `getScorers()` with `listScorers()`.
|
|
|
25
25
|
|
|
26
26
|
### `runExperiment` to `runEvals`
|
|
27
27
|
|
|
28
|
-
The `runExperiment()` function has been renamed to `runEvals()
|
|
28
|
+
The `runExperiment()` function has been renamed to `runEvals()` to identify that it runs evaluations.
|
|
29
29
|
|
|
30
30
|
To migrate, update function calls from `runExperiment` to `runEvals`.
|
|
31
31
|
|
|
@@ -152,7 +152,7 @@ import type {
|
|
|
152
152
|
|
|
153
153
|
### Message content structure to nested format
|
|
154
154
|
|
|
155
|
-
Tool invocations and text content are now accessed through a nested `content` object
|
|
155
|
+
Tool invocations and text content are now accessed through a nested `content` object instead of flat message properties. The nested structure matches the database message format and its types.
|
|
156
156
|
|
|
157
157
|
To migrate, access tool invocations via `message.content.toolInvocations` and text via `message.content.content` or use the `getTextContentFromMastraDBMessage()` helper.
|
|
158
158
|
|
|
@@ -260,7 +260,7 @@ To migrate, use `MastraDBMessage` for storage or AI SDK v5 message formats direc
|
|
|
260
260
|
|
|
261
261
|
### `processors` config from Memory constructor
|
|
262
262
|
|
|
263
|
-
The `processors` config option in the Memory constructor
|
|
263
|
+
The `processors` config option in the Memory constructor is no longer supported and throws an error. Configure processors at the Agent level, where processor behavior is scoped to agent execution.
|
|
264
264
|
|
|
265
265
|
To migrate, move processor configuration from Memory to Agent using `inputProcessors` and/or `outputProcessors`.
|
|
266
266
|
|
|
@@ -6,11 +6,11 @@
|
|
|
6
6
|
|
|
7
7
|
Mastra v1 was released in January 2026. We recommend starting any new projects with Mastra v1, or upgrading your existing project to continue receiving updates and support.
|
|
8
8
|
|
|
9
|
-
This guide
|
|
9
|
+
This guide covers the breaking changes when upgrading from Mastra 0.x to v1.0. The migration is organized by package and feature area to help you systematically update your codebase.
|
|
10
10
|
|
|
11
11
|
> **Need help?:** Need help with the migration? Join our [Discord community](https://discord.gg/BTYqqHKUrf) to ask questions.
|
|
12
12
|
|
|
13
|
-
> **Coming from Mastra Cloud?:** The legacy Mastra Cloud product has been replaced by the [Mastra platform](https://mastra.ai/docs/mastra-platform/overview), which splits hosting into two separate products: **Studio** (visual environment, observability) and **Server** (production API). Old Mastra Cloud access tokens don't work with Mastra platform
|
|
13
|
+
> **Coming from Mastra Cloud?:** The legacy Mastra Cloud product has been replaced by the [Mastra platform](https://mastra.ai/docs/mastra-platform/overview), which splits hosting into two separate products: **Studio** (visual environment, observability) and **Server** (production API). Old Mastra Cloud access tokens don't work with Mastra platform. Create new ones with `mastra auth tokens create`.
|
|
14
14
|
>
|
|
15
15
|
> If you upgrade to v1 packages without also migrating your `telemetry:` config to `observability:` and creating a Studio project, observability data will stop flowing. Follow the [Mastra Cloud migration guide](https://mastra.ai/guides/migrations/mastra-cloud) end to end.
|
|
16
16
|
|
|
@@ -18,7 +18,7 @@ This guide provides a comprehensive overview of breaking changes when upgrading
|
|
|
18
18
|
|
|
19
19
|
### Update all Mastra packages to `latest` tag
|
|
20
20
|
|
|
21
|
-
Use your package manager to update your project's versions.
|
|
21
|
+
Use your package manager to update your project's versions. Update **all** Mastra packages together to ensure compatibility (all `@mastra/*` packages and `mastra`).
|
|
22
22
|
|
|
23
23
|
Here's how you update the most commonly used packages:
|
|
24
24
|
|
|
@@ -27,7 +27,7 @@ import type { InputProcessor } from '@mastra/core/processors';
|
|
|
27
27
|
|
|
28
28
|
### Processor message types from `MastraMessageV2` to `MastraDBMessage`
|
|
29
29
|
|
|
30
|
-
Processor message types have changed from `MastraMessageV2` to `MastraDBMessage`.
|
|
30
|
+
Processor message types have changed from `MastraMessageV2` to `MastraDBMessage`. Processors and scorers now use the database message format and its types.
|
|
31
31
|
|
|
32
32
|
To migrate, update processor message type imports and usage.
|
|
33
33
|
|
|
@@ -39,7 +39,7 @@ Run the migration command which automatically deduplicates spans and adds the co
|
|
|
39
39
|
npx mastra migrate
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
The CLI bundles your project
|
|
42
|
+
The CLI bundles your project and connects to your configured storage before running the migration. It keeps the most complete record (based on `endTime` and attributes) when removing duplicates.
|
|
43
43
|
|
|
44
44
|
#### Option 2: Manual SQL (PostgreSQL)
|
|
45
45
|
|
|
@@ -144,7 +144,7 @@ To migrate, update your imports and instantiation:
|
|
|
144
144
|
});
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
> **Note:** If you're using a single store implementation (like `PostgresStore` or `LibSQLStore`) directly,
|
|
147
|
+
> **Note:** If you're using a single store implementation (like `PostgresStore` or `LibSQLStore`) directly, keep the existing configuration. This only affects code that explicitly uses `MastraStorage` for composite storage.
|
|
148
148
|
|
|
149
149
|
### Required `id` property for storage instances
|
|
150
150
|
|
|
@@ -168,7 +168,7 @@ const storage = new PostgresStore({
|
|
|
168
168
|
|
|
169
169
|
### Pagination from `offset/limit` to `page/perPage`
|
|
170
170
|
|
|
171
|
-
All pagination APIs now use `page` and `perPage` instead of `offset` and `limit
|
|
171
|
+
All pagination APIs now use `page` and `perPage` instead of `offset` and `limit`, matching page-based web pagination.
|
|
172
172
|
|
|
173
173
|
To migrate, update all pagination parameters from `offset/limit` to `page/perPage`. Note that `page` is 0-indexed.
|
|
174
174
|
|
|
@@ -388,9 +388,9 @@ To migrate, use the memory store, remove format parameters, and update code to w
|
|
|
388
388
|
|
|
389
389
|
### Vector store API from positional to named arguments
|
|
390
390
|
|
|
391
|
-
All vector store methods now use
|
|
391
|
+
All vector store methods now use an arguments object instead of positional arguments. This makes each value's purpose visible at the call site and lets method signatures evolve without relying on argument order.
|
|
392
392
|
|
|
393
|
-
To migrate, update all vector store method calls to use
|
|
393
|
+
To migrate, update all vector store method calls to use an arguments object.
|
|
394
394
|
|
|
395
395
|
```diff
|
|
396
396
|
- await vectorDB.createIndex(indexName, 3, 'cosine');
|
|
@@ -417,9 +417,9 @@ To migrate, update all vector store method calls to use named arguments.
|
|
|
417
417
|
|
|
418
418
|
### Vector store method renames
|
|
419
419
|
|
|
420
|
-
The `updateIndexById` and `deleteIndexById` methods have been renamed to `updateVector` and `deleteVector` respectively.
|
|
420
|
+
The `updateIndexById` and `deleteIndexById` methods have been renamed to `updateVector` and `deleteVector` respectively. The new names identify that these methods operate on vectors.
|
|
421
421
|
|
|
422
|
-
To migrate, rename the methods and
|
|
422
|
+
To migrate, rename the methods and pass an arguments object.
|
|
423
423
|
|
|
424
424
|
```diff
|
|
425
425
|
- await vectorDB.updateIndexById(indexName, id, update);
|
|
@@ -449,9 +449,9 @@ To migrate, pass the connection string as an object property.
|
|
|
449
449
|
|
|
450
450
|
### PGVector `defineIndex` to `buildIndex`
|
|
451
451
|
|
|
452
|
-
The `defineIndex()` method has been removed in favor of `buildIndex()
|
|
452
|
+
The `defineIndex()` method has been removed in favor of `buildIndex()`, which identifies that the method builds an index.
|
|
453
453
|
|
|
454
|
-
To migrate, rename the method and
|
|
454
|
+
To migrate, rename the method and pass an arguments object.
|
|
455
455
|
|
|
456
456
|
```diff
|
|
457
457
|
- await vectorDB.defineIndex(indexName, 'cosine', { type: 'flat' });
|
|
@@ -464,7 +464,7 @@ To migrate, rename the method and use named arguments.
|
|
|
464
464
|
|
|
465
465
|
### `PostgresStore`: `schema` to `schemaName`
|
|
466
466
|
|
|
467
|
-
The `schema` parameter has been renamed to `schemaName` in the PostgresStore constructor.
|
|
467
|
+
The `schema` parameter has been renamed to `schemaName` in the PostgresStore constructor. The new name identifies the value as the database schema's name.
|
|
468
468
|
|
|
469
469
|
To migrate, rename the parameter.
|
|
470
470
|
|
|
@@ -521,7 +521,7 @@ To migrate, use paginated methods via domain stores. For fetching all records, u
|
|
|
521
521
|
|
|
522
522
|
### `getTraces` and `getTracesPaginated`
|
|
523
523
|
|
|
524
|
-
The `getTraces()` and `getTracesPaginated()` methods have been removed from storage.
|
|
524
|
+
The `getTraces()` and `getTracesPaginated()` methods have been removed from storage. Use the observability package to access traces instead of core storage.
|
|
525
525
|
|
|
526
526
|
To migrate, use observability storage methods instead.
|
|
527
527
|
|
|
@@ -8,9 +8,9 @@ Tool execution signatures have been updated to use separate input and context pa
|
|
|
8
8
|
|
|
9
9
|
### `createTool` execute signature to `(inputData, context)` format
|
|
10
10
|
|
|
11
|
-
All `createTool` execute functions now use a
|
|
11
|
+
All `createTool` execute functions now use a signature with separate `inputData` and `context` parameters instead of a single destructured object. Tool inputs and execution context are now passed independently.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
This signature change only applies to `createTool`. For workflow `createStep` calls, keep the `async (inputData, context)` signature.
|
|
14
14
|
|
|
15
15
|
To migrate, update `createTool` signatures to use `inputData` as the first parameter (typed from `inputSchema`) and `context` as the second parameter.
|
|
16
16
|
|
|
@@ -88,7 +88,7 @@ To skip the `suspendSchema` or `resumeSchema` validation, don't define `suspendS
|
|
|
88
88
|
|
|
89
89
|
### `RuntimeContext` to `RequestContext`
|
|
90
90
|
|
|
91
|
-
The `RuntimeContext` class has been renamed to `RequestContext` throughout the tool execution context.
|
|
91
|
+
The `RuntimeContext` class has been renamed to `RequestContext` throughout the tool execution context. The new name identifies the class as request-specific data.
|
|
92
92
|
|
|
93
93
|
To migrate, update references from `runtimeContext` to `requestContext` in tool execution functions.
|
|
94
94
|
|
|
@@ -6,9 +6,9 @@ The observability system has been restructured in v1 with a dedicated `@mastra/o
|
|
|
6
6
|
|
|
7
7
|
> **Observability data stops flowing on upgrade:** If you upgrade Mastra packages to v1 without migrating your `telemetry:` config to `observability:`, the old config is ignored at runtime. Your service will start cleanly with no error, but **no traces, logs, or metrics will be sent anywhere**. If you were sending data to Mastra Cloud, the dashboard will go empty.
|
|
8
8
|
>
|
|
9
|
-
> Complete this migration in the same change that bumps your Mastra packages, and verify traces appear in [Mastra Studio](https://mastra.ai/docs/studio/observability) before considering the upgrade complete. If you previously hosted on Mastra Cloud, also follow the [Mastra Cloud migration guide](https://mastra.ai/guides/migrations/mastra-cloud)
|
|
9
|
+
> Complete this migration in the same change that bumps your Mastra packages, and verify traces appear in [Mastra Studio](https://mastra.ai/docs/studio/observability) before considering the upgrade complete. If you previously hosted on Mastra Cloud, also follow the [Mastra Cloud migration guide](https://mastra.ai/guides/migrations/mastra-cloud). The new platform requires a new access token and a Studio project before `MastraPlatformExporter` can route data to it.
|
|
10
10
|
|
|
11
|
-
> **Exporter rename:** `MastraPlatformExporter` (sends data to Mastra platform) replaces the previous `CloudExporter`, and `MastraStorageExporter` (persists data to Mastra Storage) replaces the previous `DefaultExporter`. The original classes
|
|
11
|
+
> **Exporter rename:** `MastraPlatformExporter` (sends data to Mastra platform) replaces the previous `CloudExporter`, and `MastraStorageExporter` (persists data to Mastra Storage) replaces the previous `DefaultExporter`. The original classes remain available from `@mastra/observability` and behave identically, but they're deprecated. New code should use `MastraPlatformExporter` and `MastraStorageExporter`. Existing imports of `CloudExporter` or `DefaultExporter` continue to work until they're removed in a future major version.
|
|
12
12
|
|
|
13
13
|
## Migration paths
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@ Voice packages have been renamed from speech to voice with updated class names a
|
|
|
8
8
|
|
|
9
9
|
### Voice configuration property names
|
|
10
10
|
|
|
11
|
-
Voice configuration properties have been renamed for consistency. `speakProvider` is now `output`, `listenProvider` is now `input`, and `realtimeProvider` is now `realtime`.
|
|
11
|
+
Voice configuration properties have been renamed for consistency. `speakProvider` is now `output`, `listenProvider` is now `input`, and `realtimeProvider` is now `realtime`. The new names match each property's role in voice input and output.
|
|
12
12
|
|
|
13
13
|
To migrate, update configuration property names when configuring agents with voice capabilities.
|
|
14
14
|
|
|
@@ -65,7 +65,7 @@ To migrate, rename method calls from `createRunAsync` to `createRun`.
|
|
|
65
65
|
|
|
66
66
|
### `runCount` to `retryCount` (deprecated)
|
|
67
67
|
|
|
68
|
-
The `runCount` parameter has been deprecated in favor of `retryCount` in workflow step execution.
|
|
68
|
+
The `runCount` parameter has been deprecated in favor of `retryCount` in workflow step execution. The new name identifies the value as the number of retries. The old `runCount` still works but shows deprecation warnings.
|
|
69
69
|
|
|
70
70
|
To migrate, rename `runCount` to `retryCount` in step execution functions.
|
|
71
71
|
|
|
@@ -161,7 +161,7 @@ The following options are available in the standard `.stream()` and `generate()`
|
|
|
161
161
|
name: z.string(),
|
|
162
162
|
age: z.number(),
|
|
163
163
|
}),
|
|
164
|
-
model: 'openai/gpt-5.
|
|
164
|
+
model: 'openai/gpt-5.6-sol', // Optional model override for structuring
|
|
165
165
|
errorStrategy: 'fallback',
|
|
166
166
|
fallbackValue: { name: 'unknown', age: 0 },
|
|
167
167
|
instructions: 'Extract user information', // Override default structuring instructions
|
|
@@ -299,7 +299,7 @@ The following options are available in the standard `.stream()` and `generate()`
|
|
|
299
299
|
schema: z.object({
|
|
300
300
|
summary: z.string(),
|
|
301
301
|
}),
|
|
302
|
-
model: 'openai/gpt-5.
|
|
302
|
+
model: 'openai/gpt-5.6-sol',
|
|
303
303
|
},
|
|
304
304
|
})
|
|
305
305
|
```
|
|
@@ -89,6 +89,7 @@ List of required environment variables for each model provider and gateway suppo
|
|
|
89
89
|
| [Mistral](https://mastra.ai/models/providers/mistral) | `mistral/*` | `MISTRAL_API_KEY` |
|
|
90
90
|
| [Mixlayer](https://mastra.ai/models/providers/mixlayer) | `mixlayer/*` | `MIXLAYER_API_KEY` |
|
|
91
91
|
| [Moark](https://mastra.ai/models/providers/moark) | `moark/*` | `MOARK_API_KEY` |
|
|
92
|
+
| [Modal](https://mastra.ai/models/providers/modal) | `modal/*` | `MODAL_PROXY_TOKEN` |
|
|
92
93
|
| [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai) | `model-oracle-ai/*` | `MODEL_ORACLE_API_KEY` |
|
|
93
94
|
| [ModelScope](https://mastra.ai/models/providers/modelscope) | `modelscope/*` | `MODELSCOPE_API_KEY` |
|
|
94
95
|
| [Moonshot AI](https://mastra.ai/models/providers/moonshotai) | `moonshotai/*` | `MOONSHOT_API_KEY` |
|
|
@@ -35,7 +35,7 @@ const myPrivateGateway: MastraModelGatewayInterface = {
|
|
|
35
35
|
return {
|
|
36
36
|
'my-provider': {
|
|
37
37
|
name: 'My Provider',
|
|
38
|
-
models: ['openai/gpt-5.
|
|
38
|
+
models: ['openai/gpt-5.6-sol'],
|
|
39
39
|
apiKeyEnvVar: 'MY_API_KEY',
|
|
40
40
|
gateway: 'private',
|
|
41
41
|
url: 'https://api.myprovider.com/v1',
|
|
@@ -81,7 +81,7 @@ class MyPrivateGateway extends MastraModelGateway {
|
|
|
81
81
|
return {
|
|
82
82
|
'my-provider': {
|
|
83
83
|
name: 'My Provider',
|
|
84
|
-
models: ['openai/gpt-5.
|
|
84
|
+
models: ['openai/gpt-5.6-sol', 'anthropic/claude-sonnet-4-6'],
|
|
85
85
|
apiKeyEnvVar: 'MY_API_KEY',
|
|
86
86
|
gateway: this.id,
|
|
87
87
|
url: 'https://api.myprovider.com/v1',
|
|
@@ -192,7 +192,7 @@ const agent = new Agent({
|
|
|
192
192
|
id: 'my-agent',
|
|
193
193
|
name: 'My Agent',
|
|
194
194
|
instructions: 'You are a helpful assistant',
|
|
195
|
-
model: 'private/my-provider/openai/gpt-5.
|
|
195
|
+
model: 'private/my-provider/openai/gpt-5.6-sol', // Uses MyPrivateGateway
|
|
196
196
|
});
|
|
197
197
|
|
|
198
198
|
mastra.addAgent(agent, 'myAgent');
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenRouter
|
|
4
4
|
|
|
5
|
-
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
5
|
+
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 338 models through Mastra's model router.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
|
|
8
8
|
|
|
@@ -282,8 +282,6 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
282
282
|
| `perplexity/sonar-pro` |
|
|
283
283
|
| `perplexity/sonar-pro-search` |
|
|
284
284
|
| `perplexity/sonar-reasoning-pro` |
|
|
285
|
-
| `poolside/laguna-m.1` |
|
|
286
|
-
| `poolside/laguna-m.1:free` |
|
|
287
285
|
| `poolside/laguna-s-2.1` |
|
|
288
286
|
| `poolside/laguna-s-2.1:free` |
|
|
289
287
|
| `poolside/laguna-xs-2.1` |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Vercel
|
|
4
4
|
|
|
5
|
-
Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
5
|
+
Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 307 models through Mastra's model router.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
|
|
8
8
|
|
|
@@ -61,6 +61,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
61
61
|
| `alibaba/qwen3.5-plus` |
|
|
62
62
|
| `alibaba/qwen3.6-27b` |
|
|
63
63
|
| `alibaba/qwen3.6-plus` |
|
|
64
|
+
| `alibaba/qwen3.7-flash` |
|
|
64
65
|
| `alibaba/qwen3.7-max` |
|
|
65
66
|
| `alibaba/qwen3.7-plus` |
|
|
66
67
|
| `alibaba/wan-v2.5-t2v-preview` |
|
package/.docs/models/index.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Model Providers
|
|
4
4
|
|
|
5
|
-
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to
|
|
5
|
+
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5118 models from 163 providers through a single API.
|
|
6
6
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
@@ -29,7 +29,7 @@ const agent = new Agent({
|
|
|
29
29
|
id: "my-agent",
|
|
30
30
|
name: "My Agent",
|
|
31
31
|
instructions: "You are a helpful assistant",
|
|
32
|
-
model: "openai/gpt-5.
|
|
32
|
+
model: "openai/gpt-5.6-sol"
|
|
33
33
|
})
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -110,7 +110,7 @@ const documentProcessor = new Agent({
|
|
|
110
110
|
id: "document-processor",
|
|
111
111
|
name: "Document Processor",
|
|
112
112
|
instructions: "Extract and summarize key information from documents",
|
|
113
|
-
model: "openai/gpt-5.
|
|
113
|
+
model: "openai/gpt-5.6-sol"
|
|
114
114
|
})
|
|
115
115
|
|
|
116
116
|
// Use a powerful reasoning model for complex analysis
|
|
@@ -160,7 +160,7 @@ const planner = new Agent({
|
|
|
160
160
|
openai: { reasoningEffort: "low" }
|
|
161
161
|
}
|
|
162
162
|
},
|
|
163
|
-
model: "openai/gpt-5.
|
|
163
|
+
model: "openai/gpt-5.6-sol",
|
|
164
164
|
});
|
|
165
165
|
|
|
166
166
|
const lowEffort =
|
|
@@ -187,7 +187,7 @@ const agent = new Agent({
|
|
|
187
187
|
id: "custom-agent",
|
|
188
188
|
name: "Custom Agent",
|
|
189
189
|
model: {
|
|
190
|
-
id: "openai/gpt-5.
|
|
190
|
+
id: "openai/gpt-5.6-sol",
|
|
191
191
|
apiKey: process.env.OPENAI_API_KEY,
|
|
192
192
|
headers: {
|
|
193
193
|
"OpenAI-Organization": "org-abc123"
|
|
@@ -211,7 +211,7 @@ const agent = new Agent({
|
|
|
211
211
|
instructions: 'You are a helpful assistant.',
|
|
212
212
|
model: [
|
|
213
213
|
{
|
|
214
|
-
model: "openai/gpt-5.
|
|
214
|
+
model: "openai/gpt-5.6-sol",
|
|
215
215
|
maxRetries: 3,
|
|
216
216
|
},
|
|
217
217
|
{
|
|
@@ -48,7 +48,7 @@ for await (const chunk of stream) {
|
|
|
48
48
|
| `baseten/zai-org/GLM-4.7` | 200K | | | | | | $0.60 | $2 |
|
|
49
49
|
| `baseten/zai-org/GLM-5` | 203K | | | | | | $0.95 | $3 |
|
|
50
50
|
| `baseten/zai-org/GLM-5.1` | 203K | | | | | | $1 | $4 |
|
|
51
|
-
| `baseten/zai-org/GLM-5.2` |
|
|
51
|
+
| `baseten/zai-org/GLM-5.2` | 1.0M | | | | | | $1 | $4 |
|
|
52
52
|
| `baseten/zai-org/GLM-5.2-Fast` | 524K | | | | | | $2 | $7 |
|
|
53
53
|
|
|
54
54
|
## Advanced configuration
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Chutes
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 15 Chutes models through Mastra's model router. Authentication is handled automatically using the `CHUTES_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Chutes documentation](https://llm.chutes.ai).
|
|
8
8
|
|
|
@@ -41,6 +41,7 @@ for await (const chunk of stream) {
|
|
|
41
41
|
| `chutes/MiniMaxAI/MiniMax-M2.5-TEE` | 197K | | | | | | $0.15 | $1 |
|
|
42
42
|
| `chutes/moonshotai/Kimi-K2.5-TEE` | 262K | | | | | | $0.44 | $2 |
|
|
43
43
|
| `chutes/moonshotai/Kimi-K2.6-TEE` | 262K | | | | | | $0.66 | $4 |
|
|
44
|
+
| `chutes/moonshotai/Kimi-K3-TEE` | 1.0M | | | | | | $3 | $15 |
|
|
44
45
|
| `chutes/Nemotron-3-Nano-Omni-30B-TEE` | 131K | | | | | | $0.02 | $0.10 |
|
|
45
46
|
| `chutes/Qwen/Qwen3-235B-A22B-Thinking-2507-TEE` | 262K | | | | | | $0.30 | $1 |
|
|
46
47
|
| `chutes/Qwen/Qwen3-32B-TEE` | 41K | | | | | | $0.10 | $0.42 |
|
|
@@ -68,8 +68,8 @@ for await (const chunk of stream) {
|
|
|
68
68
|
| `crossmodel/openai/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
|
|
69
69
|
| `crossmodel/qwen/qwen3.6-flash` | 1.0M | | | | | | $0.19 | $1 |
|
|
70
70
|
| `crossmodel/qwen/qwen3.6-plus` | 1.0M | | | | | | $0.32 | $2 |
|
|
71
|
-
| `crossmodel/qwen/qwen3.7-max` | 1.0M | | | | | | $2 | $
|
|
72
|
-
| `crossmodel/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.
|
|
71
|
+
| `crossmodel/qwen/qwen3.7-max` | 1.0M | | | | | | $2 | $5 |
|
|
72
|
+
| `crossmodel/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.29 | $1 |
|
|
73
73
|
| `crossmodel/tencent/hy3` | 262K | | | | | | $0.16 | $0.64 |
|
|
74
74
|
| `crossmodel/tencent/hy3-preview` | 262K | | | | | | $0.19 | $0.63 |
|
|
75
75
|
| `crossmodel/x-ai/grok-4.3` | 1.0M | | | | | | $1 | $3 |
|
|
@@ -62,7 +62,7 @@ for await (const chunk of stream) {
|
|
|
62
62
|
| `deepinfra/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.45 | $3 |
|
|
63
63
|
| `deepinfra/Qwen/Qwen3.5-9B` | 262K | | | | | | $0.10 | $0.15 |
|
|
64
64
|
| `deepinfra/Qwen/Qwen3.6-27B` | 262K | | | | | | $0.32 | $3 |
|
|
65
|
-
| `deepinfra/Qwen/Qwen3.6-35B-A3B` | 262K | | | | | | $0.
|
|
65
|
+
| `deepinfra/Qwen/Qwen3.6-35B-A3B` | 262K | | | | | | $0.10 | $0.95 |
|
|
66
66
|
| `deepinfra/Qwen/Qwen3.7-Max` | 256K | | | | | | $3 | $8 |
|
|
67
67
|
| `deepinfra/XiaomiMiMo/MiMo-V2.5` | 262K | | | | | | $0.40 | $2 |
|
|
68
68
|
| `deepinfra/XiaomiMiMo/MiMo-V2.5-Pro` | 1.0M | | | | | | $1 | $3 |
|
|
@@ -38,17 +38,17 @@ for await (const chunk of stream) {
|
|
|
38
38
|
| ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `hyper/deepseek-v4-flash` | 1.0M | | | | | | $0.20 | $0.40 |
|
|
40
40
|
| `hyper/deepseek-v4-pro` | 1.0M | | | | | | $2 | $5 |
|
|
41
|
-
| `hyper/gemma-4-26b-a4b-it` | 256K | | | | | | $0.
|
|
41
|
+
| `hyper/gemma-4-26b-a4b-it` | 256K | | | | | | $0.12 | $0.41 |
|
|
42
42
|
| `hyper/glm-5` | 203K | | | | | | $0.81 | $3 |
|
|
43
43
|
| `hyper/glm-5.1` | 203K | | | | | | $2 | $5 |
|
|
44
44
|
| `hyper/glm-5.2` | 1.0M | | | | | | $1 | $4 |
|
|
45
|
-
| `hyper/gpt-oss-120b` | 131K | | | | | | $0.18 | $0.
|
|
45
|
+
| `hyper/gpt-oss-120b` | 131K | | | | | | $0.18 | $0.68 |
|
|
46
46
|
| `hyper/kimi-k2.5` | 262K | | | | | | $0.53 | $3 |
|
|
47
47
|
| `hyper/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
48
48
|
| `hyper/kimi-k2.7-code` | 256K | | | | | | $0.95 | $4 |
|
|
49
49
|
| `hyper/llama-3.3-70b-instruct` | 128K | | | | | | $0.61 | $1 |
|
|
50
50
|
| `hyper/llama-4-maverick-17b-128e-instruct-fp8` | 430K | | | | | | $0.28 | $0.93 |
|
|
51
|
-
| `hyper/minimax-m2.7` | 205K | | | | | | $0.
|
|
51
|
+
| `hyper/minimax-m2.7` | 205K | | | | | | $0.41 | $2 |
|
|
52
52
|
| `hyper/qwen3-coder-480b-a35b-instruct-int4-mixed-ar` | 106K | | | | | | $0.57 | $2 |
|
|
53
53
|
| `hyper/qwen3-next-80b-a3b-instruct` | 262K | | | | | | $0.12 | $1 |
|
|
54
54
|
| `hyper/qwen3.6-flash` | 1.0M | | | | | | $1 | $4 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# LLM Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 186 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
|
|
8
8
|
|
|
@@ -200,9 +200,9 @@ for await (const chunk of stream) {
|
|
|
200
200
|
| `llmgateway/qwen3-max` | 262K | | | | | | $0.84 | $3 |
|
|
201
201
|
| `llmgateway/qwen3-next-80b-a3b-instruct` | 131K | | | | | | $0.15 | $1 |
|
|
202
202
|
| `llmgateway/qwen3-next-80b-a3b-thinking` | 131K | | | | | | $0.15 | $1 |
|
|
203
|
-
| `llmgateway/qwen3-vl-235b-a22b-instruct` |
|
|
203
|
+
| `llmgateway/qwen3-vl-235b-a22b-instruct` | 262K | | | | | | $0.20 | $0.88 |
|
|
204
204
|
| `llmgateway/qwen3-vl-235b-a22b-thinking` | 131K | | | | | | $0.98 | $4 |
|
|
205
|
-
| `llmgateway/qwen3-vl-30b-a3b-instruct` |
|
|
205
|
+
| `llmgateway/qwen3-vl-30b-a3b-instruct` | 262K | | | | | | $0.15 | $0.60 |
|
|
206
206
|
| `llmgateway/qwen3-vl-flash` | 262K | | | | | | $0.05 | $0.40 |
|
|
207
207
|
| `llmgateway/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
|
|
208
208
|
| `llmgateway/qwen3.5-9b` | 262K | | | | | | $0.10 | $0.15 |
|
|
@@ -210,6 +210,7 @@ for await (const chunk of stream) {
|
|
|
210
210
|
| `llmgateway/qwen3.6-flash` | 262K | | | | | | $0.15 | $0.90 |
|
|
211
211
|
| `llmgateway/qwen3.6-max-preview` | 262K | | | | | | $1 | $8 |
|
|
212
212
|
| `llmgateway/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
|
|
213
|
+
| `llmgateway/qwen3.7-flash` | 1.0M | | | | | | $0.03 | $0.13 |
|
|
213
214
|
| `llmgateway/qwen3.7-max` | 1.0M | | | | | | $1 | $4 |
|
|
214
215
|
| `llmgateway/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
|
|
215
216
|
| `llmgateway/qwen35-397b-a17b` | 262K | | | | | | $0.60 | $4 |
|