@mastra/core 1.2.0-alpha.0 → 1.2.0

package/dist/{chunk-NS33UC72.js → chunk-ENCTSDWC.js}

@@ -1,4 +1,6 @@
 import { createTool } from './chunk-IW3BNL7A.js';
+import { MastraBase } from './chunk-JIT2OY3X.js';
+import { RegisteredLogger } from './chunk-X2WMFSPB.js';
 import * as fs2 from 'fs/promises';
 import * as nodePath from 'path';
 import { constants } from 'fs';
@@ -113,6 +115,20 @@ var FileReadRequiredError = class extends FilesystemError {
   }
 };
 
+// src/workspace/filesystem/mastra-filesystem.ts
+var MastraFilesystem = class extends MastraBase {
+  constructor(options) {
+    super({ name: options.name, component: RegisteredLogger.WORKSPACE });
+  }
+};
+
+// src/workspace/sandbox/mastra-sandbox.ts
+var MastraSandbox = class extends MastraBase {
+  constructor(options) {
+    super({ name: options.name, component: RegisteredLogger.WORKSPACE });
+  }
+};
+
 // src/workspace/line-utils.ts
 function extractLines(content, startLine, endLine) {
   const allLines = content.split("\n");
@@ -1088,7 +1104,7 @@ async function fsStat(absolutePath, userPath) {
 }
 
 // src/workspace/filesystem/local-filesystem.ts
-var LocalFilesystem = class {
+var LocalFilesystem = class extends MastraFilesystem {
   id;
   name = "LocalFilesystem";
   provider = "local";
@@ -1104,6 +1120,7 @@ var LocalFilesystem = class {
     return this._basePath;
   }
   constructor(options) {
+    super({ name: "LocalFilesystem" });
     this.id = options.id ?? this.generateId();
     this._basePath = nodePath.resolve(options.basePath);
     this._contained = options.contained ?? true;
@@ -1187,6 +1204,7 @@ var LocalFilesystem = class {
     }
   }
   async readFile(inputPath, options) {
+    this.logger.debug("Reading file", { path: inputPath, encoding: options?.encoding });
     await this.ensureInitialized();
     const absolutePath = this.resolvePath(inputPath);
     await this.assertPathContained(absolutePath);
@@ -1208,6 +1226,8 @@ var LocalFilesystem = class {
     }
   }
   async writeFile(inputPath, content, options) {
+    const contentSize = Buffer.isBuffer(content) ? content.length : content.length;
+    this.logger.debug("Writing file", { path: inputPath, size: contentSize, recursive: options?.recursive });
     await this.ensureInitialized();
     this.assertWritable("writeFile");
     const absolutePath = this.resolvePath(inputPath);
@@ -1243,6 +1263,8 @@ var LocalFilesystem = class {
     }
   }
   async appendFile(inputPath, content) {
+    const contentSize = Buffer.isBuffer(content) ? content.length : content.length;
+    this.logger.debug("Appending to file", { path: inputPath, size: contentSize });
     await this.ensureInitialized();
     this.assertWritable("appendFile");
     const absolutePath = this.resolvePath(inputPath);
@@ -1252,6 +1274,7 @@ var LocalFilesystem = class {
     await fs2.appendFile(absolutePath, this.toBuffer(content));
   }
   async deleteFile(inputPath, options) {
+    this.logger.debug("Deleting file", { path: inputPath, force: options?.force });
     await this.ensureInitialized();
     this.assertWritable("deleteFile");
     const absolutePath = this.resolvePath(inputPath);
@@ -1274,6 +1297,7 @@ var LocalFilesystem = class {
     }
   }
   async copyFile(src, dest, options) {
+    this.logger.debug("Copying file", { src, dest, recursive: options?.recursive });
     await this.ensureInitialized();
     this.assertWritable("copyFile");
     const srcPath = this.resolvePath(src);
@@ -1332,6 +1356,7 @@ var LocalFilesystem = class {
     }
   }
   async moveFile(src, dest, options) {
+    this.logger.debug("Moving file", { src, dest, overwrite: options?.overwrite });
     await this.ensureInitialized();
     this.assertWritable("moveFile");
     const srcPath = this.resolvePath(src);
@@ -1364,6 +1389,7 @@ var LocalFilesystem = class {
     }
   }
   async mkdir(inputPath, options) {
+    this.logger.debug("Creating directory", { path: inputPath, recursive: options?.recursive });
     await this.ensureInitialized();
     this.assertWritable("mkdir");
     const absolutePath = this.resolvePath(inputPath);
@@ -1385,6 +1411,7 @@ var LocalFilesystem = class {
     }
   }
   async rmdir(inputPath, options) {
+    this.logger.debug("Removing directory", { path: inputPath, recursive: options?.recursive, force: options?.force });
     await this.ensureInitialized();
     this.assertWritable("rmdir");
     const absolutePath = this.resolvePath(inputPath);
@@ -1417,6 +1444,7 @@ var LocalFilesystem = class {
     }
   }
   async readdir(inputPath, options) {
+    this.logger.debug("Reading directory", { path: inputPath, recursive: options?.recursive });
     await this.ensureInitialized();
     const absolutePath = this.resolvePath(inputPath);
     await this.assertPathContained(absolutePath);
@@ -1505,12 +1533,15 @@ var LocalFilesystem = class {
     };
   }
   async init() {
+    this.logger.debug("Initializing filesystem", { basePath: this._basePath });
     this.status = "starting";
     try {
       await fs2.mkdir(this._basePath, { recursive: true });
       this.status = "running";
+      this.logger.debug("Filesystem initialized", { basePath: this._basePath, status: this.status });
     } catch (error) {
       this.status = "error";
+      this.logger.error("Failed to initialize filesystem", { basePath: this._basePath, error });
       throw error;
     }
   }
@@ -2142,6 +2173,25 @@ var Workspace = class {
       throw new WorkspaceError("vectorStore requires an embedder", "INVALID_SEARCH_CONFIG");
     }
     if (config.bm25 || config.vectorStore && config.embedder) {
+      const buildIndexName = () => {
+        const defaultName = `${this.id}_search`.replace(/[^a-zA-Z0-9_]/g, "_");
+        const indexName = config.searchIndexName ?? defaultName;
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(indexName)) {
+          throw new WorkspaceError(
+            `Invalid searchIndexName: "${indexName}". Must start with a letter or underscore, and contain only letters, numbers, or underscores.`,
+            "INVALID_SEARCH_CONFIG",
+            this.id
+          );
+        }
+        if (indexName.length > 63) {
+          throw new WorkspaceError(
+            `searchIndexName exceeds 63 characters (got ${indexName.length})`,
+            "INVALID_SEARCH_CONFIG",
+            this.id
+          );
+        }
+        return indexName;
+      };
       this._searchEngine = new SearchEngine({
         bm25: config.bm25 ? {
           bm25: typeof config.bm25 === "object" ? config.bm25 : void 0
@@ -2149,7 +2199,7 @@ var Workspace = class {
         vector: config.vectorStore && config.embedder ? {
           vectorStore: config.vectorStore,
           embedder: config.embedder,
-          indexName: `${this.id}-search`
+          indexName: buildIndexName()
         } : void 0
       });
     }
@@ -2422,6 +2472,22 @@ var Workspace = class {
       instructions
     };
   }
+  // ---------------------------------------------------------------------------
+  // Logger Integration
+  // ---------------------------------------------------------------------------
+  /**
+   * Set the logger for this workspace and propagate to providers.
+   * Called by Mastra when the logger is set.
+   * @internal
+   */
+  __setLogger(logger) {
+    if (this._fs instanceof MastraFilesystem) {
+      this._fs.__setLogger(logger);
+    }
+    if (this._sandbox instanceof MastraSandbox) {
+      this._sandbox.__setLogger(logger);
+    }
+  }
 };
 
 // src/workspace/sandbox/sandbox.ts
@@ -2736,7 +2802,7 @@ Process terminated by ${signal}`;
     });
   });
 }
-var LocalSandbox = class {
+var LocalSandbox = class extends MastraSandbox {
   id;
   name = "LocalSandbox";
   provider = "local";
@@ -2779,6 +2845,7 @@ var LocalSandbox = class {
     return detectIsolation();
   }
   constructor(options = {}) {
+    super({ name: "LocalSandbox" });
     this.id = options.id ?? this.generateId();
     this._createdAt = /* @__PURE__ */ new Date();
     this._workingDirectory = options.workingDirectory ?? nodePath.join(process.cwd(), ".sandbox");
@@ -2809,6 +2876,7 @@ var LocalSandbox = class {
     };
   }
   async start() {
+    this.logger.debug("Starting sandbox", { workingDirectory: this._workingDirectory, isolation: this._isolation });
     this.status = "starting";
     try {
       await fs2.mkdir(this.workingDirectory, { recursive: true });
@@ -2834,15 +2902,19 @@ var LocalSandbox = class {
         }
       }
       this.status = "running";
+      this.logger.debug("Sandbox started", { workingDirectory: this._workingDirectory, status: this.status });
     } catch (error) {
       this.status = "error";
+      this.logger.error("Failed to start sandbox", { workingDirectory: this._workingDirectory, error });
       throw error;
     }
   }
   async stop() {
+    this.logger.debug("Stopping sandbox", { workingDirectory: this._workingDirectory });
     this.status = "stopped";
   }
   async destroy() {
+    this.logger.debug("Destroying sandbox", { workingDirectory: this._workingDirectory });
     if (this._seatbeltProfilePath && !this._userProvidedProfilePath) {
       try {
         await fs2.unlink(this._seatbeltProfilePath);
@@ -2909,6 +2981,7 @@ var LocalSandbox = class {
     });
   }
   async executeCommand(command, args = [], options = {}) {
+    this.logger.debug("Executing command", { command, args, cwd: options.cwd ?? this.workingDirectory });
     if (this.status !== "running") {
       await this.start();
     }
@@ -2922,20 +2995,28 @@ var LocalSandbox = class {
         onStdout: options.onStdout,
         onStderr: options.onStderr
       });
-      return {
+      const commandResult = {
         success: result.exitCode === 0,
         stdout: result.stdout,
         stderr: result.stderr,
         exitCode: result.exitCode,
         executionTimeMs: Date.now() - startTime
       };
+      this.logger.info("Command completed", {
+        command,
+        exitCode: commandResult.exitCode,
+        executionTimeMs: commandResult.executionTimeMs
+      });
+      return commandResult;
     } catch (error) {
+      const executionTimeMs = Date.now() - startTime;
+      this.logger.error("Command failed", { command, error, executionTimeMs });
       return {
         success: false,
         stdout: "",
         stderr: error instanceof Error ? error.message : String(error),
         exitCode: 1,
-        executionTimeMs: Date.now() - startTime
+        executionTimeMs
       };
     }
   }
@@ -3098,7 +3179,7 @@ function createWorkspaceTools(workspace) {
     if (readFileConfig.enabled) {
       tools[WORKSPACE_TOOLS.FILESYSTEM.READ_FILE] = createTool({
         id: WORKSPACE_TOOLS.FILESYSTEM.READ_FILE,
-        description: "Read the contents of a file from the workspace filesystem. Supports reading specific line ranges using offset/limit parameters.",
+        description: "Read the contents of a file from the workspace filesystem. Use offset/limit parameters to read specific line ranges for large files.",
         requireApproval: readFileConfig.requireApproval,
         inputSchema: z.object({
           path: z.string().describe('The path to the file to read (e.g., "/data/config.json")'),
@@ -3201,7 +3282,13 @@ function createWorkspaceTools(workspace) {
     if (!isReadOnly && editFileConfig.enabled) {
       tools[WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE] = createTool({
         id: WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE,
-        description: "Edit a file by replacing specific text. The old_string must match exactly and be unique in the file (unless using replace_all). You should read the file first to ensure you have the exact text to replace.",
+        description: `Edit a file by replacing specific text. The old_string must match exactly and be unique in the file.
+
+Usage:
+- Read the file first to get the exact text to replace.
+- By default, ${WORKSPACE_TOOLS.FILESYSTEM.READ_FILE} output includes line number prefixes (e.g., "     1\u2192"). Ensure you preserve the exact indentation as it appears AFTER the arrow. Never include any part of the line number prefix in old_string or new_string.
+- Include enough surrounding context (multiple lines) to make old_string unique. If it still isn't unique, include more lines.
+- Use replace_all only when intentionally replacing all occurrences.`,
         requireApproval: editFileConfig.requireApproval,
         inputSchema: z.object({
           path: z.string().describe("The path to the file to edit"),
@@ -3491,7 +3578,13 @@ Examples:
     if (workspace.sandbox.executeCommand && executeCommandConfig.enabled) {
       tools[WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND] = createTool({
         id: WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,
-        description: `Execute a shell command in the workspace sandbox. The output (stdout/stderr) is displayed to the user automatically in the tool result. ${pathInfo}`,
+        description: `Execute a shell command in the workspace sandbox.${pathInfo}
+
+Usage:
+- Verify parent directories exist before running commands that create files or directories.
+- Always quote file paths that contain spaces (e.g., cd "/path/with spaces").
+- Commands timeout after 30 seconds by default. Use the timeout parameter for longer operations.
+- Use cwd to set the working directory, or commands run from the sandbox default.`,
         requireApproval: executeCommandConfig.requireApproval,
         inputSchema: z.object({
           command: z.string().describe('The command to execute (e.g., "ls", "npm", "python")'),
@@ -3575,6 +3668,6 @@ Examples:
   return tools;
 }
 
-export { BM25Index, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, NotDirectoryError, PermissionError, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxTimeoutError, SearchNotAvailableError, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotReadyError, WorkspaceReadOnlyError, createWorkspaceTools, detectIsolation, extractLines, getRecommendedIsolation, isIsolationAvailable, resolveToolConfig };
-//# sourceMappingURL=chunk-NS33UC72.js.map
-//# sourceMappingURL=chunk-NS33UC72.js.map
+export { BM25Index, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, MastraFilesystem, MastraSandbox, NotDirectoryError, PermissionError, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxTimeoutError, SearchNotAvailableError, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotReadyError, WorkspaceReadOnlyError, createWorkspaceTools, detectIsolation, extractLines, getRecommendedIsolation, isIsolationAvailable, resolveToolConfig };
+//# sourceMappingURL=chunk-ENCTSDWC.js.map
+//# sourceMappingURL=chunk-ENCTSDWC.js.map