create-mastra 0.16.0-alpha.1 → 0.17.0-alpha.0

package/dist/index.js

@@ -1,10 +1,10 @@
 #! /usr/bin/env node
 import { Command } from 'commander';
 import { randomUUID } from 'node:crypto';
-import * as fs4__default from 'node:fs';
-import fs4__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import * as fs3__default from 'node:fs';
+import fs3__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
-import path3, { dirname } from 'node:path';
+import path, { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { PostHog } from 'posthog-node';
 import util, { stripVTControlCharacters } from 'node:util';
@@ -12,18 +12,18 @@ import y$1, { stdout, stdin } from 'node:process';
 import * as g from 'node:readline';
 import g__default from 'node:readline';
 import { Writable } from 'node:stream';
-import fs5 from 'node:fs/promises';
+import fs4 from 'node:fs/promises';
 import child_process from 'node:child_process';
 import tty from 'node:tty';
-import pino from 'pino';
-import pretty from 'pino-pretty';
-import { execa } from 'execa';
 import fsExtra, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
 import prettier from 'prettier';
+import { execa } from 'execa';
+import pino from 'pino';
+import pretty from 'pino-pretty';
 import fsExtra$1 from 'fs-extra';
 
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path3.dirname(__filename);
+var __dirname = path.dirname(__filename);
 var analyticsInstance = null;
 function getAnalytics() {
   return analyticsInstance;
@@ -39,7 +39,7 @@ var PosthogAnalytics = class {
     host = "https://app.posthog.com"
   }) {
     this.version = version;
-    const cliConfigPath = path3.join(__dirname, "mastra-cli.json");
+    const cliConfigPath = path.join(__dirname, "mastra-cli.json");
     if (existsSync(cliConfigPath)) {
       try {
         const { distinctId, sessionId } = JSON.parse(readFileSync(cliConfigPath, "utf-8"));
@@ -67,7 +67,7 @@ var PosthogAnalytics = class {
   }
   writeCliConfig({ distinctId, sessionId }) {
     try {
-      writeFileSync(path3.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
+      writeFileSync(path.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
     } catch {
     }
   }
@@ -422,7 +422,7 @@ ${color2.gray(d)}  ${t}
 `):process.stdout.write(`${w}  ${l}
 `),E(),s();};return {start:H,stop:N,message:(m="")=>{l=R(m??l);}}},Ce=async(t,n)=>{const r={},i=Object.keys(t);for(const s of i){const c=t[s],a=await c({results:r})?.catch(l=>{throw l});if(typeof n?.onCancel=="function"&&pD(a)){r[s]="canceled",n.onCancel({results:r});continue}r[s]=a;}return r};
 
-var shellQuote$1 = {};
+var shellQuote = {};
 
 var quote;
 var hasRequiredQuote;
@@ -688,16 +688,16 @@ function requireParse () {
 var hasRequiredShellQuote;
 
 function requireShellQuote () {
-	if (hasRequiredShellQuote) return shellQuote$1;
+	if (hasRequiredShellQuote) return shellQuote;
 	hasRequiredShellQuote = 1;
 
-	shellQuote$1.quote = requireQuote();
-	shellQuote$1.parse = requireParse();
-	return shellQuote$1;
+	shellQuote.quote = requireQuote();
+	shellQuote.parse = requireParse();
+	return shellQuote;
 }
 
 var shellQuoteExports = requireShellQuote();
-var shellQuote = /*@__PURE__*/getDefaultExportFromCjs(shellQuoteExports);
+var shellQuote2 = /*@__PURE__*/getDefaultExportFromCjs(shellQuoteExports);
 
 // eslint-disable-next-line no-warning-comments
 // TODO: Use a better method when it's added to Node.js (https://github.com/nodejs/node/pull/40240)
@@ -724,18 +724,13 @@ const format = (open, close) => {
 		// Handle nested colors.
 
 		// We could have done this, but it's too slow (as of Node.js 22).
-		// return openCode + string.replaceAll(closeCode, (close === 22 ? closeCode : '') + openCode) + closeCode;
+		// return openCode + string.replaceAll(closeCode, openCode) + closeCode;
 
 		let result = openCode;
 		let lastIndex = 0;
 
-		// SGR 22 resets both bold (1) and dim (2). When we encounter a nested
-		// close for styles that use 22, we need to re-open the outer style.
-		const reopenOnNestedClose = close === 22;
-		const replaceCode = (reopenOnNestedClose ? closeCode : '') + openCode;
-
 		while (index !== -1) {
-			result += string.slice(lastIndex, index) + replaceCode;
+			result += string.slice(lastIndex, index) + openCode;
 			lastIndex = index + closeCode.length;
 			index = string.indexOf(closeCode, lastIndex);
 		}
@@ -1178,282 +1173,6 @@ var PinoLogger = class extends MastraLogger {
   }
 };
 
-function getPackageManager() {
-  const userAgent = process.env.npm_config_user_agent || "";
-  const execPath = process.env.npm_execpath || "";
-  if (userAgent.includes("yarn")) {
-    return "yarn";
-  }
-  if (userAgent.includes("pnpm")) {
-    return "pnpm";
-  }
-  if (userAgent.includes("npm")) {
-    return "npm";
-  }
-  if (execPath.includes("yarn")) {
-    return "yarn";
-  }
-  if (execPath.includes("pnpm")) {
-    return "pnpm";
-  }
-  if (execPath.includes("npm")) {
-    return "npm";
-  }
-  return "npm";
-}
-var logger = createLogger(false);
-function createLogger(debug = false) {
-  return new PinoLogger({
-    name: "Mastra CLI",
-    level: debug ? "debug" : "info"
-  });
-}
-var exec = util.promisify(child_process.exec);
-async function cloneTemplate(options) {
-  const { template, projectName, targetDir } = options;
-  const projectPath = targetDir ? path3.resolve(targetDir, projectName) : path3.resolve(projectName);
-  const spinner5 = yoctoSpinner({ text: `Cloning template "${template.title}"...` }).start();
-  try {
-    if (await directoryExists(projectPath)) {
-      spinner5.error(`Directory ${projectName} already exists`);
-      throw new Error(`Directory ${projectName} already exists`);
-    }
-    await cloneRepositoryWithoutGit(template.githubUrl, projectPath);
-    await updatePackageJson(projectPath, projectName);
-    const envExamplePath = path3.join(projectPath, ".env.example");
-    if (await fileExists(envExamplePath)) {
-      await fs5.copyFile(envExamplePath, path3.join(projectPath, ".env"));
-    }
-    spinner5.success(`Template "${template.title}" cloned successfully to ${projectName}`);
-    return projectPath;
-  } catch (error) {
-    spinner5.error(`Failed to clone template: ${error instanceof Error ? error.message : "Unknown error"}`);
-    throw error;
-  }
-}
-async function directoryExists(dirPath) {
-  try {
-    const stat = await fs5.stat(dirPath);
-    return stat.isDirectory();
-  } catch {
-    return false;
-  }
-}
-async function fileExists(filePath) {
-  try {
-    const stat = await fs5.stat(filePath);
-    return stat.isFile();
-  } catch {
-    return false;
-  }
-}
-async function cloneRepositoryWithoutGit(repoUrl, targetPath) {
-  await fs5.mkdir(targetPath, { recursive: true });
-  try {
-    const degitRepo = repoUrl.replace("https://github.com/", "");
-    const degitCommand = shellQuote.quote(["npx", "degit", degitRepo, targetPath]);
-    await exec(degitCommand, {
-      cwd: process.cwd()
-    });
-  } catch {
-    try {
-      const gitCommand = shellQuote.quote(["git", "clone", repoUrl, targetPath]);
-      await exec(gitCommand, {
-        cwd: process.cwd()
-      });
-      const gitDir = path3.join(targetPath, ".git");
-      if (await directoryExists(gitDir)) {
-        await fs5.rm(gitDir, { recursive: true, force: true });
-      }
-    } catch (gitError) {
-      throw new Error(`Failed to clone repository: ${gitError instanceof Error ? gitError.message : "Unknown error"}`);
-    }
-  }
-}
-async function updatePackageJson(projectPath, projectName) {
-  const packageJsonPath = path3.join(projectPath, "package.json");
-  try {
-    const packageJsonContent = await fs5.readFile(packageJsonPath, "utf-8");
-    const packageJson = JSON.parse(packageJsonContent);
-    packageJson.name = projectName;
-    await fs5.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2), "utf-8");
-  } catch (error) {
-    logger.warn(`Could not update package.json: ${error instanceof Error ? error.message : "Unknown error"}`);
-  }
-}
-async function installDependencies(projectPath, packageManager) {
-  const spinner5 = yoctoSpinner({ text: "Installing dependencies..." }).start();
-  try {
-    const pm = packageManager || getPackageManager();
-    const installCommand = shellQuote.quote([pm, "install"]);
-    await exec(installCommand, {
-      cwd: projectPath
-    });
-    spinner5.success("Dependencies installed successfully");
-  } catch (error) {
-    spinner5.error(`Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`);
-    throw error;
-  }
-}
-var TEMPLATES_API_URL = process.env.MASTRA_TEMPLATES_API_URL || "https://mastra.ai/api/templates.json";
-async function loadTemplates() {
-  try {
-    const response = await fetch(TEMPLATES_API_URL);
-    if (!response.ok) {
-      throw new Error(`Failed to fetch templates: ${response.statusText}`);
-    }
-    const templates = await response.json();
-    return templates;
-  } catch (error) {
-    console.error("Error loading templates:", error);
-    throw new Error("Failed to load templates. Please check your internet connection and try again.");
-  }
-}
-function pluralize(count, singular, plural) {
-  return count === 1 ? singular : plural || `${singular}s`;
-}
-async function selectTemplate(templates) {
-  const choices = templates.map((template) => {
-    const parts = [];
-    if (template.agents?.length) {
-      parts.push(`${template.agents.length} ${pluralize(template.agents.length, "agent")}`);
-    }
-    if (template.tools?.length) {
-      parts.push(`${template.tools.length} ${pluralize(template.tools.length, "tool")}`);
-    }
-    if (template.workflows?.length) {
-      parts.push(`${template.workflows.length} ${pluralize(template.workflows.length, "workflow")}`);
-    }
-    if (template.mcp?.length) {
-      parts.push(`${template.mcp.length} ${pluralize(template.mcp.length, "MCP server")}`);
-    }
-    if (template.networks?.length) {
-      parts.push(`${template.networks.length} ${pluralize(template.networks.length, "agent network")}`);
-    }
-    return {
-      value: template,
-      label: template.title,
-      hint: parts.join(", ") || "Template components"
-    };
-  });
-  const selected = await ve({
-    message: "Select a template:",
-    options: choices
-  });
-  if (pD(selected)) {
-    return null;
-  }
-  return selected;
-}
-function findTemplateByName(templates, templateName) {
-  let template = templates.find((t) => t.slug === templateName);
-  if (template) return template;
-  const slugWithPrefix = `template-${templateName}`;
-  template = templates.find((t) => t.slug === slugWithPrefix);
-  if (template) return template;
-  template = templates.find((t) => t.title.toLowerCase() === templateName.toLowerCase());
-  if (template) return template;
-  return null;
-}
-function getDefaultProjectName(template) {
-  return template.slug.replace(/^template-/, "");
-}
-function getPackageManagerAddCommand(pm) {
-  switch (pm) {
-    case "npm":
-      return "install --audit=false --fund=false --loglevel=error --progress=false --update-notifier=false";
-    case "yarn":
-      return "add";
-    case "pnpm":
-      return "add --loglevel=error";
-    case "bun":
-      return "add";
-    default:
-      return "add";
-  }
-}
-var DepsService = class {
-  packageManager;
-  constructor() {
-    this.packageManager = this.getPackageManager();
-  }
-  findLockFile(dir) {
-    const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock"];
-    for (const file of lockFiles) {
-      if (fs4__default__default.existsSync(path3.join(dir, file))) {
-        return file;
-      }
-    }
-    const parentDir = path3.resolve(dir, "..");
-    if (parentDir !== dir) {
-      return this.findLockFile(parentDir);
-    }
-    return null;
-  }
-  getPackageManager() {
-    const lockFile = this.findLockFile(process.cwd());
-    switch (lockFile) {
-      case "pnpm-lock.yaml":
-        return "pnpm";
-      case "package-lock.json":
-        return "npm";
-      case "yarn.lock":
-        return "yarn";
-      case "bun.lock":
-        return "bun";
-      default:
-        return "npm";
-    }
-  }
-  async installPackages(packages) {
-    const pm = this.packageManager;
-    const installCommand = getPackageManagerAddCommand(pm);
-    const packageList = packages.join(" ");
-    return execa(`${pm} ${installCommand} ${packageList}`, {
-      all: true,
-      shell: true,
-      stdio: "inherit"
-    });
-  }
-  async checkDependencies(dependencies) {
-    try {
-      const packageJsonPath = path3.join(process.cwd(), "package.json");
-      try {
-        await fs5.access(packageJsonPath);
-      } catch {
-        return "No package.json file found in the current directory";
-      }
-      const packageJson = JSON.parse(await fs5.readFile(packageJsonPath, "utf-8"));
-      for (const dependency of dependencies) {
-        if (!packageJson.dependencies || !packageJson.dependencies[dependency]) {
-          return `Please install ${dependency} before running this command (${this.packageManager} install ${dependency})`;
-        }
-      }
-      return "ok";
-    } catch (err) {
-      console.error(err);
-      return "Could not check dependencies";
-    }
-  }
-  async getProjectName() {
-    try {
-      const packageJsonPath = path3.join(process.cwd(), "package.json");
-      const packageJson = await fs5.readFile(packageJsonPath, "utf-8");
-      const pkg = JSON.parse(packageJson);
-      return pkg.name;
-    } catch (err) {
-      throw err;
-    }
-  }
-  async addScriptsToPackageJson(scripts) {
-    const packageJson = JSON.parse(await fs5.readFile("package.json", "utf-8"));
-    packageJson.scripts = {
-      ...packageJson.scripts,
-      ...scripts
-    };
-    await fs5.writeFile("package.json", JSON.stringify(packageJson, null, 2));
-  }
-};
 var args = ["-y", "@mastra/mcp-docs-server"];
 var createMcpConfig = (editor) => {
   if (editor === "vscode") {
@@ -1506,19 +1225,19 @@ async function writeMergedConfig(configPath, editor) {
     spaces: 2
   });
 }
-var windsurfGlobalMCPConfigPath = path3.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
-var cursorGlobalMCPConfigPath = path3.join(os.homedir(), ".cursor", "mcp.json");
-path3.join(process.cwd(), ".vscode", "mcp.json");
-var vscodeGlobalMCPConfigPath = path3.join(
+var windsurfGlobalMCPConfigPath = path.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
+var cursorGlobalMCPConfigPath = path.join(os.homedir(), ".cursor", "mcp.json");
+path.join(process.cwd(), ".vscode", "mcp.json");
+var vscodeGlobalMCPConfigPath = path.join(
   os.homedir(),
-  process.platform === "win32" ? path3.join("AppData", "Roaming", "Code", "User", "settings.json") : process.platform === "darwin" ? path3.join("Library", "Application Support", "Code", "User", "settings.json") : path3.join(".config", "Code", "User", "settings.json")
+  process.platform === "win32" ? path.join("AppData", "Roaming", "Code", "User", "settings.json") : process.platform === "darwin" ? path.join("Library", "Application Support", "Code", "User", "settings.json") : path.join(".config", "Code", "User", "settings.json")
 );
 async function installMastraDocsMCPServer({ editor, directory }) {
   if (editor === `cursor`) {
-    await writeMergedConfig(path3.join(directory, ".cursor", "mcp.json"), "cursor");
+    await writeMergedConfig(path.join(directory, ".cursor", "mcp.json"), "cursor");
   }
   if (editor === `vscode`) {
-    await writeMergedConfig(path3.join(directory, ".vscode", "mcp.json"), "vscode");
+    await writeMergedConfig(path.join(directory, ".vscode", "mcp.json"), "vscode");
   }
   if (editor === `cursor-global`) {
     const alreadyInstalled = await globalMCPIsAlreadyInstalled(editor);
@@ -1566,6 +1285,102 @@ async function globalMCPIsAlreadyInstalled(editor) {
     return false;
   }
 }
+function getPackageManagerAddCommand(pm) {
+  switch (pm) {
+    case "npm":
+      return "install --audit=false --fund=false --loglevel=error --progress=false --update-notifier=false";
+    case "yarn":
+      return "add";
+    case "pnpm":
+      return "add --loglevel=error";
+    case "bun":
+      return "add";
+    default:
+      return "add";
+  }
+}
+var DepsService = class {
+  packageManager;
+  constructor() {
+    this.packageManager = this.getPackageManager();
+  }
+  findLockFile(dir) {
+    const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock"];
+    for (const file of lockFiles) {
+      if (fs3__default__default.existsSync(path.join(dir, file))) {
+        return file;
+      }
+    }
+    const parentDir = path.resolve(dir, "..");
+    if (parentDir !== dir) {
+      return this.findLockFile(parentDir);
+    }
+    return null;
+  }
+  getPackageManager() {
+    const lockFile = this.findLockFile(process.cwd());
+    switch (lockFile) {
+      case "pnpm-lock.yaml":
+        return "pnpm";
+      case "package-lock.json":
+        return "npm";
+      case "yarn.lock":
+        return "yarn";
+      case "bun.lock":
+        return "bun";
+      default:
+        return "npm";
+    }
+  }
+  async installPackages(packages) {
+    const pm = this.packageManager;
+    const installCommand = getPackageManagerAddCommand(pm);
+    const packageList = packages.join(" ");
+    return execa(`${pm} ${installCommand} ${packageList}`, {
+      all: true,
+      shell: true,
+      stdio: "inherit"
+    });
+  }
+  async checkDependencies(dependencies) {
+    try {
+      const packageJsonPath = path.join(process.cwd(), "package.json");
+      try {
+        await fs4.access(packageJsonPath);
+      } catch {
+        return "No package.json file found in the current directory";
+      }
+      const packageJson = JSON.parse(await fs4.readFile(packageJsonPath, "utf-8"));
+      for (const dependency of dependencies) {
+        if (!packageJson.dependencies || !packageJson.dependencies[dependency]) {
+          return `Please install ${dependency} before running this command (${this.packageManager} install ${dependency})`;
+        }
+      }
+      return "ok";
+    } catch (err) {
+      console.error(err);
+      return "Could not check dependencies";
+    }
+  }
+  async getProjectName() {
+    try {
+      const packageJsonPath = path.join(process.cwd(), "package.json");
+      const packageJson = await fs4.readFile(packageJsonPath, "utf-8");
+      const pkg = JSON.parse(packageJson);
+      return pkg.name;
+    } catch (err) {
+      throw err;
+    }
+  }
+  async addScriptsToPackageJson(scripts) {
+    const packageJson = JSON.parse(await fs4.readFile("package.json", "utf-8"));
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      ...scripts
+    };
+    await fs4.writeFile("package.json", JSON.stringify(packageJson, null, 2));
+  }
+};
 var EnvService = class {
 };
 var FileEnvService = class extends EnvService {
@@ -1576,7 +1391,7 @@ var FileEnvService = class extends EnvService {
   }
   readFile(filePath) {
     return new Promise((resolve, reject) => {
-      fs4__default.readFile(filePath, "utf8", (err, data) => {
+      fs3__default.readFile(filePath, "utf8", (err, data) => {
         if (err) reject(err);
         else resolve(data);
       });
@@ -1584,7 +1399,7 @@ var FileEnvService = class extends EnvService {
   }
   writeFile({ filePath, data }) {
     return new Promise((resolve, reject) => {
-      fs4__default.writeFile(filePath, data, "utf8", (err) => {
+      fs3__default.writeFile(filePath, data, "utf8", (err) => {
         if (err) reject(err);
         else resolve();
       });
@@ -1637,10 +1452,10 @@ var FileService = class {
    */
   async copyStarterFile(inputFile, outputFilePath, replaceIfExists) {
     const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path3.dirname(__filename);
-    const filePath = path3.resolve(__dirname, "starter-files", inputFile);
-    const fileString = fs4__default__default.readFileSync(filePath, "utf8");
-    if (fs4__default__default.existsSync(outputFilePath) && !replaceIfExists) {
+    const __dirname = path.dirname(__filename);
+    const filePath = path.resolve(__dirname, "starter-files", inputFile);
+    const fileString = fs3__default__default.readFileSync(filePath, "utf8");
+    if (fs3__default__default.existsSync(outputFilePath) && !replaceIfExists) {
       console.info(`${outputFilePath} already exists`);
       return false;
     }
@@ -1648,14 +1463,14 @@ var FileService = class {
     return true;
   }
   async setupEnvFile({ dbUrl }) {
-    const envPath = path3.join(process.cwd(), ".env.development");
+    const envPath = path.join(process.cwd(), ".env.development");
     await fsExtra.ensureFile(envPath);
     const fileEnvService = new FileEnvService(envPath);
     await fileEnvService.setEnvValue("DB_URL", dbUrl);
   }
   getFirstExistingFile(files) {
     for (const f of files) {
-      if (fs4__default__default.existsSync(f)) {
+      if (fs3__default__default.existsSync(f)) {
         return f;
       }
     }
@@ -1665,14 +1480,14 @@ var FileService = class {
     filePath,
     replacements
   }) {
-    let fileContent = fs4__default__default.readFileSync(filePath, "utf8");
+    let fileContent = fs3__default__default.readFileSync(filePath, "utf8");
     replacements.forEach(({ search, replace }) => {
       fileContent = fileContent.replaceAll(search, replace);
     });
-    fs4__default__default.writeFileSync(filePath, fileContent);
+    fs3__default__default.writeFileSync(filePath, fileContent);
   }
 };
-var exec2 = util.promisify(child_process.exec);
+var exec = util.promisify(child_process.exec);
 var getModelIdentifier = (llmProvider) => {
   if (llmProvider === "openai") {
     return `'openai/gpt-4o-mini'`;
@@ -1726,8 +1541,8 @@ export const weatherAgent = new Agent({
     parser: "typescript",
     singleQuote: true
   });
-  await fs5.writeFile(destPath, "");
-  await fs5.writeFile(destPath, formattedContent);
+  await fs4.writeFile(destPath, "");
+  await fs4.writeFile(destPath, formattedContent);
 }
 async function writeWorkflowSample(destPath) {
   const content = `import { createStep, createWorkflow } from '@mastra/core/workflows';
@@ -1920,7 +1735,7 @@ export { weatherWorkflow };`;
     semi: true,
     singleQuote: true
   });
-  await fs5.writeFile(destPath, formattedContent);
+  await fs4.writeFile(destPath, formattedContent);
 }
 async function writeToolSample(destPath) {
   const fileService = new FileService();
@@ -1949,15 +1764,15 @@ var writeIndexFile = async ({
   addWorkflow
 }) => {
   const indexPath = dirPath + "/index.ts";
-  const destPath = path3.join(indexPath);
+  const destPath = path.join(indexPath);
   try {
-    await fs5.writeFile(destPath, "");
+    await fs4.writeFile(destPath, "");
     const filteredExports = [
       addWorkflow ? `workflows: { weatherWorkflow },` : "",
       addAgent ? `agents: { weatherAgent },` : ""
     ].filter(Boolean);
     if (!addExample) {
-      await fs5.writeFile(
+      await fs4.writeFile(
         destPath,
         `
 import { Mastra } from '@mastra/core';
@@ -1967,7 +1782,7 @@ export const mastra = new Mastra()
       );
       return;
     }
-    await fs5.writeFile(
+    await fs4.writeFile(
       destPath,
       `
 import { Mastra } from '@mastra/core/mastra';
@@ -2027,15 +1842,15 @@ var getAPIKey = async (provider) => {
 var writeAPIKey = async ({ provider, apiKey }) => {
   const envFileName = apiKey ? ".env" : ".env.example";
   const key = await getAPIKey(provider);
-  const escapedKey = shellQuote.quote([key]);
-  const escapedApiKey = shellQuote.quote([apiKey ? apiKey : "your-api-key"]);
-  await exec2(`echo ${escapedKey}=${escapedApiKey} >> ${envFileName}`);
+  const escapedKey = shellQuote2.quote([key]);
+  const escapedApiKey = shellQuote2.quote([apiKey ? apiKey : "your-api-key"]);
+  await exec(`echo ${escapedKey}=${escapedApiKey} >> ${envFileName}`);
 };
 var createMastraDir = async (directory) => {
   let dir = directory.trim().split("/").filter((item) => item !== "");
-  const dirPath = path3.join(process.cwd(), ...dir, "mastra");
+  const dirPath = path.join(process.cwd(), ...dir, "mastra");
   try {
-    await fs5.access(dirPath);
+    await fs4.access(dirPath);
     return { ok: false };
   } catch {
     await fsExtra.ensureDir(dirPath);
@@ -2181,13 +1996,193 @@ This means the Mastra docs MCP server will be available in all your Windsurf pro
   );
   return mastraProject;
 };
+function getPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  const execPath = process.env.npm_execpath || "";
+  if (userAgent.includes("yarn")) {
+    return "yarn";
+  }
+  if (userAgent.includes("pnpm")) {
+    return "pnpm";
+  }
+  if (userAgent.includes("npm")) {
+    return "npm";
+  }
+  if (execPath.includes("yarn")) {
+    return "yarn";
+  }
+  if (execPath.includes("pnpm")) {
+    return "pnpm";
+  }
+  if (execPath.includes("npm")) {
+    return "npm";
+  }
+  return "npm";
+}
+var logger = createLogger(false);
+function createLogger(debug = false) {
+  return new PinoLogger({
+    name: "Mastra CLI",
+    level: debug ? "debug" : "info"
+  });
+}
+var exec2 = util.promisify(child_process.exec);
+async function cloneTemplate(options) {
+  const { template, projectName, targetDir } = options;
+  const projectPath = targetDir ? path.resolve(targetDir, projectName) : path.resolve(projectName);
+  const spinner5 = yoctoSpinner({ text: `Cloning template "${template.title}"...` }).start();
+  try {
+    if (await directoryExists(projectPath)) {
+      spinner5.error(`Directory ${projectName} already exists`);
+      throw new Error(`Directory ${projectName} already exists`);
+    }
+    await cloneRepositoryWithoutGit(template.githubUrl, projectPath);
+    await updatePackageJson(projectPath, projectName);
+    const envExamplePath = path.join(projectPath, ".env.example");
+    if (await fileExists(envExamplePath)) {
+      await fs4.copyFile(envExamplePath, path.join(projectPath, ".env"));
+    }
+    spinner5.success(`Template "${template.title}" cloned successfully to ${projectName}`);
+    return projectPath;
+  } catch (error) {
+    spinner5.error(`Failed to clone template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
+async function directoryExists(dirPath) {
+  try {
+    const stat = await fs4.stat(dirPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function fileExists(filePath) {
+  try {
+    const stat = await fs4.stat(filePath);
+    return stat.isFile();
+  } catch {
+    return false;
+  }
+}
+async function cloneRepositoryWithoutGit(repoUrl, targetPath) {
+  await fs4.mkdir(targetPath, { recursive: true });
+  try {
+    const degitRepo = repoUrl.replace("https://github.com/", "");
+    const degitCommand = shellQuote2.quote(["npx", "degit", degitRepo, targetPath]);
+    await exec2(degitCommand, {
+      cwd: process.cwd()
+    });
+  } catch {
+    try {
+      const gitCommand = shellQuote2.quote(["git", "clone", repoUrl, targetPath]);
+      await exec2(gitCommand, {
+        cwd: process.cwd()
+      });
+      const gitDir = path.join(targetPath, ".git");
+      if (await directoryExists(gitDir)) {
+        await fs4.rm(gitDir, { recursive: true, force: true });
+      }
+    } catch (gitError) {
+      throw new Error(`Failed to clone repository: ${gitError instanceof Error ? gitError.message : "Unknown error"}`);
+    }
+  }
+}
+async function updatePackageJson(projectPath, projectName) {
+  const packageJsonPath = path.join(projectPath, "package.json");
+  try {
+    const packageJsonContent = await fs4.readFile(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonContent);
+    packageJson.name = projectName;
+    await fs4.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2), "utf-8");
+  } catch (error) {
+    logger.warn(`Could not update package.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+async function installDependencies(projectPath, packageManager) {
+  const spinner5 = yoctoSpinner({ text: "Installing dependencies..." }).start();
+  try {
+    const pm = packageManager || getPackageManager();
+    const installCommand = shellQuote2.quote([pm, "install"]);
+    await exec2(installCommand, {
+      cwd: projectPath
+    });
+    spinner5.success("Dependencies installed successfully");
+  } catch (error) {
+    spinner5.error(`Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
+var TEMPLATES_API_URL = process.env.MASTRA_TEMPLATES_API_URL || "https://mastra.ai/api/templates.json";
+async function loadTemplates() {
+  try {
+    const response = await fetch(TEMPLATES_API_URL);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch templates: ${response.statusText}`);
+    }
+    const templates = await response.json();
+    return templates;
+  } catch (error) {
+    console.error("Error loading templates:", error);
+    throw new Error("Failed to load templates. Please check your internet connection and try again.");
+  }
+}
+function pluralize(count, singular, plural) {
+  return count === 1 ? singular : plural || `${singular}s`;
+}
+async function selectTemplate(templates) {
+  const choices = templates.map((template) => {
+    const parts = [];
+    if (template.agents?.length) {
+      parts.push(`${template.agents.length} ${pluralize(template.agents.length, "agent")}`);
+    }
+    if (template.tools?.length) {
+      parts.push(`${template.tools.length} ${pluralize(template.tools.length, "tool")}`);
+    }
+    if (template.workflows?.length) {
+      parts.push(`${template.workflows.length} ${pluralize(template.workflows.length, "workflow")}`);
+    }
+    if (template.mcp?.length) {
+      parts.push(`${template.mcp.length} ${pluralize(template.mcp.length, "MCP server")}`);
+    }
+    if (template.networks?.length) {
+      parts.push(`${template.networks.length} ${pluralize(template.networks.length, "agent network")}`);
+    }
+    return {
+      value: template,
+      label: template.title,
+      hint: parts.join(", ") || "Template components"
+    };
+  });
+  const selected = await ve({
+    message: "Select a template:",
+    options: choices
+  });
+  if (pD(selected)) {
+    return null;
+  }
+  return selected;
+}
+function findTemplateByName(templates, templateName) {
+  let template = templates.find((t) => t.slug === templateName);
+  if (template) return template;
+  const slugWithPrefix = `template-${templateName}`;
+  template = templates.find((t) => t.slug === slugWithPrefix);
+  if (template) return template;
+  template = templates.find((t) => t.title.toLowerCase() === templateName.toLowerCase());
+  if (template) return template;
+  return null;
+}
+function getDefaultProjectName(template) {
+  return template.slug.replace(/^template-/, "");
+}
 var s = Y();
 var init = async ({
-  directory,
-  addExample = false,
+  directory = "src/",
   components,
   llmProvider = "openai",
   llmApiKey,
+  addExample = false,
   configureEditorWithDocsMCP
 }) => {
   s.start("Initializing Mastra");
@@ -2318,7 +2313,7 @@ var createMastraProject = async ({
     defaultValue: "my-mastra-app",
     validate: (value) => {
       if (value.length === 0) return "Project name cannot be empty";
-      if (fs4__default__default.existsSync(value)) {
+      if (fs3__default__default.existsSync(value)) {
         return `A directory named "${value}" already exists. Please choose a different name.`;
       }
     }
@@ -2338,7 +2333,7 @@ var createMastraProject = async ({
   try {
     s2.start("Creating project");
     try {
-      await fs5.mkdir(projectName);
+      await fs4.mkdir(projectName);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "EEXIST") {
         s2.stop(`A directory named "${projectName}" already exists. Please choose a different name.`);
@@ -2370,7 +2365,7 @@ var createMastraProject = async ({
     s2.stop("Project structure created");
     s2.start(`Installing ${pm} dependencies`);
     try {
-      await exec3(`${pm} ${installCommand} zod@^3`);
+      await exec3(`${pm} ${installCommand} zod@^4`);
       await exec3(`${pm} ${installCommand} typescript @types/node --save-dev`);
       await exec3(`echo '{
   "compilerOptions": {
@@ -2640,7 +2635,7 @@ async function createFromTemplate(args2) {
 async function getPackageVersion() {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
-  const pkgJsonPath = path3.join(__dirname, "..", "package.json");
+  const pkgJsonPath = path.join(__dirname, "..", "package.json");
   const content = await fsExtra$1.readJSON(pkgJsonPath);
   return content.version;
 }