mastra 0.6.1-alpha.4 → 0.6.1-alpha.6

package/README.md

@@ -90,17 +90,25 @@ const mastra = new Mastra({
 });
 ```
 
-### Deploy
+### Lint
 
-`mastra deploy`
+`mastra lint`
 
-This command deploys the mastra project to a serverless platform like Vercel or Cloudflare Workers.
+Validates your Mastra project structure and code.
 
-The deploy command does the following:
+Options:
+
+```bash
+--root    Path to your root folder
+--tools   Comma-separated list of paths to tool files to include
+```
 
-- Initializes the mastra project
-- Builds the project
-- Deploys the built project to the platform
+Example usage:
+
+```bash
+# Lint default directory
+mastra lint
+```
 
 # Telemetry
 

package/dist/{chunk-YW5YUAZU.js → chunk-6PMRPTZU.js}

@@ -404,6 +404,7 @@ async function writeAgentSample(llmProvider, destPath, addExampleTool) {
 ${providerImport}
 import { Agent } from '@mastra/core/agent';
 import { Memory } from '@mastra/memory';
+import { LibSQLStore } from '@mastra/libsql';
 ${addExampleTool ? `import { weatherTool } from '../tools';` : ""}
 
 export const weatherAgent = new Agent({
@@ -412,6 +413,9 @@ export const weatherAgent = new Agent({
   model: ${modelItem},
   ${addExampleTool ? "tools: { weatherTool }," : ""}
   memory: new Memory({
+    storage: new LibSQLStore({
+      url: "file:../mastra.db", // path is relative to the .mastra/output directory
+    }),
     options: {
       lastMessages: 10,
       semanticRecall: false,

package/dist/commands/create/create.js

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

package/dist/index.js

@@ -1,20 +1,21 @@
 #! /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-YW5YUAZU.js';
-export { create } from './chunk-YW5YUAZU.js';
+import { DepsService, create, checkPkgJson, checkAndInstallCoreDeps, interactivePrompt, init, logger, FileService, convertToViteEnvVar } from './chunk-6PMRPTZU.js';
+export { create } from './chunk-6PMRPTZU.js';
 import { Command } from 'commander';
 import { config } from 'dotenv';
 import { join as join$1, dirname } from 'node:path';
-import { getServerOptions, getWatcherInputOptions, writeTelemetryConfig, createWatcher, FileService as FileService$2 } from '@mastra/deployer/build';
+import { getServerOptions, FileService as FileService$2, getWatcherInputOptions, writeTelemetryConfig, createWatcher } from '@mastra/deployer/build';
 import { Bundler } from '@mastra/deployer/bundler';
-import { FileService, getDeployer } from '@mastra/deployer';
+import { getDeployer, FileService as FileService$1 } from '@mastra/deployer';
 import { join } from 'path';
 import { isWebContainer } from '@webcontainer/env';
 import { execa } from 'execa';
 import { writeFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import * as fsExtra from 'fs-extra';
+import { readFileSync } from 'fs';
 
 var BuildBundler = class extends Bundler {
   constructor() {
@@ -92,14 +93,18 @@ var BuildBundler = class extends Bundler {
     });
     `;
   }
+  async lint(entryFile, outputDirectory, toolsPaths) {
+    await super.lint(entryFile, outputDirectory, toolsPaths);
+  }
 };
-async function build({ dir, tools }) {
-  const mastraDir = dir ? dir.startsWith("/") ? dir : join$1(process.cwd(), dir) : join$1(process.cwd(), "src", "mastra");
-  const outputDirectory = join$1(process.cwd(), ".mastra");
+async function build({ dir: dir2, tools, root }) {
+  const rootDir = root || process.cwd();
+  const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join$1(rootDir, dir2) : join$1(rootDir, "src", "mastra");
+  const outputDirectory = join$1(rootDir, ".mastra");
   const defaultToolsPath = join$1(mastraDir, "tools");
   const discoveredTools = [defaultToolsPath, ...tools ?? []];
   try {
-    const fs = new FileService$1();
+    const fs = new FileService();
     const mastraEntryFile = fs.getFirstExistingFile([join$1(mastraDir, "index.ts"), join$1(mastraDir, "index.js")]);
     const platformDeployer = await getDeployer(mastraEntryFile, outputDirectory);
     if (!platformDeployer) {
@@ -122,11 +127,11 @@ async function build({ dir, tools }) {
     }
   }
 }
-async function deploy({ dir }) {
-  let mastraDir = dir || join(process.cwd(), "src/mastra");
+async function deploy({ dir: dir2 }) {
+  let mastraDir = dir2 || join(process.cwd(), "src/mastra");
   try {
     const outputDirectory = join(process.cwd(), ".mastra");
-    const fs = new FileService$1();
+    const fs = new FileService();
     const mastraEntryFile = fs.getFirstExistingFile([join(mastraDir, "index.ts"), join(mastraDir, "index.js")]);
     const deployer = await getDeployer(mastraEntryFile, outputDirectory);
     if (!deployer) {
@@ -160,7 +165,7 @@ var DevBundler = class extends Bundler {
   getEnvFiles() {
     const possibleFiles = [".env.development", ".env.local", ".env"];
     try {
-      const fileService = new FileService();
+      const fileService = new FileService$1();
       const envFile = fileService.getFirstExistingFile(possibleFiles);
       return Promise.resolve([envFile]);
     } catch {
@@ -331,16 +336,16 @@ async function rebundleAndRestart(dotMastraPath, port, bundler) {
 }
 async function dev({
   port,
-  dir,
+  dir: dir2,
   root,
   tools
 }) {
   const rootDir = root || process.cwd();
-  const mastraDir = dir ? dir.startsWith("/") ? dir : join(process.cwd(), dir) : join(process.cwd(), "src", "mastra");
+  const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join(process.cwd(), dir2) : join(process.cwd(), "src", "mastra");
   const dotMastraPath = join(rootDir, ".mastra");
   const defaultToolsPath = join(mastraDir, "tools");
   const discoveredTools = [defaultToolsPath, ...tools || []];
-  const fileService = new FileService();
+  const fileService = new FileService$1();
   const entryFile = fileService.getFirstExistingFile([join(mastraDir, "index.ts"), join(mastraDir, "index.js")]);
   const bundler = new DevBundler();
   await bundler.prepare(dotMastraPath);
@@ -368,6 +373,202 @@ async function dev({
   });
 }
 
+// src/commands/lint/rules/mastraCoreRule.ts
+var mastraCoreRule = {
+  name: "mastra-core",
+  description: "Checks if @mastra/core is installed",
+  async run(context) {
+    const hasCore = context.mastraPackages.some((pkg) => pkg.name === "@mastra/core");
+    if (!hasCore) {
+      logger.error("@mastra/core is not installed. This package is required for Mastra to work properly.");
+      return false;
+    }
+    return true;
+  }
+};
+
+// src/commands/lint/rules/mastraDepsCompatibilityRule.ts
+var mastraDepsCompatibilityRule = {
+  name: "mastra-deps-compatibility",
+  description: "Checks if Mastra package versions are compatible",
+  async run(context) {
+    if (context.mastraPackages.length === 0) {
+      logger.warn("No Mastra packages found in package.json");
+      return true;
+    }
+    const hasAlpha = context.mastraPackages.some((pkg) => pkg.isAlpha);
+    const hasNonAlpha = context.mastraPackages.some((pkg) => !pkg.isAlpha);
+    if (hasAlpha && hasNonAlpha) {
+      logger.error("Inconsistent Mastra package versions found:");
+      context.mastraPackages.forEach(({ name, version: version2 }) => {
+        logger.error(`  ${name}: ${version2}`);
+      });
+      logger.error("All Mastra packages should be either alpha or non-alpha versions");
+      return false;
+    }
+    logger.info("All Mastra package versions are consistent!");
+    return true;
+  }
+};
+function readNextConfig(dir) {
+  const nextConfigPath = join(dir, "next.config.js");
+  try {
+    const nextConfigContent = readFileSync(nextConfigPath, "utf-8");
+    const configMatch = nextConfigContent.match(/const nextConfig = ({[\s\S]*?});/);
+    if (!configMatch?.[1]) {
+      return null;
+    }
+    const configStr = configMatch[1].replace(/\n/g, "").replace(/\s+/g, " ");
+    return eval(`(${configStr})`);
+  } catch {
+    return null;
+  }
+}
+function isNextJsProject(dir2) {
+  const nextConfigPath2 = join(dir2, "next.config.js");
+  try {
+    readFileSync(nextConfigPath2, "utf-8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+var nextConfigRule = {
+  name: "next-config",
+  description: "Checks if Next.js config is properly configured for Mastra packages",
+  async run(context) {
+    if (!isNextJsProject(context.rootDir)) {
+      return true;
+    }
+    const nextConfig = readNextConfig(context.rootDir);
+    if (!nextConfig) {
+      return false;
+    }
+    const serverExternals = nextConfig.serverExternalPackages || [];
+    const hasMastraExternals = serverExternals.some(
+      (pkg) => pkg === "@mastra/*" || pkg === "@mastra/core" || pkg.startsWith("@mastra/")
+    );
+    if (!hasMastraExternals) {
+      logger.error("next.config.js is missing Mastra packages in serverExternalPackages");
+      logger.error("Please add the following to your next.config.js:");
+      logger.error('  serverExternalPackages: ["@mastra/*"],');
+      return false;
+    }
+    logger.info("Next.js config is properly configured for Mastra packages");
+    return true;
+  }
+};
+function readTsConfig(dir2) {
+  const tsConfigPath = join(dir2, "tsconfig.json");
+  try {
+    const tsConfigContent = readFileSync(tsConfigPath, "utf-8");
+    return JSON.parse(tsConfigContent);
+  } catch {
+    return null;
+  }
+}
+var tsConfigRule = {
+  name: "ts-config",
+  description: "Checks if TypeScript config is properly configured for Mastra packages",
+  async run(context) {
+    const tsConfig = readTsConfig(context.rootDir);
+    if (!tsConfig) {
+      logger.warn("No tsconfig.json found. This might cause issues with Mastra packages.");
+      return true;
+    }
+    const { module, moduleResolution } = tsConfig.compilerOptions || {};
+    const isValidConfig = moduleResolution === "bundler" || module === "CommonJS";
+    if (!isValidConfig) {
+      logger.error("tsconfig.json has invalid configuration");
+      logger.error("Please set either:");
+      logger.error('  "compilerOptions": {');
+      logger.error('    "moduleResolution": "bundler"');
+      logger.error("  }");
+      logger.error("or");
+      logger.error('  "compilerOptions": {');
+      logger.error('    "module": "CommonJS"');
+      logger.error("  }");
+      logger.error("For the recommended TypeScript configuration, see:");
+      logger.error("https://mastra.ai/en/docs/getting-started/installation#initialize-typescript");
+      return false;
+    }
+    logger.info("TypeScript config is properly configured for Mastra packages");
+    return true;
+  }
+};
+
+// src/commands/lint/rules/index.ts
+var rules = [nextConfigRule, tsConfigRule, mastraCoreRule, mastraDepsCompatibilityRule];
+
+// src/commands/lint/index.ts
+function readPackageJson(dir2) {
+  const packageJsonPath = join(dir2, "package.json");
+  try {
+    const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
+    return JSON.parse(packageJsonContent);
+  } catch (error) {
+    if (error instanceof Error) {
+      logger.error(`Failed to read package.json: ${error.message}`);
+    }
+    throw error;
+  }
+}
+function getMastraPackages(packageJson) {
+  const allDependencies = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies
+  };
+  const mastraPackages = Object.entries(allDependencies).filter(
+    ([name]) => name.startsWith("@mastra/") || name === "mastra"
+  );
+  return mastraPackages.map(([name, version2]) => ({
+    name,
+    version: version2,
+    isAlpha: version2.includes("alpha")
+  }));
+}
+async function lint({ dir: dir2, root, tools }) {
+  try {
+    const rootDir = root || process.cwd();
+    const mastraDir = dir2 ? dir2.startsWith("/") ? dir2 : join(process.cwd(), dir2) : join(process.cwd(), "src", "mastra");
+    const outputDirectory = join(rootDir, ".mastra");
+    const defaultToolsPath = join(mastraDir, "tools");
+    const discoveredTools = [defaultToolsPath, ...tools ?? []];
+    const packageJson = readPackageJson(rootDir);
+    const mastraPackages = getMastraPackages(packageJson);
+    const context = {
+      rootDir,
+      mastraDir,
+      outputDirectory,
+      discoveredTools,
+      packageJson,
+      mastraPackages
+    };
+    const results = await Promise.all(rules.map((rule) => rule.run(context)));
+    const allRulesPassed = results.every((result) => result);
+    if (allRulesPassed) {
+      const fileService = new FileService();
+      const mastraEntryFile = fileService.getFirstExistingFile([
+        join(mastraDir, "index.ts"),
+        join(mastraDir, "index.js")
+      ]);
+      const platformDeployer = await getDeployer(mastraEntryFile, outputDirectory);
+      if (!platformDeployer) {
+        const deployer = new BuildBundler();
+        await deployer.lint(mastraEntryFile, outputDirectory, discoveredTools);
+      } else {
+        await platformDeployer.lint(mastraEntryFile, outputDirectory, discoveredTools);
+      }
+    }
+    return allRulesPassed;
+  } catch (error) {
+    if (error instanceof Error) {
+      logger.error(`Lint check failed: ${error.message}`);
+    }
+    return false;
+  }
+}
+
 // src/index.ts
 var depsService = new DepsService();
 var version = await depsService.getPackageVersion();
@@ -457,6 +658,16 @@ program.command("init").description("Initialize Mastra in your project").option(
     origin
   });
 });
+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(async (args) => {
+  await analytics.trackCommandExecution({
+    command: "lint",
+    args,
+    execution: async () => {
+      await lint({ dir: args.dir, root: args.root, tools: args.tools ? args.tools.split(",") : [] });
+    },
+    origin
+  });
+});
 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("-p, --port <port>", "deprecated: Port number for the development server (defaults to 4111)").action((args) => {
   analytics.trackCommand({
     command: "dev",
@@ -474,14 +685,15 @@ program.command("dev").description("Start mastra server").option("-d, --dir <dir
     logger.error(err.message);
   });
 });
-program.command("build").description("Build your Mastra project").option("-d, --dir <path>", "Path to directory").option("-t, --tools <toolsDirs>", "Comma-separated list of paths to tool files to include").action(async (args) => {
+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").action(async (args) => {
   await analytics.trackCommandExecution({
     command: "mastra build",
     args,
     execution: async () => {
       await build({
-        dir: args.dir,
-        tools: args.tools ? args.tools.split(",") : []
+        dir: args?.dir,
+        root: args?.root,
+        tools: args?.tools ? args.tools.split(",") : []
       });
     },
     origin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mastra",
-  "version": "0.6.1-alpha.4",
+  "version": "0.6.1-alpha.6",
   "license": "Elastic-2.0",
   "description": "cli for mastra",
   "type": "module",
@@ -54,8 +54,8 @@
     "yocto-spinner": "^0.1.2",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "^0.9.2-alpha.4",
-    "@mastra/deployer": "^0.3.2-alpha.4"
+    "@mastra/core": "^0.9.2-alpha.6",
+    "@mastra/deployer": "^0.3.2-alpha.6"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -73,8 +73,8 @@
     "typescript": "^5.8.2",
     "vitest": "^3.1.2",
     "@internal/lint": "0.0.2",
-    "@mastra/client-js": "0.1.20-alpha.4",
-    "@mastra/playground-ui": "5.0.2-alpha.4"
+    "@mastra/client-js": "0.1.20-alpha.6",
+    "@mastra/playground-ui": "5.0.2-alpha.6"
   },
   "scripts": {
     "build": "npm-run-all --serial build:lib copy-starter-files copy-templates build:playground",