@mastra/core 1.2.1-alpha.0 → 1.3.0-alpha.2

package/dist/workspace/filesystem/mastra-filesystem.d.ts

@@ -1,9 +1,21 @@
 /**
  * MastraFilesystem Base Class
  *
- * Abstract base class for filesystem providers that want automatic logger integration.
+ * Abstract base class for filesystem providers that want automatic logger integration
+ * and lifecycle management.
+ *
  * Extends MastraBase to receive the Mastra logger when registered with a Mastra instance.
  *
+ * ## Lifecycle Management
+ *
+ * The base class provides race-condition-safe lifecycle wrappers:
+ * - `_init()` - Handles concurrent calls, status management
+ * - `_destroy()` - Handles concurrent calls and status management
+ *
+ * Subclasses override the plain `init()` and `destroy()` methods to provide
+ * their implementation. Callers use the `_`-prefixed wrappers (or `callLifecycle()`)
+ * which add status tracking and race-condition safety.
+ *
  * External providers can extend this class to get logger support, or implement
  * the WorkspaceFilesystem interface directly if they don't need logging.
  */
@@ -11,7 +23,7 @@ import { MastraBase } from '../../base.js';
 import type { ProviderStatus } from '../lifecycle.js';
 import type { WorkspaceFilesystem, FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions } from './filesystem.js';
 /**
- * Abstract base class for filesystem providers with logger support.
+ * Abstract base class for filesystem providers with logger support and lifecycle management.
  *
  * Providers that extend this class automatically receive the Mastra logger
  * when the filesystem is used with a Mastra instance.
@@ -22,13 +34,19 @@ import type { WorkspaceFilesystem, FileContent, FileStat, FileEntry, ReadOptions
  *   readonly id = 'my-fs';
  *   readonly name = 'MyCustomFilesystem';
  *   readonly provider = 'custom';
- *   status: ProviderStatus = 'stopped';
+ *   status: ProviderStatus = 'pending';
  *
  *   constructor() {
  *     super({ name: 'MyCustomFilesystem' });
  *   }
  *
+ *   // Override init() to provide initialization logic
+ *   async init(): Promise<void> {
+ *     // Your initialization logic here
+ *   }
+ *
  *   async readFile(path: string): Promise<string | Buffer> {
+ *     await this.ensureReady();
  *     this.logger.debug('Reading file', { path });
  *     // Implementation...
  *   }
@@ -45,9 +63,80 @@ export declare abstract class MastraFilesystem extends MastraBase implements Wor
     abstract readonly provider: string;
     /** Current status of the filesystem */
     abstract status: ProviderStatus;
+    /** Error message when status is 'error' */
+    error?: string;
+    /** Promise for _init() to prevent race conditions from concurrent calls */
+    private _initPromise?;
+    /** Promise for _destroy() to prevent race conditions from concurrent calls */
+    private _destroyPromise?;
     constructor(options: {
         name: string;
     });
+    /**
+     * Initialize the filesystem (wrapper with status management and race-condition safety).
+     *
+     * This method is race-condition-safe - concurrent calls will return the same promise.
+     * Handles status management automatically.
+     *
+     * Subclasses override `init()` to provide their initialization logic.
+     */
+    _init(): Promise<void>;
+    /**
+     * Internal init execution - handles status.
+     */
+    private _executeInit;
+    /**
+     * Override this method to implement filesystem initialization logic.
+     *
+     * Called by `_init()` after status is set to 'initializing'.
+     * Status will be set to 'ready' on success, 'error' on failure.
+     *
+     * @example
+     * ```typescript
+     * async init(): Promise<void> {
+     *   this._client = new StorageClient({ ... });
+     *   await this._client.connect();
+     * }
+     * ```
+     */
+    init(): Promise<void>;
+    /**
+     * Ensure the filesystem is ready.
+     *
+     * Calls `_init()` if status is not 'ready'. Useful for lazy initialization
+     * where operations should automatically initialize the filesystem if needed.
+     *
+     * @throws {FilesystemNotReadyError} if the filesystem fails to reach 'ready' status
+     *
+     * @example
+     * ```typescript
+     * async readFile(path: string): Promise<string | Buffer> {
+     *   await this.ensureReady();
+     *   // Now safe to use the filesystem
+     * }
+     * ```
+     */
+    protected ensureReady(): Promise<void>;
+    /**
+     * Destroy the filesystem and clean up all resources (wrapper with status management).
+     *
+     * This method is race-condition-safe - concurrent calls will return the same promise.
+     * Handles status management.
+     *
+     * Subclasses override `destroy()` to provide their destroy logic.
+     */
+    _destroy(): Promise<void>;
+    /**
+     * Internal destroy execution - handles status.
+     */
+    private _executeDestroy;
+    /**
+     * Override this method to implement filesystem destroy logic.
+     *
+     * Called by `_destroy()` after status is set to 'destroying'.
+     * Status will be set to 'destroyed' on success, 'error' on failure.
+     */
+    destroy(): Promise<void>;
     abstract readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
     abstract writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
     abstract appendFile(path: string, content: FileContent): Promise<void>;

package/dist/workspace/filesystem/mastra-filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mastra-filesystem.d.ts","sourceRoot":"","sources":["../../../src/workspace/filesystem/mastra-filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BAAsB,gBAAiB,SAAQ,UAAW,YAAW,mBAAmB;IACtF,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAQrC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAChF,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7F,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACzE,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAClF,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9E,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAC3E,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAC/C"}
+{"version":3,"file":"mastra-filesystem.d.ts","sourceRoot":"","sources":["../../../src/workspace/filesystem/mastra-filesystem.ts"],"names":[],"mappings":"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"}

package/dist/workspace/filesystem/mount.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Mount Types for Workspace Filesystems
+ *
+ * Base types for filesystem mounts. Provider-specific mount configs
+ * are defined in their respective packages (e.g., @mastra/s3, @mastra/e2b).
+ */
+/**
+ * Base configuration for filesystem mounts.
+ * Extended by specific packages (e.g., @mastra/s3 defines S3MountConfig).
+ *
+ * Filesystem packages implement getMountConfig() returning their specific config.
+ * Sandbox packages define what mount configs they support.
+ */
+export interface FilesystemMountConfig {
+    /** Mount type identifier (e.g., 's3', 'gcs', 'r2') */
+    type: string;
+}
+/**
+ * Result of a mount operation.
+ */
+export interface MountResult {
+    /** Whether the mount was successful */
+    success: boolean;
+    /** Path where the filesystem was mounted */
+    mountPath: string;
+    /** Error message if mount failed */
+    error?: string;
+}
+/**
+ * Icon identifiers for filesystem providers.
+ * Used in UI to display appropriate icons.
+ */
+export type FilesystemIcon = 's3' | 'aws-s3' | 'gcs' | 'google-cloud' | 'google-cloud-storage' | 'r2' | 'cloudflare' | 'cloudflare-r2' | 'azure' | 'azure-blob' | 'minio' | 'local' | 'folder' | 'database' | 'hard-drive' | 'cloud' | string;
+//# sourceMappingURL=mount.d.ts.map

package/dist/workspace/filesystem/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/workspace/filesystem/mount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,QAAQ,GACR,KAAK,GACL,cAAc,GACd,sBAAsB,GACtB,IAAI,GACJ,YAAY,GACZ,eAAe,GACf,OAAO,GACP,YAAY,GACZ,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,OAAO,GACP,MAAM,CAAC"}

package/dist/workspace/index.cjs

@@ -1,140 +1,168 @@
 'use strict';
 
-var chunkHMCXNOF6_cjs = require('../chunk-HMCXNOF6.cjs');
+var chunkCGPH7CMG_cjs = require('../chunk-CGPH7CMG.cjs');
 
 
 
+Object.defineProperty(exports, "CompositeFilesystem", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.CompositeFilesystem; }
+});
 Object.defineProperty(exports, "DirectoryNotEmptyError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.DirectoryNotEmptyError; }
+  get: function () { return chunkCGPH7CMG_cjs.DirectoryNotEmptyError; }
 });
 Object.defineProperty(exports, "DirectoryNotFoundError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.DirectoryNotFoundError; }
+  get: function () { return chunkCGPH7CMG_cjs.DirectoryNotFoundError; }
 });
 Object.defineProperty(exports, "FileExistsError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.FileExistsError; }
+  get: function () { return chunkCGPH7CMG_cjs.FileExistsError; }
 });
 Object.defineProperty(exports, "FileNotFoundError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.FileNotFoundError; }
+  get: function () { return chunkCGPH7CMG_cjs.FileNotFoundError; }
 });
 Object.defineProperty(exports, "FileReadRequiredError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.FileReadRequiredError; }
+  get: function () { return chunkCGPH7CMG_cjs.FileReadRequiredError; }
 });
 Object.defineProperty(exports, "FilesystemError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.FilesystemError; }
+  get: function () { return chunkCGPH7CMG_cjs.FilesystemError; }
 });
 Object.defineProperty(exports, "FilesystemNotAvailableError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.FilesystemNotAvailableError; }
+  get: function () { return chunkCGPH7CMG_cjs.FilesystemNotAvailableError; }
+});
+Object.defineProperty(exports, "FilesystemNotMountableError", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.FilesystemNotMountableError; }
+});
+Object.defineProperty(exports, "FilesystemNotReadyError", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.FilesystemNotReadyError; }
 });
 Object.defineProperty(exports, "IsDirectoryError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.IsDirectoryError; }
+  get: function () { return chunkCGPH7CMG_cjs.IsDirectoryError; }
 });
 Object.defineProperty(exports, "IsolationUnavailableError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.IsolationUnavailableError; }
+  get: function () { return chunkCGPH7CMG_cjs.IsolationUnavailableError; }
 });
 Object.defineProperty(exports, "LocalFilesystem", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.LocalFilesystem; }
+  get: function () { return chunkCGPH7CMG_cjs.LocalFilesystem; }
 });
 Object.defineProperty(exports, "LocalSandbox", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.LocalSandbox; }
+  get: function () { return chunkCGPH7CMG_cjs.LocalSandbox; }
 });
 Object.defineProperty(exports, "MastraFilesystem", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.MastraFilesystem; }
+  get: function () { return chunkCGPH7CMG_cjs.MastraFilesystem; }
 });
 Object.defineProperty(exports, "MastraSandbox", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.MastraSandbox; }
+  get: function () { return chunkCGPH7CMG_cjs.MastraSandbox; }
+});
+Object.defineProperty(exports, "MountError", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.MountError; }
+});
+Object.defineProperty(exports, "MountManager", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.MountManager; }
+});
+Object.defineProperty(exports, "MountNotSupportedError", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.MountNotSupportedError; }
 });
 Object.defineProperty(exports, "NotDirectoryError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.NotDirectoryError; }
+  get: function () { return chunkCGPH7CMG_cjs.NotDirectoryError; }
 });
 Object.defineProperty(exports, "PermissionError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.PermissionError; }
+  get: function () { return chunkCGPH7CMG_cjs.PermissionError; }
 });
 Object.defineProperty(exports, "SandboxError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxError; }
 });
 Object.defineProperty(exports, "SandboxExecutionError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxExecutionError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxExecutionError; }
 });
 Object.defineProperty(exports, "SandboxFeatureNotSupportedError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxFeatureNotSupportedError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxFeatureNotSupportedError; }
 });
 Object.defineProperty(exports, "SandboxNotAvailableError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxNotAvailableError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxNotAvailableError; }
 });
 Object.defineProperty(exports, "SandboxNotReadyError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxNotReadyError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxNotReadyError; }
 });
 Object.defineProperty(exports, "SandboxTimeoutError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SandboxTimeoutError; }
+  get: function () { return chunkCGPH7CMG_cjs.SandboxTimeoutError; }
 });
 Object.defineProperty(exports, "SearchNotAvailableError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.SearchNotAvailableError; }
+  get: function () { return chunkCGPH7CMG_cjs.SearchNotAvailableError; }
 });
 Object.defineProperty(exports, "WORKSPACE_TOOLS", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.WORKSPACE_TOOLS; }
+  get: function () { return chunkCGPH7CMG_cjs.WORKSPACE_TOOLS; }
 });
 Object.defineProperty(exports, "WORKSPACE_TOOLS_PREFIX", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.WORKSPACE_TOOLS_PREFIX; }
+  get: function () { return chunkCGPH7CMG_cjs.WORKSPACE_TOOLS_PREFIX; }
 });
 Object.defineProperty(exports, "Workspace", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.Workspace; }
+  get: function () { return chunkCGPH7CMG_cjs.Workspace; }
 });
 Object.defineProperty(exports, "WorkspaceError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.WorkspaceError; }
+  get: function () { return chunkCGPH7CMG_cjs.WorkspaceError; }
 });
 Object.defineProperty(exports, "WorkspaceNotReadyError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.WorkspaceNotReadyError; }
+  get: function () { return chunkCGPH7CMG_cjs.WorkspaceNotReadyError; }
 });
 Object.defineProperty(exports, "WorkspaceReadOnlyError", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.WorkspaceReadOnlyError; }
+  get: function () { return chunkCGPH7CMG_cjs.WorkspaceReadOnlyError; }
+});
+Object.defineProperty(exports, "callLifecycle", {
+  enumerable: true,
+  get: function () { return chunkCGPH7CMG_cjs.callLifecycle; }
 });
 Object.defineProperty(exports, "createWorkspaceTools", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.createWorkspaceTools; }
+  get: function () { return chunkCGPH7CMG_cjs.createWorkspaceTools; }
 });
 Object.defineProperty(exports, "detectIsolation", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.detectIsolation; }
+  get: function () { return chunkCGPH7CMG_cjs.detectIsolation; }
 });
 Object.defineProperty(exports, "getRecommendedIsolation", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.getRecommendedIsolation; }
+  get: function () { return chunkCGPH7CMG_cjs.getRecommendedIsolation; }
 });
 Object.defineProperty(exports, "isIsolationAvailable", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.isIsolationAvailable; }
+  get: function () { return chunkCGPH7CMG_cjs.isIsolationAvailable; }
 });
 Object.defineProperty(exports, "resolveToolConfig", {
   enumerable: true,
-  get: function () { return chunkHMCXNOF6_cjs.resolveToolConfig; }
+  get: function () { return chunkCGPH7CMG_cjs.resolveToolConfig; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/workspace/index.d.ts

@@ -1,14 +1,18 @@
 export * from './workspace.js';
 export { LocalFilesystem, type LocalFilesystemOptions } from './filesystem/index.js';
+export { CompositeFilesystem, type CompositeFilesystemConfig } from './filesystem/index.js';
 export { LocalSandbox, type LocalSandboxOptions } from './sandbox/index.js';
 export { MastraFilesystem } from './filesystem/index.js';
 export { MastraSandbox } from './sandbox/index.js';
 export * from './errors.js';
-export { SandboxError, SandboxExecutionError, SandboxTimeoutError, SandboxNotReadyError, IsolationUnavailableError, type SandboxOperation, } from './sandbox/index.js';
+export { SandboxError, SandboxExecutionError, SandboxTimeoutError, SandboxNotReadyError, IsolationUnavailableError, MountError, MountNotSupportedError, FilesystemNotMountableError, type SandboxOperation, } from './sandbox/index.js';
 export { createWorkspaceTools, resolveToolConfig, type WorkspaceToolConfig, type WorkspaceToolsConfig } from './tools/index.js';
 export * from './lifecycle.js';
 export type { WorkspaceFilesystem, FileContent, FileStat, FileEntry, FilesystemInfo, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, } from './filesystem/index.js';
-export type { WorkspaceSandbox, ExecutionResult, CommandResult, ExecuteCommandOptions, SandboxInfo } from './sandbox/index.js';
+export type { FilesystemMountConfig, MountResult, FilesystemIcon } from './filesystem/index.js';
+export { MountManager } from './sandbox/index.js';
+export type { WorkspaceSandbox, ExecutionResult, CommandResult, ExecuteCommandOptions, SandboxInfo, SandboxLifecycleHook, MastraSandboxOptions, } from './sandbox/index.js';
+export type { MountManagerConfig, MountFn, OnMountHook, OnMountArgs, OnMountResult } from './sandbox/index.js';
 export type { IsolationBackend, NativeSandboxConfig, SandboxDetectionResult } from './sandbox/index.js';
 export { detectIsolation, isIsolationAvailable, getRecommendedIsolation } from './sandbox/index.js';
 export { WORKSPACE_TOOLS_PREFIX, WORKSPACE_TOOLS, type WorkspaceToolName } from './constants/index.js';

package/dist/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGvH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGtH,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9F,YAAY,EACV,WAAW,EACX,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGvH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtG,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9F,YAAY,EACV,WAAW,EACX,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/workspace/index.js

@@ -1,3 +1,3 @@
-export { 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, getRecommendedIsolation, isIsolationAvailable, resolveToolConfig } from '../chunk-ENCTSDWC.js';
+export { CompositeFilesystem, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, FilesystemNotMountableError, FilesystemNotReadyError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, MastraFilesystem, MastraSandbox, MountError, MountManager, MountNotSupportedError, NotDirectoryError, PermissionError, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxTimeoutError, SearchNotAvailableError, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotReadyError, WorkspaceReadOnlyError, callLifecycle, createWorkspaceTools, detectIsolation, getRecommendedIsolation, isIsolationAvailable, resolveToolConfig } from '../chunk-2GWTJFVM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/workspace/lifecycle.d.ts

@@ -36,6 +36,8 @@
 export interface Lifecycle<TInfo = unknown> {
     /** Current status */
     status: ProviderStatus;
+    /** Error message when status is 'error' */
+    error?: string;
     /**
      * One-time setup operations.
      *
@@ -103,4 +105,31 @@ export interface Lifecycle<TInfo = unknown> {
  * instances can use these states.
  */
 export type ProviderStatus = 'pending' | 'initializing' | 'ready' | 'starting' | 'running' | 'stopping' | 'stopped' | 'destroying' | 'destroyed' | 'error';
+/**
+ * Provider that may have lifecycle methods.
+ * Used by `callLifecycle` to dispatch to the correct method.
+ */
+interface LifecycleProvider {
+    _init?(): void | Promise<void>;
+    _start?(): void | Promise<void>;
+    _stop?(): void | Promise<void>;
+    _destroy?(): void | Promise<void>;
+    init?(): void | Promise<void>;
+    start?(): void | Promise<void>;
+    stop?(): void | Promise<void>;
+    destroy?(): void | Promise<void>;
+}
+/**
+ * Call a lifecycle method on a provider, preferring the `_`-prefixed wrapper
+ * (which adds status tracking & race-condition safety) when available,
+ * falling back to the plain method for interface-only implementations.
+ *
+ * @example
+ * ```typescript
+ * await callLifecycle(sandbox, 'start');   // calls sandbox._start() ?? sandbox.start()
+ * await callLifecycle(filesystem, 'init'); // calls filesystem._init() ?? filesystem.init()
+ * ```
+ */
+export declare function callLifecycle(provider: LifecycleProvider, method: 'init' | 'start' | 'stop' | 'destroy'): Promise<void>;
+export {};
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/workspace/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/workspace/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,SAAS,CAAC,KAAK,GAAG,OAAO;IACxC,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IAEvB;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC;AAMD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,cAAc,GACd,OAAO,GACP,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/workspace/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,SAAS,CAAC,KAAK,GAAG,OAAO;IACxC,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IAEvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC;AAMD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,cAAc,GACd,OAAO,GACP,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CAAC;AAMZ;;;GAGG;AACH,UAAU,iBAAiB;IACzB,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAC5C,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/workspace/sandbox/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Sandbox Errors
+ *
+ * Error classes for sandbox operations including execution and mounting.
+ */
+import type { SandboxOperation } from './types.js';
+export declare class SandboxError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class SandboxExecutionError extends SandboxError {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(message: string, exitCode: number, stdout: string, stderr: string);
+}
+export declare class SandboxTimeoutError extends SandboxError {
+    readonly timeoutMs: number;
+    readonly operation: SandboxOperation;
+    constructor(timeoutMs: number, operation: SandboxOperation);
+}
+export declare class SandboxNotReadyError extends SandboxError {
+    constructor(idOrStatus: string);
+}
+export declare class IsolationUnavailableError extends SandboxError {
+    readonly backend: string;
+    readonly reason: string;
+    constructor(backend: string, reason: string);
+}
+/**
+ * Base error for mount operations.
+ */
+export declare class MountError extends SandboxError {
+    readonly mountPath: string;
+    constructor(message: string, mountPath: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when sandbox doesn't support mounting.
+ */
+export declare class MountNotSupportedError extends SandboxError {
+    constructor(sandboxProvider: string);
+}
+/**
+ * Error thrown when a filesystem cannot be mounted.
+ */
+export declare class FilesystemNotMountableError extends SandboxError {
+    constructor(filesystemProvider: string, reason?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/workspace/sandbox/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMhD,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAMD,qBAAa,qBAAsB,SAAQ,YAAY;aAGnC,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM;gBAH9B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;CAKjC;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aAEjC,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,gBAAgB;gBAD3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB;CAK9C;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,yBAA0B,SAAQ,YAAY;aAEvC,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,MAAM;gBADd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;CAKjC;AAMD;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;aAGxB,SAAS,EAAE,MAAM;gBADjC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,eAAe,EAAE,MAAM;CAMpC;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;gBAC/C,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOxD"}

package/dist/workspace/sandbox/index.d.ts

@@ -1,3 +1,6 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './mount-manager.js';
 export * from './sandbox.js';
 export * from './mastra-sandbox.js';
 export * from './local-sandbox.js';

package/dist/workspace/sandbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/workspace/sandbox/local-sandbox.d.ts

@@ -10,12 +10,13 @@
  */
 import type { ProviderStatus } from '../lifecycle.js';
 import { MastraSandbox } from './mastra-sandbox.js';
+import type { MastraSandboxOptions } from './mastra-sandbox.js';
 import type { IsolationBackend, NativeSandboxConfig } from './native-sandbox/index.js';
-import type { SandboxInfo, ExecuteCommandOptions, CommandResult } from './sandbox.js';
+import type { SandboxInfo, ExecuteCommandOptions, CommandResult } from './types.js';
 /**
  * Local sandbox provider configuration.
  */
-export interface LocalSandboxOptions {
+export interface LocalSandboxOptions extends Pick<MastraSandboxOptions, 'onStart' | 'onStop' | 'onDestroy'> {
     /** Unique identifier for this sandbox instance */
     id?: string;
     /** Working directory for command execution */
@@ -119,8 +120,22 @@ export declare class LocalSandbox extends MastraSandbox {
      * Merges the sandbox's configured env with any additional env from the command.
      */
     private buildEnv;
+    /**
+     * Start the local sandbox.
+     * Creates working directory and sets up seatbelt profile if using macOS isolation.
+     * Status management is handled by the base class.
+     */
     start(): Promise<void>;
+    /**
+     * Stop the local sandbox.
+     * Status management is handled by the base class.
+     */
     stop(): Promise<void>;
+    /**
+     * Destroy the local sandbox and clean up resources.
+     * Cleans up seatbelt profile if auto-generated.
+     * Status management is handled by the base class.
+     */
     destroy(): Promise<void>;
     isReady(): Promise<boolean>;
     getInfo(): Promise<SandboxInfo>;

package/dist/workspace/sandbox/local-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAyEnF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,WAAW;IAE5B,MAAM,EAAE,cAAc,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAC3D,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAElC;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;gBAIV,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BxB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrC,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAazB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC;CAmD1B"}
+{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAwEjF;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzG,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,WAAW;IAE5B,MAAM,EAAE,cAAc,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAC3D,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAElC;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;gBAIV,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrC,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAazB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC;CAiD1B"}