create-mastra 0.0.0-tsconfig-compile-20250703214351 → 0.0.0-unified-sidebar-20251010130811

package/dist/index.js

@@ -1,10 +1,10 @@
 #! /usr/bin/env node
 import { Command } from 'commander';
 import { randomUUID } from 'node:crypto';
-import * as fs3__default from 'node:fs';
-import fs3__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import * as fs4__default from 'node:fs';
+import fs4__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
-import path2, { dirname } from 'node:path';
+import path3, { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { PostHog } from 'posthog-node';
 import util, { stripVTControlCharacters } from 'node:util';
@@ -12,18 +12,22 @@ 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 child_process from 'node:child_process';
-import fs4 from 'node:fs/promises';
-import { execa } from 'execa';
-import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
-import prettier from 'prettier';
 import tty from 'node:tty';
 import pino from 'pino';
 import pretty from 'pino-pretty';
-import fsExtra from 'fs-extra';
+import { execa } from 'execa';
+import fsExtra, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
+import prettier from 'prettier';
+import fsExtra$1 from 'fs-extra';
 
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path2.dirname(__filename);
+var __dirname = path3.dirname(__filename);
+var analyticsInstance = null;
+function getAnalytics() {
+  return analyticsInstance;
+}
 var PosthogAnalytics = class {
   sessionId;
   client;
@@ -35,7 +39,7 @@ var PosthogAnalytics = class {
     host = "https://app.posthog.com"
   }) {
     this.version = version;
-    const cliConfigPath = path2.join(__dirname, "mastra-cli.json");
+    const cliConfigPath = path3.join(__dirname, "mastra-cli.json");
     if (existsSync(cliConfigPath)) {
       try {
         const { distinctId, sessionId } = JSON.parse(readFileSync(cliConfigPath, "utf-8"));
@@ -63,7 +67,7 @@ var PosthogAnalytics = class {
   }
   writeCliConfig({ distinctId, sessionId }) {
     try {
-      writeFileSync(path2.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
+      writeFileSync(path3.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
     } catch {
     }
   }
@@ -113,6 +117,22 @@ var PosthogAnalytics = class {
       }
     });
   }
+  trackEvent(eventName, properties) {
+    try {
+      if (!this.client) {
+        return;
+      }
+      this.client.capture({
+        distinctId: this.distinctId,
+        event: eventName,
+        properties: {
+          ...this.getSystemProperties(),
+          ...properties
+        }
+      });
+    } catch {
+    }
+  }
   trackCommand(options) {
     try {
       if (!this.client) {
@@ -1153,6 +1173,197 @@ 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 = new PinoLogger({
+  name: "Mastra CLI",
+  level: "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() {
@@ -1161,11 +1372,11 @@ var DepsService = class {
   findLockFile(dir) {
     const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock"];
     for (const file of lockFiles) {
-      if (fs3__default__default.existsSync(path2.join(dir, file))) {
+      if (fs4__default__default.existsSync(path3.join(dir, file))) {
         return file;
       }
     }
-    const parentDir = path2.resolve(dir, "..");
+    const parentDir = path3.resolve(dir, "..");
     if (parentDir !== dir) {
       return this.findLockFile(parentDir);
     }
@@ -1187,14 +1398,10 @@ var DepsService = class {
     }
   }
   async installPackages(packages) {
-    let runCommand = this.packageManager;
-    if (this.packageManager === "npm") {
-      runCommand = `${this.packageManager} i`;
-    } else {
-      runCommand = `${this.packageManager} add`;
-    }
+    const pm = this.packageManager;
+    const installCommand = getPackageManagerAddCommand(pm);
     const packageList = packages.join(" ");
-    return execa(`${runCommand} ${packageList}`, {
+    return execa(`${pm} ${installCommand} ${packageList}`, {
       all: true,
       shell: true,
       stdio: "inherit"
@@ -1202,13 +1409,13 @@ var DepsService = class {
   }
   async checkDependencies(dependencies) {
     try {
-      const packageJsonPath = path2.join(process.cwd(), "package.json");
+      const packageJsonPath = path3.join(process.cwd(), "package.json");
       try {
-        await fs4.access(packageJsonPath);
+        await fs5.access(packageJsonPath);
       } catch {
         return "No package.json file found in the current directory";
       }
-      const packageJson = JSON.parse(await fs4.readFile(packageJsonPath, "utf-8"));
+      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})`;
@@ -1222,65 +1429,23 @@ var DepsService = class {
   }
   async getProjectName() {
     try {
-      const packageJsonPath = path2.join(process.cwd(), "package.json");
-      const packageJson = await fs4.readFile(packageJsonPath, "utf-8");
+      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 getPackageVersion() {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const pkgJsonPath = path2.join(__dirname, "..", "package.json");
-    const content = await fsExtra3.readJSON(pkgJsonPath);
-    return content.version;
-  }
   async addScriptsToPackageJson(scripts) {
-    const packageJson = JSON.parse(await fs4.readFile("package.json", "utf-8"));
+    const packageJson = JSON.parse(await fs5.readFile("package.json", "utf-8"));
     packageJson.scripts = {
       ...packageJson.scripts,
       ...scripts
     };
-    await fs4.writeFile("package.json", JSON.stringify(packageJson, null, 2));
+    await fs5.writeFile("package.json", JSON.stringify(packageJson, null, 2));
   }
 };
-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";
-}
-function getPackageManagerInstallCommand(pm) {
-  switch (pm) {
-    case "npm":
-      return "install";
-    case "yarn":
-      return "add";
-    case "pnpm":
-      return "add";
-    default:
-      return "install";
-  }
-}
 var args = ["-y", "@mastra/mcp-docs-server"];
 var createMcpConfig = (editor) => {
   if (editor === "vscode") {
@@ -1333,19 +1498,19 @@ async function writeMergedConfig(configPath, editor) {
     spaces: 2
   });
 }
-var windsurfGlobalMCPConfigPath = path2.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
-var cursorGlobalMCPConfigPath = path2.join(os.homedir(), ".cursor", "mcp.json");
-path2.join(process.cwd(), ".vscode", "mcp.json");
-var vscodeGlobalMCPConfigPath = path2.join(
+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(
   os.homedir(),
-  process.platform === "win32" ? path2.join("AppData", "Roaming", "Code", "User", "settings.json") : process.platform === "darwin" ? path2.join("Library", "Application Support", "Code", "User", "settings.json") : path2.join(".config", "Code", "User", "settings.json")
+  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")
 );
 async function installMastraDocsMCPServer({ editor, directory }) {
   if (editor === `cursor`) {
-    await writeMergedConfig(path2.join(directory, ".cursor", "mcp.json"), "cursor");
+    await writeMergedConfig(path3.join(directory, ".cursor", "mcp.json"), "cursor");
   }
   if (editor === `vscode`) {
-    await writeMergedConfig(path2.join(directory, ".vscode", "mcp.json"), "vscode");
+    await writeMergedConfig(path3.join(directory, ".vscode", "mcp.json"), "vscode");
   }
   if (editor === `cursor-global`) {
     const alreadyInstalled = await globalMCPIsAlreadyInstalled(editor);
@@ -1403,7 +1568,7 @@ var FileEnvService = class extends EnvService {
   }
   readFile(filePath) {
     return new Promise((resolve, reject) => {
-      fs3__default.readFile(filePath, "utf8", (err, data) => {
+      fs4__default.readFile(filePath, "utf8", (err, data) => {
         if (err) reject(err);
         else resolve(data);
       });
@@ -1411,7 +1576,7 @@ var FileEnvService = class extends EnvService {
   }
   writeFile({ filePath, data }) {
     return new Promise((resolve, reject) => {
-      fs3__default.writeFile(filePath, data, "utf8", (err) => {
+      fs4__default.writeFile(filePath, data, "utf8", (err) => {
         if (err) reject(err);
         else resolve();
       });
@@ -1431,7 +1596,7 @@ var FileEnvService = class extends EnvService {
 ${key}=${value}`;
     }
     await this.writeFile({ filePath, data });
-    console.log(`${key} set to ${value} in ENV file.`);
+    console.info(`${key} set to ${value} in ENV file.`);
     return data;
   }
   async getEnvValue(key) {
@@ -1464,25 +1629,25 @@ var FileService = class {
    */
   async copyStarterFile(inputFile, outputFilePath, replaceIfExists) {
     const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path2.dirname(__filename);
-    const filePath = path2.resolve(__dirname, "starter-files", inputFile);
-    const fileString = fs3__default__default.readFileSync(filePath, "utf8");
-    if (fs3__default__default.existsSync(outputFilePath) && !replaceIfExists) {
-      console.log(`${outputFilePath} already exists`);
+    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) {
+      console.info(`${outputFilePath} already exists`);
       return false;
     }
-    await fsExtra3.outputFile(outputFilePath, fileString);
+    await fsExtra.outputFile(outputFilePath, fileString);
     return true;
   }
   async setupEnvFile({ dbUrl }) {
-    const envPath = path2.join(process.cwd(), ".env.development");
-    await fsExtra3.ensureFile(envPath);
+    const envPath = path3.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 (fs3__default__default.existsSync(f)) {
+      if (fs4__default__default.existsSync(f)) {
         return f;
       }
     }
@@ -1492,57 +1657,31 @@ var FileService = class {
     filePath,
     replacements
   }) {
-    let fileContent = fs3__default__default.readFileSync(filePath, "utf8");
+    let fileContent = fs4__default__default.readFileSync(filePath, "utf8");
     replacements.forEach(({ search, replace }) => {
       fileContent = fileContent.replaceAll(search, replace);
     });
-    fs3__default__default.writeFileSync(filePath, fileContent);
-  }
-};
-new PinoLogger({
-  name: "Mastra CLI",
-  level: "info"
-});
-var exec = util.promisify(child_process.exec);
-var getAISDKPackage = (llmProvider) => {
-  switch (llmProvider) {
-    case "openai":
-      return "@ai-sdk/openai";
-    case "anthropic":
-      return "@ai-sdk/anthropic";
-    case "groq":
-      return "@ai-sdk/groq";
-    case "google":
-      return "@ai-sdk/google";
-    case "cerebras":
-      return "@ai-sdk/cerebras";
-    default:
-      return "@ai-sdk/openai";
+    fs4__default__default.writeFileSync(filePath, fileContent);
   }
 };
-var getProviderImportAndModelItem = (llmProvider) => {
-  let providerImport = "";
-  let modelItem = "";
+var exec2 = util.promisify(child_process.exec);
+var getModelIdentifier = (llmProvider) => {
   if (llmProvider === "openai") {
-    providerImport = `import { openai } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `openai('gpt-4o-mini')`;
+    return `'openai/gpt-4o-mini'`;
   } else if (llmProvider === "anthropic") {
-    providerImport = `import { anthropic } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `anthropic('claude-3-5-sonnet-20241022')`;
+    return `'anthropic/claude-3-5-sonnet-20241022'`;
   } else if (llmProvider === "groq") {
-    providerImport = `import { groq } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `groq('llama-3.3-70b-versatile')`;
+    return `'groq/llama-3.3-70b-versatile'`;
   } else if (llmProvider === "google") {
-    providerImport = `import { google } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `google('gemini-2.5-pro-exp-03-25')`;
+    return `'google/gemini-2.5-pro'`;
   } else if (llmProvider === "cerebras") {
-    providerImport = `import { cerebras } from '${getAISDKPackage(llmProvider)}';`;
-    modelItem = `cerebras('llama-3.3-70b')`;
+    return `'cerebras/llama-3.3-70b'`;
+  } else if (llmProvider === "mistral") {
+    return `'mistral/mistral-medium-2508'`;
   }
-  return { providerImport, modelItem };
 };
 async function writeAgentSample(llmProvider, destPath, addExampleTool) {
-  const { providerImport, modelItem } = getProviderImportAndModelItem(llmProvider);
+  const modelString = getModelIdentifier(llmProvider);
   const instructions = `
       You are a helpful weather assistant that provides accurate weather information and can help planning activities based on the weather.
 
@@ -1558,7 +1697,6 @@ async function writeAgentSample(llmProvider, destPath, addExampleTool) {
       ${addExampleTool ? "Use the weatherTool to fetch current weather data." : ""}
 `;
   const content = `
-${providerImport}
 import { Agent } from '@mastra/core/agent';
 import { Memory } from '@mastra/memory';
 import { LibSQLStore } from '@mastra/libsql';
@@ -1567,7 +1705,7 @@ ${addExampleTool ? `import { weatherTool } from '../tools/weather-tool';` : ""}
 export const weatherAgent = new Agent({
   name: 'Weather Agent',
   instructions: \`${instructions}\`,
-  model: ${modelItem},
+  model: ${modelString},
   ${addExampleTool ? "tools: { weatherTool }," : ""}
   memory: new Memory({
     storage: new LibSQLStore({
@@ -1580,8 +1718,8 @@ export const weatherAgent = new Agent({
     parser: "typescript",
     singleQuote: true
   });
-  await fs4.writeFile(destPath, "");
-  await fs4.writeFile(destPath, formattedContent);
+  await fs5.writeFile(destPath, "");
+  await fs5.writeFile(destPath, formattedContent);
 }
 async function writeWorkflowSample(destPath) {
   const content = `import { createStep, createWorkflow } from '@mastra/core/workflows';
@@ -1774,7 +1912,7 @@ export { weatherWorkflow };`;
     semi: true,
     singleQuote: true
   });
-  await fs4.writeFile(destPath, formattedContent);
+  await fs5.writeFile(destPath, formattedContent);
 }
 async function writeToolSample(destPath) {
   const fileService = new FileService();
@@ -1794,7 +1932,7 @@ async function writeCodeSampleForComponents(llmprovider, component, destPath, im
 }
 var createComponentsDir = async (dirPath, component) => {
   const componentPath = dirPath + `/${component}`;
-  await fsExtra3.ensureDir(componentPath);
+  await fsExtra.ensureDir(componentPath);
 };
 var writeIndexFile = async ({
   dirPath,
@@ -1803,15 +1941,15 @@ var writeIndexFile = async ({
   addWorkflow
 }) => {
   const indexPath = dirPath + "/index.ts";
-  const destPath = path2.join(indexPath);
+  const destPath = path3.join(indexPath);
   try {
-    await fs4.writeFile(destPath, "");
+    await fs5.writeFile(destPath, "");
     const filteredExports = [
       addWorkflow ? `workflows: { weatherWorkflow },` : "",
       addAgent ? `agents: { weatherAgent },` : ""
     ].filter(Boolean);
     if (!addExample) {
-      await fs4.writeFile(
+      await fs5.writeFile(
         destPath,
         `
 import { Mastra } from '@mastra/core';
@@ -1821,7 +1959,7 @@ export const mastra = new Mastra()
       );
       return;
     }
-    await fs4.writeFile(
+    await fs5.writeFile(
       destPath,
       `
 import { Mastra } from '@mastra/core/mastra';
@@ -1833,13 +1971,21 @@ ${addAgent ? `import { weatherAgent } from './agents/weather-agent';` : ""}
 export const mastra = new Mastra({
   ${filteredExports.join("\n  ")}
   storage: new LibSQLStore({
-    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db
+    // stores observability, scores, ... into memory storage, if it needs to persist, change to file:../mastra.db
     url: ":memory:",
   }),
   logger: new PinoLogger({
     name: 'Mastra',
     level: 'info',
   }),
+  telemetry: {
+    // Telemetry is deprecated and will be removed in the Nov 4th release
+    enabled: false, 
+  },
+  observability: {
+    // Enables DefaultExporter and CloudExporter for AI tracing
+    default: { enabled: true }, 
+  },
 });
 `
     );
@@ -1863,27 +2009,28 @@ var getAPIKey = async (provider) => {
     case "cerebras":
       key = "CEREBRAS_API_KEY";
       return key;
+    case "mistral":
+      key = "MISTRAL_API_KEY";
+      return key;
     default:
       return key;
   }
 };
-var writeAPIKey = async ({
-  provider,
-  apiKey = "your-api-key"
-}) => {
+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]);
-  await exec(`echo ${escapedKey}=${escapedApiKey} >> .env`);
+  const escapedApiKey = shellQuote.quote([apiKey ? apiKey : "your-api-key"]);
+  await exec2(`echo ${escapedKey}=${escapedApiKey} >> ${envFileName}`);
 };
 var createMastraDir = async (directory) => {
   let dir = directory.trim().split("/").filter((item) => item !== "");
-  const dirPath = path2.join(process.cwd(), ...dir, "mastra");
+  const dirPath = path3.join(process.cwd(), ...dir, "mastra");
   try {
-    await fs4.access(dirPath);
+    await fs5.access(dirPath);
     return { ok: false };
   } catch {
-    await fsExtra3.ensureDir(dirPath);
+    await fsExtra.ensureDir(dirPath);
     return { ok: true, dirPath };
   }
 };
@@ -1895,8 +2042,19 @@ var writeCodeSample = async (dirPath, component, llmProvider, importComponents)
     throw err;
   }
 };
-var interactivePrompt = async () => {
-  Ie(color2.inverse(" Mastra Init "));
+var LLM_PROVIDERS = [
+  { value: "openai", label: "OpenAI", hint: "recommended" },
+  { value: "anthropic", label: "Anthropic" },
+  { value: "groq", label: "Groq" },
+  { value: "google", label: "Google" },
+  { value: "cerebras", label: "Cerebras" },
+  { value: "mistral", label: "Mistral" }
+];
+var interactivePrompt = async (args2 = {}) => {
+  const { skip = {}, options: { showBanner = true } = {} } = args2;
+  if (showBanner) {
+    Ie(color2.inverse(" Mastra Init "));
+  }
   const mastraProject = await Ce(
     {
       directory: () => he({
@@ -1904,19 +2062,15 @@ var interactivePrompt = async () => {
         placeholder: "src/",
         defaultValue: "src/"
       }),
-      llmProvider: () => ve({
-        message: "Select default provider:",
-        options: [
-          { value: "openai", label: "OpenAI", hint: "recommended" },
-          { value: "anthropic", label: "Anthropic" },
-          { value: "groq", label: "Groq" },
-          { value: "google", label: "Google" },
-          { value: "cerebras", label: "Cerebras" }
-        ]
+      llmProvider: () => skip?.llmProvider ? void 0 : ve({
+        message: "Select a default provider:",
+        options: LLM_PROVIDERS
       }),
       llmApiKey: async ({ results: { llmProvider } }) => {
+        if (skip?.llmApiKey) return void 0;
+        const llmName = LLM_PROVIDERS.find((p6) => p6.value === llmProvider)?.label || "provider";
         const keyChoice = await ve({
-          message: `Enter your ${llmProvider} API key?`,
+          message: `Enter your ${llmName} API key?`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
             { value: "enter", label: "Enter API key" }
@@ -1926,7 +2080,10 @@ var interactivePrompt = async () => {
         if (keyChoice === "enter") {
           return he({
             message: "Enter your API key:",
-            placeholder: "sk-..."
+            placeholder: "sk-...",
+            validate: (value) => {
+              if (value.length === 0) return "API key cannot be empty";
+            }
           });
         }
         return void 0;
@@ -1936,7 +2093,7 @@ var interactivePrompt = async () => {
         const cursorIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`cursor`);
         const vscodeIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`vscode`);
         const editor = await ve({
-          message: `Make your AI IDE into a Mastra expert? (installs Mastra docs MCP server)`,
+          message: `Make your IDE into a Mastra expert? (Installs Mastra's MCP server)`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
             {
@@ -2017,7 +2174,6 @@ This means the Mastra docs MCP server will be available in all your Windsurf pro
   return mastraProject;
 };
 var s = Y();
-var exec2 = util.promisify(child_process.exec);
 var init = async ({
   directory,
   addExample = false,
@@ -2065,11 +2221,6 @@ var init = async ({
       }
     }
     const key = await getAPIKey(llmProvider || "openai");
-    const aiSdkPackage = getAISDKPackage(llmProvider);
-    const depsService = new DepsService();
-    const pm = depsService.packageManager;
-    const installCommand = getPackageManagerInstallCommand(pm);
-    await exec2(`${pm} ${installCommand} ${aiSdkPackage}`);
     if (configureEditorWithDocsMCP) {
       await installMastraDocsMCPServer({
         editor: configureEditorWithDocsMCP,
@@ -2123,9 +2274,9 @@ var execWithTimeout = async (command, timeoutMs) => {
   }
 };
 async function installMastraDependency(pm, dependency, versionTag, isDev, timeout) {
-  let installCommand = getPackageManagerInstallCommand(pm);
+  let installCommand = getPackageManagerAddCommand(pm);
   if (isDev) {
-    installCommand = `${installCommand} --save-dev`;
+    installCommand = `${installCommand} -D`;
   }
   try {
     await execWithTimeout(`${pm} ${installCommand} ${dependency}${versionTag}`, timeout);
@@ -2147,23 +2298,39 @@ async function installMastraDependency(pm, dependency, versionTag, isDev, timeou
 var createMastraProject = async ({
   projectName: name,
   createVersionTag,
-  timeout
+  timeout,
+  llmProvider,
+  llmApiKey,
+  needsInteractive
 }) => {
   Ie(color2.inverse(" Mastra Create "));
   const projectName = name ?? await he({
     message: "What do you want to name your project?",
     placeholder: "my-mastra-app",
-    defaultValue: "my-mastra-app"
+    defaultValue: "my-mastra-app",
+    validate: (value) => {
+      if (value.length === 0) return "Project name cannot be empty";
+      if (fs4__default__default.existsSync(value)) {
+        return `A directory named "${value}" already exists. Please choose a different name.`;
+      }
+    }
   });
   if (pD(projectName)) {
     xe("Operation cancelled");
     process.exit(0);
   }
+  let result;
+  if (needsInteractive) {
+    result = await interactivePrompt({
+      options: { showBanner: false },
+      skip: { llmProvider: llmProvider !== void 0, llmApiKey: llmApiKey !== void 0 }
+    });
+  }
   const s2 = Y();
   try {
     s2.start("Creating project");
     try {
-      await fs4.mkdir(projectName);
+      await fs5.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.`);
@@ -2175,7 +2342,7 @@ var createMastraProject = async ({
     }
     process.chdir(projectName);
     const pm = getPackageManager();
-    const installCommand = getPackageManagerInstallCommand(pm);
+    const installCommand = getPackageManagerAddCommand(pm);
     s2.message("Initializing project structure");
     try {
       await exec3(`npm init -y`);
@@ -2195,7 +2362,7 @@ var createMastraProject = async ({
     s2.stop("Project structure created");
     s2.start(`Installing ${pm} dependencies`);
     try {
-      await exec3(`${pm} ${installCommand} zod`);
+      await exec3(`${pm} ${installCommand} zod@^3`);
       await exec3(`${pm} ${installCommand} typescript @types/node --save-dev`);
       await exec3(`echo '{
   "compilerOptions": {
@@ -2219,15 +2386,15 @@ var createMastraProject = async ({
       );
     }
     s2.stop(`${pm} dependencies installed`);
-    s2.start("Installing mastra");
+    s2.start("Installing Mastra CLI");
     const versionTag = createVersionTag ? `@${createVersionTag}` : "@latest";
     try {
       await installMastraDependency(pm, "mastra", versionTag, true, timeout);
     } catch (error) {
       throw new Error(`Failed to install Mastra CLI: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    s2.stop("mastra installed");
-    s2.start("Installing dependencies");
+    s2.stop("Mastra CLI installed");
+    s2.start("Installing Mastra dependencies");
     try {
       await installMastraDependency(pm, "@mastra/core", versionTag, false, timeout);
       await installMastraDependency(pm, "@mastra/libsql", versionTag, false, timeout);
@@ -2253,8 +2420,8 @@ var createMastraProject = async ({
     }
     s2.stop(".gitignore added");
     Se("Project created successfully");
-    console.log("");
-    return { projectName };
+    console.info("");
+    return { projectName, result };
   } catch (error) {
     s2.stop();
     const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred";
@@ -2263,14 +2430,21 @@ var createMastraProject = async ({
   }
 };
 var create = async (args2) => {
-  const { projectName } = await createMastraProject({
+  if (args2.template !== void 0) {
+    await createFromTemplate({ ...args2, injectedAnalytics: args2.analytics });
+    return;
+  }
+  const needsInteractive = args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0;
+  const { projectName, result } = await createMastraProject({
     projectName: args2?.projectName,
     createVersionTag: args2?.createVersionTag,
-    timeout: args2?.timeout
+    timeout: args2?.timeout,
+    llmProvider: args2?.llmProvider,
+    llmApiKey: args2?.llmApiKey,
+    needsInteractive
   });
   const directory = args2.directory || "src/";
-  if (args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0) {
-    const result = await interactivePrompt();
+  if (needsInteractive && result) {
     await init({
       ...result,
       llmApiKey: result?.llmApiKey,
@@ -2300,18 +2474,172 @@ var postCreate = ({ projectName }) => {
     ${color2.cyan(`${packageManager} run dev`)}
   `);
 };
+function isGitHubUrl(url) {
+  try {
+    const parsedUrl = new URL(url);
+    return parsedUrl.hostname === "github.com" && parsedUrl.pathname.split("/").length >= 3;
+  } catch {
+    return false;
+  }
+}
+async function validateGitHubProject(githubUrl) {
+  const errors = [];
+  try {
+    const urlParts = new URL(githubUrl).pathname.split("/").filter(Boolean);
+    const owner = urlParts[0];
+    const repo = urlParts[1]?.replace(".git", "");
+    if (!owner || !repo) {
+      throw new Error("Invalid GitHub URL format");
+    }
+    const branches = ["main", "master"];
+    let packageJsonContent = null;
+    let indexContent = null;
+    for (const branch of branches) {
+      try {
+        const packageJsonUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/package.json`;
+        const packageJsonResponse = await fetch(packageJsonUrl);
+        if (packageJsonResponse.ok) {
+          packageJsonContent = await packageJsonResponse.text();
+          const indexUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/src/mastra/index.ts`;
+          const indexResponse = await fetch(indexUrl);
+          if (indexResponse.ok) {
+            indexContent = await indexResponse.text();
+          }
+          break;
+        }
+      } catch {
+      }
+    }
+    if (!packageJsonContent) {
+      errors.push("Could not fetch package.json from repository");
+      return { isValid: false, errors };
+    }
+    try {
+      const packageJson = JSON.parse(packageJsonContent);
+      const hasMastraCore = packageJson.dependencies?.["@mastra/core"] || packageJson.devDependencies?.["@mastra/core"] || packageJson.peerDependencies?.["@mastra/core"];
+      if (!hasMastraCore) {
+        errors.push("Missing @mastra/core dependency in package.json");
+      }
+    } catch {
+      errors.push("Invalid package.json format");
+    }
+    if (!indexContent) {
+      errors.push("Missing src/mastra/index.ts file");
+    } else {
+      const hasMastraExport = indexContent.includes("export") && (indexContent.includes("new Mastra") || indexContent.includes("Mastra("));
+      if (!hasMastraExport) {
+        errors.push("src/mastra/index.ts does not export a Mastra instance");
+      }
+    }
+    return { isValid: errors.length === 0, errors };
+  } catch (error) {
+    errors.push(`Failed to validate GitHub repository: ${error instanceof Error ? error.message : "Unknown error"}`);
+    return { isValid: false, errors };
+  }
+}
+async function createFromGitHubUrl(url) {
+  const urlParts = new URL(url).pathname.split("/").filter(Boolean);
+  const owner = urlParts[0] || "unknown";
+  const repo = urlParts[1] || "unknown";
+  return {
+    githubUrl: url,
+    title: `${owner}/${repo}`,
+    slug: repo,
+    agents: [],
+    mcp: [],
+    tools: [],
+    networks: [],
+    workflows: []
+  };
+}
+async function createFromTemplate(args2) {
+  let selectedTemplate;
+  if (args2.template === true) {
+    const templates = await loadTemplates();
+    const selected = await selectTemplate(templates);
+    if (!selected) {
+      M.info("No template selected. Exiting.");
+      return;
+    }
+    selectedTemplate = selected;
+  } else if (args2.template && typeof args2.template === "string") {
+    if (isGitHubUrl(args2.template)) {
+      const spinner5 = Y();
+      spinner5.start("Validating GitHub repository...");
+      const validation = await validateGitHubProject(args2.template);
+      if (!validation.isValid) {
+        spinner5.stop("Validation failed");
+        M.error("This does not appear to be a valid Mastra project:");
+        validation.errors.forEach((error) => M.error(`  - ${error}`));
+        throw new Error("Invalid Mastra project");
+      }
+      spinner5.stop("Valid Mastra project \u2713");
+      selectedTemplate = await createFromGitHubUrl(args2.template);
+    } else {
+      const templates = await loadTemplates();
+      const found = findTemplateByName(templates, args2.template);
+      if (!found) {
+        M.error(`Template "${args2.template}" not found. Available templates:`);
+        templates.forEach((t) => M.info(`  - ${t.title} (use: ${t.slug.replace("template-", "")})`));
+        throw new Error(`Template "${args2.template}" not found`);
+      }
+      selectedTemplate = found;
+    }
+  }
+  if (!selectedTemplate) {
+    throw new Error("No template selected");
+  }
+  let projectName = args2.projectName;
+  if (!projectName) {
+    const defaultName = getDefaultProjectName(selectedTemplate);
+    const response = await he({
+      message: "What is your project name?",
+      defaultValue: defaultName,
+      placeholder: defaultName
+    });
+    if (pD(response)) {
+      M.info("Project creation cancelled.");
+      return;
+    }
+    projectName = response;
+  }
+  try {
+    const analytics = args2.injectedAnalytics || getAnalytics();
+    if (analytics) {
+      analytics.trackEvent("cli_template_used", {
+        template_slug: selectedTemplate.slug,
+        template_title: selectedTemplate.title
+      });
+    }
+    const projectPath = await cloneTemplate({
+      template: selectedTemplate,
+      projectName
+    });
+    await installDependencies(projectPath);
+    Me(`
+      ${color2.green("Mastra template installed!")}
+
+      Add the necessary environment
+      variables in your ${color2.cyan(".env")} file
+      `);
+    postCreate({ projectName });
+  } catch (error) {
+    M.error(`Failed to create project from template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
 
 async function getPackageVersion() {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
-  const pkgJsonPath = path2.join(__dirname, "..", "package.json");
-  const content = await fsExtra.readJSON(pkgJsonPath);
+  const pkgJsonPath = path3.join(__dirname, "..", "package.json");
+  const content = await fsExtra$1.readJSON(pkgJsonPath);
   return content.version;
 }
 async function getCreateVersionTag() {
   try {
     const pkgPath = fileURLToPath(import.meta.resolve("create-mastra/package.json"));
-    const json = await fsExtra.readJSON(pkgPath);
+    const json = await fsExtra$1.readJSON(pkgPath);
     const { stdout } = await execa("npm", ["dist-tag", "create-mastra"]);
     const tagLine = stdout.split("\n").find((distLine) => distLine.endsWith(`: ${json.version}`));
     const tag = tagLine ? tagLine.split(":")[0].trim() : "latest";
@@ -2335,14 +2663,17 @@ program.version(`${version}`, "-v, --version").description(`create-mastra ${vers
     analytics.trackCommand({
       command: "version"
     });
-    console.log(`create-mastra ${version}`);
+    console.info(`create-mastra ${version}`);
   } catch {
   }
 });
 program.name("create-mastra").description("Create a new Mastra project").argument("[project-name]", "Directory name of the project").option(
   "-p, --project-name <string>",
   "Project name that will be used in package.json and as the project directory name."
-).option("--default", "Quick start with defaults(src, OpenAI, 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("-n, --no-example", "Do not include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option("-d, --dir <directory>", "Target directory for Mastra source code (default: src/)").option("-m, --mcp <mcp>", "MCP Server for code editor (cursor, cursor-global, windsurf, vscode)").action(async (projectNameArg, args) => {
+).option("--default", "Quick start with defaults (src, OpenAI, 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("-n, --no-example", "Do not include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option("-d, --dir <directory>", "Target directory for Mastra source code (default: src/)").option("-m, --mcp <mcp>", "MCP Server for code editor (cursor, cursor-global, windsurf, vscode)").option(
+  "--template [template-name]",
+  "Create project from a template (use template name, public GitHub URL, or leave blank to select from list)"
+).action(async (projectNameArg, args) => {
   const projectName = projectNameArg || args.projectName;
   const timeout = args?.timeout ? args?.timeout === true ? 6e4 : parseInt(args?.timeout, 10) : void 0;
   if (args.default) {
@@ -2353,7 +2684,9 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
       createVersionTag,
       timeout,
       mcpServer: args.mcp,
-      directory: "src/"
+      directory: "src/",
+      template: args.template,
+      analytics
     });
     return;
   }
@@ -2361,12 +2694,14 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
     components: args.components ? args.components.split(",") : [],
     llmProvider: args.llm,
     addExample: args.example,
-    llmApiKey: args["llm-api-key"],
+    llmApiKey: args.llmApiKey,
     createVersionTag,
     timeout,
     projectName,
     directory: args.dir,
-    mcpServer: args.mcp
+    mcpServer: args.mcp,
+    template: args.template,
+    analytics
   });
 });
 program.parse(process.argv);