@mastra/mcp-docs-server 1.0.0-beta.14 → 1.0.0-beta.15

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.
Files changed (57) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +10 -10
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +51 -51
  3. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +195 -195
  4. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +76 -76
  5. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +195 -195
  6. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +195 -195
  7. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +218 -0
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +308 -308
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +19 -19
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +27 -27
  11. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +195 -195
  12. package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
  13. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  14. package/.docs/organized/changelogs/%40mastra%2Flance.md +195 -195
  15. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +195 -195
  16. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +8 -8
  17. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +128 -128
  18. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +219 -219
  19. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +219 -219
  20. package/.docs/organized/changelogs/%40mastra%2Fpg.md +235 -235
  21. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +81 -81
  22. package/.docs/organized/changelogs/%40mastra%2Freact.md +70 -70
  23. package/.docs/organized/changelogs/%40mastra%2Fserver.md +125 -125
  24. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +195 -195
  25. package/.docs/organized/changelogs/create-mastra.md +11 -11
  26. package/.docs/organized/changelogs/mastra.md +40 -40
  27. package/.docs/organized/code-examples/agent-v6.md +70 -11
  28. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  29. package/.docs/raw/agents/adding-voice.mdx +8 -3
  30. package/.docs/raw/deployment/overview.mdx +3 -4
  31. package/.docs/raw/deployment/workflow-runners.mdx +14 -0
  32. package/.docs/raw/getting-started/studio.mdx +1 -1
  33. package/.docs/raw/guides/deployment/inngest.mdx +198 -140
  34. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +11 -3
  35. package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
  36. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +41 -0
  37. package/.docs/raw/mastra-cloud/deployment.mdx +39 -0
  38. package/.docs/raw/mastra-cloud/observability.mdx +9 -15
  39. package/.docs/raw/mastra-cloud/overview.mdx +14 -44
  40. package/.docs/raw/mastra-cloud/setup.mdx +64 -0
  41. package/.docs/raw/mastra-cloud/studio.mdx +35 -0
  42. package/.docs/raw/reference/logging/pino-logger.mdx +1 -1
  43. package/.docs/raw/reference/processors/token-limiter-processor.mdx +39 -18
  44. package/.docs/raw/reference/storage/cloudflare-d1.mdx +4 -2
  45. package/.docs/raw/reference/storage/lance.mdx +3 -2
  46. package/.docs/raw/reference/storage/libsql.mdx +5 -2
  47. package/.docs/raw/reference/storage/mongodb.mdx +4 -2
  48. package/.docs/raw/reference/storage/mssql.mdx +4 -2
  49. package/.docs/raw/reference/storage/postgresql.mdx +4 -2
  50. package/.docs/raw/voice/overview.mdx +1 -1
  51. package/.docs/raw/workflows/overview.mdx +1 -1
  52. package/.docs/raw/workflows/snapshots.mdx +2 -1
  53. package/CHANGELOG.md +7 -0
  54. package/package.json +4 -4
  55. package/.docs/raw/mastra-cloud/dashboard.mdx +0 -96
  56. package/.docs/raw/mastra-cloud/setting-up.mdx +0 -106
  57. package/.docs/raw/workflows/inngest-workflow.mdx +0 -362
@@ -1,46 +1,40 @@
1
1
  ---
2
- title: "Understanding Tracing and Logs | Mastra Cloud"
2
+ title: "Observability | Mastra Cloud"
3
3
  description: Monitoring and debugging tools for Mastra Cloud deployments
4
4
  ---
5
5
 
6
- # Understanding Tracing and Logs
6
+ # Observability
7
7
 
8
- Mastra Cloud provides full observability for production applications, giving you insight into how your agents and workflows behave. Observability can be enabled whether your application is deployed to Mastra Cloud, running locally, or hosted on your own infrastructure. Any Mastra project can send traces and logs to the platform regardless of where it's running.
8
+ Cloud provides observability for production applications, giving you insight into how your agents and workflows behave. Observability works whether your application is deployed to Mastra Cloud, running locally, or hosted on your own infrastructure. Any Mastra project can send traces and logs to the platform regardless of where it's running.
9
9
 
10
10
  For details on configuring observability, see the [Cloud Exporter](/docs/v1/observability/tracing/exporters/cloud) docs.
11
11
 
12
12
  ## Traces
13
13
 
14
- More detailed traces are available for both agents and workflows by enabling [observability](/docs/v1/observability/tracing/overview) using one of our [supported providers](/docs/v1/observability/tracing/overview#exporters).
14
+ Traces are available for both agents and workflows by enabling [observability](/docs/v1/observability/tracing/overview) using one of the [supported providers](/docs/v1/observability/tracing/overview#exporters).
15
15
 
16
16
  ### Agents
17
17
 
18
- With observability enabled, you can view detailed outputs from your agents in the **Traces** section in Studio.
18
+ With observability enabled, you can view detailed outputs from your agents in the **Traces** section in [Studio](/docs/v1/mastra-cloud/studio).
19
19
 
20
20
  ![observability agents](/img/mastra-cloud/mastra-cloud-observability-agents.jpg)
21
21
 
22
- Key features:
23
-
24
- Agent traces break a run into clear steps, model calls, tool calls, and intermediate chunks, each with timing, inputs, outputs, and errors. You can drill into any span to inspect prompts, token usage, and results, making it easy to diagnose issues and understand how the agent produced its output.
22
+ Agent traces break a run into clear steps: model calls, tool calls, and intermediate chunks. Each includes timing, inputs, outputs, and errors. Drill into any span to inspect prompts, token usage, and results.
25
23
 
26
24
  ### Workflows
27
25
 
28
- With observability enabled, you can view detailed outputs from your workflows in the **Traces** section in Studio.
26
+ With observability enabled, you can view detailed outputs from your workflows in the **Traces** section in [Studio](/docs/v1/mastra-cloud/studio).
29
27
 
30
28
  ![observability workflows](/img/mastra-cloud/mastra-cloud-observability-workflows.jpg)
31
29
 
32
- Key features:
33
-
34
- Workflow traces capture each step in the run, including transitions, branching, timing, and any tool calls inside the workflow. You can inspect inputs, outputs, and errors for every step, making it easy to debug long-running or multi-step processes and understand how data flows through the workflow.
30
+ Workflow traces capture each step in the run, including transitions, branching, timing, and any tool calls. Inspect inputs, outputs, and errors for every step to debug long-running or multi-step processes.
35
31
 
36
32
  ## Logs
37
33
 
38
- You can view detailed logs for debugging and monitoring your application's behavior on the [Logs](/docs/v1/mastra-cloud/dashboard#logs) page of the Dashboard.
34
+ The **Logs** page in the [project dashboard](/docs/v1/mastra-cloud/deployment#project-dashboard) displays detailed information for debugging and monitoring your application's behavior.
39
35
 
40
36
  ![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
41
37
 
42
- Key features:
43
-
44
38
  Each log entry includes its severity level and a detailed message showing agent, workflow, or storage activity.
45
39
 
46
40
  ## Next steps
@@ -5,57 +5,27 @@ description: Deployment and monitoring service for Mastra applications
5
5
 
6
6
  # Mastra Cloud
7
7
 
8
- [Mastra Cloud](https://mastra.ai/cloud) is a platform for deploying, managing, monitoring, and debugging Mastra applications. When you [deploy](/docs/v1/mastra-cloud/setting-up) your application, Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
8
+ [Mastra Cloud](https://cloud.mastra.ai) is a platform for deploying, managing, and monitoring Mastra applications. [Import your project](/docs/v1/mastra-cloud/setup) to get started.
9
9
 
10
- ## Platform features
10
+ ## Studio
11
11
 
12
- Deploy and manage your applications with automated builds, organized projects, and no additional configuration.
12
+ Run [Studio](/docs/v1/mastra-cloud/studio) in the cloud and share access with your team via a link. Team members can test agents and workflows, tweak system prompts, and give feedback without running the project locally.
13
13
 
14
- ![Platform features](/img/mastra-cloud/mastra-cloud-platform-features.jpg)
14
+ ## Deploy
15
15
 
16
- Key features:
16
+ Enable [deployments](/docs/v1/mastra-cloud/deployment) and Mastra Cloud hosts your server for you. Connect your GitHub repository for automatic deployments whenever you push to your configured branch. Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
17
17
 
18
- Mastra Cloud supports zero-config deployment, continuous integration with GitHub, and atomic deployments that package agents, tools, and workflows together.
18
+ Once deployed, the project dashboard gives you visibility into:
19
19
 
20
- ## Project Dashboard
20
+ - Deployment status and history
21
+ - Build logs and configuration
22
+ - Environment variables and settings
21
23
 
22
- Monitor and debug your applications with detailed output logs, deployment state, and interactive tools.
24
+ ## Observability
23
25
 
24
- ![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
26
+ [Observability](/docs/v1/mastra-cloud/observability) provides insight into how your agents and workflows behave in production. View detailed traces of agent runs, workflow executions, and logs to debug issues and understand performance.
25
27
 
26
- Key features:
28
+ :::info
29
+ You don’t need to deploy to Mastra Cloud to use Observability. You can send traces to Mastra from any environment
30
+ :::
27
31
 
28
- The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a Studio for testing agents and workflows.
29
-
30
- ## Project structure
31
-
32
- Use a standard Mastra project structure for proper detection and deployment.
33
-
34
- ```shell
35
- src
36
- └── mastra
37
- ├── agents
38
- │ └── agent-name.ts
39
- ├── tools
40
- │ └── tool-name.ts
41
- ├── workflows
42
- │ └── workflow-name.ts
43
- └── index.ts
44
- package.json
45
- ```
46
-
47
- Mastra Cloud scans your repository for:
48
-
49
- - **Agents**: Defined using: `new Agent({...})`
50
- - **Tools**: Defined using: `createTool({...})`
51
- - **Workflows**: Defined using: `createWorkflow({...})`
52
- - **Steps**: Defined using: `createStep({...})`
53
- - **Environment Variables**: API keys and configuration variables
54
-
55
- ## Technical implementation
56
-
57
- Mastra Cloud is purpose-built for Mastra agents, tools, and workflows. It handles long-running requests, records detailed traces for every execution, and includes built-in support for evals.
58
-
59
- ## Next steps
60
-
61
- - [Setting Up and Deploying](/docs/v1/mastra-cloud/setting-up)
@@ -0,0 +1,64 @@
1
+ ---
2
+ title: "Setup | Mastra Cloud"
3
+ description: Import your Mastra project to Mastra Cloud
4
+ ---
5
+
6
+ import Steps from "@site/src/components/Steps";
7
+ import StepItem from "@site/src/components/StepItem";
8
+
9
+ # Setup
10
+
11
+ Import your Mastra project to [Mastra Cloud](https://cloud.mastra.ai) to use [Studio](/docs/v1/mastra-cloud/studio) and optionally [deploy](/docs/v1/mastra-cloud/deployment) your agent.
12
+
13
+ ## Before you begin
14
+
15
+ - [Sign in](https://cloud.mastra.ai) to Cloud
16
+ - Push your [Mastra project](/docs/v1/getting-started/start) to GitHub
17
+
18
+ ## Options
19
+
20
+
21
+ ![Select project type](/img/mastra-cloud/mastra-cloud-select.png)
22
+
23
+ When you create a new project, you can choose from three options:
24
+
25
+ 1. **Create from GitHub** - Import a Mastra project from GitHub
26
+ 2. **Create from your server** - Connect a self-hosted Mastra instance to [Studio](/docs/v1/mastra-cloud/studio)
27
+ 3. **Create from template** - Start from a [pre-built template](https://mastra.ai/templates)
28
+
29
+
30
+ To create a project from GitHub, follow these steps:
31
+
32
+ ## Create from GitHub
33
+
34
+ <Steps>
35
+
36
+ <StepItem>
37
+ Connect to GitHub when prompted
38
+
39
+ ![Deployment details](/img/mastra-cloud/mastra-cloud-connect.png)
40
+ </StepItem>
41
+
42
+ <StepItem>
43
+ Search for your repository and click **Import**
44
+
45
+ ![Deployment details](/img/mastra-cloud/mastra-cloud-import-git-repository.jpg)
46
+ </StepItem>
47
+
48
+ <StepItem>
49
+ Configure your project settings. Mastra Cloud auto-detects most settings, but you'll still need to enter the environment variables for your configured [model provider](/models/v1):
50
+
51
+ ![Deployment details](/img/mastra-cloud/mastra-cloud-deployment-details.jpg)
52
+ </StepItem>
53
+
54
+ <StepItem>
55
+
56
+ Click **Create Project**
57
+ </StepItem>
58
+ </Steps>
59
+
60
+ ## Next steps
61
+
62
+ Once your project is imported, [Studio](/docs/v1/mastra-cloud/studio) automatically creates a sandbox where you can interact with your agents and share access with your team.
63
+
64
+ When you're ready for production, enable [Deployment](/docs/v1/mastra-cloud/deployment) settings and hit deploy!
@@ -0,0 +1,35 @@
1
+ ---
2
+ title: "Studio | Mastra Cloud"
3
+ description: Run Studio in the cloud for team collaboration
4
+ ---
5
+
6
+ import YouTube from "@site/src/components/YouTube-player";
7
+
8
+ # Studio
9
+
10
+ <YouTube id="ojGu6Bi4wYk" />
11
+
12
+ Mastra Cloud provides a hosted version of [Studio](/docs/v1/getting-started/studio) that gives your team a shared environment for interacting with and testing your agents. Team members can chat with agents, review traces, give feedback, and tweak system prompts - without needing to run the project locally.
13
+
14
+ [Set up your project](/docs/v1/mastra-cloud/setup) to access Studio in the cloud.
15
+
16
+ See the [Studio documentation](/docs/v1/getting-started/studio) for details on features like the Agents playground, Workflows runner, Tools testing, and MCP Servers.
17
+
18
+ :::note
19
+ You don't need to deploy your agent to use Studio. Studio runs in a sandbox environment separate from your production deployment
20
+ :::
21
+
22
+ ## Sharing access
23
+
24
+ To invite team members, go to [Mastra Cloud](https://cloud.mastra.ai), click **Team Settings**, then **Members** to add them. Once invited, they can sign in and access your project's Studio.
25
+
26
+ ![Invite team members](/img/mastra-cloud/mastra-cloud-invite.png)
27
+
28
+ :::warning
29
+ Team members can view environment variables and delete projects. Only invite people you trust.
30
+ :::
31
+
32
+ ## Next steps
33
+
34
+ - [Deployment](/docs/v1/mastra-cloud/deployment) - Manage deployments and settings
35
+ - [Observability](/docs/v1/mastra-cloud/observability) - Monitor traces and logs
@@ -7,7 +7,7 @@ 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/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.
10
+ When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/mastra-cloud/observability#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
 
@@ -1,11 +1,14 @@
1
1
  ---
2
2
  title: "Reference: Token Limiter Processor | Processors"
3
- description: "Documentation for the TokenLimiterProcessor in Mastra, which limits the number of tokens in AI responses."
3
+ description: "Documentation for the TokenLimiterProcessor in Mastra, which limits the number of tokens in messages."
4
4
  ---
5
5
 
6
6
  # TokenLimiterProcessor
7
7
 
8
- The `TokenLimiterProcessor` is an **output processor** that limits the number of tokens in AI responses. This processor helps control response length by implementing token counting with configurable strategies for handling exceeded limits, including truncation and abortion options for both streaming and non-streaming scenarios.
8
+ The `TokenLimiterProcessor` limits the number of tokens in messages. It can be used as both an input and output processor:
9
+
10
+ - **Input processor**: Filters historical messages to fit within the context window, prioritizing recent messages
11
+ - **Output processor**: Limits generated response tokens via streaming or non-streaming with configurable strategies for handling exceeded limits
9
12
 
10
13
  ## Usage example
11
14
 
@@ -82,6 +85,12 @@ const processor = new TokenLimiterProcessor({
82
85
  description: "Optional processor display name",
83
86
  isOptional: true,
84
87
  },
88
+ {
89
+ name: "processInput",
90
+ type: "(args: { messages: MastraDBMessage[]; abort: (reason?: string) => never }) => Promise<MastraDBMessage[]>",
91
+ description: "Filters input messages to fit within token limit, prioritizing recent messages while preserving system messages",
92
+ isOptional: false,
93
+ },
85
94
  {
86
95
  name: "processOutputStream",
87
96
  type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",
@@ -90,22 +99,10 @@ const processor = new TokenLimiterProcessor({
90
99
  },
91
100
  {
92
101
  name: "processOutputResult",
93
- type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never }) => Promise<MastraMessageV2[]>",
102
+ type: "(args: { messages: MastraDBMessage[]; abort: (reason?: string) => never }) => Promise<MastraDBMessage[]>",
94
103
  description: "Processes final output results to limit token count in non-streaming scenarios",
95
104
  isOptional: false,
96
105
  },
97
- {
98
- name: "reset",
99
- type: "() => void",
100
- description: "Reset the token counter (useful for testing or reusing the processor)",
101
- isOptional: false,
102
- },
103
- {
104
- name: "getCurrentTokens",
105
- type: "() => number",
106
- description: "Get the current token count",
107
- isOptional: false,
108
- },
109
106
  {
110
107
  name: "getMaxTokens",
111
108
  type: "() => number",
@@ -117,14 +114,38 @@ const processor = new TokenLimiterProcessor({
117
114
 
118
115
  ## Extended usage example
119
116
 
120
- ```typescript title="src/mastra/agents/limited-agent.ts"
117
+ ### As an input processor (limit context window)
118
+
119
+ Use `inputProcessors` to limit historical messages sent to the model, which helps stay within context window limits:
120
+
121
+ ```typescript title="src/mastra/agents/context-limited-agent.ts"
122
+ import { Agent } from "@mastra/core/agent";
123
+ import { Memory } from "@mastra/memory";
124
+ import { TokenLimiterProcessor } from "@mastra/core/processors";
125
+
126
+ export const agent = new Agent({
127
+ name: "context-limited-agent",
128
+ instructions: "You are a helpful assistant",
129
+ model: "openai/gpt-4o",
130
+ memory: new Memory({ /* ... */ }),
131
+ inputProcessors: [
132
+ new TokenLimiterProcessor({ limit: 4000 }) // Limits historical messages to ~4000 tokens
133
+ ]
134
+ });
135
+ ```
136
+
137
+ ### As an output processor (limit response length)
138
+
139
+ Use `outputProcessors` to limit the length of generated responses:
140
+
141
+ ```typescript title="src/mastra/agents/response-limited-agent.ts"
121
142
  import { Agent } from "@mastra/core/agent";
122
143
  import { TokenLimiterProcessor } from "@mastra/core/processors";
123
144
 
124
145
  export const agent = new Agent({
125
- name: "limited-agent",
146
+ name: "response-limited-agent",
126
147
  instructions: "You are a helpful assistant",
127
- model: "openai/gpt-5.1",
148
+ model: "openai/gpt-4o",
128
149
  outputProcessors: [
129
150
  new TokenLimiterProcessor({
130
151
  limit: 1000,
@@ -118,14 +118,16 @@ If you're using storage directly without Mastra, you must call `init()` explicit
118
118
  import { D1Store } from "@mastra/cloudflare-d1";
119
119
 
120
120
  const storage = new D1Store({
121
+ id: 'd1-storage',
121
122
  binding: D1Database,
122
123
  });
123
124
 
124
125
  // Required when using storage directly
125
126
  await storage.init();
126
127
 
127
- // Now you can use the storage
128
- await storage.getThread({ threadId: "..." });
128
+ // Access domain-specific stores via getStore()
129
+ const memoryStore = await storage.getStore('memory');
130
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
129
131
  ```
130
132
 
131
133
  :::warning
@@ -98,8 +98,9 @@ const storage = await LanceStorage.create("my-storage", "/path/to/db");
98
98
  // Required when using storage directly
99
99
  await storage.init();
100
100
 
101
- // Now you can use the storage
102
- await storage.getThread({ threadId: "..." });
101
+ // Access domain-specific stores via getStore()
102
+ const memoryStore = await storage.getStore('memory');
103
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
103
104
  ```
104
105
 
105
106
  :::warning
@@ -115,7 +115,7 @@ const mastra = new Mastra({
115
115
 
116
116
  If using storage directly without Mastra, call `init()` explicitly:
117
117
 
118
- ```typescript
118
+ ```typescript
119
119
  import { LibSQLStore } from "@mastra/libsql";
120
120
 
121
121
  const storage = new LibSQLStore({
@@ -124,5 +124,8 @@ const storage = new LibSQLStore({
124
124
  });
125
125
 
126
126
  await storage.init();
127
- await storage.getThread({ threadId: "..." });
127
+
128
+ // Access domain-specific stores via getStore()
129
+ const memoryStore = await storage.getStore('memory');
130
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
128
131
  ```
@@ -117,6 +117,7 @@ If you're using storage directly without Mastra, you must call `init()` explicit
117
117
  import { MongoDBStore } from "@mastra/mongodb";
118
118
 
119
119
  const storage = new MongoDBStore({
120
+ id: 'mongodb-storage',
120
121
  url: process.env.MONGODB_URL,
121
122
  dbName: process.env.MONGODB_DATABASE,
122
123
  });
@@ -124,8 +125,9 @@ const storage = new MongoDBStore({
124
125
  // Required when using storage directly
125
126
  await storage.init();
126
127
 
127
- // Now you can use the storage
128
- await storage.getThread({ threadId: "..." });
128
+ // Access domain-specific stores via getStore()
129
+ const memoryStore = await storage.getStore('memory');
130
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
129
131
  ```
130
132
 
131
133
  :::warning
@@ -124,14 +124,16 @@ If you're using storage directly without Mastra, you must call `init()` explicit
124
124
  import { MSSQLStore } from "@mastra/mssql";
125
125
 
126
126
  const storage = new MSSQLStore({
127
+ id: 'mssql-storage',
127
128
  connectionString: process.env.DATABASE_URL,
128
129
  });
129
130
 
130
131
  // Required when using storage directly
131
132
  await storage.init();
132
133
 
133
- // Now you can use the storage
134
- await storage.getThread({ threadId: "..." });
134
+ // Access domain-specific stores via getStore()
135
+ const memoryStore = await storage.getStore('memory');
136
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
135
137
  ```
136
138
 
137
139
  :::warning
@@ -124,14 +124,16 @@ If you're using storage directly without Mastra, you must call `init()` explicit
124
124
  import { PostgresStore } from "@mastra/pg";
125
125
 
126
126
  const storage = new PostgresStore({
127
+ id: 'pg-storage',
127
128
  connectionString: process.env.DATABASE_URL,
128
129
  });
129
130
 
130
131
  // Required when using storage directly
131
132
  await storage.init();
132
133
 
133
- // Now you can use the storage
134
- await storage.getThread({ threadId: "..." });
134
+ // Access domain-specific stores via getStore()
135
+ const memoryStore = await storage.getStore('memory');
136
+ const thread = await memoryStore?.getThreadById({ threadId: "..." });
135
137
  ```
136
138
 
137
139
  :::warning
@@ -1031,4 +1031,4 @@ For more information on the CompositeVoice, refer to the [CompositeVoice Referen
1031
1031
  - [Google Gemini Live Voice](/reference/v1/voice/google-gemini-live)
1032
1032
  - [Deepgram Voice](/reference/v1/voice/deepgram)
1033
1033
  - [PlayAI Voice](/reference/v1/voice/playai)
1034
- - [Voice Examples](/examples/v1/voice/text-to-speech)
1034
+ - [Voice Examples](https://github.com/mastra-ai/voice-examples)
@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
8
8
 
9
9
  # Workflows overview
10
10
 
11
- Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down, how data moves between them, and what gets executed when.
11
+ Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down, how data moves between them, and what gets executed when. Workflows run using the built-in execution engine by default, or can be deployed to [workflow runners](/docs/v1/deployment/workflow-runners) like Inngest for managed infrastructure.
12
12
 
13
13
  ![Workflows overview](/img/workflows/workflows-overview.jpg)
14
14
 
@@ -114,8 +114,9 @@ When a workflow is resumed, Mastra retrieves the persisted snapshot with these s
114
114
 
115
115
  ```typescript
116
116
  const storage = mastra.getStorage();
117
+ const workflowStore = await storage?.getStore('workflows');
117
118
 
118
- const snapshot = await storage!.loadWorkflowSnapshot({
119
+ const snapshot = await workflowStore?.loadWorkflowSnapshot({
119
120
  runId: "<run-id>",
120
121
  workflowName: "<workflow-id>",
121
122
  });
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.0.0-beta.15
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
8
+ - @mastra/core@1.0.0-beta.15
9
+
3
10
  ## 1.0.0-beta.14
4
11
 
5
12
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.0.0-beta.14",
3
+ "version": "1.0.0-beta.15",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,8 +28,8 @@
28
28
  "@modelcontextprotocol/sdk": "^1.17.5",
29
29
  "jsdom": "^26.1.0",
30
30
  "zod": "^3.25.76",
31
- "@mastra/mcp": "^1.0.0-beta.6",
32
- "@mastra/core": "1.0.0-beta.14"
31
+ "@mastra/core": "1.0.0-beta.15",
32
+ "@mastra/mcp": "^1.0.0-beta.6"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@hono/node-server": "^1.19.6",
@@ -46,7 +46,7 @@
46
46
  "typescript": "^5.8.3",
47
47
  "vitest": "4.0.12",
48
48
  "@internal/lint": "0.0.53",
49
- "@mastra/core": "1.0.0-beta.14"
49
+ "@mastra/core": "1.0.0-beta.15"
50
50
  },
51
51
  "homepage": "https://mastra.ai",
52
52
  "repository": {
@@ -1,96 +0,0 @@
1
- ---
2
- title: "Navigating the Dashboard | Mastra Cloud"
3
- description: Details of each feature available in Mastra Cloud
4
- ---
5
-
6
- # Navigating the Dashboard
7
-
8
- This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Studio](/docs/v1/mastra-cloud/dashboard#studio).
9
-
10
- ## Overview
11
-
12
- The **Overview** page provides details about your application, including its domain URL, status, latest deployment, and connected agents and workflows.
13
-
14
- ![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
15
-
16
- Key features:
17
-
18
- Each project shows its current deployment status, active domains, and environment variables, so you can quickly understand how your application is running.
19
-
20
- ## Deployments
21
-
22
- The **Deployments** page shows recent builds and gives you quick access to detailed build logs. Click any row to view more information about a specific deployment.
23
-
24
- ![Dashboard deployment](/img/mastra-cloud/mastra-cloud-dashboard-deployments.jpg)
25
-
26
- Key features:
27
-
28
- Each deployment includes its current status, the Git branch it was deployed from, and a title generated from the commit hash.
29
-
30
- ## Logs
31
-
32
- The **Logs** page is where you'll find detailed information to help debug and monitor your application's behavior in the production environment.
33
-
34
- ![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
35
-
36
- Key features:
37
-
38
- Each log includes a severity level and detailed messages showing agent, workflow, and storage activity.
39
-
40
- ## Settings
41
-
42
- On the **Settings** page you can modify the configuration of your application.
43
-
44
- ![Dashboard settings](/img/mastra-cloud/mastra-cloud-dashboard-settings.jpg)
45
-
46
- Key features:
47
-
48
- You can manage environment variables, edit key project settings like the name and branch, configure storage with LibSQLStore, and set a stable URL for your endpoints.
49
-
50
- > Changes to configuration require a new deployment before taking effect.
51
-
52
- ## Studio
53
-
54
- ### Agents
55
-
56
- On the **Agents** page you'll see all agents used in your application. Click any agent to interact using the chat interface.
57
-
58
- ![Dashboard Studio agents](/img/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
59
-
60
- Key features:
61
-
62
- Test your agents in real time using the chat interface, review traces of each interaction, and see evaluation scores for every response.
63
-
64
- ### Workflows
65
-
66
- On the **Workflows** page you'll see all workflows used in your application. Click any workflow to interact using the runner interface.
67
-
68
- ![Dashboard Studio workflows](/img/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
69
-
70
- Key features:
71
-
72
- Visualize your workflow with a step-by-step graph, view execution traces, and run workflows directly using the built-in runner.
73
-
74
- ### Tools
75
-
76
- On the **Tools** page you'll see all tools used by your agents. Click any tool to interact using the input interface.
77
-
78
- ![Dashboard Studio tools](/img/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
79
-
80
- Key features:
81
-
82
- Test your tools by providing an input that matches the schema and viewing the structured output.
83
-
84
- ## MCP Servers
85
-
86
- The **MCP Servers** page lists all MCP Servers included in your application. Click any MCP Server for more information.
87
-
88
- ![Dashboard Studio mcp servers](/img/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
89
-
90
- Key features:
91
-
92
- Each MCP Server includes API endpoints for HTTP and SSE, along with IDE configuration snippets for tools like Cursor and Windsurf.
93
-
94
- ## Next steps
95
-
96
- - [Understanding Tracing and Logs](/docs/v1/mastra-cloud/observability)