mastra 0.3.2-alpha.0 → 0.4.0-alpha.2

package/dist/{chunk-7BUCNWW4.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 {
@@ -273,6 +330,8 @@ var getAISDKPackage = (llmProvider) => {
       return "@ai-sdk/groq";
     case "google":
       return "@ai-sdk/google";
+    case "cerebras":
+      return "@ai-sdk/cerebras";
     default:
       return "@ai-sdk/openai";
   }
@@ -288,10 +347,13 @@ var getProviderImportAndModelItem = (llmProvider) => {
     modelItem = `anthropic('claude-3-5-sonnet-20241022')`;
   } else if (llmProvider === "groq") {
     providerImport = `import { groq } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `groq('llama-3.3-70b-versatile`;
+    modelItem = `groq('llama-3.3-70b-versatile')`;
   } else if (llmProvider === "google") {
     providerImport = `import { google } from '${getAISDKPackage(llmProvider)}';`;
     modelItem = `google('gemini-1.5-pro-latest')`;
+  } else if (llmProvider === "cerebras") {
+    providerImport = `import { cerebras } from '${getAISDKPackage(llmProvider)}';`;
+    modelItem = `cerebras('llama-3.3-70b')`;
   }
   return { providerImport, modelItem };
 };
@@ -597,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();
@@ -629,6 +691,9 @@ var getAPIKey = async (provider) => {
     case "google":
       key = "GOOGLE_GENERATIVE_AI_API_KEY";
       return key;
+    case "cerebras":
+      key = "CEREBRAS_API_KEY";
+      return key;
     default:
       return key;
   }
@@ -660,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" },
@@ -678,21 +743,22 @@ 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" },
           { value: "anthropic", label: "Anthropic" },
           { value: "groq", label: "Groq" },
-          { value: "google", label: "Google" }
+          { value: "google", label: "Google" },
+          { value: "cerebras", label: "Cerebras" }
         ]
       }),
       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" },
@@ -701,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);
       }
     }
@@ -742,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 {
@@ -782,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!")}
       `);
     }
@@ -830,20 +922,21 @@ var execWithTimeout = async (command, timeoutMs) => {
   }
 };
 var createMastraProject = async ({
+  projectName: name,
   createVersionTag,
   timeout
 }) => {
-  p.intro(color2.inverse("Mastra Create"));
-  const projectName = 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);
@@ -907,19 +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({
-    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,
@@ -928,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,
@@ -939,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.d.ts

@@ -1,6 +1,7 @@
-type LLMProvider = 'openai' | 'anthropic' | 'groq' | 'google';
+type LLMProvider = 'openai' | 'anthropic' | 'groq' | 'google' | 'cerebras';
 
 declare const create: (args: {
+    projectName?: string;
     components?: string[];
     llmProvider?: LLMProvider;
     addExample?: boolean;

package/dist/commands/create/create.js

@@ -1 +1 @@
-export { create } from '../../chunk-7BUCNWW4.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-7BUCNWW4.js';
-export { create } from './chunk-7BUCNWW4.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...");
@@ -354,7 +365,10 @@ program.version(`${version}`, "-v, --version").description(`Mastra CLI ${version
   } catch {
   }
 });
-program.command("create").description("Create a new Mastra project").option("--default", "Quick start with defaults(src, OpenAI, no examples)").option("-c, --components <components>", "Comma-separated list of components (agents, tools, workflows)").option("-l, --llm <model-provider>", "Default model provider (openai, anthropic, groq, or google))").option("-k, --llm-api-key <api-key>", "API key for the model provider").option("-e, --example", "Include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").action(async (args) => {
+program.command("create").description("Create a new Mastra project").option("--default", "Quick start with defaults(src, OpenAI, no examples)").option("-c, --components <components>", "Comma-separated list of components (agents, tools, workflows)").option("-l, --llm <model-provider>", "Default model provider (openai, anthropic, groq, google, or cerebras))").option("-k, --llm-api-key <api-key>", "API key for the model provider").option("-e, --example", "Include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option(
+  "-p, --project-name <string>",
+  "Project name that will be used in package.json and as the project directory name."
+).action(async (args) => {
   await analytics.trackCommandExecution({
     command: "create",
     args,
@@ -374,7 +388,8 @@ program.command("create").description("Create a new Mastra project").option("--d
         llmProvider: args.llm,
         addExample: args.example,
         llmApiKey: args["llm-api-key"],
-        timeout
+        timeout,
+        projectName: args.projectName
       });
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mastra",
-  "version": "0.3.2-alpha.0",
+  "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/deployer": "^0.2.1-alpha.0",
-    "@mastra/core": "^0.6.1-alpha.0"
+    "@mastra/core": "^0.6.1-alpha.2",
+    "@mastra/deployer": "^0.2.1-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.1",