create-mastra 0.0.0-fix-network-silence-20250930164151 → 0.0.0-fix-maxSteps-modelsetting-playground-20251008194458

package/CHANGELOG.md

@@ -1,6 +1,186 @@
 # create-mastra
 
-## 0.0.0-fix-network-silence-20250930164151
+## 0.0.0-fix-maxSteps-modelsetting-playground-20251008194458
+
+### Patch Changes
+
+- Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
+
+## 0.15.1-alpha.1
+
+## 0.15.1-alpha.0
+
+### Patch Changes
+
+- Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
+
+## 0.15.0
+
+### Patch Changes
+
+- Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
+
+- streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
+
+- avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
+
+- add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
+
+- Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
+
+- Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
+
+- Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
+
+- Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
+  fixed an issue with provider ID rendering in playground UI
+
+- Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
+
+## 0.15.0-alpha.3
+
+### Patch Changes
+
+- Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
+  fixed an issue with provider ID rendering in playground UI
+
+## 0.14.2-alpha.2
+
+### Patch Changes
+
+- Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
+
+## 0.14.2-alpha.1
+
+### Patch Changes
+
+- Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
+
+- avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
+
+- add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
+
+- Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
+
+- Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
+
+## 0.14.2-alpha.0
+
+### Patch Changes
+
+- streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
+
+- Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
+
+## 0.14.1
+
+### Patch Changes
+
+- Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
+
+## 0.14.1-alpha.0
+
+### Patch Changes
+
+- Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
+
+## 0.14.0
+
+### Minor Changes
+
+- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
+
+### Patch Changes
+
+- Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
+
+- add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
+
+- better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
+
+- fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
+
+- Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
+
+  **Documentation generation (`@mastra/core`):**
+  - Fixed inverted dynamic model selection logic in provider examples
+  - Improved copy: replaced marketing language with action-oriented descriptions
+  - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
+
+  **Playground UI model picker (`@mastra/playground-ui`):**
+  - Fixed provider field clearing when typing in model input
+  - Added responsive layout (stacks on mobile, side-by-side on desktop)
+  - Improved general styling of provider/model pickers
+
+  **Environment variables (`@mastra/deployer`):**
+  - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
+  - Added correct singular/plural handling for "environment variable(s)"
+
+- show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
+
+- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
+
+- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
+
+## 0.14.0-alpha.0
+
+### Minor Changes
+
+- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
+
+### Patch Changes
+
+- Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
+
+- add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
+
+- better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
+
+- fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
+
+- Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
+
+  **Documentation generation (`@mastra/core`):**
+  - Fixed inverted dynamic model selection logic in provider examples
+  - Improved copy: replaced marketing language with action-oriented descriptions
+  - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
+
+  **Playground UI model picker (`@mastra/playground-ui`):**
+  - Fixed provider field clearing when typing in model input
+  - Added responsive layout (stacks on mobile, side-by-side on desktop)
+  - Improved general styling of provider/model pickers
+
+  **Environment variables (`@mastra/deployer`):**
+  - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
+  - Added correct singular/plural handling for "environment variable(s)"
+
+- show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
+
+- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
+
+- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
+
+## 0.13.4
+
+### Patch Changes
+
+- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
+
+- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
+
+## 0.13.4-alpha.1
+
+### Patch Changes
+
+- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
+
+## 0.13.4-alpha.0
+
+### Patch Changes
+
+- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
+
+## 0.13.3
 
 ### Patch Changes
 
@@ -8,10 +188,22 @@
 
 - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
 
+- Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
+
 - Add types in the streamVNext codepath, fixes for various issues across multiple packages surfaced from type issues, align return types. ([#8010](https://github.com/mastra-ai/mastra/pull/8010))
 
 - Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
 
+## 0.13.3-alpha.1
+
+### Patch Changes
+
+- Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
+
+- Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
+
+- Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
+
 ## 0.13.3-alpha.0
 
 ### Patch Changes

package/dist/index.js

@@ -1667,10 +1667,8 @@ 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";
+      return "latest";
   }
 };
 var getAISDKPackage = (llmProvider) => {
@@ -2007,13 +2005,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 }, 
+  },
 });
 `
     );
@@ -2044,14 +2050,12 @@ var getAPIKey = async (provider) => {
       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 exec2(`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 !== "");
@@ -2072,8 +2076,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({
@@ -2081,20 +2096,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" },
-          { value: "mistral", label: "Mistral" }
-        ]
+      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" }
@@ -2104,7 +2114,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;
@@ -2114,7 +2127,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" },
             {
@@ -2326,18 +2339,34 @@ 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");
@@ -2398,15 +2427,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);
@@ -2433,7 +2462,7 @@ var createMastraProject = async ({
     s2.stop(".gitignore added");
     Se("Project created successfully");
     console.info("");
-    return { projectName };
+    return { projectName, result };
   } catch (error) {
     s2.stop();
     const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred";
@@ -2446,14 +2475,17 @@ var create = async (args2) => {
     await createFromTemplate({ ...args2, injectedAnalytics: args2.analytics });
     return;
   }
-  const { projectName } = await createMastraProject({
+  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,
@@ -2679,7 +2711,7 @@ program.version(`${version}`, "-v, --version").description(`create-mastra ${vers
 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)").option(
+).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) => {
@@ -2703,7 +2735,7 @@ 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,