@mastra/mcp-docs-server 0.13.29-alpha.1 → 0.13.30-alpha.0

package/.docs/raw/getting-started/installation.mdx

@@ -21,10 +21,6 @@ Mastra also supports other LLM providers. For a full list of supported models an
 
 Our CLI is the fastest way to get started with Mastra. You can run `create mastra` anywhere on your machine.
 
-<Callout type="warning">
-  The CLI currently generates projects that are only compatible with `ai-sdk v4`. Please refer to [ai-sdk v5 compatibility](#ai-sdk-v5-compatibility) if you wish to use `ai-sdk v5`.
-</Callout>
-
 <Steps>
 
 ## Start the CLI wizard
@@ -372,49 +368,6 @@ To install Mastra in an existing project, use the `mastra init` command.
 
 > See [mastra init](/reference/cli/init) for more information.
 
-## ai-sdk v5 compatibility
-
-By default, Mastra projects are only compatible with `ai-sdk v4`, if you wish to use `ai-sdk v5`, please make the following changes to the generated project.
-
-Install the latest version to the `@ai-sdk/openai` package:
-<Tabs items={["npm", "pnpm", "yarn", "bun"]}>
-
-  <Tab>
-    ```bash copy
-    npm install @ai-sdk/openai@latest
-    ```
-
-  </Tab>
-  <Tab>
-    ```bash copy
-    pnpm add @ai-sdk/openai@latest
-    ```
-
-  </Tab>
-  <Tab>
-    ```bash copy
-    yarn add @ai-sdk/openai@latest
-    ```
-
-  </Tab>
-  <Tab>
-    ```bash copy
-    bun add @ai-sdk/openai@latest
-    ```
-
-  </Tab>
-</Tabs>
-
-Update the `planActivities` step in `src/mastra/workflows/weather-workflow.ts` as follows:
-```ts filename="src/mastra/workflows/weather-workflow.ts" showLineNumbers{150} copy
-const response = await agent.stream([
-  {
-    role: 'user',
-    content: prompt,
-  },
-]);
-```
-
 ## Next steps
 
 - [Local Development](/docs/server-db/local-dev-playground)

package/.docs/raw/reference/agents/generateLegacy.mdx

@@ -8,7 +8,7 @@ import { Callout } from 'nextra/components';
 # Agent.generateLegacy() (Legacy)
 
 <Callout type="warning">
-  **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.generate()`](./generate.mdx) method instead. See the [migration guide](./migration-guide.mdx) for details on upgrading.
+  **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.generate()`](./generate.mdx) method instead. See the [migration guide](../../guides/migrations/vnext-to-standard-apis) for details on upgrading.
 </Callout>
 
 The `.generateLegacy()` method is the legacy version of the agent generation API, used to interact with V1 model agents to produce text or structured responses. This method accepts messages and optional generation options.
@@ -442,7 +442,7 @@ await agent.generateLegacy("message for agent");
 ## Migration to New API
 
 <Callout type="info">
-  The new `.generate()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved streaming support. See the [migration guide](./migration-guide.mdx) for detailed migration instructions.
+  The new `.generate()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved streaming support. See the [migration guide](../../guides/migrations/vnext-to-standard-apis) for detailed migration instructions.
 </Callout>
 
 ### Quick Migration Example
@@ -522,7 +522,7 @@ await agent.generateLegacy(
 
 ## Related
 
-- [Migration Guide](./migration-guide.mdx)
+- [Migration Guide](../../guides/migrations/vnext-to-standard-apis)
 - [New .generate() method](./generate.mdx)
 - [Generating responses](../../docs/agents/overview.mdx#generating-responses)
-- [Streaming responses](../../docs/agents/overview.mdx#streaming-responses)
+- [Streaming responses](../../docs/agents/overview.mdx#streaming-responses)

package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx

@@ -218,11 +218,14 @@ console.log(fullText);
 
 ```typescript
 const stream = await agent.stream("Generate user data", {
-  output: z.object({
-    name: z.string(),
-    age: z.number(),
-    email: z.string()
-  })
+  structuredOutput: {
+    schema: z.object({
+      name: z.string(),
+      age: z.number(),
+      email: z.string()
+    })
+  },
+  maxSteps: 1
 });
 
 // Stream partial objects
@@ -234,6 +237,7 @@ for await (const partial of stream.objectStream) {
 const user = await stream.object;
 console.log("Final:", user); // { name: "John", age: 30, email: "john@example.com" }
 ```
+```
 
 ### Tool Calls and Results
 

package/.docs/raw/reference/streaming/agents/streamLegacy.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.streamLegacy() (Legacy) | Agents | Mastra Docs"  
+title: "Reference: Agent.streamLegacy() (Legacy) | Agents | Mastra Docs"
 description: "Documentation for the legacy `Agent.streamLegacy()` method in Mastra agents. This method is deprecated and will be removed in a future version."
 ---
 
@@ -8,7 +8,7 @@ import { Callout } from 'nextra/components';
 # Agent.streamLegacy() (Legacy)
 
 <Callout type="warning">
-  **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.stream()`](./stream.mdx) method instead. See the [migration guide](../../agents/migration-guide.mdx) for details on upgrading.
+  **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.stream()`](./stream.mdx) method instead. See the [migration guide](../../../guides/migrations/vnext-to-standard-apis) for details on upgrading.
 </Callout>
 
 The `.streamLegacy()` method is the legacy version of the agent streaming API, used for real-time streaming of responses from V1 model agents. This method accepts messages and optional streaming options.
@@ -482,7 +482,7 @@ await agent.streamLegacy("message for agent", {
 ## Migration to New API
 
 <Callout type="info">
-  The new `.stream()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved callback system. See the [migration guide](../../agents/migration-guide.mdx) for detailed migration instructions.
+  The new `.stream()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved callback system. See the [migration guide](../../../guides/migrations/vnext-to-standard-apis) for detailed migration instructions.
 </Callout>
 
 ### Quick Migration Example
@@ -509,7 +509,7 @@ const result = await agent.stream("message", {
 
 ## Related
 
-- [Migration Guide](../../agents/migration-guide.mdx)
+- [Migration Guide](../../../guides/migrations/vnext-to-standard-apis)
 - [New .stream() method](./stream.mdx)
 - [Generating responses](../../docs/agents/overview.mdx#generating-responses)
 - [Streaming responses](../../docs/agents/overview.mdx#streaming-responses)

package/.docs/raw/reference/streaming/workflows/observeStream.mdx

@@ -0,0 +1,49 @@
+---
+title: "Reference: Run.observeStream() | Workflows | Mastra Docs"
+description: Documentation for the `Run.observeStream()` method in workflows, which enables reopening the stream of an already active workflow run.
+---
+
+# Run.observeStream()
+
+The `.observeStream()` method opens a new `ReadableStream` to a workflow run that is currently running, allowing you to observe the stream of events if the original stream is no longer available.
+
+## Usage example
+
+```typescript showLineNumbers copy
+const run = await workflow.createRunAsync();
+
+run.stream({
+  inputData: {
+    value: "initial data",
+  },
+});
+
+const { stream } = await run.observeStream();
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+## Returns
+
+`ReadableStream<ChunkType>`
+
+## Stream Events
+
+The stream emits various event types during workflow execution. Each event has a `type` field and a `payload` containing relevant data:
+
+- **`start`**: Workflow execution begins
+- **`step-start`**: A step begins execution
+- **`tool-call`**: A tool call is initiated
+- **`tool-call-streaming-start`**: Tool call streaming begins
+- **`tool-call-delta`**: Incremental tool output updates
+- **`step-result`**: A step completes with results
+- **`step-finish`**: A step finishes execution
+- **`finish`**: Workflow execution completes
+
+## Related
+
+- [Workflows overview](../../../docs/workflows/overview.mdx#run-workflow)
+- [Workflow.createRunAsync()](../../../reference/workflows/workflow-methods/create-run.mdx)
+- [Run.stream()](./stream.mdx)

package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx

@@ -0,0 +1,47 @@
+---
+title: "Reference: Run.observeStreamVNext() | Workflows | Mastra Docs"
+description: Documentation for the `Run.observeStreamVNext()` method in workflows, which enables reopening the stream of an already active workflow run.
+---
+
+# Run.observeStreamVNext() (Experimental)
+
+The `.observeStreamVNext()` method opens a new `ReadableStream` to a workflow run that is currently running, allowing you to observe the stream of events if the original stream is no longer available.
+
+## Usage example
+
+```typescript showLineNumbers copy
+const run = await workflow.createRunAsync();
+
+run.streamVNext({
+  inputData: {
+    value: "initial data",
+  },
+});
+
+const stream = await run.observeStreamVNext();
+
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+## Returns
+
+`ReadableStream<ChunkType>`
+
+## Stream Events
+
+The stream emits various event types during workflow execution. Each event has a `type` field and a `payload` containing relevant data:
+
+- **`workflow-start`**: Workflow execution begins
+- **`workflow-step-start`**: A step begins execution
+- **`workflow-step-output`**: Custom output from a step
+- **`workflow-step-result`**: A step completes with results
+- **`workflow-finish`**: Workflow execution completes with usage statistics
+
+## Related
+
+- [Workflows overview](../../../docs/workflows/overview.mdx#run-workflow)
+- [Workflow.createRunAsync()](../../../reference/workflows/workflow-methods/create-run.mdx)
+- [Run.streamVNext()](./streamVNext.mdx)
+- [Run.resumeStreamVNext()](./resumeStreamVNext.mdx)

package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx

@@ -18,15 +18,17 @@ const run = await workflow.createRunAsync();
 
 const stream = run.streamVNext({
   inputData: {
-    value: "initial data",
-  },
+    value: "initial data"
+  }
 });
 
-
 const result = await stream.result;
-if (result.status === "suspended") {
+
+if (result!.status === "suspended") {
   const resumedStream = await run.resumeStreamVNext({
-    resumeData: { value: "resume data" }
+    resumeData: {
+      value: "resume data"
+    }
   });
 }
 ```

package/.docs/raw/reference/streaming/workflows/stream.mdx

@@ -12,7 +12,7 @@ The `.stream()` method allows you to monitor the execution of a workflow run, pr
 ```typescript showLineNumbers copy
 const run = await workflow.createRunAsync();
 
-const stream = await run.stream({
+const { stream } = await run.stream({
   inputData: {
     value: "initial data",
   },

package/.docs/raw/streaming/workflow-streaming.mdx

@@ -69,6 +69,29 @@ const stream = await run.stream({
 for await (const chunk of stream) {
   console.log(chunk);
 }
+
+if (result!.status === "suspended") {
+  // if the workflow is suspended, we can resume it with the resumeStreamVNext method
+  const resumedStream = await run.resumeStreamVNext({
+    resumeData: { value: "resume data" }
+  });
+
+  for await (const chunk of resumedStream) {
+    console.log(chunk);
+  }
+}
+```
+
+### Resuming an interrupted workflow stream
+
+If a workflow stream is closed or interrupted for any reason, you can resume it with the `resumeStreamVNext` method. This will return a new `ReadableStream` that you can use to observe the workflow events.
+
+```typescript showLineNumbers copy
+const newStream = await run.resumeStreamVNext();
+
+for await (const chunk of newStream) {
+  console.log(chunk);
+}
 ```
 
 ## Workflow using an agent

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 0.13.30-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`2ddb851`](https://github.com/mastra-ai/mastra/commit/2ddb8519c4b6f1d31be10ffd33b41d2b649a04ff), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb), [`59d036d`](https://github.com/mastra-ai/mastra/commit/59d036d4c2706b430b0e3f1f1e0ee853ce16ca04)]:
+  - @mastra/core@0.21.0-alpha.0
+  - @mastra/mcp@0.13.5-alpha.0
+
+## 0.13.29
+
+### Patch Changes
+
+- Updated dependencies [[`07eaf25`](https://github.com/mastra-ai/mastra/commit/07eaf25aada9e42235dbf905854de53da4d8121b), [`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372), [`68b1111`](https://github.com/mastra-ai/mastra/commit/68b11118a1303f93e9c0c157850c0751309304c5)]:
+  - @mastra/core@0.20.2
+
 ## 0.13.29-alpha.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.29-alpha.1",
+  "version": "0.13.30-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.20.2-alpha.1",
-    "@mastra/mcp": "^0.13.4"
+    "@mastra/core": "0.21.0-alpha.0",
+    "@mastra/mcp": "^0.13.5-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.5",
@@ -43,14 +43,14 @@
     "@types/turndown": "^5.0.5",
     "@wong2/mcp-cli": "^1.10.0",
     "cross-env": "^7.0.3",
-    "eslint": "^9.35.0",
+    "eslint": "^9.36.0",
     "hono": "^4.9.7",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.47",
-    "@mastra/core": "0.20.2-alpha.1"
+    "@internal/lint": "0.0.48",
+    "@mastra/core": "0.21.0-alpha.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/raw/reference/agents/migration-guide.mdx

@@ -1,291 +0,0 @@
-# Migration Guide: VNext to Standard APIs
-
-## Overview
-
-As of `v 0.20.00`, the `streamVNext()` and `generateVNext()` methods in Mastra agents have been renamed to `stream()` and `generate()` respectively. These are now the standard APIs with full AI SDK v5 compatibility. The original `stream()` and `generate()` methods have been renamed to `streamLegacy()` and `generateLegacy()` to maintain backward compatibility with AI SDK v4.
-
-### Continue using AI SDK v4 models
-- Rename all your `stream()` and `generate()` calls to `streamLegacy()` and `generateLegacy()` respectively. No other change is needed.
-
-### Continue using AI SDK v5 models
-- Rename all your `streamVNext()` and `generateVNext()` calls to `stream()` and `generate()` respectively. No other change is needed.
-
-### Upgrade from AI SDK v4 models to v5 models
-
-First bump all your model provider packages by a major version. This will ensure that they are all v5 models now. Follow the guide below to understand the differences.
-
-## Key Differences
-
-### 1. Model version support
-
-- **Legacy APIs (`generateLegacy`, `streamLegacy`)**: Only support AI SDK v4 models (specificationVersion: 'v1')
-- **Current APIs (`generate`, `stream`)**: Only support AI SDK v5 models (specificationVersion: 'v2')
-- This is enforced at runtime with clear error messages
-
-### 2. Return types
-
-#### Legacy methods return AI SDK v4 types
-
-- **`generateLegacy()`**:
-  - `GenerateTextResult` or `GenerateObjectResult`
-
-- **`streamLegacy()`**:
-  - `StreamTextResult` or `StreamObjectResult`
-
-#### New stream methods return Mastra/AI SDK v5 types
-
-- **`generate()`**:
-  - When `format: 'mastra'` (default): Returns `MastraModelOutput.getFullOutput()` result
-  - When `format: 'aisdk'`: Returns `AISDKV5OutputStream.getFullOutput()` result (AI SDK v5 compatible)
-  - Internally calls `stream()` and awaits `getFullOutput()`
-
-- **`stream()`**:
-  - When `format: 'mastra'` (default): Returns `MastraModelOutput<OUTPUT>`
-  - When `format: 'aisdk'`: Returns `AISDKV5OutputStream<OUTPUT>` (AI SDK v5 compatible)
-
-#### Format Control
-
-- **Legacy**: No format control, always returns AI SDK v4 types
-- **New stream**: Can choose format via `format` option ('mastra' or 'aisdk')
-
-```typescript
-// Mastra native format (default)
-const result = await agent.stream(messages, {
-  format: 'mastra'
-});
-
-// AI SDK v5 compatibility
-const result = await agent.stream(messages, {
-  format: 'aisdk'
-});
-```
-
-### 3. New Options in Non-Legacy APIs
-
-The following options are available in `stream()` and `generate()` but NOT in their legacy counterparts:
-
-1. **`format`** - Choose between 'mastra' or 'aisdk' output format
-
-```typescript
-const result = await agent.stream(messages, {
-  format: 'aisdk' // or 'mastra' (default)
-});
-```
-
-2. **`system`** - Custom system message (separate from instructions)
-
-```typescript
-const result = await agent.stream(messages, {
-  system: 'You are a helpful assistant'
-});
-```
-
-3. **`structuredOutput`** - Enhanced structured output with model override and custom options
-
-- If no model is added it will use the agent's default model.
-- Error strategy when the object does not conform to the schema is `warn` (log a warning), `error` (throw an error), or `fallback` (return a default fallback value of your choice).
-
-```typescript
-const result = await agent.generate(messages, {
-  structuredOutput: {
-    schema: z.object({
-      name: z.string(),
-      age: z.number()
-    }),
-    model: openai('gpt-4o-mini'), // Optional model override for structuring
-    errorStrategy: 'fallback',
-    fallbackValue: { name: 'unknown', age: 0 },
-    instructions: 'Extract user information' // Override default structuring instructions
-  }
-});
-```
-
-4. **`stopWhen`** - Flexible stop conditions (step count, token limit, etc.)
-
-```typescript
-const result = await agent.stream(messages, {
-  stopWhen: ({ steps, totalTokens }) => steps >= 5 || totalTokens >= 10000
-});
-```
-
-5. **`providerOptions`** - Provider-specific options (e.g., OpenAI-specific settings)
-
-```typescript
-const result = await agent.stream(messages, {
-  providerOptions: {
-    openai: {
-      store: true,
-      metadata: { userId: '123' }
-    }
-  }
-});
-```
-
-6. **`onChunk`** - Callback for each streaming chunk
-
-```typescript
-const result = await agent.stream(messages, {
-  onChunk: (chunk) => {
-    console.log('Received chunk:', chunk);
-  }
-});
-```
-
-7. **`onError`** - Error callback
-
-```typescript
-const result = await agent.stream(messages, {
-  onError: (error) => {
-    console.error('Stream error:', error);
-  }
-});
-```
-
-8. **`onAbort`** - Abort callback
-
-```typescript
-const result = await agent.stream(messages, {
-  onAbort: () => {
-    console.log('Stream aborted');
-  }
-});
-```
-
-9. **`activeTools`** - Specify which tools are active for this execution
-
-```typescript
-const result = await agent.stream(messages, {
-  activeTools: ['search', 'calculator'] // Only these tools will be available
-});
-```
-
-10. **`abortSignal`** - AbortSignal for cancellation
-
-```typescript
-const controller = new AbortController();
-const result = await agent.stream(messages, {
-  abortSignal: controller.signal
-});
-
-// Later: controller.abort();
-```
-
-11. **`prepareStep`** - Callback before each step in multi-step execution
-
-```typescript
-const result = await agent.stream(messages, {
-  prepareStep: ({ step, state }) => {
-    console.log('About to execute step:', step);
-    return { /* modified state */ };
-  }
-});
-```
-
-12. **`requireToolApproval`** - Require approval for all tool calls
-
-```typescript
-const result = await agent.stream(messages, {
-  requireToolApproval: true
-});
-```
-
-### 4. Options That Still Exist But Have Been Moved
-
-#### `temperature` and Other Model Settings
-
-Unified in `modelSettings`
-
-```typescript
-const result = await agent.stream(messages, {
-  modelSettings: {
-    temperature: 0.7,
-    maxTokens: 1000,
-    topP: 0.9
-  }
-});
-```
-
-#### `resourceId` and `threadId`
-
-Moved to memory object.
-
-```typescript
-const result = await agent.stream(messages, {
-  memory: {
-    resource: 'user-123',
-    thread: 'thread-456'
-  }
-});
-```
-
-### 5. Options That Are Deprecated or Removed
-
-#### `experimental_output`
-
-Use `structuredOutput` instead to allow for tool calls and an object return.
-
-```typescript
-const result = await agent.generate(messages, {
-  structuredOutput: {
-    schema: z.object({
-      summary: z.string()
-    })
-  }
-});
-```
-
-#### `output`
-
-The `output` property is deprecated in favor of `structuredOutput`, to achieve the same results use maxSteps 1 with `structuredOutput`.
-
-```typescript
-const result = await agent.generate(messages, {
-  structuredOutput: {
-    schema: {
-      z.object({
-        name: z.string()
-      })
-    }
-  },
-  maxSteps: 1
-});
-```
-
-#### `memoryOptions` was removed
-
-Use `memory` instead
-```typescript
-const result = await agent.generate(messages, {
-  memory: {
-    ...
-  }
-});
-```
-
-### 6. Type Changes
-
-#### `context`
-
-- **Legacy**: `CoreMessage[]`
-- **New format**: `ModelMessage[]`
-
-#### `toolChoice` uses the AI SDK v5 `ToolChoice` type
-
-```typescript
-type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
-    type: 'tool';
-    toolName: Extract<keyof TOOLS, string>;
-};
-```
-
-
-## Migration Checklist
-
-### If you're already using `streamVNext` and `generateVNext`
-
-Just find/replace the methods to `stream` and `generate` respectively.
-
-### If you're using the old `stream` and `generate`
-
-Decide whether you want to upgrade or not. If you don't, just find/replace to `streamLegacy` and `generateLegacy`.
-