mastra 0.4.0-alpha.1 → 0.4.0-alpha.2

package/dist/{chunk-4TSDPCUZ.js → chunk-PRZGXNSB.js}

@@ -1,14 +1,15 @@
-import * as p from '@clack/prompts';
+import * as p2 from '@clack/prompts';
 import color2 from 'picocolors';
 import child_process from 'node:child_process';
 import util from 'node:util';
 import * as fs3 from 'fs';
-import fs3__default from 'fs';
+import fs3__default, { existsSync } from 'fs';
 import fs4 from 'fs/promises';
 import path, { dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { execa } from 'execa';
-import fsExtra3 from 'fs-extra/esm';
+import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
+import os from 'os';
 import prettier from 'prettier';
 import yoctoSpinner from 'yocto-spinner';
 import { createLogger } from '@mastra/core/logger';
@@ -144,6 +145,62 @@ function getPackageManagerInstallCommand(pm) {
       return "install";
   }
 }
+function installMastraDocsMCPServer({
+  editor,
+  directory
+}) {
+  if (!editor) return;
+  if (editor === `cursor`) return installCursorMCP(directory);
+  if (editor === `windsurf`) return installWindsurfMCP();
+}
+var args = ["-y", "@mastra/mcp-docs-server@latest"];
+var mcpConfig = {
+  mcpServers: {
+    mastra: process.platform === `win32` ? {
+      command: "cmd",
+      args: ["/c", "npx", ...args]
+    } : {
+      command: "npx",
+      args
+    }
+  }
+};
+function makeConfig(original) {
+  return {
+    ...original,
+    mcpServers: {
+      ...original?.mcpServers || {},
+      ...mcpConfig.mcpServers
+    }
+  };
+}
+async function writeMergedConfig(configPath) {
+  const configExists = existsSync(configPath);
+  const config = makeConfig(configExists ? await readJSON(configPath) : {});
+  await ensureFile(configPath);
+  await writeJSON(configPath, config, {
+    spaces: 2
+  });
+}
+async function installCursorMCP(directory) {
+  const configPath = path.join(directory, ".cursor", "mcp.json");
+  await writeMergedConfig(configPath);
+}
+async function installWindsurfMCP() {
+  const configPath = path.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
+  const confirm2 = await p2.select({
+    message: `Windsurf only supports a global MCP config (at ${configPath}) is it ok to add/update that global config?
+This means the Mastra docs MCP server will be available in all your Windsurf projects.`,
+    options: [
+      { value: "skip", label: "No, skip for now" },
+      { value: "yes", label: "Yes, I understand" }
+    ]
+  });
+  if (confirm2 !== `yes`) {
+    return void 0;
+  }
+  await writeMergedConfig(configPath);
+}
 
 // src/services/service.env.ts
 var EnvService = class {
@@ -602,16 +659,16 @@ var checkAndInstallCoreDeps = async () => {
 var spinner = yoctoSpinner({ text: "Installing Mastra core dependencies\n" });
 async function installCoreDeps() {
   try {
-    const confirm2 = await p.confirm({
+    const confirm2 = await p2.confirm({
       message: "You do not have the @mastra/core package installed. Would you like to install it?",
       initialValue: false
     });
-    if (p.isCancel(confirm2)) {
-      p.cancel("Installation Cancelled");
+    if (p2.isCancel(confirm2)) {
+      p2.cancel("Installation Cancelled");
       process.exit(0);
     }
     if (!confirm2) {
-      p.cancel("Installation Cancelled");
+      p2.cancel("Installation Cancelled");
       process.exit(0);
     }
     spinner.start();
@@ -668,15 +725,15 @@ var writeCodeSample = async (dirPath, component, llmProvider, importComponents)
   }
 };
 var interactivePrompt = async () => {
-  p.intro(color2.inverse("Mastra Init"));
-  const mastraProject = await p.group(
+  p2.intro(color2.inverse("Mastra Init"));
+  const mastraProject = await p2.group(
     {
-      directory: () => p.text({
+      directory: () => p2.text({
         message: "Where should we create the Mastra files? (default: src/)",
         placeholder: "src/",
         defaultValue: "src/"
       }),
-      components: () => p.multiselect({
+      components: () => p2.multiselect({
         message: "Choose components to install:",
         options: [
           { value: "agents", label: "Agents", hint: "recommended" },
@@ -686,11 +743,11 @@ var interactivePrompt = async () => {
           }
         ]
       }),
-      shouldAddTools: () => p.confirm({
+      shouldAddTools: () => p2.confirm({
         message: "Add tools?",
         initialValue: false
       }),
-      llmProvider: () => p.select({
+      llmProvider: () => p2.select({
         message: "Select default provider:",
         options: [
           { value: "openai", label: "OpenAI", hint: "recommended" },
@@ -701,7 +758,7 @@ var interactivePrompt = async () => {
         ]
       }),
       llmApiKey: async ({ results: { llmProvider } }) => {
-        const keyChoice = await p.select({
+        const keyChoice = await p2.select({
           message: `Enter your ${llmProvider} API key?`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
@@ -710,21 +767,40 @@ var interactivePrompt = async () => {
           initialValue: "skip"
         });
         if (keyChoice === "enter") {
-          return p.text({
+          return p2.text({
             message: "Enter your API key:",
             placeholder: "sk-..."
           });
         }
         return void 0;
       },
-      addExample: () => p.confirm({
+      addExample: () => p2.confirm({
         message: "Add example",
         initialValue: false
-      })
+      }),
+      configureEditorWithDocsMCP: async () => {
+        const editor = await p2.select({
+          message: `Make your AI IDE into a Mastra expert? (installs Mastra docs MCP server)`,
+          options: [
+            { value: "skip", label: "Skip for now", hint: "default" },
+            { value: "cursor", label: "Cursor" },
+            { value: "windsurf", label: "Windsurf" }
+          ]
+        });
+        if (editor === `skip`) return void 0;
+        if (editor === `cursor`) {
+          p2.log.message(
+            `
+Note: you will need to go into Cursor Settings -> MCP Settings and manually enable the installed Mastra MCP server.
+`
+          );
+        }
+        return editor;
+      }
     },
     {
       onCancel: () => {
-        p.cancel("Operation cancelled.");
+        p2.cancel("Operation cancelled.");
         process.exit(0);
       }
     }
@@ -751,14 +827,15 @@ var checkPkgJson = async () => {
 };
 
 // src/commands/init/init.ts
-var s = p.spinner();
+var s = p2.spinner();
 var exec2 = util.promisify(child_process.exec);
 var init = async ({
   directory,
   addExample = false,
   components,
   llmProvider = "openai",
-  llmApiKey
+  llmApiKey,
+  configureEditorWithDocsMCP
 }) => {
   s.start("Initializing Mastra");
   try {
@@ -791,16 +868,22 @@ var init = async ({
     const pm = depsService.packageManager;
     const installCommand = getPackageManagerInstallCommand(pm);
     await exec2(`${pm} ${installCommand} ${aiSdkPackage}`);
+    if (configureEditorWithDocsMCP) {
+      await installMastraDocsMCPServer({
+        editor: configureEditorWithDocsMCP,
+        directory: process.cwd()
+      });
+    }
     s.stop();
     if (!llmApiKey) {
-      p.note(`
+      p2.note(`
       ${color2.green("Mastra initialized successfully!")}
 
       Add your ${color2.cyan(key)} as an environment variable
       in your ${color2.cyan(".env.development")} file
       `);
     } else {
-      p.note(`
+      p2.note(`
       ${color2.green("Mastra initialized successfully!")}
       `);
     }
@@ -843,17 +926,17 @@ var createMastraProject = async ({
   createVersionTag,
   timeout
 }) => {
-  p.intro(color2.inverse("Mastra Create"));
-  const projectName = name ?? await p.text({
+  p2.intro(color2.inverse("Mastra Create"));
+  const projectName = name ?? await p2.text({
     message: "What do you want to name your project?",
     placeholder: "my-mastra-app",
     defaultValue: "my-mastra-app"
   });
-  if (p.isCancel(projectName)) {
-    p.cancel("Operation cancelled");
+  if (p2.isCancel(projectName)) {
+    p2.cancel("Operation cancelled");
     process.exit(0);
   }
-  const s2 = p.spinner();
+  const s2 = p2.spinner();
   s2.start("Creating project");
   try {
     await fs4.mkdir(projectName);
@@ -917,20 +1000,20 @@ var createMastraProject = async ({
   await exec3(`echo .env >> .gitignore`);
   await exec3(`echo *.db >> .gitignore`);
   s2.stop(".gitignore added");
-  p.outro("Project created successfully");
+  p2.outro("Project created successfully");
   console.log("");
   return { projectName };
 };
 
 // src/commands/create/create.ts
-var create = async (args) => {
+var create = async (args2) => {
   const { projectName } = await createMastraProject({
-    projectName: args?.projectName,
-    createVersionTag: args?.createVersionTag,
-    timeout: args?.timeout
+    projectName: args2?.projectName,
+    createVersionTag: args2?.createVersionTag,
+    timeout: args2?.timeout
   });
   const directory = "/src";
-  if (!args.components || !args.llmProvider || !args.addExample) {
+  if (!args2.components || !args2.llmProvider || !args2.addExample) {
     const result = await interactivePrompt();
     await init({
       ...result,
@@ -939,7 +1022,7 @@ var create = async (args) => {
     postCreate({ projectName });
     return;
   }
-  const { components = [], llmProvider = "openai", addExample = false, llmApiKey } = args;
+  const { components = [], llmProvider = "openai", addExample = false, llmApiKey } = args2;
   await init({
     directory,
     components,
@@ -950,7 +1033,7 @@ var create = async (args) => {
   postCreate({ projectName });
 };
 var postCreate = ({ projectName }) => {
-  p.outro(`
+  p2.outro(`
    ${color2.green("To start your project:")}
 
     ${color2.cyan("cd")} ${projectName}

package/dist/commands/create/create.js

@@ -1 +1 @@
-export { create } from '../../chunk-4TSDPCUZ.js';
+export { create } from '../../chunk-PRZGXNSB.js';

package/dist/index.js

@@ -1,8 +1,8 @@
 #! /usr/bin/env node
 import { PosthogAnalytics } from './chunk-SLGHDOYI.js';
 export { PosthogAnalytics } from './chunk-SLGHDOYI.js';
-import { DepsService, create, checkPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService as FileService$1 } from './chunk-4TSDPCUZ.js';
-export { create } from './chunk-4TSDPCUZ.js';
+import { DepsService, create, checkPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService as FileService$1 } from './chunk-PRZGXNSB.js';
+export { create } from './chunk-PRZGXNSB.js';
 import { Command } from 'commander';
 import { join as join$1, dirname, basename } from 'node:path';
 import { getWatcherInputOptions, writeTelemetryConfig, createWatcher, FileService as FileService$2 } from '@mastra/deployer/build';
@@ -178,6 +178,8 @@ var DevBundler = class extends Bundler {
         }
       }
     }
+    const outputDir = join$1(outputDirectory, this.outputDir);
+    const copyPublic = this.copyPublic.bind(this);
     const watcher = await createWatcher(
       {
         ...inputOptions,
@@ -202,6 +204,15 @@ var DevBundler = class extends Bundler {
                 }
               }
             }
+          },
+          {
+            name: "public-dir-watcher",
+            buildStart() {
+              this.addWatchFile(join$1(dirname(entryFile), "public"));
+            },
+            buildEnd() {
+              return copyPublic(dirname(entryFile), outputDirectory);
+            }
           }
         ],
         input: {
@@ -209,7 +220,7 @@ var DevBundler = class extends Bundler {
         }
       },
       {
-        dir: join$1(outputDirectory, this.outputDir)
+        dir: outputDir
       }
     );
     this.logger.info("Starting watcher...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mastra",
-  "version": "0.4.0-alpha.1",
+  "version": "0.4.0-alpha.2",
   "license": "ISC",
   "description": "cli for mastra",
   "type": "module",
@@ -55,8 +55,8 @@
     "yocto-spinner": "^0.1.2",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "^0.6.1-alpha.1",
-    "@mastra/deployer": "^0.2.1-alpha.1"
+    "@mastra/core": "^0.6.1-alpha.2",
+    "@mastra/deployer": "^0.2.1-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.1",