create-mastra 0.0.0-share-agent-metadata-with-cloud-20250718123411 → 0.0.0-stream-vnext-usage-20250908171242

package/README.md

@@ -4,22 +4,16 @@ The easiest way to get started with Mastra is by using `create-mastra`. This CLI
 
 ## Usage
 
-Using npx:
-
-```bash
-npx create-mastra@latest
-```
-
 Using npm:
 
 ```bash
-npm create mastra@latest
+npx create-mastra@latest
 ```
 
 Using yarn:
 
 ```bash
-yarn create mastra
+yarn dlx create-mastra@latest
 ```
 
 Using pnpm:

package/dist/index.js

@@ -18,7 +18,7 @@ import tty from 'node:tty';
 import pino from 'pino';
 import pretty from 'pino-pretty';
 import { execa } from 'execa';
-import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
+import fsExtra2, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
 import prettier from 'prettier';
 import fsExtra from 'fs-extra';
 
@@ -1196,18 +1196,6 @@ function getPackageManager() {
   }
   return "npm";
 }
-function getPackageManagerInstallCommand(pm) {
-  switch (pm) {
-    case "npm":
-      return "install";
-    case "yarn":
-      return "add";
-    case "pnpm":
-      return "add";
-    default:
-      return "install";
-  }
-}
 var logger = new PinoLogger({
   name: "Mastra CLI",
   level: "info"
@@ -1216,10 +1204,10 @@ 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 spinner4 = yoctoSpinner({ text: `Cloning template "${template.title}"...` }).start();
+  const spinner5 = yoctoSpinner({ text: `Cloning template "${template.title}"...` }).start();
   try {
     if (await directoryExists(projectPath)) {
-      spinner4.error(`Directory ${projectName} already exists`);
+      spinner5.error(`Directory ${projectName} already exists`);
       throw new Error(`Directory ${projectName} already exists`);
     }
     await cloneRepositoryWithoutGit(template.githubUrl, projectPath);
@@ -1228,10 +1216,10 @@ async function cloneTemplate(options) {
     if (await fileExists(envExamplePath)) {
       await fs.copyFile(envExamplePath, path3.join(projectPath, ".env"));
     }
-    spinner4.success(`Template "${template.title}" cloned successfully to ${projectName}`);
+    spinner5.success(`Template "${template.title}" cloned successfully to ${projectName}`);
     return projectPath;
   } catch (error) {
-    spinner4.error(`Failed to clone template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    spinner5.error(`Failed to clone template: ${error instanceof Error ? error.message : "Unknown error"}`);
     throw error;
   }
 }
@@ -1286,16 +1274,16 @@ async function updatePackageJson(projectPath, projectName) {
   }
 }
 async function installDependencies(projectPath, packageManager) {
-  const spinner4 = yoctoSpinner({ text: "Installing dependencies..." }).start();
+  const spinner5 = yoctoSpinner({ text: "Installing dependencies..." }).start();
   try {
     const pm = packageManager || getPackageManager();
     const installCommand = shellQuote.quote([pm, "install"]);
     await exec(installCommand, {
       cwd: projectPath
     });
-    spinner4.success("Dependencies installed successfully");
+    spinner5.success("Dependencies installed successfully");
   } catch (error) {
-    spinner4.error(`Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`);
+    spinner5.error(`Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`);
     throw error;
   }
 }
@@ -1362,6 +1350,20 @@ function findTemplateByName(templates, templateName) {
 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() {
@@ -1396,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"
@@ -1439,13 +1437,6 @@ var DepsService = class {
       throw err;
     }
   }
-  async getPackageVersion() {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const pkgJsonPath = path3.join(__dirname, "..", "package.json");
-    const content = await fsExtra3.readJSON(pkgJsonPath);
-    return content.version;
-  }
   async addScriptsToPackageJson(scripts) {
     const packageJson = JSON.parse(await fs.readFile("package.json", "utf-8"));
     packageJson.scripts = {
@@ -1645,12 +1636,12 @@ var FileService = class {
       console.log(`${outputFilePath} already exists`);
       return false;
     }
-    await fsExtra3.outputFile(outputFilePath, fileString);
+    await fsExtra2.outputFile(outputFilePath, fileString);
     return true;
   }
   async setupEnvFile({ dbUrl }) {
     const envPath = path3.join(process.cwd(), ".env.development");
-    await fsExtra3.ensureFile(envPath);
+    await fsExtra2.ensureFile(envPath);
     const fileEnvService = new FileEnvService(envPath);
     await fileEnvService.setEnvValue("DB_URL", dbUrl);
   }
@@ -1674,6 +1665,14 @@ var FileService = class {
   }
 };
 var exec2 = util.promisify(child_process.exec);
+var getAISDKPackageVersion = (llmProvider) => {
+  switch (llmProvider) {
+    case "cerebras":
+      return "^0.2.14";
+    default:
+      return "^1.0.0";
+  }
+};
 var getAISDKPackage = (llmProvider) => {
   switch (llmProvider) {
     case "openai":
@@ -1686,6 +1685,8 @@ var getAISDKPackage = (llmProvider) => {
       return "@ai-sdk/google";
     case "cerebras":
       return "@ai-sdk/cerebras";
+    case "mistral":
+      return "@ai-sdk/mistral";
     default:
       return "@ai-sdk/openai";
   }
@@ -1704,10 +1705,13 @@ var getProviderImportAndModelItem = (llmProvider) => {
     modelItem = `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')`;
+    modelItem = `google('gemini-2.5-pro')`;
   } else if (llmProvider === "cerebras") {
     providerImport = `import { cerebras } from '${getAISDKPackage(llmProvider)}';`;
     modelItem = `cerebras('llama-3.3-70b')`;
+  } else if (llmProvider === "mistral") {
+    providerImport = `import { mistral } from '${getAISDKPackage(llmProvider)}';`;
+    modelItem = `mistral('mistral-medium-2508')`;
   }
   return { providerImport, modelItem };
 };
@@ -1964,7 +1968,7 @@ async function writeCodeSampleForComponents(llmprovider, component, destPath, im
 }
 var createComponentsDir = async (dirPath, component) => {
   const componentPath = dirPath + `/${component}`;
-  await fsExtra3.ensureDir(componentPath);
+  await fsExtra2.ensureDir(componentPath);
 };
 var writeIndexFile = async ({
   dirPath,
@@ -2033,6 +2037,9 @@ var getAPIKey = async (provider) => {
     case "cerebras":
       key = "CEREBRAS_API_KEY";
       return key;
+    case "mistral":
+      key = "MISTRAL_API_KEY";
+      return key;
     default:
       return key;
   }
@@ -2053,7 +2060,7 @@ var createMastraDir = async (directory) => {
     await fs.access(dirPath);
     return { ok: false };
   } catch {
-    await fsExtra3.ensureDir(dirPath);
+    await fsExtra2.ensureDir(dirPath);
     return { ok: true, dirPath };
   }
 };
@@ -2081,7 +2088,8 @@ var interactivePrompt = async () => {
           { value: "anthropic", label: "Anthropic" },
           { value: "groq", label: "Groq" },
           { value: "google", label: "Google" },
-          { value: "cerebras", label: "Cerebras" }
+          { value: "cerebras", label: "Cerebras" },
+          { value: "mistral", label: "Mistral" }
         ]
       }),
       llmApiKey: async ({ results: { llmProvider } }) => {
@@ -2236,10 +2244,11 @@ var init = async ({
     }
     const key = await getAPIKey(llmProvider || "openai");
     const aiSdkPackage = getAISDKPackage(llmProvider);
+    const aiSdkPackageVersion = getAISDKPackageVersion(llmProvider);
     const depsService = new DepsService();
     const pm = depsService.packageManager;
-    const installCommand = getPackageManagerInstallCommand(pm);
-    await exec3(`${pm} ${installCommand} ${aiSdkPackage}`);
+    const installCommand = getPackageManagerAddCommand(pm);
+    await exec3(`${pm} ${installCommand} ${aiSdkPackage}@${aiSdkPackageVersion}`);
     if (configureEditorWithDocsMCP) {
       await installMastraDocsMCPServer({
         editor: configureEditorWithDocsMCP,
@@ -2293,9 +2302,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);
@@ -2345,7 +2354,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 exec4(`npm init -y`);
@@ -2434,7 +2443,7 @@ var createMastraProject = async ({
 };
 var create = async (args2) => {
   if (args2.template !== void 0) {
-    await createFromTemplate(args2);
+    await createFromTemplate({ ...args2, injectedAnalytics: args2.analytics });
     return;
   }
   const { projectName } = await createMastraProject({
@@ -2474,21 +2483,116 @@ 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) {
-  const templates = await loadTemplates();
   let selectedTemplate;
   if (args2.template === true) {
-    selectedTemplate = await selectTemplate(templates);
-    if (!selectedTemplate) {
+    const templates = await loadTemplates();
+    const selected = await selectTemplate(templates);
+    if (!selected) {
       M.info("No template selected. Exiting.");
       return;
     }
-  } else if (args2.template) {
-    selectedTemplate = findTemplateByName(templates, args2.template);
-    if (!selectedTemplate) {
-      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 = 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) {
@@ -2509,8 +2613,13 @@ async function createFromTemplate(args2) {
     projectName = response;
   }
   try {
-    const analytics = getAnalytics();
-    if (analytics) ;
+    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
@@ -2519,7 +2628,7 @@ async function createFromTemplate(args2) {
     Me(`
       ${color2.green("Mastra template installed!")}
 
-      Add the necessary environment 
+      Add the necessary environment
       variables in your ${color2.cyan(".env")} file
       `);
     postCreate({ projectName });
@@ -2572,7 +2681,7 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
   "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)").option(
   "--template [template-name]",
-  "Create project from a template (use template name or leave blank to select from list)"
+  "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;
@@ -2585,7 +2694,8 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
       timeout,
       mcpServer: args.mcp,
       directory: "src/",
-      template: args.template
+      template: args.template,
+      analytics
     });
     return;
   }
@@ -2599,7 +2709,8 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
     projectName,
     directory: args.dir,
     mcpServer: args.mcp,
-    template: args.template
+    template: args.template,
+    analytics
   });
 });
 program.parse(process.argv);