mastra 0.5.0 → 0.6.0-alpha.11

package/dist/{chunk-BY3FZLXQ.js → chunk-YW5YUAZU.js}

@@ -185,20 +185,41 @@ async function writeMergedConfig(configPath) {
   });
 }
 var windsurfGlobalMCPConfigPath = path.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
+var cursorGlobalMCPConfigPath = path.join(os.homedir(), ".cursor", "mcp.json");
 async function installMastraDocsMCPServer({
   editor,
   directory
 }) {
-  if (editor === `cursor`) await writeMergedConfig(path.join(directory, ".cursor", "mcp.json"));
-  const windsurfIsInstalled = await globalWindsurfMCPIsAlreadyInstalled();
-  if (editor === `windsurf` && !windsurfIsInstalled) await writeMergedConfig(windsurfGlobalMCPConfigPath);
+  if (editor === `cursor`) {
+    await writeMergedConfig(path.join(directory, ".cursor", "mcp.json"));
+  }
+  if (editor === `cursor-global`) {
+    const alreadyInstalled = await globalMCPIsAlreadyInstalled(editor);
+    if (alreadyInstalled) {
+      return;
+    }
+    await writeMergedConfig(cursorGlobalMCPConfigPath);
+  }
+  if (editor === `windsurf`) {
+    const alreadyInstalled = await globalMCPIsAlreadyInstalled(editor);
+    if (alreadyInstalled) {
+      return;
+    }
+    await writeMergedConfig(windsurfGlobalMCPConfigPath);
+  }
 }
-async function globalWindsurfMCPIsAlreadyInstalled() {
-  if (!existsSync(windsurfGlobalMCPConfigPath)) {
+async function globalMCPIsAlreadyInstalled(editor) {
+  let configPath = ``;
+  if (editor === "windsurf") {
+    configPath = windsurfGlobalMCPConfigPath;
+  } else if (editor === "cursor-global") {
+    configPath = cursorGlobalMCPConfigPath;
+  }
+  if (!configPath || !existsSync(configPath)) {
     return false;
   }
   try {
-    const configContents = await readJSON(windsurfGlobalMCPConfigPath);
+    const configContents = await readJSON(configPath);
     if (!configContents?.mcpServers) return false;
     const hasMastraMCP = Object.values(configContents.mcpServers).some(
       (server) => server?.args?.find((arg) => arg?.includes(`@mastra/mcp-docs-server`))
@@ -382,6 +403,7 @@ async function writeAgentSample(llmProvider, destPath, addExampleTool) {
   const content = `
 ${providerImport}
 import { Agent } from '@mastra/core/agent';
+import { Memory } from '@mastra/memory';
 ${addExampleTool ? `import { weatherTool } from '../tools';` : ""}
 
 export const weatherAgent = new Agent({
@@ -389,6 +411,15 @@ export const weatherAgent = new Agent({
   instructions: \`${instructions}\`,
   model: ${modelItem},
   ${addExampleTool ? "tools: { weatherTool }," : ""}
+  memory: new Memory({
+    options: {
+      lastMessages: 10,
+      semanticRecall: false,
+      threads: {
+        generateTitle: false
+      } 
+    }
+  })
 });
     `;
   const formattedContent = await prettier.format(content, {
@@ -643,11 +674,16 @@ export const mastra = new Mastra()
       `
 import { Mastra } from '@mastra/core/mastra';
 import { createLogger } from '@mastra/core/logger';
+import { LibSQLStore } from '@mastra/libsql';
 ${addWorkflow ? `import { weatherWorkflow } from './workflows';` : ""}
 ${addAgent ? `import { weatherAgent } from './agents';` : ""}
 
 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
+    url: ":memory:",
+  }),
   logger: createLogger({
     name: 'Mastra',
     level: 'info',
@@ -659,18 +695,24 @@ export const mastra = new Mastra({
     throw err;
   }
 };
-var checkAndInstallCoreDeps = async () => {
+var checkAndInstallCoreDeps = async (addExample) => {
   const depsService = new DepsService();
-  const depCheck = await depsService.checkDependencies(["@mastra/core"]);
+  let depCheck = await depsService.checkDependencies(["@mastra/core"]);
   if (depCheck !== "ok") {
-    await installCoreDeps();
+    await installCoreDeps("@mastra/core");
+  }
+  if (addExample) {
+    depCheck = await depsService.checkDependencies(["@mastra/libsql"]);
+    if (depCheck !== "ok") {
+      await installCoreDeps("@mastra/libsql");
+    }
   }
 };
 var spinner = yoctoSpinner({ text: "Installing Mastra core dependencies\n" });
-async function installCoreDeps() {
+async function installCoreDeps(pkg) {
   try {
     const confirm2 = await p.confirm({
-      message: "You do not have the @mastra/core package installed. Would you like to install it?",
+      message: `You do not have the ${pkg} package installed. Would you like to install it?`,
       initialValue: false
     });
     if (p.isCancel(confirm2)) {
@@ -683,7 +725,7 @@ async function installCoreDeps() {
     }
     spinner.start();
     const depsService = new DepsService();
-    await depsService.installPackages(["@mastra/core@latest"]);
+    await depsService.installPackages([`${pkg}@latest`]);
     spinner.success("@mastra/core installed successfully");
   } catch (err) {
     console.error(err);
@@ -789,12 +831,22 @@ var interactivePrompt = async () => {
         initialValue: false
       }),
       configureEditorWithDocsMCP: async () => {
-        const windsurfIsAlreadyInstalled = await globalWindsurfMCPIsAlreadyInstalled();
+        const windsurfIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`windsurf`);
+        const cursorIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`cursor`);
         const editor = await p.select({
           message: `Make your AI IDE into a Mastra expert? (installs Mastra docs MCP server)`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
-            { value: "cursor", label: "Cursor" },
+            {
+              value: "cursor",
+              label: "Cursor (project only)",
+              hint: cursorIsAlreadyInstalled ? `Already installed globally` : void 0
+            },
+            {
+              value: "cursor-global",
+              label: "Cursor (global, all projects)",
+              hint: cursorIsAlreadyInstalled ? `Already installed` : void 0
+            },
             {
               value: "windsurf",
               label: "Windsurf",
@@ -815,6 +867,18 @@ Note: you will need to go into Cursor Settings -> MCP Settings and manually enab
 `
           );
         }
+        if (editor === `cursor-global`) {
+          const confirm2 = await p.select({
+            message: `Global install will add/update ${cursorGlobalMCPConfigPath} and make the Mastra docs MCP server available in all your Cursor projects. Continue?`,
+            options: [
+              { value: "yes", label: "Yes, I understand" },
+              { value: "skip", label: "No, skip for now" }
+            ]
+          });
+          if (confirm2 !== `yes`) {
+            return void 0;
+          }
+        }
         if (editor === `windsurf`) {
           const confirm2 = await p.select({
             message: `Windsurf only supports a global MCP config (at ${windsurfGlobalMCPConfigPath}) is it ok to add/update that global config?
@@ -894,6 +958,15 @@ var init = async ({
           (component) => writeCodeSample(dirPath, component, llmProvider, components)
         )
       ]);
+      const depService = new DepsService();
+      const needsLibsql = await depService.checkDependencies(["@mastra/libsql"]) !== `ok`;
+      if (needsLibsql) {
+        await depService.installPackages(["@mastra/libsql"]);
+      }
+      const needsMemory = components.includes(`agents`) && await depService.checkDependencies(["@mastra/memory"]) !== `ok`;
+      if (needsMemory) {
+        await depService.installPackages(["@mastra/memory"]);
+      }
     }
     const key = await getAPIKey(llmProvider || "openai");
     const aiSdkPackage = getAISDKPackage(llmProvider);
@@ -1033,9 +1106,11 @@ var createMastraProject = async ({
   const versionTag = createVersionTag ? `@${createVersionTag}` : "@latest";
   await installMastraDependency(pm, "mastra", versionTag, true, timeout);
   s2.stop("mastra installed");
-  s2.start("Installing @mastra/core");
+  s2.start("Installing dependencies");
   await installMastraDependency(pm, "@mastra/core", versionTag, false, timeout);
-  s2.stop("@mastra/core installed");
+  await installMastraDependency(pm, "@mastra/libsql", versionTag, false, timeout);
+  await installMastraDependency(pm, "@mastra/memory", versionTag, false, timeout);
+  s2.stop("Dependencies installed");
   s2.start("Adding .gitignore");
   await exec3(`echo output.txt >> .gitignore`);
   await exec3(`echo node_modules >> .gitignore`);
@@ -1058,8 +1133,8 @@ var create = async (args2) => {
     createVersionTag: args2?.createVersionTag,
     timeout: args2?.timeout
   });
-  const directory = "/src";
-  if (!args2.components || !args2.llmProvider || !args2.addExample) {
+  const directory = args2.directory || "src/";
+  if (args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0) {
     const result = await interactivePrompt();
     await init({
       ...result,

package/dist/commands/create/create.d.ts

@@ -8,6 +8,7 @@ declare const create: (args: {
     llmApiKey?: string;
     createVersionTag?: string;
     timeout?: number;
+    directory?: string;
 }) => Promise<void>;
 
 export { create };

package/dist/commands/create/create.js

@@ -1 +1 @@
-export { create } from '../../chunk-BY3FZLXQ.js';
+export { create } from '../../chunk-YW5YUAZU.js';

package/dist/index.js

@@ -1,8 +1,8 @@
 #! /usr/bin/env node
 import { PosthogAnalytics } from './chunk-7OXWUU2Q.js';
 export { PosthogAnalytics } from './chunk-7OXWUU2Q.js';
-import { DepsService, create, checkPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, convertToViteEnvVar, FileService as FileService$1 } from './chunk-BY3FZLXQ.js';
-export { create } from './chunk-BY3FZLXQ.js';
+import { DepsService, create, checkPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, convertToViteEnvVar, FileService as FileService$1 } from './chunk-YW5YUAZU.js';
+export { create } from './chunk-YW5YUAZU.js';
 import { Command } from 'commander';
 import { config } from 'dotenv';
 import { join as join$1, dirname } from 'node:path';
@@ -94,7 +94,7 @@ var BuildBundler = class extends Bundler {
   }
 };
 async function build({ dir, tools }) {
-  const mastraDir = dir ?? join$1(process.cwd(), "src", "mastra");
+  const mastraDir = dir ? dir.startsWith("/") ? dir : join$1(process.cwd(), dir) : join$1(process.cwd(), "src", "mastra");
   const outputDirectory = join$1(process.cwd(), ".mastra");
   const defaultToolsPath = join$1(mastraDir, "tools");
   const discoveredTools = [defaultToolsPath, ...tools ?? []];
@@ -106,6 +106,10 @@ async function build({ dir, tools }) {
       const deployer = new BuildBundler();
       await deployer.prepare(outputDirectory);
       await deployer.bundle(mastraEntryFile, outputDirectory, discoveredTools);
+      logger.info(`Build successful, you can now deploy the .mastra/output directory to your target platform.`);
+      logger.info(
+        `To start the server, run: node --import=./.mastra/output/instrumentation.mjs .mastra/output/index.mjs`
+      );
       return;
     }
     logger.info("Deployer found, preparing deployer build...");
@@ -213,11 +217,8 @@ var DevBundler = class extends Bundler {
           {
             name: "tools-watcher",
             async buildEnd() {
-              const toolsInputOptions2 = Array.from(Object.keys(inputOptions.input || {})).filter((key) => key.startsWith("tools/")).map((key) => `./${key}.mjs`);
-              await writeFile(
-                join$1(outputDir, "tools.mjs"),
-                `export const tools = ${JSON.stringify(toolsInputOptions2)};`
-              );
+              const toolsInputPaths = Array.from(Object.keys(toolsInputOptions || {})).filter((key) => key.startsWith("tools/")).map((key) => `./${key}.mjs`);
+              await writeFile(join$1(outputDir, "tools.mjs"), `export const tools = ${JSON.stringify(toolsInputPaths)};`);
             }
           }
         ],
@@ -335,7 +336,7 @@ async function dev({
   tools
 }) {
   const rootDir = root || process.cwd();
-  const mastraDir = join(rootDir, dir || "src/mastra");
+  const mastraDir = dir ? dir.startsWith("/") ? dir : join(process.cwd(), dir) : join(process.cwd(), "src", "mastra");
   const dotMastraPath = join(rootDir, ".mastra");
   const defaultToolsPath = join(mastraDir, "tools");
   const discoveredTools = [defaultToolsPath, ...tools || []];
@@ -387,13 +388,14 @@ program.version(`${version}`, "-v, --version").description(`Mastra CLI ${version
   } catch {
   }
 });
-program.command("create").description("Create a new Mastra project").option("--default", "Quick start with defaults(src, OpenAI, no 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("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option(
+program.command("create [project-name]").description("Create a new Mastra project").option("--default", "Quick start with defaults(src, OpenAI, no 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(
   "-p, --project-name <string>",
   "Project name that will be used in package.json and as the project directory name."
-).action(async (args) => {
+).action(async (projectNameArg, args) => {
+  const projectName = projectNameArg || args.projectName;
   await analytics.trackCommandExecution({
     command: "create",
-    args,
+    args: { ...args, projectName },
     execution: async () => {
       const timeout = args?.timeout ? args?.timeout === true ? 6e4 : parseInt(args?.timeout, 10) : void 0;
       if (args.default) {
@@ -411,19 +413,20 @@ program.command("create").description("Create a new Mastra project").option("--d
         addExample: args.example,
         llmApiKey: args["llm-api-key"],
         timeout,
-        projectName: args.projectName
+        projectName,
+        directory: args.dir
       });
     },
     origin
   });
 });
-program.command("init").description("Initialize Mastra in your project").option("--default", "Quick start with defaults(src, OpenAI, no examples)").option("-d, --dir <directory>", "Directory for Mastra files to (defaults to src/)").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").action(async (args) => {
+program.command("init").description("Initialize Mastra in your project").option("--default", "Quick start with defaults(src, OpenAI, no examples)").option("-d, --dir <directory>", "Directory for Mastra files to (defaults to src/)").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").action(async (args) => {
   await analytics.trackCommandExecution({
     command: "init",
     args,
     execution: async () => {
       await checkPkgJson();
-      await checkAndInstallCoreDeps();
+      await checkAndInstallCoreDeps(args?.example || args?.default);
       if (!Object.keys(args).length) {
         const result = await interactivePrompt();
         await init({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mastra",
-  "version": "0.5.0",
+  "version": "0.6.0-alpha.11",
   "license": "Elastic-2.0",
   "description": "cli for mastra",
   "type": "module",
@@ -54,11 +54,11 @@
     "yocto-spinner": "^0.1.2",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "^0.9.0",
-    "@mastra/deployer": "^0.3.0"
+    "@mastra/deployer": "^0.3.1-alpha.8",
+    "@mastra/core": "^0.9.1-alpha.8"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.52.1",
+    "@microsoft/api-extractor": "^7.52.5",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.17.27",
     "@types/prompt": "^1.1.9",
@@ -67,14 +67,14 @@
     "eslint": "^9.23.0",
     "memfs": "^4.17.0",
     "npm-run-all2": "^7.0.2",
-    "rollup": "^4.35.0",
+    "rollup": "^4.40.1",
     "tsup": "^8.4.0",
     "type-fest": "^4.37.0",
     "typescript": "^5.8.2",
-    "vitest": "^3.0.9",
+    "vitest": "^3.1.2",
+    "@mastra/client-js": "0.1.19-alpha.8",
     "@internal/lint": "0.0.2",
-    "@mastra/client-js": "0.1.18",
-    "@mastra/playground-ui": "5.0.0"
+    "@mastra/playground-ui": "5.0.1-alpha.9"
   },
   "scripts": {
     "build": "npm-run-all --serial build:lib copy-starter-files copy-templates build:playground",