@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.
- package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +51 -51
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +76 -76
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Fconvex.md +218 -0
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +308 -308
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +27 -27
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Flance.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +195 -195
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +8 -8
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +128 -128
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +219 -219
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +219 -219
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +235 -235
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +81 -81
- package/.docs/organized/changelogs/%40mastra%2Freact.md +70 -70
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +125 -125
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +195 -195
- package/.docs/organized/changelogs/create-mastra.md +11 -11
- package/.docs/organized/changelogs/mastra.md +40 -40
- package/.docs/organized/code-examples/agent-v6.md +70 -11
- package/.docs/organized/code-examples/client-side-tools.md +1 -1
- package/.docs/raw/agents/adding-voice.mdx +8 -3
- package/.docs/raw/deployment/overview.mdx +3 -4
- package/.docs/raw/deployment/workflow-runners.mdx +14 -0
- package/.docs/raw/getting-started/studio.mdx +1 -1
- package/.docs/raw/guides/deployment/inngest.mdx +198 -140
- package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +11 -3
- package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +41 -0
- package/.docs/raw/mastra-cloud/deployment.mdx +39 -0
- package/.docs/raw/mastra-cloud/observability.mdx +9 -15
- package/.docs/raw/mastra-cloud/overview.mdx +14 -44
- package/.docs/raw/mastra-cloud/setup.mdx +64 -0
- package/.docs/raw/mastra-cloud/studio.mdx +35 -0
- package/.docs/raw/reference/logging/pino-logger.mdx +1 -1
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +39 -18
- package/.docs/raw/reference/storage/cloudflare-d1.mdx +4 -2
- package/.docs/raw/reference/storage/lance.mdx +3 -2
- package/.docs/raw/reference/storage/libsql.mdx +5 -2
- package/.docs/raw/reference/storage/mongodb.mdx +4 -2
- package/.docs/raw/reference/storage/mssql.mdx +4 -2
- package/.docs/raw/reference/storage/postgresql.mdx +4 -2
- package/.docs/raw/voice/overview.mdx +1 -1
- package/.docs/raw/workflows/overview.mdx +1 -1
- package/.docs/raw/workflows/snapshots.mdx +2 -1
- package/CHANGELOG.md +7 -0
- package/package.json +4 -4
- package/.docs/raw/mastra-cloud/dashboard.mdx +0 -96
- package/.docs/raw/mastra-cloud/setting-up.mdx +0 -106
- package/.docs/raw/workflows/inngest-workflow.mdx +0 -362
|
@@ -1,46 +1,40 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: "
|
|
2
|
+
title: "Observability | Mastra Cloud"
|
|
3
3
|
description: Monitoring and debugging tools for Mastra Cloud deployments
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Observability
|
|
7
7
|
|
|
8
|
-
|
|
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
|
-
|
|
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
|

|
|
21
21
|
|
|
22
|
-
|
|
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
|

|
|
31
29
|
|
|
32
|
-
|
|
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
|
-
|
|
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
|

|
|
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
|
|
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
|
-
##
|
|
10
|
+
## Studio
|
|
11
11
|
|
|
12
|
-
|
|
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
|
-
|
|
14
|
+
## Deploy
|
|
15
15
|
|
|
16
|
-
|
|
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
|
-
|
|
18
|
+
Once deployed, the project dashboard gives you visibility into:
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
- Deployment status and history
|
|
21
|
+
- Build logs and configuration
|
|
22
|
+
- Environment variables and settings
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
## Observability
|
|
23
25
|
|
|
24
|
-
|
|
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
|
-
|
|
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
|
+

|
|
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
|
+

|
|
40
|
+
</StepItem>
|
|
41
|
+
|
|
42
|
+
<StepItem>
|
|
43
|
+
Search for your repository and click **Import**
|
|
44
|
+
|
|
45
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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/
|
|
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
|
|
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`
|
|
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:
|
|
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
|
-
|
|
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-
|
|
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
|
-
//
|
|
128
|
-
await storage.
|
|
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
|
-
//
|
|
102
|
-
await storage.
|
|
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
|
-
|
|
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
|
-
//
|
|
128
|
-
await storage.
|
|
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
|
-
//
|
|
134
|
-
await storage.
|
|
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
|
-
//
|
|
134
|
-
await storage.
|
|
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](/
|
|
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
|

|
|
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
|
|
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.
|
|
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/
|
|
32
|
-
"@mastra/
|
|
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.
|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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
|
-

|
|
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)
|