@mastra/mcp-docs-server 0.13.9-alpha.1 → 0.13.9-alpha.3

package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md

@@ -1,5 +1,18 @@
 # @mastra/voice-playai
 
+## 0.10.7-alpha.0
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+- Updated dependencies [cb36de0]
+- Updated dependencies [a82b851]
+- Updated dependencies [41a0a0e]
+- Updated dependencies [2871020]
+- Updated dependencies [4a406ec]
+- Updated dependencies [5d377e5]
+  - @mastra/core@0.13.0-alpha.2
+
 ## 0.10.6
 
 ### Patch Changes
@@ -286,17 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [3171b5b]
-- Updated dependencies [973e5ac]
-- Updated dependencies [9e1eff5]
-  - @mastra/core@0.9.4-alpha.2
-
-## 0.1.18-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [ab80e7e]
-- Updated dependencies [6fa1ad1]
-- Updated dependencies [c28d7a0]
-
-... 1026 more lines hidden. See full changelog in package directory.
+... 1039 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,18 @@
 # @mastra/voice-sarvam
 
+## 0.10.7-alpha.0
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+- Updated dependencies [cb36de0]
+- Updated dependencies [a82b851]
+- Updated dependencies [41a0a0e]
+- Updated dependencies [2871020]
+- Updated dependencies [4a406ec]
+- Updated dependencies [5d377e5]
+  - @mastra/core@0.13.0-alpha.2
+
 ## 0.10.6
 
 ### Patch Changes
@@ -286,17 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [3171b5b]
-- Updated dependencies [973e5ac]
-- Updated dependencies [9e1eff5]
-  - @mastra/core@0.9.4-alpha.2
-
-## 0.1.13-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [ab80e7e]
-- Updated dependencies [6fa1ad1]
-- Updated dependencies [c28d7a0]
-
-... 676 more lines hidden. See full changelog in package directory.
+... 689 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,18 @@
 # @mastra/voice-speechify
 
+## 0.10.7-alpha.0
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+- Updated dependencies [cb36de0]
+- Updated dependencies [a82b851]
+- Updated dependencies [41a0a0e]
+- Updated dependencies [2871020]
+- Updated dependencies [4a406ec]
+- Updated dependencies [5d377e5]
+  - @mastra/core@0.13.0-alpha.2
+
 ## 0.10.6
 
 ### Patch Changes
@@ -286,17 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [3e9c131]
-  - @mastra/core@0.9.4-alpha.4
-
-## 0.1.18-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [396be50]
-- Updated dependencies [c3bd795]
-- Updated dependencies [da082f8]
-- Updated dependencies [a5810ce]
-  - @mastra/core@0.9.4-alpha.3
-
-... 1030 more lines hidden. See full changelog in package directory.
+... 1043 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,7 @@
 # create-mastra
 
+## 0.10.19-alpha.2
+
 ## 0.10.19-alpha.1
 
 ## 0.10.19-alpha.0
@@ -297,6 +299,4 @@
 
 ### Patch Changes
 
-- 44ba52d: Add proper error message when installation of mastra fails
-
-... 1155 more lines hidden. See full changelog in package directory.
+... 1157 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,22 @@
 # mastra
 
+## 0.10.19-alpha.2
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+- Updated dependencies [cb36de0]
+- Updated dependencies [cb36de0]
+- Updated dependencies [a82b851]
+- Updated dependencies [41a0a0e]
+- Updated dependencies [2871020]
+- Updated dependencies [4a406ec]
+- Updated dependencies [5d377e5]
+  - @mastra/core@0.13.0-alpha.2
+  - @mastra/deployer@0.13.0-alpha.2
+  - @mastra/loggers@0.10.6-alpha.0
+  - @mastra/mcp@0.10.10-alpha.0
+
 ## 0.10.19-alpha.1
 
 ### Patch Changes
@@ -281,22 +298,5 @@
 - af1f902: share thread list between agent, network and cloud
 - 2affc57: Fix output type of network loop
 - 51192f8: Spread the loaded env into the main process
-- f6c4d75: fix date picker on change
-- 698518b: Allow external templates from github
-- 09464dd: Share AgentMetadata component with cloud
-- 80c2b06: Fix agent chat stop button to cancel stream/generate reqs in the playground
-- Updated dependencies [f248d53]
-- Updated dependencies [82c6860]
-- Updated dependencies [2affc57]
-- Updated dependencies [66e13e3]
-- Updated dependencies [edd9482]
-- Updated dependencies [18344d7]
-- Updated dependencies [7ba91fa]
-- Updated dependencies [a512ede]
-- Updated dependencies [35b1155]
-- Updated dependencies [9d372c2]
-- Updated dependencies [45469c5]
-- Updated dependencies [40c2525]
-- Updated dependencies [e473f27]
 
-... 4742 more lines hidden. See full changelog in package directory.
+... 4759 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/agui.md

@@ -13,14 +13,14 @@
     "@mastra/loggers": "latest",
     "@mastra/memory": "latest",
     "mastra": "latest",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "zod": "^3.25.67"
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
     "@vitejs/plugin-react": "^4.4.1",

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -7,15 +7,15 @@
     "@ai-sdk/react": "^1.2.12",
     "@mastra/core": "latest",
     "next": "^15.3.1",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "zod": "^3.25.67"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.0",
     "@types/node": "^20.17.57",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "eslint": "^9.30.1",
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",

package/.docs/organized/code-examples/ai-sdk-v5.md

@@ -13,16 +13,16 @@
     "@mastra/rag": "0.0.0-ai-v5-20250625173645",
     "@mastra/server": "0.0.0-ai-v5-20250625173645",
     "next": "15.2.4",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "swr": "^2.3.3",
     "zod": "^3.25.67"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3",
     "@types/node": "^20",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "eslint": "^9",
     "eslint-config-next": "15.1.7",
     "mastra": "0.0.0-ai-v5-20250625173645",

package/.docs/organized/code-examples/assistant-ui.md

@@ -9,15 +9,15 @@
     "@assistant-ui/react-ui": "^0.1.8",
     "@mastra/client-js": "latest",
     "next": "^15.3.1",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "tailwindcss-animate": "^1.0.7",
     "zod": "^3.25.67"
   },
   "devDependencies": {
     "@types/node": "^20.17.57",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "eslint": "^9.30.1",
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",

package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md

@@ -12,8 +12,8 @@
     "next": "^15.3.1",
     "next-themes": "^0.4.5",
     "nuqs": "^2.4.1",
-    "react": "19.1.0",
-    "react-dom": "19.1.0",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
     "sonner": "^1.7.4",
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",

package/.docs/organized/code-examples/bird-checker-with-nextjs.md

@@ -11,8 +11,8 @@
     "next": "^15.3.1",
     "next-themes": "^0.4.5",
     "nuqs": "^2.4.1",
-    "react": "19.1.0",
-    "react-dom": "19.1.0",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
     "sonner": "^1.7.4",
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",
@@ -21,8 +21,8 @@
   "devDependencies": {
     "@libsql/client": "^0.15.4",
     "@types/node": "^20.17.57",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "eslint": "^9.30.1",
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",

package/.docs/organized/code-examples/client-side-tools.md

@@ -6,14 +6,14 @@
     "@ai-sdk/openai": "^1.3.22",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "zod": "^3.25.67"
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "@vitejs/plugin-react": "^4.3.4",
     "eslint": "^9.30.1",
     "eslint-plugin-react-hooks": "^5.2.0",

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -50,8 +50,8 @@
     "prosemirror-schema-list": "^1.5.1",
     "prosemirror-state": "^1.4.3",
     "prosemirror-view": "^1.39.1",
-    "react": "19.1.0",
-    "react-dom": "19.1.0",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
     "react-markdown": "^9.1.0",
     "remark-gfm": "^4.0.1",
     "server-only": "^0.0.1",
@@ -68,8 +68,8 @@
     "@types/d3-scale": "^4.0.9",
     "@types/node": "^22.15.29",
     "@types/pdf-parse": "^1.1.4",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "drizzle-kit": "^0.31.0",
     "eslint": "^9.30.1",
     "eslint-config-next": "15.3.5",

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -17,8 +17,8 @@
     "clsx": "^2.1.1",
     "lucide-react": "^0.454.0",
     "next": "15.2.4",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
     "react-syntax-highlighter": "^15.6.1",
     "sharp": "^0.33.5",
     "tailwind-merge": "^2.6.0",
@@ -30,8 +30,8 @@
     "@libsql/client": "^0.15.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.17.57",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
     "@types/react-syntax-highlighter": "^15.5.13",
     "eslint": "^9.30.1",
     "eslint-config-next": "15.3.5",

package/.docs/organized/code-examples/workflow-with-separate-steps.md

@@ -20,15 +20,21 @@
 import { mastra } from './mastra';
 
 async function main() {
-  const myWorkflow = mastra.getWorkflow('myWorkflow');
-  const { start } = myWorkflow.createRun();
+  const run = await mastra.getWorkflow('myWorkflow').createRunAsync();
   try {
-    const res = await start({
-      triggerData: {
-        inputValue: 30,
+    const res = await run.start({
+      inputData: {
+        inputValue: 12,
       },
     });
-    console.log(res.results);
+
+    if (res.status === 'success') {
+      console.log(res.result);
+    } else if (res.status === 'failed') {
+      console.log('Workflow failed:', res.error);
+    } else {
+      console.log('Workflow suspended:', res.suspended);
+    }
   } catch (e) {
     console.log(e);
   }
@@ -54,64 +60,101 @@ export const mastra = new Mastra({
 
 ### mastra/workflows/index.ts
 ```typescript
-import { Step, Workflow } from '@mastra/core/workflows';
+import { createStep, createWorkflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 
-const stepOne = new Step({
+const stepOne = createStep({
   id: 'stepOne',
-  execute: async ({ context }) => {
-    const triggerData = context?.triggerData;
-    const doubledValue = triggerData.inputValue * 2;
-    return { doubledValue };
+  inputSchema: z.object({
+    inputValue: z.number(),
+  }),
+  outputSchema: z.object({
+    doubledValue: z.number(),
+    isOriginalOdd: z.boolean(), // Track original parity
+  }),
+  execute: async ({ inputData }) => {
+    const doubledValue = inputData.inputValue * 2;
+    const isOriginalOdd = inputData.inputValue % 2 === 1;
+    return { doubledValue, isOriginalOdd };
   },
 });
 
-const stepTwo = new Step({
+const stepTwo = createStep({
   id: 'stepTwo',
-  execute: async ({ context }) => {
-    if (context?.steps.stepOne.status !== 'success') {
-      throw new Error('stepOne failed');
-    }
-    const stepOneResult = context?.steps.stepOne?.output;
-    const incrementedValue = stepOneResult.doubledValue + 1;
+  inputSchema: z.object({
+    doubledValue: z.number(),
+    isOriginalOdd: z.boolean(),
+  }),
+  outputSchema: z.object({
+    incrementedValue: z.number(),
+  }),
+  execute: async ({ inputData }) => {
+    // Increment only if original input was odd
+    const incrementedValue = inputData.doubledValue + (inputData.isOriginalOdd ? 1 : 0);
     return { incrementedValue };
   },
 });
 
-const stepThree = new Step({
+const stepThree = createStep({
   id: 'stepThree',
-  execute: async ({ context }) => {
-    const triggerData = context?.triggerData;
-    const tripledValue = triggerData.inputValue * 3;
+  inputSchema: z.object({
+    incrementedValue: z.number(),
+  }),
+  outputSchema: z.object({
+    tripledValue: z.number(),
+  }),
+  execute: async ({ inputData, getStepResult }) => {
+    try {
+      const stepTwoResult = getStepResult(stepTwo);
+      if (!stepTwoResult || typeof stepTwoResult.incrementedValue !== 'number') {
+        throw new Error('stepTwo failed or returned invalid data');
+      }
+    } catch (error) {
+      throw new Error(`stepTwo failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+
+    const tripledValue = inputData.incrementedValue * 3;
     return { tripledValue };
   },
 });
 
-const stepFour = new Step({
+const stepFour = createStep({
   id: 'stepFour',
-  execute: async ({ context }) => {
-    if (context?.steps.stepThree.status !== 'success') {
-      throw new Error('stepThree failed');
+  inputSchema: z.object({
+    tripledValue: z.number(),
+  }),
+  outputSchema: z.object({
+    isEven: z.boolean(),
+  }),
+  execute: async ({ inputData, getStepResult }) => {
+    try {
+      const stepThreeResult = getStepResult(stepThree);
+      if (!stepThreeResult || typeof stepThreeResult.tripledValue !== 'number') {
+        throw new Error('stepThree failed or returned invalid data');
+      }
+    } catch (error) {
+      throw new Error(`stepThree failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
-    const stepThreeResult = context?.steps.stepThree?.output;
-    const isEven = stepThreeResult.tripledValue % 2 === 0;
+
+    const isEven = inputData.tripledValue % 2 === 0;
     return { isEven };
   },
 });
 
-export const myWorkflow = new Workflow({
-  name: 'my-workflow',
-  triggerSchema: z.object({
+export const myWorkflow = createWorkflow({
+  id: 'my-workflow',
+  inputSchema: z.object({
     inputValue: z.number(),
   }),
-});
-
-myWorkflow.step(stepOne).then(stepTwo).step(stepThree).then(stepFour).commit();
-
-const { start } = myWorkflow.createRun();
-
-const result = await start({ triggerData: { inputValue: 3 } });
+  outputSchema: z.object({
+    isEven: z.boolean(),
+  }),
+})
+  .then(stepOne)
+  .then(stepTwo)
+  .then(stepThree)
+  .then(stepFour);
 
-console.log(result);
+myWorkflow.commit();
 
 ```

package/.docs/raw/agents/overview.mdx

@@ -100,6 +100,7 @@ await testAgent.generate([
       {
         type: 'image',
         image: "https://example.com/images/test-image.jpg",
+        mimeType: "image/jpeg"
       },
       {
         type: 'text',

package/.docs/raw/course/02-agent-tools-mcp/14-getting-github-mcp-url.md

@@ -1,16 +1,35 @@
-# Getting a Composio GitHub MCP URL
+# Getting a Smithery GitHub MCP URL
 
-First, you'll need to get a Composio GitHub MCP URL. This typically requires:
+First, you'll need to get a Smithery GitHub MCP URL. This typically requires:
 
-1. Setting up the Composio GitHub integration
-2. Authenticating with your GitHub account
-3. Getting your unique MCP URL
+1. Setting up a Smithery account
+2. Creating a personal access token with your GitHub account
+3. Getting your unique MCP URL via the Smithery packages
 
-For this example, we'll use an environment variable to store the URL:
+For this example, we'll use an environment variable to store the Smithery API key and profile name which can be found in the Smithery interface.
 
 ```bash
 # Add this to your .env file
-COMPOSIO_MCP_GITHUB=https://your-composio-github-mcp-url.com
+SMITHERY_API_KEY=your_smithery_api_key
+SMITHERY_PROFILE=your_smithery_profile_name
 ```
 
-Using an environment variable keeps your configuration secure and flexible. This approach allows you to easily switch between different GitHub accounts or environments without modifying your code. It also prevents sensitive information from being committed to your repository.
+Using an environment variable keeps your configuration secure and flexible. It also prevents sensitive information from being committed to your repository.
+
+We will use the Smithery packages to authenticate and create a streamable HTTP URL for the MCP server configuration
+
+```bash
+pnpm install @smithery/sdk
+```
+
+```ts
+import { createSmitheryUrl } from "@smithery/sdk";
+
+const smitheryGithubMCPServerUrl = createSmitheryUrl(
+  "https://server.smithery.ai/@smithery-ai/github",
+  {
+    apiKey: process.env.SMITHERY_API_KEY,
+    profile: process.env.SMITHERY_PROFILE,
+  },
+);
+```

package/.docs/raw/course/02-agent-tools-mcp/15-updating-mcp-config-github.md

@@ -9,7 +9,7 @@ const mcp = new MCPClient({
       url: new URL(process.env.ZAPIER_MCP_URL || ""),
     },
     github: {
-      url: new URL(process.env.COMPOSIO_MCP_GITHUB || ""),
+      url: smitheryGithubMCPServerUrl,
     },
   },
 });

package/.docs/raw/memory/memory-processors.mdx

@@ -97,9 +97,10 @@ const memoryWithMultipleProcessors = new Memory({
 
 You can create custom logic by extending the base `MemoryProcessor` class.
 
-```typescript copy showLineNumbers {4-19,23-26}
-import { Memory, CoreMessage } from "@mastra/memory";
-import { MemoryProcessor, MemoryProcessorOpts } from "@mastra/core/memory";
+```typescript copy showLineNumbers {5-20,24-27}
+import { Memory } from "@mastra/memory";
+import { CoreMessage, MemoryProcessorOpts } from "@mastra/core";
+import { MemoryProcessor } from "@mastra/core/memory";
 
 class ConversationOnlyFilter extends MemoryProcessor {
   constructor() {

package/.docs/raw/workflows/using-with-agents-and-tools.mdx

@@ -258,6 +258,31 @@ export const cityCoordinatesTool = createTool({
 });
 ```
 
+## Using workflows in agents
+
+You can also use Workflows in Agents. This agent is able to choose between using the test tool or the test workflow.
+
+```typescript
+import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
+import { testTool } from "../tools/test-tool";
+import { testWorkflow } from "../workflows/test-workflow";
+
+export const testAgent = new Agent({
+  name: "test-agent",
+  description: "Create facts for a country based on the city",
+  instructions: `Return an interesting fact about the country based on the city provided`,
+  model: openai("gpt-4o"),
+  workflows: {
+    test_workflow: testWorkflow
+  },
+  tools: {
+    test_tool: testTool
+  },
+});
+```
+
+
 ## Exposing workflows with `MCPServer`
 
 You can convert your workflows into tools by passing them into an instance of a Mastra `MCPServer`. This allows any MCP-compatible client to access your workflow.