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

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,15 @@
 # @mastra/client-js
 
+## 0.10.17-alpha.1
+
+### Patch Changes
+
+- cda801d: Added the ability to pass in metadata for UIMessage and MastraMessageV2 in client-js and agent.stream/generate
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+
 ## 0.10.17-alpha.0
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 
 ## 0.10.8
 
-### Patch Changes
-
-- 9047bda: clientTools - stream tool-result part
-- a606c75: show right suspend schema for nested workflow on playground
-- 1760a1c: Use workflow stream in playground instead of watch
-- 038e5ae: Add cancel workflow run
-- 7e801dd: Add tools to network api response
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
 
-... 1714 more lines hidden. See full changelog in package directory.
+... 1724 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,13 @@
 # @mastra/core
 
+## 0.12.0-alpha.1
+
+### Patch Changes
+
+- e0f73c6: Make input optional for scorer run
+- cda801d: Added the ability to pass in metadata for UIMessage and MastraMessageV2 in client-js and agent.stream/generate
+- a77c823: include PATCH method in default CORS configuration
+
 ## 0.12.0-alpha.0
 
 ### Minor Changes
@@ -290,13 +298,5 @@
 
 - b8f16b2: Fixes generateTitle overwriting working memory when both get used in the same LLM response cycle.
 - 3e04487: Fix provider tools to check for output schema before attaching to tool
-- a344ac7: Fix tool streaming in agent network
-- dc4ca0a: Fixed a regression where intentionally serialized JSON message content was being parsed back into an object by MessageList
-
-## 0.10.8-alpha.1
-
-### Patch Changes
-
-- b8f16b2: Fixes generateTitle overwriting working memory when both get used in the same LLM response cycle.
 
-... 2272 more lines hidden. See full changelog in package directory.
+... 2280 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,16 @@
 # @mastra/deployer
 
+## 0.12.0-alpha.1
+
+### Patch Changes
+
+- a77c823: include PATCH method in default CORS configuration
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+  - @mastra/server@0.12.0-alpha.1
+
 ## 0.12.0-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [f36e4f1]
 - Updated dependencies [7f6e403]
   - @mastra/core@0.10.11
-  - @mastra/server@0.10.11
-
-## 0.10.11-alpha.4
-
-### Patch Changes
-
-- 40cd025: Check if tool is actually a tool for /api/tools
-  - @mastra/core@0.10.11-alpha.4
-  - @mastra/server@0.10.11-alpha.4
-
-## 0.10.11-alpha.3
 
-... 3034 more lines hidden. See full changelog in package directory.
+... 3045 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fevals.md

@@ -1,5 +1,15 @@
 # @mastra/evals
 
+## 0.10.8-alpha.1
+
+### Patch Changes
+
+- e0f73c6: Make input optional for scorer run
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+
 ## 0.10.8-alpha.0
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 
 - 83da932: Move @mastra/core to peerdeps
 
-### Patch Changes
-
-- Updated dependencies [b3a3d63]
-- Updated dependencies [344f453]
-- Updated dependencies [0a3ae6d]
-- Updated dependencies [95911be]
-- Updated dependencies [5eb5a99]
-- Updated dependencies [7e632c5]
-- Updated dependencies [1e9fbfa]
-- Updated dependencies [b2ae5aa]
 
-... 1788 more lines hidden. See full changelog in package directory.
+... 1798 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,14 @@
 # @mastra/mcp-docs-server
 
+## 0.13.7-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+
 ## 0.13.7-alpha.0
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 - 3bb8b36: include storage instance to memory config
 
-### Patch Changes
-
-- 1ccccff: dependencies updates:
-  - Updated dependency [`zod@^3.25.56` ↗︎](https://www.npmjs.com/package/zod/v/3.25.56) (from `^3.24.3`, in `dependencies`)
-- 1ccccff: dependencies updates:
-  - Updated dependency [`zod@^3.25.56` ↗︎](https://www.npmjs.com/package/zod/v/3.25.56) (from `^3.24.3`, in `dependencies`)
-- 26f0031: Removed @latest from @mastra/mcp-docs-server scaffolded configuration for Windsurf/Cursor/VSCode. There is an npx caching issue that causes @latest to break the MCP server for many users, and for now removing @latest makes it work. We will debug this more but for now having a working docs server is more important than it updating every time users start their IDE.
-- Updated dependencies [d1ed912]
-- Updated dependencies [f6fd25f]
 
-... 1019 more lines hidden. See full changelog in package directory.
+... 1028 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmemory.md

@@ -1,5 +1,15 @@
 # @mastra/memory
 
+## 0.11.6-alpha.1
+
+### Patch Changes
+
+- cda801d: Added the ability to pass in metadata for UIMessage and MastraMessageV2 in client-js and agent.stream/generate
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+
 ## 0.11.6-alpha.0
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 - Updated dependencies [d8f2d19]
 - Updated dependencies [9d52b17]
 - Updated dependencies [8ba1b51]
-  - @mastra/core@0.10.7-alpha.0
-
-## 0.10.4
-
-### Patch Changes
-
-- 4051477: dependencies updates:
-  - Added dependency [`zod-to-json-schema@^3.24.5` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.5) (to `dependencies`)
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`@upstash/redis@^1.35.0` ↗︎](https://www.npmjs.com/package/@upstash/redis/v/1.35.0) (from `^1.34.5`, in `dependencies`)
 
-... 2406 more lines hidden. See full changelog in package directory.
+... 2416 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,16 @@
 # @mastra/playground-ui
 
+## 5.1.16-alpha.1
+
+### Patch Changes
+
+- 6336993: Fix workflow input form overflow
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+  - @mastra/client-js@0.10.17-alpha.1
+
 ## 5.1.16-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 - Updated dependencies [18da791]
 - Updated dependencies [cb16baf]
 - Updated dependencies [f36e4f1]
-- Updated dependencies [7f6e403]
-  - @mastra/core@0.10.11
-  - @mastra/client-js@0.10.10
-
-## 5.1.11-alpha.4
-
-### Patch Changes
-
-- c1cceea: Bump peerdeps of @matra/core
-  - @mastra/core@0.10.11-alpha.4
-  - @mastra/client-js@0.10.10-alpha.4
 
-... 2202 more lines hidden. See full changelog in package directory.
+... 2213 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,14 @@
 # @mastra/deployer
 
+## 0.12.0-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+
 ## 0.12.0-alpha.0
 
 ### Patch Changes
@@ -290,13 +299,4 @@
 
 ### Patch Changes
 
-- a606c75: show right suspend schema for nested workflow on playground
-- 038e5ae: Add cancel workflow run
-- 81a1b3b: Update peerdeps
-- 7e801dd: Add tools to network api response
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
-- Updated dependencies [a606c75]
-
-... 2512 more lines hidden. See full changelog in package directory.
+... 2521 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,11 @@
 # create-mastra
 
+## 0.10.14-alpha.1
+
+### Patch Changes
+
+- 6336993: Fix workflow input form overflow
+
 ## 0.10.14-alpha.0
 
 ### Patch Changes
@@ -292,11 +298,5 @@
 
 ## 0.10.3
 
-### Patch Changes
-
-- e719504: don't start posthog when the browser is Brave
-- 8f60de4: fix workflow output when the schema is a primitive
-
-## 0.10.3-alpha.1
 
-... 1124 more lines hidden. See full changelog in package directory.
+... 1130 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,16 @@
 # mastra
 
+## 0.10.16-alpha.1
+
+### Patch Changes
+
+- 6336993: Fix workflow input form overflow
+- Updated dependencies [e0f73c6]
+- Updated dependencies [cda801d]
+- Updated dependencies [a77c823]
+  - @mastra/core@0.12.0-alpha.1
+  - @mastra/deployer@0.12.0-alpha.1
+
 ## 0.10.16-alpha.0
 
 ### Patch Changes
@@ -287,16 +298,5 @@
 
 ## 0.10.11
 
-### Patch Changes
 
-- ec77f83: Expose --inspect flag for mastra dev to start debugger
-- af9e40e: Map log level number to string value
-- f457d86: reset localstorage when resetting model settings
-- 8722d53: Fix multi modal remaining steps
-- 565cc0c: fix redirection when clicking on the playground breadcrumbs
-- 4219597: add JSON input close to form input
-- 2873c7f: dependencies updates:
-  - Updated dependency [`dotenv@^16.6.1` ↗︎](https://www.npmjs.com/package/dotenv/v/16.6.1) (from `^16.5.0`, in `dependencies`)
-- a9f51e4: Fix plaground get tools not including x-mastra-dev-header"
-
-... 4563 more lines hidden. See full changelog in package directory.
+... 4574 more lines hidden. See full changelog in package directory.

package/.docs/raw/community/contributing-templates.mdx

@@ -0,0 +1,192 @@
+---
+title: "Contributing Templates"
+description: "How to contribute your own templates to the Mastra ecosystem"
+---
+
+import { Callout } from "nextra/components";
+
+# Contributing Templates
+
+The Mastra community plays a vital role in creating templates that showcase innovative application patterns. This guide explains how to contribute your own templates to the Mastra ecosystem.
+
+## Template Contribution Process
+
+### 1. Review Requirements
+
+Before creating a template, ensure you understand:
+
+- [Templates Reference](/reference/templates) - Technical requirements and conventions
+- [Project Structure](/docs/getting-started/project-structure) - Standard Mastra project organization
+- Community guidelines and quality standards
+
+### 2. Develop Your Template
+
+Create your template following the established patterns:
+
+- Focus on a specific use case or pattern
+- Include comprehensive documentation
+- Test thoroughly with fresh installations
+- Follow all technical requirements
+
+### 3. Submit for Review
+
+Once your template is ready, submit it through our contribution form. Templates undergo an approval process to ensure quality and consistency.
+
+## Submission Guidelines
+
+### Template Criteria
+
+We accept templates that:
+
+- **Demonstrate unique value** - Show innovative use cases or patterns not covered by existing templates
+- **Follow conventions** - Adhere to all technical requirements and structural guidelines
+- **Include quality documentation** - Provide clear setup instructions and usage examples
+- **Work reliably** - Function correctly with minimal setup after installation
+
+### Quality Standards
+
+Templates must meet these quality benchmarks:
+
+- **Code quality** - Clean, well-commented, and maintainable code
+- **Error handling** - Proper error handling for external APIs and user inputs
+- **Type safety** - Full TypeScript typing with Zod validation where appropriate
+- **Documentation** - Comprehensive README with setup and usage instructions
+- **Testing** - Verified to work with fresh installations
+
+## Submission Process
+
+### 1. Prepare Your Template
+
+Ensure your template meets all requirements outlined in the [Templates Reference](/reference/templates):
+
+- Proper project structure in `src/mastra/` directory
+- Standard TypeScript configuration
+- Comprehensive `.env.example` file
+- Detailed README with setup instructions
+
+### 2. Submit Your Template
+
+Submit your template using our contribution form:
+
+**[Submit Template Contribution](https://forms.gle/5qcU5UTKYcgFdVfE7)**
+
+### Required Information
+
+When submitting your template, provide:
+
+- **Template Name** - Clear, descriptive name indicating the use case
+- **Template Author Name** - Your name or organization name
+- **Template Author Email** - Contact email for communication about your submission
+- **GitHub URL** - Link to your template repository
+- **Description** - Detailed explanation of what the template does and its value
+- **Optional Image** - Screenshot or diagram showing the template in action
+- **Optional Demo Video** - Link to a video demonstrating the template's functionality
+
+## Review Process
+
+### Review Criteria
+
+Templates are evaluated on:
+
+- **Technical compliance** - Adherence to template rules and conventions
+- **Code quality** - Clean, maintainable, and well-documented code
+- **Uniqueness** - Novel use cases or innovative implementation patterns
+- **Educational value** - Ability to teach Mastra concepts effectively
+- **Community benefit** - Potential value to the broader Mastra community
+
+### Feedback and Iteration
+
+If your template needs improvements:
+
+- You'll receive specific feedback on required changes
+- Make the requested modifications and resubmit
+- The review process continues until the template meets standards
+
+## Community Guidelines
+
+### Template Ideas
+
+Consider creating templates for:
+
+- **Industry-specific use cases** - Healthcare, finance, education, etc.
+- **Integration patterns** - Specific API or service integrations
+- **Advanced techniques** - Complex workflows, multi-agent systems, or novel patterns
+- **Learning resources** - Step-by-step tutorials for specific concepts
+
+### Development Best Practices
+
+- **Start simple** - Begin with a minimal working example and add complexity gradually
+- **Document thoroughly** - Include detailed comments and comprehensive README
+- **Test extensively** - Verify your template works across different environments
+- **Seek feedback** - Share with the community for early feedback before submission
+
+### Community Engagement
+
+- **Join Discord** - Participate in the [Mastra Discord community](https://discord.gg/BTYqqHKUrf)
+- **Share progress** - Update the community on your template development
+- **Help others** - Assist other contributors with their templates
+- **Stay updated** - Keep track of new Mastra features and conventions
+
+## Template Maintenance
+
+### Ongoing Responsibilities
+
+As a template contributor, you may be asked to:
+
+- **Update dependencies** - Keep templates current with latest Mastra versions
+- **Fix issues** - Address bugs or compatibility problems
+- **Improve documentation** - Enhance instructions based on user feedback
+- **Add features** - Extend templates with new capabilities
+
+### Community Support
+
+The Mastra team and community provide:
+
+- **Technical guidance** - Help with complex implementation challenges
+- **Review feedback** - Detailed feedback to improve template quality
+- **Promotion** - Showcase approved templates to the community
+- **Maintenance assistance** - Support for keeping templates up-to-date
+
+## Validation Checklist
+
+Before submitting a template, verify:
+
+- [ ] All code organized in `src/mastra/` directory
+- [ ] Uses standard Mastra TypeScript configuration
+- [ ] Includes comprehensive `.env.example`
+- [ ] Has detailed README with setup instructions
+- [ ] No monorepo or web framework boilerplate
+- [ ] Successfully runs after fresh install and environment setup
+- [ ] Follows all code quality standards
+- [ ] Demonstrates clear, valuable use case
+
+## Community Showcase
+
+### Template Gallery
+
+Approved templates will be featured in:
+
+- **mastra.ai/templates** - Community template gallery (coming soon)
+- **Documentation** - Referenced in relevant documentation sections
+- **Community highlights** - Featured in newsletters and community updates
+
+### Recognition
+
+Template contributors receive:
+
+- **Attribution** - Your name and contact information with the template
+- **Community recognition** - Acknowledgment in community channels
+
+## Getting Started
+
+Ready to contribute a template?
+
+1. **Explore existing templates** - Review current templates for inspiration and patterns
+2. **Plan your template** - Define the use case and value proposition
+3. **Follow the requirements** - Ensure compliance with all technical requirements
+4. **Build and test** - Create a working, well-documented template
+5. **Submit for review** - Use the contribution form to submit your template
+
+<Callout type="info">
+Your contributions help grow the Mastra ecosystem and provide valuable resources for the entire community. We look forward to seeing your innovative templates!
+</Callout>

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

@@ -68,6 +68,22 @@ You can also run the Mastra CLI in non-interactive mode by passing all required
 npx create-mastra@latest --project-name hello-mastra --example --components tools,agents,workflows --llm openai
 ```
 
+**Install with a template**
+
+Start with a pre-built template that demonstrates specific use cases:
+
+```bash copy
+npx create-mastra@latest --template template-name
+```
+
+For example, to create a text-to-SQL application:
+
+```bash copy
+npx create-mastra@latest --template text-to-sql
+```
+
+> Browse available templates and learn more in [Templates](/docs/getting-started/templates).
+
 > See the [create-mastra](/reference/cli/create-mastra) documentation for a full list of available CLI options.
 
 ### Add your API key

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

@@ -0,0 +1,95 @@
+---
+title: "Templates | Getting Started | Mastra Docs"
+description: Pre-built project structures that demonstrate common Mastra use cases and patterns
+---
+
+import { Callout } from "nextra/components";
+import { Tabs, Tab } from "@/components/tabs";
+
+# Templates
+
+Templates are pre-built Mastra projects that demonstrate specific use cases and patterns. They provide working examples you can run immediately and customize for your needs.
+
+## What Templates Offer
+
+Templates include:
+
+- **Complete working examples** - Functional code demonstrating specific patterns
+- **Best practices** - Proper project structure and Mastra conventions  
+- **Educational value** - Learn different Mastra features through examples
+- **Quick start** - Bootstrap projects faster than starting from scratch
+
+## Using Templates
+
+Install a template using the `create-mastra` command:
+
+<Tabs items={["npx", "npm", "yarn", "pnpm", "bun"]}>
+  <Tab>
+    ```bash copy
+    npx create-mastra@latest --template template-name
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    npm create mastra@latest --template template-name
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    yarn create mastra@latest --template template-name
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    pnpm create mastra@latest --template template-name
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    bun create mastra@latest --template template-name
+    ```
+  </Tab>
+</Tabs>
+
+For example, to create a text-to-SQL application:
+
+```bash copy
+npx create-mastra@latest --template text-to-sql
+```
+
+## Setting Up a Template
+
+After installation:
+
+1. **Navigate to your project**:
+   ```bash copy
+   cd your-project-name
+   ```
+
+2. **Configure environment variables**:
+   ```bash copy
+   cp .env.example .env
+   ```
+   Edit `.env` with your API keys as specified in the template's README.
+
+3. **Start development**:
+   ```bash copy
+   npm run dev
+   ```
+
+<Callout type="info">
+  Each template includes a comprehensive README with specific setup instructions and usage examples.
+</Callout>
+
+## Available Templates
+
+Browse available templates in the [templates directory](https://github.com/mastra-ai/mastra/tree/main/templates) on GitHub.
+
+## Next Steps
+
+- **Explore code** - Understand how templates implement functionality
+- **Customize** - Modify agents, tools, and workflows for your use case
+- **Learn patterns** - Study templates to understand Mastra best practices
+- **Contribute** - Create your own templates for the community
+
+For detailed information on creating templates, see the [Templates Reference](/reference/templates).

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

@@ -16,16 +16,27 @@ The `messages` parameter can be:
 - A single string
 - An array of strings
 - An array of message objects with `role` and `content` properties
+- An array of `UIMessageWithMetadata` objects (for messages with metadata)
 
-The message object structure:
+The message object structures:
 
 ```typescript
 interface Message {
   role: "system" | "user" | "assistant";
   content: string;
 }
+
+// For messages with metadata
+interface UIMessageWithMetadata {
+  role: "user" | "assistant";
+  content: string;
+  parts: Array<{ type: string; text?: string; [key: string]: any }>;
+  metadata?: Record<string, unknown>; // Optional metadata field
+}
 ```
 
+When using `UIMessageWithMetadata`, the metadata will be preserved throughout the conversation and stored with the messages in memory.
+
 ### `options` (Optional)
 
 An optional object that can include configuration for output structure, memory management, tool usage, telemetry, and more.
@@ -175,6 +186,12 @@ An optional object that can include configuration for output structure, memory m
       description:
         "Tools that are executed on the 'client' side of the request. These tools do not have execute functions in the definition.",
     },
+    {
+      name: "savePerStep",
+      type: "boolean",
+      isOptional: true,
+      description: "Save messages incrementally after each stream step completes (default: false).",
+    }
   ]}
 />