mastra 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/commands/start/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start.ts"],"names":[],"mappings":"AAKA,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,iBAkFrD"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,iBAmFrD"}

package/dist/commands/studio/index.d.ts

@@ -0,0 +1,2 @@
+export { studio } from './studio.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/studio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/commands/studio/studio.d.ts

@@ -0,0 +1,7 @@
+interface StudioOptions {
+    env?: string;
+    port?: string | number;
+}
+export declare function studio(options?: StudioOptions): Promise<void>;
+export {};
+//# sourceMappingURL=studio.d.ts.map

package/dist/commands/studio/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../src/commands/studio/studio.ts"],"names":[],"mappings":"AAQA,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAKD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,iBAqCvD"}

package/dist/commands/utils.d.ts

@@ -1,6 +1,24 @@
 import type { PackageManager } from '../utils/package-manager.js';
 export declare function getPackageManager(): PackageManager;
 export declare function parseMcp(value: string): "cursor" | "cursor-global" | "windsurf" | "vscode";
-export declare function parseComponents(value: string): ("tools" | "agents" | "workflows" | "scorers")[];
+export declare function parseComponents(value: string): ("agents" | "workflows" | "tools" | "scorers")[];
 export declare function parseLlmProvider(value: string): "openai" | "anthropic" | "groq" | "google" | "cerebras" | "mistral";
+export declare function shouldSkipDotenvLoading(): boolean;
+/**
+ * Get the version tag (e.g., 'beta', 'latest') for the currently running mastra CLI.
+ * This queries npm dist-tags to find which tag corresponds to the current version.
+ */
+export declare function getVersionTag(): Promise<string | undefined>;
+/**
+ * Check if the current directory already has git initialized.
+ */
+export declare function isGitInitialized({ cwd }: {
+    cwd: string;
+}): Promise<boolean>;
+/**
+ * Initialize a git repository in the specified directory.
+ */
+export declare function gitInit({ cwd }: {
+    cwd: string;
+}): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/commands/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/commands/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,wBAAgB,iBAAiB,IAAI,cAAc,CA2BlD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,sDAKrC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,oDAQ5C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,uEAK7C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/commands/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,wBAAgB,iBAAiB,IAAI,cAAc,CAiClD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,sDAKrC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,oDAQ5C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,uEAK7C;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAejE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjF;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,iBAarD"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAanE,eAAO,MAAM,OAAO,oBAAoB,CAAC;AAEzC,eAAO,MAAM,SAAS,kBAIpB,CAAC;AAMH,eAAO,MAAM,MAAM,EAA0C,UAAU,CAAC;AA+GxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAcnE,eAAO,MAAM,OAAO,oBAAoB,CAAC;AAEzC,eAAO,MAAM,SAAS,kBAIpB,CAAC;AAMH,eAAO,MAAM,MAAM,EAA0C,UAAU,CAAC;AA4HxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,15 +1,15 @@
 #! /usr/bin/env node
-import { COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, create, checkForPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService, createLogger, DepsService } from './chunk-NHL3S2MZ.js';
-export { create } from './chunk-NHL3S2MZ.js';
-import { PosthogAnalytics, setAnalytics } from './chunk-OQQFOUQW.js';
-export { PosthogAnalytics } from './chunk-OQQFOUQW.js';
+import { package_default, COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, create, checkForPkgJson, getVersionTag, isGitInitialized, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService, createLogger, shouldSkipDotenvLoading, DepsService } from './chunk-7KQSE34M.js';
+export { create } from './chunk-7KQSE34M.js';
+import { PosthogAnalytics, setAnalytics } from './chunk-TL3K64EI.js';
+export { PosthogAnalytics } from './chunk-TL3K64EI.js';
 import { Command } from 'commander';
 import pc2 from 'picocolors';
 import * as p2 from '@clack/prompts';
-import fs, { readFileSync } from 'fs';
-import path, { join, dirname } from 'path';
-import { getServerOptions, FileService as FileService$2, getBundlerOptions, getWatcherInputOptions, createWatcher } from '@mastra/deployer/build';
-import { Bundler } from '@mastra/deployer/bundler';
+import fs, { existsSync, readFileSync } from 'fs';
+import path, { dirname, join } from 'path';
+import { getServerOptions, normalizeStudioBase, FileService as FileService$2, getWatcherInputOptions, createWatcher } from '@mastra/deployer/build';
+import { Bundler, IS_DEFAULT } from '@mastra/deployer/bundler';
 import { getDeployer, FileService as FileService$1 } from '@mastra/deployer';
 import stripJsonComments from 'strip-json-comments';
 import process2 from 'process';
@@ -21,10 +21,8 @@ import { fileURLToPath } from 'url';
 import * as fsExtra from 'fs-extra';
 import { spawn } from 'child_process';
 import { config } from 'dotenv';
-
-// package.json
-var package_default = {
-  version: "1.0.0-beta.1"};
+import http from 'http';
+import handler from 'serve-handler';
 
 // src/commands/scorers/available-scorers.ts
 var AVAILABLE_SCORERS = [
@@ -478,7 +476,20 @@ var BuildBundler = class extends Bundler {
   constructor() {
     super("Build");
   }
+  async getUserBundlerOptions(mastraEntryFile, outputDirectory) {
+    const bundlerOptions = await super.getUserBundlerOptions(mastraEntryFile, outputDirectory);
+    if (!bundlerOptions?.[IS_DEFAULT]) {
+      return bundlerOptions;
+    }
+    return {
+      ...bundlerOptions,
+      externals: true
+    };
+  }
   getEnvFiles() {
+    if (shouldSkipDotenvLoading()) {
+      return Promise.resolve([]);
+    }
     const possibleFiles = [".env.production", ".env.local", ".env"];
     try {
       const fileService = new FileService$2();
@@ -630,14 +641,17 @@ var initProject = async (args) => {
     args: { ...args },
     execution: async () => {
       await checkForPkgJson();
-      await checkAndInstallCoreDeps(Boolean(args?.example || args?.default));
+      const versionTag = await getVersionTag();
+      const skipGitInit = await isGitInitialized({ cwd: process.cwd() });
+      await checkAndInstallCoreDeps(Boolean(args?.example || args?.default), versionTag);
       if (!Object.keys(args).length) {
-        const result = await interactivePrompt();
+        const result = await interactivePrompt({ skip: { gitInit: skipGitInit } });
         await init({
           ...result,
           llmApiKey: result?.llmApiKey,
           components: ["agents", "tools", "workflows"],
-          addExample: true
+          addExample: true,
+          versionTag
         });
         return;
       }
@@ -647,7 +661,8 @@ var initProject = async (args) => {
           components: ["agents", "tools", "workflows"],
           llmProvider: "openai",
           addExample: true,
-          configureEditorWithDocsMCP: args.mcp
+          configureEditorWithDocsMCP: args.mcp,
+          versionTag
         });
         return;
       }
@@ -657,7 +672,8 @@ var initProject = async (args) => {
         llmProvider: args.llm,
         addExample: args.example,
         llmApiKey: args.llmApiKey,
-        configureEditorWithDocsMCP: args.mcp
+        configureEditorWithDocsMCP: args.mcp,
+        versionTag
       });
       return;
     },
@@ -933,7 +949,7 @@ var DevLogger = class {
     const prefix = this.formatPrefix("\u25C7", pc2.blue);
     console.info(`${prefix} ${pc2.blue("Starting Mastra dev server...")}`);
   }
-  ready(host, port, startTime, https) {
+  ready(host, port, studioBasePath, startTime, https) {
     let protocol = "http";
     if (https && https.key && https.cert) {
       protocol = "https";
@@ -942,8 +958,8 @@ var DevLogger = class {
     const timing = startTime ? `${Date.now() - startTime} ms` : "XXX ms";
     console.info(pc2.inverse(pc2.green(" mastra ")) + ` ${pc2.green(version)} ${pc2.gray("ready in")} ${timing}`);
     console.info("");
-    console.info(`${pc2.dim("\u2502")} ${pc2.bold("Playground:")} ${pc2.cyan(`${protocol}://${host}:${port}/`)}`);
-    console.info(`${pc2.dim("\u2502")} ${pc2.bold("API:")}        ${`${protocol}://${host}:${port}/api`}`);
+    console.info(`${pc2.dim("\u2502")} ${pc2.bold("Studio:")} ${pc2.cyan(`${protocol}://${host}:${port}${studioBasePath}`)}`);
+    console.info(`${pc2.dim("\u2502")} ${pc2.bold("API:")}    ${`${protocol}://${host}:${port}/api`}`);
     console.info("");
   }
   bundling() {
@@ -1022,6 +1038,9 @@ var DevBundler = class extends Bundler {
     this.customEnvFile = customEnvFile;
   }
   getEnvFiles() {
+    if (shouldSkipDotenvLoading()) {
+      return Promise.resolve([]);
+    }
     const possibleFiles = [".env.development", ".env.local", ".env"];
     if (this.customEnvFile) {
       possibleFiles.unshift(this.customEnvFile);
@@ -1036,24 +1055,19 @@ var DevBundler = class extends Bundler {
   }
   async prepare(outputDirectory) {
     await super.prepare(outputDirectory);
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
+    const __filename2 = fileURLToPath(import.meta.url);
+    const __dirname2 = dirname(__filename2);
     const playgroundServePath = join(outputDirectory, this.outputDir, "playground");
-    await fsExtra.copy(join(dirname(__dirname), "dist/playground"), playgroundServePath, {
+    await fsExtra.copy(join(dirname(__dirname2), "dist/playground"), playgroundServePath, {
       overwrite: true
     });
   }
   async watch(entryFile, outputDirectory, toolsPaths) {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
+    const __filename2 = fileURLToPath(import.meta.url);
+    const __dirname2 = dirname(__filename2);
     const envFiles = await this.getEnvFiles();
-    let sourcemapEnabled = false;
-    try {
-      const bundlerOptions = await getBundlerOptions(entryFile, outputDirectory);
-      sourcemapEnabled = !!bundlerOptions?.sourcemap;
-    } catch (error) {
-      this.logger.debug("Failed to get bundler options, sourcemap will be disabled", { error });
-    }
+    const bundlerOptions = await this.getUserBundlerOptions(entryFile, outputDirectory);
+    const sourcemapEnabled = !!bundlerOptions?.sourcemap;
     const inputOptions = await getWatcherInputOptions(
       entryFile,
       "node",
@@ -1118,7 +1132,7 @@ var DevBundler = class extends Bundler {
           }
         ],
         input: {
-          index: join(__dirname, "templates", "dev.entry.js"),
+          index: join(__dirname2, "templates", "dev.entry.js"),
           ...toolsInputOptions
         }
       },
@@ -1154,20 +1168,41 @@ var currentServerProcess;
 var isRestarting = false;
 var serverStartTime;
 var ON_ERROR_MAX_RESTARTS = 3;
+var restartAllActiveWorkflowRuns = async ({ host, port }) => {
+  try {
+    await fetch(`http://${host}:${port}/__restart-active-workflow-runs`, {
+      method: "POST"
+    });
+  } catch (error) {
+    devLogger.error(`Failed to restart all active workflow runs: ${error}`);
+    await new Promise((resolve) => setTimeout(resolve, 1500));
+    try {
+      await fetch(`http://${host}:${port}/__restart-active-workflow-runs`, {
+        method: "POST"
+      });
+    } catch {
+    }
+  }
+};
 var startServer = async (dotMastraPath, {
   port,
-  host
+  host,
+  studioBasePath
 }, env, startOptions = {}, errorRestartCount = 0) => {
   let serverIsReady = false;
   try {
     serverStartTime = Date.now();
     devLogger.starting();
     const commands = [];
-    if (startOptions.inspect) {
-      commands.push("--inspect");
+    const inspect = startOptions.inspect === "" ? true : startOptions.inspect;
+    const inspectBrk = startOptions.inspectBrk === "" ? true : startOptions.inspectBrk;
+    if (inspect) {
+      const inspectFlag = typeof inspect === "string" ? `--inspect=${inspect}` : "--inspect";
+      commands.push(inspectFlag);
     }
-    if (startOptions.inspectBrk) {
-      commands.push("--inspect-brk");
+    if (inspectBrk) {
+      const inspectBrkFlag = typeof inspectBrk === "string" ? `--inspect-brk=${inspectBrk}` : "--inspect-brk";
+      commands.push(inspectBrkFlag);
     }
     if (startOptions.customArgs) {
       commands.push(...startOptions.customArgs);
@@ -1200,7 +1235,7 @@ var startServer = async (dotMastraPath, {
     if (currentServerProcess.stdout) {
       currentServerProcess.stdout.on("data", (data) => {
         const output = data.toString();
-        if (!output.includes("Playground available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on port")) {
+        if (!output.includes("Studio available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on ")) {
           process2.stdout.write(output);
         }
       });
@@ -1208,7 +1243,7 @@ var startServer = async (dotMastraPath, {
     if (currentServerProcess.stderr) {
       currentServerProcess.stderr.on("data", (data) => {
         const output = data.toString();
-        if (!output.includes("Playground available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on port")) {
+        if (!output.includes("Studio available") && !output.includes("\u{1F468}\u200D\u{1F4BB}") && !output.includes("Mastra API running on ")) {
           process2.stderr.write(output);
         }
       });
@@ -1221,10 +1256,11 @@ var startServer = async (dotMastraPath, {
     currentServerProcess.on("message", async (message) => {
       if (message?.type === "server-ready") {
         serverIsReady = true;
-        devLogger.ready(host, port, serverStartTime, startOptions.https);
+        devLogger.ready(host, port, studioBasePath, serverStartTime, startOptions.https);
         devLogger.watching();
+        await restartAllActiveWorkflowRuns({ host, port });
         try {
-          await fetch(`http://${host}:${port}/__refresh`, {
+          await fetch(`http://${host}:${port}${studioBasePath}/__refresh`, {
             method: "POST",
             headers: {
               "Content-Type": "application/json"
@@ -1233,7 +1269,7 @@ var startServer = async (dotMastraPath, {
         } catch {
           await new Promise((resolve) => setTimeout(resolve, 1500));
           try {
-            await fetch(`http://${host}:${port}/__refresh`, {
+            await fetch(`http://${host}:${port}${studioBasePath}/__refresh`, {
               method: "POST",
               headers: {
                 "Content-Type": "application/json"
@@ -1268,7 +1304,8 @@ var startServer = async (dotMastraPath, {
           dotMastraPath,
           {
             port,
-            host
+            host,
+            studioBasePath
           },
           env,
           startOptions,
@@ -1280,13 +1317,14 @@ var startServer = async (dotMastraPath, {
 };
 async function checkAndRestart(dotMastraPath, {
   port,
-  host
+  host,
+  studioBasePath
 }, bundler, startOptions = {}) {
   if (isRestarting) {
     return;
   }
   try {
-    const response = await fetch(`http://${host}:${port}/__hot-reload-status`);
+    const response = await fetch(`http://${host}:${port}${studioBasePath}/__hot-reload-status`);
     if (response.ok) {
       const status = await response.json();
       if (status.disabled) {
@@ -1298,11 +1336,12 @@ async function checkAndRestart(dotMastraPath, {
     devLogger.debug(`[Mastra Dev] - Could not check hot reload status: ${error}`);
   }
   devLogger.info("[Mastra Dev] - \u2705 Restarting server...");
-  await rebundleAndRestart(dotMastraPath, { port, host }, bundler, startOptions);
+  await rebundleAndRestart(dotMastraPath, { port, host, studioBasePath }, bundler, startOptions);
 }
 async function rebundleAndRestart(dotMastraPath, {
   port,
-  host
+  host,
+  studioBasePath
 }, bundler, startOptions = {}) {
   if (isRestarting) {
     return;
@@ -1322,7 +1361,8 @@ async function rebundleAndRestart(dotMastraPath, {
       join(dotMastraPath, "output"),
       {
         port,
-        host
+        host,
+        studioBasePath
       },
       env,
       startOptions
@@ -1357,6 +1397,7 @@ async function dev({
   const serverOptions = await getServerOptions(entryFile, join(dotMastraPath, "output"));
   let portToUse = serverOptions?.port ?? process2.env.PORT;
   let hostToUse = serverOptions?.host ?? process2.env.HOST ?? "localhost";
+  const studioBasePathToUse = normalizeStudioBase(serverOptions?.studioBase ?? "/");
   if (!portToUse || isNaN(Number(portToUse))) {
     const portList = Array.from({ length: 21 }, (_, i) => 4111 + i);
     portToUse = String(
@@ -1382,7 +1423,8 @@ async function dev({
     join(dotMastraPath, "output"),
     {
       port: Number(portToUse),
-      host: hostToUse
+      host: hostToUse,
+      studioBasePath: studioBasePathToUse
     },
     loadedEnv,
     startOptions
@@ -1398,7 +1440,8 @@ async function dev({
         dotMastraPath,
         {
           port: Number(portToUse),
-          host: hostToUse
+          host: hostToUse,
+          studioBasePath: studioBasePathToUse
         },
         bundler,
         startOptions
@@ -1426,7 +1469,7 @@ var startDevServer = async (args) => {
     root: args?.root,
     tools: args?.tools ? args.tools.split(",") : [],
     env: args?.env,
-    inspect: args?.inspect && !args?.inspectBrk,
+    inspect: args?.inspectBrk ? false : args?.inspect,
     inspectBrk: args?.inspectBrk,
     customArgs: args?.customArgs ? args.customArgs.split(",") : [],
     https: args?.https,
@@ -1436,7 +1479,9 @@ var startDevServer = async (args) => {
   });
 };
 async function start(options = {}) {
-  config({ path: [options.env || ".env.production", ".env"] });
+  if (!shouldSkipDotenvLoading()) {
+    config({ path: [options.env || ".env.production", ".env"], quiet: true });
+  }
   const outputDir = options.dir || ".mastra/output";
   try {
     const outputPath = join(process.cwd(), outputDir);
@@ -1519,6 +1564,50 @@ var startProject = async (args) => {
     origin: origin2
   });
 };
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+async function studio(options = {}) {
+  config({ path: [options.env || ".env.production", ".env"] });
+  try {
+    const distPath = join(__dirname, "playground");
+    if (!existsSync(distPath)) {
+      logger.error(`Studio distribution not found at ${distPath}.`);
+      process.exit(1);
+    }
+    const port = options.port || 3e3;
+    const server = createServer(distPath);
+    server.listen(port, () => {
+      logger.info(`Mastra Studio running on http://localhost:${port}`);
+    });
+    process.on("SIGINT", () => {
+      server.close(() => {
+        process.exit(0);
+      });
+    });
+    process.on("SIGTERM", () => {
+      server.close(() => {
+        process.exit(0);
+      });
+    });
+  } catch (error) {
+    logger.error(`Failed to start Mastra Studio: ${error.message}`);
+    process.exit(1);
+  }
+}
+var createServer = (builtStudioPath) => {
+  const server = http.createServer((request, response) => {
+    return handler(request, response, {
+      public: builtStudioPath,
+      rewrites: [
+        {
+          source: "**",
+          destination: "/index.html"
+        }
+      ]
+    });
+  });
+  return server;
+};
 
 // src/index.ts
 var mastraPkg = package_default;
@@ -1539,7 +1628,7 @@ ${pc2.bold(pc2.cyan("Mastra"))} is a typescript framework for building AI applic
 ).action(() => {
   program.help();
 });
-program.command("create [project-name]").description("Create a new Mastra project").option("--default", "Quick start with defaults(src, OpenAI, examples)").option(
+program.command("create [project-name]").description("Create a new Mastra project").option("--default", "Quick start with defaults (src, OpenAI, examples)").option(
   "-c, --components <components>",
   `Comma-separated list of components (${COMPONENTS.join(", ")})`,
   parseComponents
@@ -1550,18 +1639,25 @@ program.command("create [project-name]").description("Create a new Mastra projec
   "--template [template-name]",
   "Create project from a template (use template name, public GitHub URL, or leave blank to select from list)"
 ).action(createProject);
-program.command("init").description("Initialize Mastra in your project").option("--default", "Quick start with defaults(src, OpenAI, examples)").option("-d, --dir <directory>", "Directory for Mastra files to (defaults to src/)").option(
+program.command("init").description("Initialize Mastra in your project").option("--default", "Quick start with defaults (src, OpenAI, examples)").option("-d, --dir <directory>", "Directory for Mastra files to (defaults to src/)").option(
   "-c, --components <components>",
   `Comma-separated list of components (${COMPONENTS.join(", ")})`,
   parseComponents
 ).option("-l, --llm <model-provider>", `Default model provider (${LLMProvider.join(", ")})`, parseLlmProvider).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("-m, --mcp <editor>", "MCP Server for code editor (cursor, cursor-global, windsurf, vscode)", parseMcp).action(initProject);
 program.command("lint").description("Lint your Mastra project").option("-d, --dir <path>", "Path to your Mastra folder").option("-r, --root <path>", "Path to your root folder").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").action(lintProject);
-program.command("dev").description("Start mastra server").option("-d, --dir <dir>", "Path to your mastra folder").option("-r, --root <root>", "Path to your root folder").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").option("-e, --env <env>", "Custom env file to include in the dev server").option("-i, --inspect", "Start the dev server in inspect mode").option("-b, --inspect-brk", "Start the dev server in inspect mode and break at the beginning of the script").option(
+program.command("dev").description("Start mastra server").option("-d, --dir <dir>", "Path to your mastra folder").option("-r, --root <root>", "Path to your root folder").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").option("-e, --env <env>", "Custom env file to include in the dev server").option(
+  "-i, --inspect [host:port]",
+  "Start the dev server in inspect mode (optional: [host:]port, e.g., 0.0.0.0:9229)"
+).option(
+  "-b, --inspect-brk [host:port]",
+  "Start the dev server in inspect mode and break at the beginning of the script (optional: [host:]port)"
+).option(
   "-c, --custom-args <args>",
   "Comma-separated list of custom arguments to pass to the dev server. IE: --experimental-transform-types"
 ).option("-s, --https", "Enable local HTTPS").option("--debug", "Enable debug logs", false).action(startDevServer);
 program.command("build").description("Build your Mastra project").option("-d, --dir <path>", "Path to your Mastra Folder").option("-r, --root <path>", "Path to your root folder").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").option("--debug", "Enable debug logs", false).action(buildProject);
 program.command("start").description("Start your built Mastra application").option("-d, --dir <path>", "Path to your built Mastra output directory (default: .mastra/output)").option("-e, --env <env>", "Custom env file to include in the start").action(startProject);
+program.command("studio").description("Start the Mastra studio").option("-p, --port <port>", "Port to run the studio on (default: 3000)").option("-e, --env <env>", "Custom env file to include in the studio").action(studio);
 var scorersCommand = program.command("scorers").description("Manage scorers for evaluating AI outputs");
 scorersCommand.command("add [scorer-name]").description("Add a new scorer to your project").option("-d, --dir <path>", "Path to your Mastra directory (default: auto-detect)").action(addScorer);
 scorersCommand.command("list").description("List available scorer templates").action(listScorers);