@mastra/core 1.6.0 → 1.7.0-alpha.0

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

@@ -0,0 +1,18 @@
+/**
+ * Local Process Manager
+ *
+ * Local implementation of SandboxProcessManager using child_process.spawn.
+ * Tracks processes in-memory since there's no server to query.
+ */
+import type { LocalSandbox } from './local-sandbox.js';
+import { ProcessHandle, SandboxProcessManager } from './process-manager/index.js';
+import type { ProcessInfo, SpawnProcessOptions } from './process-manager/index.js';
+/**
+ * Local implementation of SandboxProcessManager.
+ * Spawns processes via child_process.spawn and tracks them in-memory.
+ */
+export declare class LocalProcessManager extends SandboxProcessManager<LocalSandbox> {
+    spawn(command: string, options?: SpawnProcessOptions): Promise<ProcessHandle>;
+    list(): Promise<ProcessInfo[]>;
+}
+//# sourceMappingURL=local-process-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-process-manager.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-process-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAwH1E;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,qBAAqB,CAAC,YAAY,CAAC;IACpE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBjF,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAOrC"}

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

@@ -8,11 +8,14 @@
  * - macOS: Uses seatbelt (sandbox-exec) for filesystem and network isolation
  * - Linux: Uses bubblewrap (bwrap) for namespace isolation
  */
+import type { RequestContext } from '../../request-context/index.js';
 import type { ProviderStatus } from '../lifecycle.js';
+import type { InstructionsOption } from '../types.js';
+import { LocalProcessManager } from './local-process-manager.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 './types.js';
+import type { SandboxInfo } from './types.js';
 /**
  * Local sandbox provider configuration.
  */
@@ -56,6 +59,16 @@ export interface LocalSandboxOptions extends MastraSandboxOptions {
      * Only used when isolation is 'seatbelt' or 'bwrap'.
      */
     nativeSandbox?: NativeSandboxConfig;
+    /**
+     * Custom instructions that override the default instructions
+     * returned by `getInstructions()`.
+     *
+     * - `string` — Fully replaces the default instructions.
+     *   Pass an empty string to suppress instructions entirely.
+     * - `(opts) => string` — Receives the default instructions and
+     *   optional request context so you can extend or customise per-request.
+     */
+    instructions?: InstructionsOption;
 }
 /**
  * Local sandbox implementation.
@@ -81,45 +94,18 @@ export declare class LocalSandbox extends MastraSandbox {
     readonly name = "LocalSandbox";
     readonly provider = "local";
     status: ProviderStatus;
-    private readonly _workingDirectory;
+    readonly workingDirectory: string;
+    readonly isolation: IsolationBackend;
+    readonly processes: LocalProcessManager;
     private readonly env;
-    private readonly timeout?;
-    private readonly _isolation;
     private readonly _nativeSandboxConfig;
     private _seatbeltProfile?;
     private _seatbeltProfilePath?;
     private _sandboxFolderPath?;
     private _userProvidedProfilePath;
     private readonly _createdAt;
-    /**
-     * The working directory where commands are executed.
-     */
-    get workingDirectory(): string;
-    /**
-     * The isolation backend being used.
-     */
-    get isolation(): IsolationBackend;
-    /**
-     * Detect the best available isolation backend for this platform.
-     * Returns detection result with backend recommendation and availability.
-     *
-     * @example
-     * ```typescript
-     * const result = LocalSandbox.detectIsolation();
-     * const sandbox = new LocalSandbox({
-     *   isolation: result.available ? result.backend : 'none',
-     * });
-     * ```
-     */
-    static detectIsolation(): import("./native-sandbox").SandboxDetectionResult;
+    private readonly _instructionsOverride?;
     constructor(options?: LocalSandboxOptions);
-    private generateId;
-    /**
-     * Build the environment object for execution.
-     * Always includes PATH by default (needed for finding executables).
-     * 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.
@@ -137,13 +123,41 @@ export declare class LocalSandbox extends MastraSandbox {
      * Status management is handled by the base class.
      */
     destroy(): Promise<void>;
+    /** @deprecated Use `status === 'running'` instead. */
     isReady(): Promise<boolean>;
     getInfo(): Promise<SandboxInfo>;
-    getInstructions(): string;
+    getInstructions(opts?: {
+        requestContext?: RequestContext;
+    }): string;
+    private _getDefaultInstructions;
+    private generateId;
+    /**
+     * Build the environment object for execution.
+     * Always includes PATH by default (needed for finding executables).
+     * Merges the sandbox's configured env with any additional env from the command.
+     * @internal Used by LocalProcessManager.
+     */
+    buildEnv(additionalEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
     /**
      * Wrap a command with the configured isolation backend.
+     * @internal Used by LocalProcessManager for background process isolation.
+     */
+    wrapCommandForIsolation(command: string): {
+        command: string;
+        args: string[];
+    };
+    /**
+     * Detect the best available isolation backend for this platform.
+     * Returns detection result with backend recommendation and availability.
+     *
+     * @example
+     * ```typescript
+     * const result = LocalSandbox.detectIsolation();
+     * const sandbox = new LocalSandbox({
+     *   isolation: result.available ? result.backend : 'none',
+     * });
+     * ```
      */
-    private wrapCommandForIsolation;
-    executeCommand(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
+    static detectIsolation(): import("./native-sandbox").SandboxDetectionResult;
 }
 //# sourceMappingURL=local-sandbox.d.ts.map

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;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,oBAAoB;IAC/D,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;IAuD5B;;;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"}
+{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,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,MAAM,SAAS,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,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;IACpC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;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,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,SAAiB,SAAS,EAAE,mBAAmB,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,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;IAClC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAqB;gBAEhD,OAAO,GAAE,mBAAwB;IA2B7C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B9B,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrC,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,MAAM;IAInE,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;IAQ9D;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAa7E;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;CAGvB"}

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

@@ -27,7 +27,9 @@ import type { WorkspaceFilesystem } from '../filesystem/filesystem.js';
 import type { MountResult } from '../filesystem/mount.js';
 import type { ProviderStatus } from '../lifecycle.js';
 import { MountManager } from './mount-manager.js';
+import type { SandboxProcessManager } from './process-manager/index.js';
 import type { WorkspaceSandbox } from './sandbox.js';
+import type { CommandResult, ExecuteCommandOptions, SandboxInfo } from './types.js';
 /**
  * Lifecycle hook that fires during sandbox state transitions.
  * Receives the sandbox instance so users can call `executeCommand`, read files, etc.
@@ -46,6 +48,27 @@ export interface MastraSandboxOptions {
     onStop?: SandboxLifecycleHook;
     /** Called before the sandbox is destroyed */
     onDestroy?: SandboxLifecycleHook;
+    /**
+     * Process manager for this sandbox.
+     *
+     * When provided, the base class automatically:
+     * 1. Sets the sandbox back-reference on the process manager
+     * 2. Exposes it via `this.processes`
+     * 3. Creates a default `executeCommand` implementation (spawn + wait)
+     *
+     * @example
+     * ```typescript
+     * class MySandbox extends MastraSandbox {
+     *   constructor() {
+     *     super({
+     *       name: 'MySandbox',
+     *       processes: new MyProcessManager({ env: myEnv }),
+     *     });
+     *   }
+     * }
+     * ```
+     */
+    processes?: SandboxProcessManager;
 }
 /**
  * Abstract base class for sandbox providers with logger support.
@@ -64,20 +87,15 @@ export interface MastraSandboxOptions {
  *   status: ProviderStatus = 'pending';
  *
  *   constructor() {
- *     super({ name: 'MyCustomSandbox' });
- *   }
- *
- *   // Override start() to provide startup logic
- *   async start(): Promise<void> {
- *     // Your startup logic here
+ *     super({
+ *       name: 'MyCustomSandbox',
+ *       processes: new MyProcessManager({ env: myEnv }),
+ *     });
  *   }
  *
+ *   async start(): Promise<void> { /* startup logic *\/ }
  *   async mount(filesystem, mountPath) { ... }
  *   async unmount(mountPath) { ... }
- *   async executeCommand(command: string, args?: string[]): Promise<CommandResult> {
- *     this.logger.debug('Executing command', { command, args });
- *     // Implementation...
- *   }
  * }
  * ```
  */
@@ -90,10 +108,26 @@ export declare abstract class MastraSandbox extends MastraBase implements Worksp
     abstract readonly provider: string;
     /** Current status of the sandbox */
     abstract status: ProviderStatus;
+    /**
+     * Execute a shell command and wait for completion.
+     *
+     * Method syntax (not property syntax) is intentional — it prevents
+     * `useDefineForClassFields` from emitting `this.executeCommand = undefined`
+     * which would shadow prototype methods defined by subclasses.
+     */
+    executeCommand?(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
+    /** Process manager */
+    readonly processes?: SandboxProcessManager;
     /** Mount manager - automatically created if subclass implements mount() */
     readonly mounts?: MountManager;
     /** Optional mount method - implement to enable mounting support */
     mount?(filesystem: WorkspaceFilesystem, mountPath: string): Promise<MountResult>;
+    /** Optional unmount method */
+    unmount?(mountPath: string): Promise<void>;
+    /** Get instructions describing how this sandbox works */
+    getInstructions?(): string;
+    /** Get sandbox status and metadata */
+    getInfo?(): SandboxInfo | Promise<SandboxInfo>;
     /** Promise for _start() to prevent race conditions from concurrent calls */
     protected _startPromise?: Promise<void>;
     /** Promise for _stop() to prevent race conditions from concurrent calls */
@@ -150,7 +184,7 @@ export declare abstract class MastraSandbox extends MastraBase implements Worksp
      * }
      * ```
      */
-    protected ensureRunning(): Promise<void>;
+    ensureRunning(): Promise<void>;
     /**
      * Stop the sandbox (wrapper with status management and race-condition safety).
      *

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

@@ -1 +1 @@
-{"version":3,"file":"mastra-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/mastra-sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mastra-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/mastra-sandbox.ts"],"names":[],"mappings":"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"}

package/dist/workspace/sandbox/native-sandbox/bubblewrap.d.ts

@@ -8,13 +8,12 @@ import type { NativeSandboxConfig } from './types.js';
 /**
  * Build the bwrap command arguments for the given configuration.
  *
- * @param command - The command to run inside the sandbox
- * @param args - Arguments for the command
+ * @param command - The full shell command string to run inside the sandbox
  * @param workspacePath - The workspace directory (mounted read-write)
  * @param config - Additional sandbox configuration
  * @returns Wrapped command and arguments for bwrap
  */
-export declare function buildBwrapCommand(command: string, args: string[], workspacePath: string, config: NativeSandboxConfig): {
+export declare function buildBwrapCommand(command: string, workspacePath: string, config: NativeSandboxConfig): {
     command: string;
     args: string[];
 };

package/dist/workspace/sandbox/native-sandbox/bubblewrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bubblewrap.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/bubblewrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAwBnD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,mBAAmB,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA2ErC"}
+{"version":3,"file":"bubblewrap.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/bubblewrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAwBnD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,mBAAmB,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA2ErC"}

package/dist/workspace/sandbox/native-sandbox/seatbelt.d.ts

@@ -34,12 +34,11 @@ export declare function generateSeatbeltProfile(workspacePath: string, config: N
  * Uses `-p` (inline profile) instead of `-f` (file) because
  * `-f` doesn't work reliably with path filters on modern macOS.
  *
- * @param command - The command to run
- * @param args - Arguments for the command
+ * @param command - The full shell command string to run
  * @param profile - The SBPL profile content (not a file path)
  * @returns Wrapped command and arguments for sandbox-exec
  */
-export declare function buildSeatbeltCommand(command: string, args: string[], profile: string): {
+export declare function buildSeatbeltCommand(command: string, profile: string): {
     command: string;
     args: string[];
 };

package/dist/workspace/sandbox/native-sandbox/seatbelt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seatbelt.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/seatbelt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA0BnD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8FlG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKrC"}
+{"version":3,"file":"seatbelt.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/seatbelt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA0BnD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8FlG;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAK1G"}

package/dist/workspace/sandbox/native-sandbox/wrapper.d.ts

@@ -21,21 +21,20 @@ export interface WrapCommandOptions {
 /**
  * Wrap a command with the appropriate sandbox backend.
  *
- * @param command - The command to run
- * @param args - Arguments for the command
+ * @param command - The full shell command string to run
  * @param options - Wrapping options
  * @returns The wrapped command and arguments
  *
  * @example
  * ```typescript
- * const wrapped = wrapCommand('node', ['script.js'], {
+ * const wrapped = wrapCommand('node script.js', {
  *   backend: 'seatbelt',
  *   workspacePath: '/workspace',
  *   config: { allowNetwork: false },
  * });
  * // wrapped.command = 'sandbox-exec'
- * // wrapped.args = ['-p', '<profile>', 'node', 'script.js']
+ * // wrapped.args = ['-p', '<profile>', 'sh', '-c', 'node script.js']
  * ```
  */
-export declare function wrapCommand(command: string, args: string[], options: WrapCommandOptions): WrappedCommand;
+export declare function wrapCommand(command: string, options: WrapCommandOptions): WrappedCommand;
 //# sourceMappingURL=wrapper.d.ts.map

package/dist/workspace/sandbox/native-sandbox/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/wrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAexG"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/native-sandbox/wrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAexF"}

package/dist/workspace/sandbox/process-manager/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './process-handle.js';
+export * from './process-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workspace/sandbox/process-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/process-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/workspace/sandbox/process-manager/process-handle.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Process Handle (Base Class)
+ *
+ * Abstract base class for process handles.
+ * Manages stdout/stderr callback dispatch and provides lazy
+ * reader/writer stream getters — subclasses only implement
+ * the platform-specific primitives.
+ */
+import { Readable, Writable } from 'node:stream';
+import type { CommandResult } from '../types.js';
+import type { SpawnProcessOptions } from './types.js';
+/**
+ * Handle to a spawned process.
+ *
+ * Subclasses implement the platform-specific primitives (kill, sendStdin,
+ * wait). The base class handles stdout/stderr accumulation, callback
+ * dispatch via `emitStdout`/`emitStderr`, lazy `reader`/`writer` stream
+ * getters, and optional streaming callbacks on `wait()`.
+ *
+ * **For consumers:**
+ * - `handle.stdout` — poll accumulated output
+ * - `handle.wait()` — wait for exit, optionally with streaming callbacks
+ * - `handle.reader` / `handle.writer` — Node.js stream interop (LSP, JSON-RPC, pipes)
+ * - `onStdout`/`onStderr` callbacks in {@link SpawnProcessOptions} — stream at spawn time
+ *
+ * **For implementors:** Call `emitStdout(data)` / `emitStderr(data)` from
+ * your transport callback (ChildProcess events, WebSocket messages, etc.)
+ * to dispatch data. Pass `options` through to `super(options)` to wire
+ * user callbacks automatically.
+ *
+ * @example
+ * ```typescript
+ * // Poll model
+ * const handle = await sandbox.processes.spawn('node server.js');
+ * console.log(handle.stdout);
+ *
+ * // Stream model — callbacks at spawn time
+ * const handle = await sandbox.processes.spawn('npm run dev', {
+ *   onStdout: (data) => console.log(data),
+ * });
+ *
+ * // Stream model — callbacks during wait
+ * const result = await handle.wait({
+ *   onStdout: (data) => process.stdout.write(data),
+ *   onStderr: (data) => process.stderr.write(data),
+ * });
+ *
+ * // Stream model — pipe to LSP, JSON-RPC, etc.
+ * const handle = await sandbox.processes.spawn('typescript-language-server --stdio');
+ * const connection = createMessageConnection(
+ *   new StreamMessageReader(handle.reader),
+ *   new StreamMessageWriter(handle.writer),
+ * );
+ * ```
+ */
+export declare abstract class ProcessHandle {
+    /** Process ID */
+    abstract readonly pid: number;
+    /** Exit code, undefined while the process is still running */
+    abstract readonly exitCode: number | undefined;
+    /** The command that was spawned (set by the process manager) */
+    command?: string;
+    /** Kill the running process (SIGKILL). Returns true if killed, false if not found. */
+    abstract kill(): Promise<boolean>;
+    /** Send data to the process's stdin */
+    abstract sendStdin(data: string): Promise<void>;
+    /**
+     * Wait for the process to finish and return the result.
+     *
+     * Optionally pass `onStdout`/`onStderr` callbacks to stream output chunks
+     * while waiting. The callbacks are automatically removed when `wait()`
+     * resolves, so there's no cleanup needed by the caller.
+     *
+     * Subclasses implement `wait()` with platform-specific logic — the base
+     * constructor wraps it to handle the optional streaming callbacks.
+     */
+    wait(_options?: {
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<CommandResult>;
+    private _stdout;
+    private _stderr;
+    private _stdoutListeners;
+    private _stderrListeners;
+    private _reader?;
+    private _writer?;
+    constructor(options?: Pick<SpawnProcessOptions, 'onStdout' | 'onStderr'>);
+    /** Accumulated stdout so far */
+    get stdout(): string;
+    /** Accumulated stderr so far */
+    get stderr(): string;
+    /**
+     * Emit stdout data — accumulates, dispatches to user callback, and pushes to reader stream.
+     * @internal Called by subclasses and process managers to dispatch transport data.
+     */
+    emitStdout(data: string): void;
+    /**
+     * Emit stderr data — accumulates and dispatches to user callback.
+     * @internal Called by subclasses and process managers to dispatch transport data.
+     */
+    emitStderr(data: string): void;
+    /** Readable stream of stdout (for use with StreamMessageReader, pipes, etc.) */
+    get reader(): Readable;
+    /** Writable stream to stdin (for use with StreamMessageWriter, pipes, etc.) */
+    get writer(): Writable;
+}
+//# sourceMappingURL=process-handle.d.ts.map

package/dist/workspace/sandbox/process-manager/process-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-handle.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/process-manager/process-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,8BAAsB,aAAa;IACjC,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;;;;;;;OASG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KACnC,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAW;gBAEf,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,UAAU,CAAC;IAqBxE,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,gFAAgF;IAChF,IAAI,MAAM,IAAI,QAAQ,CASrB;IAED,+EAA+E;IAC/E,IAAI,MAAM,IAAI,QAAQ,CASrB;CACF"}

package/dist/workspace/sandbox/process-manager/process-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Sandbox Process Manager (Base Class)
+ *
+ * Abstract base class for sandbox process management.
+ * Wraps all methods with ensureRunning() so the sandbox is
+ * automatically started before any process operation.
+ * Subclasses implement spawn(), list(), get().
+ */
+import type { MastraSandbox } from '../mastra-sandbox.js';
+import type { ProcessHandle } from './process-handle.js';
+import type { ProcessInfo, SpawnProcessOptions } from './types.js';
+/**
+ * Abstract base class for process management in sandboxes.
+ *
+ * Wraps subclass overrides of `spawn()`, `list()`, and `get()` with
+ * `sandbox.ensureRunning()` so the sandbox is lazily started before
+ * any process operation.
+ *
+ * Subclasses implement the actual platform-specific logic for all methods.
+ *
+ * @typeParam TSandbox - The sandbox type. Subclasses narrow this to access
+ *   sandbox-specific properties (e.g. `workingDirectory`, `instance`).
+ *
+ * @example
+ * ```typescript
+ * const handle = await sandbox.processes.spawn('node server.js');
+ * console.log(handle.pid, handle.stdout);
+ *
+ * const all = await sandbox.processes.list();
+ * const proc = await sandbox.processes.get(handle.pid);
+ * await proc?.kill();
+ * ```
+ */
+export interface ProcessManagerOptions {
+    env?: Record<string, string | undefined>;
+}
+export declare abstract class SandboxProcessManager<TSandbox extends MastraSandbox = MastraSandbox> {
+    /**
+     * The sandbox this process manager belongs to.
+     * Set automatically by MastraSandbox when processes are passed into the constructor.
+     * @internal
+     */
+    sandbox: TSandbox;
+    protected readonly env: Record<string, string | undefined>;
+    /** Tracked process handles keyed by PID. Populated by spawn(), used by get()/kill(). */
+    protected readonly _tracked: Map<number, ProcessHandle>;
+    /** PIDs that have been read after exit and should not be re-discovered by subclass fallbacks. */
+    protected readonly _dismissed: Set<number>;
+    constructor({ env }?: ProcessManagerOptions);
+    /** Spawn a process. */
+    spawn(command: string, options?: SpawnProcessOptions): Promise<ProcessHandle>;
+    /** List all tracked processes. */
+    list(): Promise<ProcessInfo[]>;
+    /** Get a handle to a process by PID. Subclasses can override for fallback behavior. */
+    get(pid: number): Promise<ProcessHandle | undefined>;
+    /** Kill a process by PID. Returns true if killed, false if not found. */
+    kill(pid: number): Promise<boolean>;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/workspace/sandbox/process-manager/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/process-manager/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,8BAAsB,qBAAqB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IACxF;;;;OAIG;IACH,OAAO,EAAG,QAAQ,CAAC;IAEnB,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAE3D,wFAAwF;IACxF,SAAS,CAAC,QAAQ,CAAC,QAAQ,6BAAoC;IAE/D,iGAAiG;IACjG,SAAS,CAAC,QAAQ,CAAC,UAAU,cAAqB;gBAEtC,EAAE,GAAQ,EAAE,GAAE,qBAA0B;IAuCpD,uBAAuB;IAEjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIvF,kCAAkC;IAC5B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIpC,uFAAuF;IACjF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAI1D,yEAAyE;IACnE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAc1C"}

package/dist/workspace/sandbox/process-manager/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Process Manager Types
+ *
+ * Type definitions for process management.
+ */
+import type { CommandOptions } from '../types.js';
+/** Options for spawning a process. */
+export interface SpawnProcessOptions extends CommandOptions {
+}
+/**
+ * Info about a tracked process.
+ * Returned by {@link SandboxProcessManager.list}.
+ */
+export interface ProcessInfo {
+    /** Process ID */
+    pid: number;
+    /** The command that was executed (if available) */
+    command?: string;
+    /** Whether the process is still running */
+    running: boolean;
+    /** Exit code if the process has finished */
+    exitCode?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/sandbox/process-manager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/workspace/sandbox/process-manager/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C,sCAAsC;AACtC,MAAM,WAAW,mBAAoB,SAAQ,cAAc;CAAG;AAM9D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

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

@@ -23,10 +23,12 @@
  * });
  * ```
  */
+import type { RequestContext } from '../../request-context/index.js';
 import type { WorkspaceFilesystem } from '../filesystem/filesystem.js';
 import type { MountResult } from '../filesystem/mount.js';
 import type { SandboxLifecycle } from '../lifecycle.js';
 import type { MountManager } from './mount-manager.js';
+import type { SandboxProcessManager } from './process-manager/index.js';
 import type { CommandResult, ExecuteCommandOptions, SandboxInfo } from './types.js';
 /**
  * Abstract sandbox interface for code and command execution.
@@ -60,16 +62,50 @@ export interface WorkspaceSandbox extends SandboxLifecycle<SandboxInfo> {
      * Get instructions describing how this sandbox works.
      * Used in tool descriptions to help agents understand execution context.
      *
+     * @param opts - Optional options including request context for per-request customisation
      * @returns A string describing how to use this sandbox
      */
-    getInstructions?(): string;
+    getInstructions?(opts?: {
+        requestContext?: RequestContext;
+    }): string;
     /**
-     * Execute a shell command.
+     * Execute a shell command and wait for it to complete.
      * Optional - if not implemented, the workspace_execute_command tool won't be available.
+     *
+     * @example
+     * ```typescript
+     * await sandbox.executeCommand('npm install');
+     *
+     * // With options
+     * await sandbox.executeCommand('npm install', [], { timeout: 60000 });
+     *
+     * // With args array (each arg is shell-quoted automatically)
+     * await sandbox.executeCommand('npm', ['install'], { timeout: 60000 });
+     * ```
+     *
      * @throws {SandboxExecutionError} if command fails to start
      * @throws {SandboxTimeoutError} if command times out
      */
     executeCommand?(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
+    /**
+     * Process manager.
+     * Optional - if not implemented, process management tools won't be available.
+     *
+     * Provides methods to spawn long-running processes, list them, and interact
+     * with them via their {@link ProcessHandle} (kill, sendStdin, wait, read output).
+     *
+     * @example
+     * ```typescript
+     * const handle = await sandbox.processes.spawn('node server.js');
+     * console.log(handle.pid);
+     *
+     * const procs = await sandbox.processes.list();
+     * const proc = await sandbox.processes.get(handle.pid);
+     * await proc?.sendStdin('hello\n');
+     * await proc?.kill();
+     * ```
+     */
+    readonly processes?: SandboxProcessManager;
     /**
      * Mount manager for tracking and processing filesystem mounts.
      * Only available if the sandbox implements mount().

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

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAMjF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,CAAC,WAAW,CAAC;IACrE,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,eAAe,CAAC,IAAI,MAAM,CAAC;IAM3B;;;;;OAKG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAM3G;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjF;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAMjF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,CAAC,WAAW,CAAC;IACrE,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,MAAM,CAAC;IAMrE;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAM3G;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAM3C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjF;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}