@yolo-labs/core-sandbox 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,263 @@
+import { SandboxProvider, CommandExecutionOptions, CommandResult } from '@yolo-labs/core-types';
+
+/**
+ * In-memory sandbox using a Map-based virtual file system.
+ *
+ * @remarks
+ * All file operations are performed against an in-memory Map. Parent
+ * directories are auto-created on write. Use `exportState()` and
+ * `importState()` for serialization round-trips. Command execution
+ * is a no-op in this implementation.
+ *
+ * @example
+ * ```ts
+ * const sandbox = new InMemorySandbox();
+ * await sandbox.writeFile('hello.txt', 'world');
+ * const content = await sandbox.readFile('hello.txt'); // 'world'
+ * ```
+ */
+declare class InMemorySandbox implements SandboxProvider {
+    private files;
+    private directories;
+    /** Reads a file from the virtual file system by path. */
+    readFile(path: string): Promise<string>;
+    /** Writes content to a file, auto-creating parent directories. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Deletes a file from the virtual file system. */
+    deleteFile(path: string): Promise<void>;
+    /** Lists immediate children (files and directories) under the given path. */
+    listFiles(path: string): Promise<string[]>;
+    /** Creates a directory and all intermediate parent directories. */
+    mkdir(path: string): Promise<void>;
+    /** Returns a no-op result; command execution is not supported in-memory. */
+    executeCommand(_command: string, _options?: CommandExecutionOptions): Promise<CommandResult>;
+    /** Initializes the sandbox (no-op for in-memory). */
+    create(): Promise<void>;
+    /** Clears all files and directories, resetting the sandbox. */
+    destroy(): Promise<void>;
+    /** Resets the sandbox to its initial empty state. */
+    reset(): Promise<void>;
+    /**
+     * Exports the entire virtual file system as a path-to-content record.
+     *
+     * @returns A plain object mapping file paths to their string contents.
+     */
+    exportState(): Record<string, string>;
+    /**
+     * Replaces the virtual file system with the given state.
+     *
+     * @param state - A plain object mapping file paths to their string contents.
+     */
+    importState(state: Record<string, string>): void;
+    private normalizePath;
+    private dirname;
+    private ensureDir;
+}
+
+/** Configuration options for the Node.js VM sandbox. */
+interface NodeVMSandboxOptions {
+    /** Maximum execution time in milliseconds (default: 5000). */
+    timeout?: number;
+    /** Custom global variables injected into the VM context. */
+    globals?: Record<string, unknown>;
+    /** Memory limit in bytes for the VM context. */
+    memoryLimit?: number;
+}
+/**
+ * Server-side sandbox that executes code in an isolated Node.js VM context.
+ *
+ * @remarks
+ * Uses Node.js `vm.runInContext` for code execution with configurable timeout.
+ * File operations are delegated to an internal {@link InMemorySandbox}.
+ * stdout/stderr are captured via a custom console object injected into the
+ * VM context. For stronger isolation, `isolated-vm` is available as an
+ * optional peer dependency.
+ */
+declare class NodeVMSandbox implements SandboxProvider {
+    private fileSystem;
+    private timeout;
+    private customGlobals;
+    private context;
+    constructor(options?: NodeVMSandboxOptions);
+    /** Reads a file from the backing in-memory file system. */
+    readFile(path: string): Promise<string>;
+    /** Writes a file to the backing in-memory file system. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Deletes a file from the backing in-memory file system. */
+    deleteFile(path: string): Promise<void>;
+    /** Lists files under the given path in the backing file system. */
+    listFiles(path: string): Promise<string[]>;
+    /** Creates a directory in the backing in-memory file system. */
+    mkdir(path: string): Promise<void>;
+    /**
+     * Executes JavaScript code in an isolated VM context with timeout and output capture.
+     *
+     * @param command - The JavaScript code string to execute.
+     * @param options - Optional timeout override and stdout/stderr streaming callbacks.
+     * @returns A {@link CommandResult} with exit code and captured output.
+     */
+    executeCommand(command: string, options?: CommandExecutionOptions): Promise<CommandResult>;
+    /** Pre-creates the isolated VM context with configured globals. */
+    create(): Promise<void>;
+    /** Destroys the VM context and clears the backing file system. */
+    destroy(): Promise<void>;
+    /** Resets the sandbox by destroying and re-creating the VM context. */
+    reset(): Promise<void>;
+    /** Exports the backing file system state as a path-to-content record. */
+    exportState(): Record<string, string>;
+    /** Replaces the backing file system with the given state. */
+    importState(state: Record<string, string>): void;
+}
+
+/** Input for a compilation pass through the esbuild bundling pipeline. */
+interface CompileRequest {
+    /** Entry point file path for the bundle. */
+    entryPoint: string;
+    /** Virtual file system mapping paths to source contents. */
+    files: Record<string, string>;
+    /** NPM dependency name-to-version map. */
+    dependencies?: Record<string, string>;
+    /** Target runtime environment. */
+    target?: 'browser' | 'node';
+    /** Output module format. */
+    format?: 'esm' | 'iife';
+    /** Whether to minify the output. */
+    minify?: boolean;
+}
+/** Output produced by a compilation pass. */
+interface BuildArtifact {
+    /** Bundled JavaScript output. */
+    code: string;
+    /** Optional source map. */
+    map?: string;
+    /** Optional extracted CSS. */
+    css?: string;
+    /** Errors encountered during compilation. */
+    errors: BuildError[];
+    /** Warnings encountered during compilation. */
+    warnings: BuildWarning[];
+}
+/** A compilation error with an optional source location. */
+interface BuildError {
+    message: string;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+}
+/** A compilation warning with an optional source location. */
+interface BuildWarning {
+    message: string;
+    location?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+}
+/** Configuration for splitting vendor dependencies into named chunks. */
+interface VendorChunkConfig {
+    chunks: Record<string, string[]>;
+    cdnBaseUrl?: string;
+}
+/** Options for generating an HTML preview page from a build artifact. */
+interface PreviewConfig {
+    template?: string;
+    title?: string;
+    scripts?: string[];
+    styles?: string[];
+}
+/** Generated preview HTML and its associated static assets. */
+interface PreviewResult {
+    html: string;
+    assets: Record<string, string>;
+}
+/**
+ * Interface for a Whateverpack-based sandbox adapter.
+ *
+ * @remarks
+ * Consumers implement this to integrate Whatever's esbuild bundling pipeline.
+ * This is a contract definition only; the actual implementation lives in
+ * the consuming application. See {@link CompileRequest} and {@link BuildArtifact}
+ * for the compilation I/O types.
+ */
+interface WhateverpackSandboxAdapter {
+    /** Compiles the given source files into a bundled build artifact. */
+    compile(request: CompileRequest): Promise<BuildArtifact>;
+    /** Resolves vendor chunk configuration into chunk-name-to-URL mappings. */
+    resolveVendorChunks(config: VendorChunkConfig): Record<string, string>;
+    /** Generates an HTML preview page from a build artifact. */
+    generatePreview(artifact: BuildArtifact, config?: PreviewConfig): Promise<PreviewResult>;
+}
+
+/**
+ * Minimal duck-type for the subset of the WebContainer API we use.
+ * Consumers pass a real `WebContainer` from `@webcontainer/api`;
+ * this interface avoids a hard dependency on that package.
+ */
+interface WebContainerLike {
+    fs: {
+        readFile(path: string, encoding: string): Promise<string>;
+        writeFile(path: string, data: string): Promise<void>;
+        readdir(path: string): Promise<string[]>;
+        mkdir(path: string, options?: {
+            recursive?: boolean;
+        }): Promise<void>;
+        rm(path: string, options?: {
+            force?: boolean;
+            recursive?: boolean;
+        }): Promise<void>;
+    };
+    spawn(command: string, args?: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<WebContainerProcessLike>;
+}
+/** Minimal duck-type for the process returned by `WebContainer.spawn()`. */
+interface WebContainerProcessLike {
+    output: ReadableStream<string>;
+    exit: Promise<number>;
+}
+/** Configuration options for {@link WebContainerSandbox}. */
+interface WebContainerSandboxOptions {
+    /** Root directory within the container to scope all operations to. Defaults to `'/'`. */
+    rootDir?: string;
+    /** Default timeout for command execution in milliseconds. Defaults to 30 000. */
+    timeout?: number;
+}
+/**
+ * SandboxProvider backed by a WebContainer instance.
+ *
+ * @remarks
+ * The consumer boots the WebContainer externally and passes it to the
+ * constructor. All file operations delegate to `container.fs` and all
+ * command execution delegates to `container.spawn()`.
+ *
+ * @example
+ * ```ts
+ * import { WebContainer } from '@webcontainer/api';
+ * import { WebContainerSandbox } from '@yolo-labs/core-sandbox';
+ *
+ * const wc = await WebContainer.boot();
+ * const sandbox = new WebContainerSandbox(wc, { rootDir: '/project' });
+ * await sandbox.writeFile('index.ts', 'console.log("hi")');
+ * ```
+ */
+declare class WebContainerSandbox implements SandboxProvider {
+    private container;
+    private rootDir;
+    private timeout;
+    constructor(container: WebContainerLike, options?: WebContainerSandboxOptions);
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    listFiles(path: string): Promise<string[]>;
+    mkdir(path: string): Promise<void>;
+    executeCommand(command: string, options?: CommandExecutionOptions): Promise<CommandResult>;
+    create(): Promise<void>;
+    destroy(): Promise<void>;
+    reset(): Promise<void>;
+    private resolvePath;
+}
+
+export { type BuildArtifact, type BuildError, type BuildWarning, type CompileRequest, InMemorySandbox, NodeVMSandbox, type NodeVMSandboxOptions, type PreviewConfig, type PreviewResult, type VendorChunkConfig, type WebContainerLike, type WebContainerProcessLike, WebContainerSandbox, type WebContainerSandboxOptions, type WhateverpackSandboxAdapter };

package/dist/index.js

@@ -0,0 +1,386 @@
+// src/in-memory-sandbox.ts
+var InMemorySandbox = class {
+  // 39a: In-memory Map for file storage
+  files = /* @__PURE__ */ new Map();
+  directories = /* @__PURE__ */ new Set([".", "/"]);
+  /** Reads a file from the virtual file system by path. */
+  async readFile(path) {
+    const normalized = this.normalizePath(path);
+    const content = this.files.get(normalized);
+    if (content === void 0) {
+      throw new Error(`ENOENT: no such file: ${normalized}`);
+    }
+    return content;
+  }
+  /** Writes content to a file, auto-creating parent directories. */
+  async writeFile(path, content) {
+    const normalized = this.normalizePath(path);
+    const dir = this.dirname(normalized);
+    if (dir) {
+      this.ensureDir(dir);
+    }
+    this.files.set(normalized, content);
+  }
+  /** Deletes a file from the virtual file system. */
+  async deleteFile(path) {
+    const normalized = this.normalizePath(path);
+    if (!this.files.has(normalized)) {
+      throw new Error(`ENOENT: no such file: ${normalized}`);
+    }
+    this.files.delete(normalized);
+  }
+  /** Lists immediate children (files and directories) under the given path. */
+  async listFiles(path) {
+    const normalized = this.normalizePath(path || ".");
+    const prefix = normalized === "." ? "" : normalized + "/";
+    const entries = /* @__PURE__ */ new Set();
+    for (const filePath of this.files.keys()) {
+      if (prefix && !filePath.startsWith(prefix)) continue;
+      if (!prefix || filePath.startsWith(prefix)) {
+        const relative = prefix ? filePath.slice(prefix.length) : filePath;
+        const firstSegment = relative.split("/")[0];
+        if (firstSegment) {
+          entries.add(firstSegment);
+        }
+      }
+    }
+    return Array.from(entries).sort();
+  }
+  /** Creates a directory and all intermediate parent directories. */
+  async mkdir(path) {
+    const normalized = this.normalizePath(path);
+    this.ensureDir(normalized);
+  }
+  /** Returns a no-op result; command execution is not supported in-memory. */
+  async executeCommand(_command, _options) {
+    return {
+      exitCode: 0,
+      stdout: "",
+      stderr: "Command execution not supported in InMemorySandbox"
+    };
+  }
+  /** Initializes the sandbox (no-op for in-memory). */
+  async create() {
+  }
+  /** Clears all files and directories, resetting the sandbox. */
+  async destroy() {
+    this.files.clear();
+    this.directories.clear();
+    this.directories.add(".");
+    this.directories.add("/");
+  }
+  /** Resets the sandbox to its initial empty state. */
+  async reset() {
+    await this.destroy();
+  }
+  /**
+   * Exports the entire virtual file system as a path-to-content record.
+   *
+   * @returns A plain object mapping file paths to their string contents.
+   */
+  exportState() {
+    const state = {};
+    for (const [path, content] of this.files) {
+      state[path] = content;
+    }
+    return state;
+  }
+  /**
+   * Replaces the virtual file system with the given state.
+   *
+   * @param state - A plain object mapping file paths to their string contents.
+   */
+  importState(state) {
+    this.files.clear();
+    this.directories.clear();
+    this.directories.add(".");
+    this.directories.add("/");
+    for (const [path, content] of Object.entries(state)) {
+      this.files.set(path, content);
+      const dir = this.dirname(path);
+      if (dir) {
+        this.ensureDir(dir);
+      }
+    }
+  }
+  // Helpers
+  normalizePath(path) {
+    return path.replace(/^\.\//, "").replace(/\/+/g, "/").replace(/\/$/, "");
+  }
+  dirname(path) {
+    const lastSlash = path.lastIndexOf("/");
+    return lastSlash > 0 ? path.slice(0, lastSlash) : "";
+  }
+  ensureDir(path) {
+    const parts = path.split("/");
+    let current = "";
+    for (const part of parts) {
+      current = current ? `${current}/${part}` : part;
+      this.directories.add(current);
+    }
+  }
+};
+
+// src/node-vm-sandbox.ts
+import { createContext, runInContext } from "vm";
+var NodeVMSandbox = class {
+  fileSystem;
+  timeout;
+  customGlobals;
+  context = null;
+  constructor(options = {}) {
+    this.fileSystem = new InMemorySandbox();
+    this.timeout = options.timeout ?? 5e3;
+    this.customGlobals = options.globals ?? {};
+  }
+  /** Reads a file from the backing in-memory file system. */
+  async readFile(path) {
+    return this.fileSystem.readFile(path);
+  }
+  /** Writes a file to the backing in-memory file system. */
+  async writeFile(path, content) {
+    return this.fileSystem.writeFile(path, content);
+  }
+  /** Deletes a file from the backing in-memory file system. */
+  async deleteFile(path) {
+    return this.fileSystem.deleteFile(path);
+  }
+  /** Lists files under the given path in the backing file system. */
+  async listFiles(path) {
+    return this.fileSystem.listFiles(path);
+  }
+  /** Creates a directory in the backing in-memory file system. */
+  async mkdir(path) {
+    return this.fileSystem.mkdir(path);
+  }
+  /**
+   * Executes JavaScript code in an isolated VM context with timeout and output capture.
+   *
+   * @param command - The JavaScript code string to execute.
+   * @param options - Optional timeout override and stdout/stderr streaming callbacks.
+   * @returns A {@link CommandResult} with exit code and captured output.
+   */
+  async executeCommand(command, options) {
+    const stdout = [];
+    const stderr = [];
+    const sandbox = {
+      ...this.customGlobals,
+      console: {
+        log: (...args) => {
+          const line = args.map(String).join(" ");
+          stdout.push(line);
+          options?.onStdout?.(line + "\n");
+        },
+        error: (...args) => {
+          const line = args.map(String).join(" ");
+          stderr.push(line);
+          options?.onStderr?.(line + "\n");
+        },
+        warn: (...args) => {
+          const line = args.map(String).join(" ");
+          stderr.push(line);
+          options?.onStderr?.(line + "\n");
+        },
+        info: (...args) => {
+          const line = args.map(String).join(" ");
+          stdout.push(line);
+          options?.onStdout?.(line + "\n");
+        }
+      },
+      setTimeout: globalThis.setTimeout,
+      clearTimeout: globalThis.clearTimeout,
+      __result: void 0
+    };
+    const ctx = this.context ?? createContext(sandbox);
+    const timeout = options?.timeout ?? this.timeout;
+    try {
+      runInContext(command, ctx, {
+        timeout,
+        filename: "sandbox.js"
+      });
+      return {
+        exitCode: 0,
+        stdout: stdout.join("\n"),
+        stderr: stderr.join("\n")
+      };
+    } catch (err) {
+      const errorMsg = err instanceof Error ? err.message : String(err);
+      stderr.push(errorMsg);
+      options?.onStderr?.(errorMsg + "\n");
+      return {
+        exitCode: 1,
+        stdout: stdout.join("\n"),
+        stderr: stderr.join("\n")
+      };
+    }
+  }
+  /** Pre-creates the isolated VM context with configured globals. */
+  async create() {
+    const sandbox = {
+      ...this.customGlobals,
+      console: globalThis.console
+    };
+    this.context = createContext(sandbox);
+  }
+  /** Destroys the VM context and clears the backing file system. */
+  async destroy() {
+    this.context = null;
+    await this.fileSystem.destroy();
+  }
+  /** Resets the sandbox by destroying and re-creating the VM context. */
+  async reset() {
+    await this.destroy();
+    await this.create();
+  }
+  /** Exports the backing file system state as a path-to-content record. */
+  exportState() {
+    return this.fileSystem.exportState();
+  }
+  /** Replaces the backing file system with the given state. */
+  importState(state) {
+    this.fileSystem.importState(state);
+  }
+};
+
+// src/webcontainer-sandbox.ts
+var WebContainerSandbox = class {
+  container;
+  rootDir;
+  timeout;
+  constructor(container, options) {
+    this.container = container;
+    this.rootDir = (options?.rootDir ?? "/").replace(/\/+$/, "") || "/";
+    this.timeout = options?.timeout ?? 3e4;
+  }
+  // ---------------------------------------------------------------------------
+  // File operations
+  // ---------------------------------------------------------------------------
+  async readFile(path) {
+    return this.container.fs.readFile(this.resolvePath(path), "utf-8");
+  }
+  async writeFile(path, content) {
+    const resolved = this.resolvePath(path);
+    const lastSlash = resolved.lastIndexOf("/");
+    if (lastSlash > 0) {
+      await this.container.fs.mkdir(resolved.substring(0, lastSlash), { recursive: true });
+    }
+    await this.container.fs.writeFile(resolved, content);
+  }
+  async deleteFile(path) {
+    await this.container.fs.rm(this.resolvePath(path));
+  }
+  async listFiles(path) {
+    return this.container.fs.readdir(this.resolvePath(path));
+  }
+  async mkdir(path) {
+    await this.container.fs.mkdir(this.resolvePath(path), { recursive: true });
+  }
+  // ---------------------------------------------------------------------------
+  // Command execution
+  // ---------------------------------------------------------------------------
+  async executeCommand(command, options) {
+    const parts = parseCommand(command);
+    const cmd = parts[0];
+    const args = parts.slice(1);
+    const spawnOpts = {};
+    if (options?.cwd) {
+      spawnOpts.cwd = this.resolvePath(options.cwd);
+    }
+    if (options?.env) {
+      spawnOpts.env = options.env;
+    }
+    const proc = await this.container.spawn(cmd, args, spawnOpts);
+    let output = "";
+    const timeout = options?.timeout ?? this.timeout;
+    const collectOutput = async () => {
+      const reader = proc.output.getReader();
+      try {
+        for (; ; ) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          output += value;
+          options?.onStdout?.(value);
+        }
+      } finally {
+        reader.releaseLock();
+      }
+    };
+    let exitCode;
+    try {
+      const results = await Promise.race([
+        Promise.all([proc.exit, collectOutput()]),
+        new Promise(
+          (_, reject) => setTimeout(() => reject(new Error("Command timed out")), timeout)
+        )
+      ]);
+      exitCode = results[0];
+    } catch {
+      exitCode = 1;
+    }
+    return {
+      exitCode,
+      stdout: output,
+      // WebContainer spawn() has a single combined output stream;
+      // separate stderr is not available.
+      stderr: ""
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle
+  // ---------------------------------------------------------------------------
+  async create() {
+    if (this.rootDir !== "/") {
+      await this.container.fs.mkdir(this.rootDir, { recursive: true });
+    }
+  }
+  async destroy() {
+  }
+  async reset() {
+  }
+  // ---------------------------------------------------------------------------
+  // Internals
+  // ---------------------------------------------------------------------------
+  resolvePath(path) {
+    let normalized = path.replace(/^\.\//, "").replace(/\/+/g, "/").replace(/\/+$/, "");
+    if (normalized === "." || normalized === "") {
+      return this.rootDir;
+    }
+    if (this.rootDir === "/") {
+      return normalized.startsWith("/") ? normalized : "/" + normalized;
+    }
+    const full = normalized.startsWith("/") ? normalized : this.rootDir + "/" + normalized;
+    if (!full.startsWith(this.rootDir)) {
+      throw new Error(`Path '${path}' is outside the root directory`);
+    }
+    return full;
+  }
+};
+function parseCommand(command) {
+  const parts = [];
+  let current = "";
+  let inSingle = false;
+  let inDouble = false;
+  for (let i = 0; i < command.length; i++) {
+    const ch = command[i];
+    if (ch === "'" && !inDouble) {
+      inSingle = !inSingle;
+    } else if (ch === '"' && !inSingle) {
+      inDouble = !inDouble;
+    } else if (ch === " " && !inSingle && !inDouble) {
+      if (current) {
+        parts.push(current);
+        current = "";
+      }
+    } else {
+      current += ch;
+    }
+  }
+  if (current) parts.push(current);
+  return parts;
+}
+export {
+  InMemorySandbox,
+  NodeVMSandbox,
+  WebContainerSandbox
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/in-memory-sandbox.ts","../src/node-vm-sandbox.ts","../src/webcontainer-sandbox.ts"],"sourcesContent":["// Task 39: InMemorySandbox — baseline provider using a plain JS object as virtual file system\n\nimport type {\n  SandboxProvider,\n  CommandResult,\n  CommandExecutionOptions,\n} from '@yolo-labs/core-types';\n\n/**\n * In-memory sandbox using a Map-based virtual file system.\n *\n * @remarks\n * All file operations are performed against an in-memory Map. Parent\n * directories are auto-created on write. Use `exportState()` and\n * `importState()` for serialization round-trips. Command execution\n * is a no-op in this implementation.\n *\n * @example\n * ```ts\n * const sandbox = new InMemorySandbox();\n * await sandbox.writeFile('hello.txt', 'world');\n * const content = await sandbox.readFile('hello.txt'); // 'world'\n * ```\n */\nexport class InMemorySandbox implements SandboxProvider {\n  // 39a: In-memory Map for file storage\n  private files = new Map<string, string>();\n  private directories = new Set<string>(['.', '/']);\n\n  /** Reads a file from the virtual file system by path. */\n  async readFile(path: string): Promise<string> {\n    const normalized = this.normalizePath(path);\n    const content = this.files.get(normalized);\n    if (content === undefined) {\n      throw new Error(`ENOENT: no such file: ${normalized}`);\n    }\n    return content;\n  }\n\n  /** Writes content to a file, auto-creating parent directories. */\n  async writeFile(path: string, content: string): Promise<void> {\n    const normalized = this.normalizePath(path);\n    // Auto-create parent directories\n    const dir = this.dirname(normalized);\n    if (dir) {\n      this.ensureDir(dir);\n    }\n    this.files.set(normalized, content);\n  }\n\n  /** Deletes a file from the virtual file system. */\n  async deleteFile(path: string): Promise<void> {\n    const normalized = this.normalizePath(path);\n    if (!this.files.has(normalized)) {\n      throw new Error(`ENOENT: no such file: ${normalized}`);\n    }\n    this.files.delete(normalized);\n  }\n\n  /** Lists immediate children (files and directories) under the given path. */\n  async listFiles(path: string): Promise<string[]> {\n    const normalized = this.normalizePath(path || '.');\n    const prefix = normalized === '.' ? '' : normalized + '/';\n    const entries = new Set<string>();\n\n    for (const filePath of this.files.keys()) {\n      if (prefix && !filePath.startsWith(prefix)) continue;\n      if (!prefix || filePath.startsWith(prefix)) {\n        const relative = prefix ? filePath.slice(prefix.length) : filePath;\n        const firstSegment = relative.split('/')[0];\n        if (firstSegment) {\n          entries.add(firstSegment);\n        }\n      }\n    }\n\n    return Array.from(entries).sort();\n  }\n\n  /** Creates a directory and all intermediate parent directories. */\n  async mkdir(path: string): Promise<void> {\n    const normalized = this.normalizePath(path);\n    this.ensureDir(normalized);\n  }\n\n  /** Returns a no-op result; command execution is not supported in-memory. */\n  async executeCommand(\n    _command: string,\n    _options?: CommandExecutionOptions,\n  ): Promise<CommandResult> {\n    return {\n      exitCode: 0,\n      stdout: '',\n      stderr: 'Command execution not supported in InMemorySandbox',\n    };\n  }\n\n  /** Initializes the sandbox (no-op for in-memory). */\n  async create(): Promise<void> {\n    // No-op\n  }\n\n  /** Clears all files and directories, resetting the sandbox. */\n  async destroy(): Promise<void> {\n    this.files.clear();\n    this.directories.clear();\n    this.directories.add('.');\n    this.directories.add('/');\n  }\n\n  /** Resets the sandbox to its initial empty state. */\n  async reset(): Promise<void> {\n    await this.destroy();\n  }\n\n  /**\n   * Exports the entire virtual file system as a path-to-content record.\n   *\n   * @returns A plain object mapping file paths to their string contents.\n   */\n  exportState(): Record<string, string> {\n    const state: Record<string, string> = {};\n    for (const [path, content] of this.files) {\n      state[path] = content;\n    }\n    return state;\n  }\n\n  /**\n   * Replaces the virtual file system with the given state.\n   *\n   * @param state - A plain object mapping file paths to their string contents.\n   */\n  importState(state: Record<string, string>): void {\n    this.files.clear();\n    this.directories.clear();\n    this.directories.add('.');\n    this.directories.add('/');\n    for (const [path, content] of Object.entries(state)) {\n      this.files.set(path, content);\n      const dir = this.dirname(path);\n      if (dir) {\n        this.ensureDir(dir);\n      }\n    }\n  }\n\n  // Helpers\n  private normalizePath(path: string): string {\n    return path.replace(/^\\.\\//, '').replace(/\\/+/g, '/').replace(/\\/$/, '');\n  }\n\n  private dirname(path: string): string {\n    const lastSlash = path.lastIndexOf('/');\n    return lastSlash > 0 ? path.slice(0, lastSlash) : '';\n  }\n\n  private ensureDir(path: string): void {\n    const parts = path.split('/');\n    let current = '';\n    for (const part of parts) {\n      current = current ? `${current}/${part}` : part;\n      this.directories.add(current);\n    }\n  }\n}\n","// Task 40: NodeVMSandbox — server-side sandbox using Node.js vm module\n\nimport { createContext, runInContext, type Context } from 'node:vm';\nimport type {\n  SandboxProvider,\n  CommandResult,\n  CommandExecutionOptions,\n} from '@yolo-labs/core-types';\nimport { InMemorySandbox } from './in-memory-sandbox.js';\n\n/** Configuration options for the Node.js VM sandbox. */\nexport interface NodeVMSandboxOptions {\n  /** Maximum execution time in milliseconds (default: 5000). */\n  timeout?: number;\n  /** Custom global variables injected into the VM context. */\n  globals?: Record<string, unknown>;\n  /** Memory limit in bytes for the VM context. */\n  memoryLimit?: number;\n}\n\n/**\n * Server-side sandbox that executes code in an isolated Node.js VM context.\n *\n * @remarks\n * Uses Node.js `vm.runInContext` for code execution with configurable timeout.\n * File operations are delegated to an internal {@link InMemorySandbox}.\n * stdout/stderr are captured via a custom console object injected into the\n * VM context. For stronger isolation, `isolated-vm` is available as an\n * optional peer dependency.\n */\nexport class NodeVMSandbox implements SandboxProvider {\n  private fileSystem: InMemorySandbox;\n  private timeout: number;\n  private customGlobals: Record<string, unknown>;\n  private context: Context | null = null;\n\n  constructor(options: NodeVMSandboxOptions = {}) {\n    this.fileSystem = new InMemorySandbox();\n    this.timeout = options.timeout ?? 5000;\n    this.customGlobals = options.globals ?? {};\n  }\n\n  /** Reads a file from the backing in-memory file system. */\n  async readFile(path: string): Promise<string> {\n    return this.fileSystem.readFile(path);\n  }\n\n  /** Writes a file to the backing in-memory file system. */\n  async writeFile(path: string, content: string): Promise<void> {\n    return this.fileSystem.writeFile(path, content);\n  }\n\n  /** Deletes a file from the backing in-memory file system. */\n  async deleteFile(path: string): Promise<void> {\n    return this.fileSystem.deleteFile(path);\n  }\n\n  /** Lists files under the given path in the backing file system. */\n  async listFiles(path: string): Promise<string[]> {\n    return this.fileSystem.listFiles(path);\n  }\n\n  /** Creates a directory in the backing in-memory file system. */\n  async mkdir(path: string): Promise<void> {\n    return this.fileSystem.mkdir(path);\n  }\n\n  /**\n   * Executes JavaScript code in an isolated VM context with timeout and output capture.\n   *\n   * @param command - The JavaScript code string to execute.\n   * @param options - Optional timeout override and stdout/stderr streaming callbacks.\n   * @returns A {@link CommandResult} with exit code and captured output.\n   */\n  async executeCommand(\n    command: string,\n    options?: CommandExecutionOptions,\n  ): Promise<CommandResult> {\n    const stdout: string[] = [];\n    const stderr: string[] = [];\n\n    // 40a: Create isolated context with configurable globals\n    const sandbox: Record<string, unknown> = {\n      ...this.customGlobals,\n      console: {\n        log: (...args: unknown[]) => {\n          const line = args.map(String).join(' ');\n          stdout.push(line);\n          options?.onStdout?.(line + '\\n');\n        },\n        error: (...args: unknown[]) => {\n          const line = args.map(String).join(' ');\n          stderr.push(line);\n          options?.onStderr?.(line + '\\n');\n        },\n        warn: (...args: unknown[]) => {\n          const line = args.map(String).join(' ');\n          stderr.push(line);\n          options?.onStderr?.(line + '\\n');\n        },\n        info: (...args: unknown[]) => {\n          const line = args.map(String).join(' ');\n          stdout.push(line);\n          options?.onStdout?.(line + '\\n');\n        },\n      },\n      setTimeout: globalThis.setTimeout,\n      clearTimeout: globalThis.clearTimeout,\n      __result: undefined,\n    };\n\n    const ctx = this.context ?? createContext(sandbox);\n    const timeout = options?.timeout ?? this.timeout;\n\n    try {\n      // 40b: Execute with timeout\n      runInContext(command, ctx, {\n        timeout,\n        filename: 'sandbox.js',\n      });\n\n      return {\n        exitCode: 0,\n        stdout: stdout.join('\\n'),\n        stderr: stderr.join('\\n'),\n      };\n    } catch (err) {\n      const errorMsg = err instanceof Error ? err.message : String(err);\n      stderr.push(errorMsg);\n      options?.onStderr?.(errorMsg + '\\n');\n\n      return {\n        exitCode: 1,\n        stdout: stdout.join('\\n'),\n        stderr: stderr.join('\\n'),\n      };\n    }\n  }\n\n  /** Pre-creates the isolated VM context with configured globals. */\n  async create(): Promise<void> {\n    // 40a: Pre-create the context\n    const sandbox: Record<string, unknown> = {\n      ...this.customGlobals,\n      console: globalThis.console,\n    };\n    this.context = createContext(sandbox);\n  }\n\n  /** Destroys the VM context and clears the backing file system. */\n  async destroy(): Promise<void> {\n    this.context = null;\n    await this.fileSystem.destroy();\n  }\n\n  /** Resets the sandbox by destroying and re-creating the VM context. */\n  async reset(): Promise<void> {\n    await this.destroy();\n    await this.create();\n  }\n\n  /** Exports the backing file system state as a path-to-content record. */\n  exportState(): Record<string, string> {\n    return this.fileSystem.exportState();\n  }\n\n  /** Replaces the backing file system with the given state. */\n  importState(state: Record<string, string>): void {\n    this.fileSystem.importState(state);\n  }\n}\n","// WebContainerSandbox — SandboxProvider backed by a WebContainer instance\n\nimport type {\n  SandboxProvider,\n  CommandResult,\n  CommandExecutionOptions,\n} from '@yolo-labs/core-types';\n\n/**\n * Minimal duck-type for the subset of the WebContainer API we use.\n * Consumers pass a real `WebContainer` from `@webcontainer/api`;\n * this interface avoids a hard dependency on that package.\n */\nexport interface WebContainerLike {\n  fs: {\n    readFile(path: string, encoding: string): Promise<string>;\n    writeFile(path: string, data: string): Promise<void>;\n    readdir(path: string): Promise<string[]>;\n    mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n    rm(path: string, options?: { force?: boolean; recursive?: boolean }): Promise<void>;\n  };\n  spawn(\n    command: string,\n    args?: string[],\n    options?: { cwd?: string; env?: Record<string, string> },\n  ): Promise<WebContainerProcessLike>;\n}\n\n/** Minimal duck-type for the process returned by `WebContainer.spawn()`. */\nexport interface WebContainerProcessLike {\n  output: ReadableStream<string>;\n  exit: Promise<number>;\n}\n\n/** Configuration options for {@link WebContainerSandbox}. */\nexport interface WebContainerSandboxOptions {\n  /** Root directory within the container to scope all operations to. Defaults to `'/'`. */\n  rootDir?: string;\n  /** Default timeout for command execution in milliseconds. Defaults to 30 000. */\n  timeout?: number;\n}\n\n/**\n * SandboxProvider backed by a WebContainer instance.\n *\n * @remarks\n * The consumer boots the WebContainer externally and passes it to the\n * constructor. All file operations delegate to `container.fs` and all\n * command execution delegates to `container.spawn()`.\n *\n * @example\n * ```ts\n * import { WebContainer } from '@webcontainer/api';\n * import { WebContainerSandbox } from '@yolo-labs/core-sandbox';\n *\n * const wc = await WebContainer.boot();\n * const sandbox = new WebContainerSandbox(wc, { rootDir: '/project' });\n * await sandbox.writeFile('index.ts', 'console.log(\"hi\")');\n * ```\n */\nexport class WebContainerSandbox implements SandboxProvider {\n  private container: WebContainerLike;\n  private rootDir: string;\n  private timeout: number;\n\n  constructor(container: WebContainerLike, options?: WebContainerSandboxOptions) {\n    this.container = container;\n    this.rootDir = (options?.rootDir ?? '/').replace(/\\/+$/, '') || '/';\n    this.timeout = options?.timeout ?? 30_000;\n  }\n\n  // ---------------------------------------------------------------------------\n  // File operations\n  // ---------------------------------------------------------------------------\n\n  async readFile(path: string): Promise<string> {\n    return this.container.fs.readFile(this.resolvePath(path), 'utf-8');\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    const resolved = this.resolvePath(path);\n    const lastSlash = resolved.lastIndexOf('/');\n    if (lastSlash > 0) {\n      await this.container.fs.mkdir(resolved.substring(0, lastSlash), { recursive: true });\n    }\n    await this.container.fs.writeFile(resolved, content);\n  }\n\n  async deleteFile(path: string): Promise<void> {\n    await this.container.fs.rm(this.resolvePath(path));\n  }\n\n  async listFiles(path: string): Promise<string[]> {\n    return this.container.fs.readdir(this.resolvePath(path));\n  }\n\n  async mkdir(path: string): Promise<void> {\n    await this.container.fs.mkdir(this.resolvePath(path), { recursive: true });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Command execution\n  // ---------------------------------------------------------------------------\n\n  async executeCommand(\n    command: string,\n    options?: CommandExecutionOptions,\n  ): Promise<CommandResult> {\n    const parts = parseCommand(command);\n    const cmd = parts[0];\n    const args = parts.slice(1);\n\n    const spawnOpts: { cwd?: string; env?: Record<string, string> } = {};\n    if (options?.cwd) {\n      spawnOpts.cwd = this.resolvePath(options.cwd);\n    }\n    if (options?.env) {\n      spawnOpts.env = options.env;\n    }\n\n    const proc = await this.container.spawn(cmd, args, spawnOpts);\n\n    let output = '';\n    const timeout = options?.timeout ?? this.timeout;\n\n    const collectOutput = async (): Promise<void> => {\n      const reader = proc.output.getReader();\n      try {\n        for (;;) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          output += value;\n          options?.onStdout?.(value);\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    };\n\n    let exitCode: number;\n    try {\n      const results = await Promise.race([\n        Promise.all([proc.exit, collectOutput()]),\n        new Promise<never>((_, reject) =>\n          setTimeout(() => reject(new Error('Command timed out')), timeout),\n        ),\n      ]);\n      exitCode = results[0];\n    } catch {\n      exitCode = 1;\n    }\n\n    return {\n      exitCode,\n      stdout: output,\n      // WebContainer spawn() has a single combined output stream;\n      // separate stderr is not available.\n      stderr: '',\n    };\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle\n  // ---------------------------------------------------------------------------\n\n  async create(): Promise<void> {\n    if (this.rootDir !== '/') {\n      await this.container.fs.mkdir(this.rootDir, { recursive: true });\n    }\n  }\n\n  async destroy(): Promise<void> {\n    // No-op: the consumer owns the WebContainer lifecycle.\n  }\n\n  async reset(): Promise<void> {\n    // No-op: resetting a WebContainer's filesystem requires remounting.\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internals\n  // ---------------------------------------------------------------------------\n\n  private resolvePath(path: string): string {\n    // Strip leading ./ and collapse slashes\n    let normalized = path\n      .replace(/^\\.\\//, '')\n      .replace(/\\/+/g, '/')\n      .replace(/\\/+$/, '');\n\n    // '.' means the root directory itself\n    if (normalized === '.' || normalized === '') {\n      return this.rootDir;\n    }\n\n    if (this.rootDir === '/') {\n      return normalized.startsWith('/') ? normalized : '/' + normalized;\n    }\n\n    const full = normalized.startsWith('/')\n      ? normalized\n      : this.rootDir + '/' + normalized;\n\n    if (!full.startsWith(this.rootDir)) {\n      throw new Error(`Path '${path}' is outside the root directory`);\n    }\n    return full;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Splits a command string into [command, ...args] with basic quote awareness.\n * Handles single and double quotes. Does not handle escapes or shell operators.\n */\nexport function parseCommand(command: string): string[] {\n  const parts: string[] = [];\n  let current = '';\n  let inSingle = false;\n  let inDouble = false;\n\n  for (let i = 0; i < command.length; i++) {\n    const ch = command[i];\n    if (ch === \"'\" && !inDouble) {\n      inSingle = !inSingle;\n    } else if (ch === '\"' && !inSingle) {\n      inDouble = !inDouble;\n    } else if (ch === ' ' && !inSingle && !inDouble) {\n      if (current) {\n        parts.push(current);\n        current = '';\n      }\n    } else {\n      current += ch;\n    }\n  }\n  if (current) parts.push(current);\n  return parts;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@yolo-labs/core-sandbox",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yolo-labs/core-types": "1.0.0"
+  },
+  "peerDependencies": {
+    "isolated-vm": ">=5.0.0",
+    "@webcontainer/api": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "isolated-vm": {
+      "optional": true
+    },
+    "@webcontainer/api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "description": "Sandbox environments (in-memory, Node VM) for safe code execution",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yolo-labs-hq/monorepo.git",
+    "directory": "yolo-core/packages/sandbox"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/yolo-labs-hq/monorepo/tree/main/yolo-core#readme",
+  "bugs": {
+    "url": "https://github.com/yolo-labs-hq/monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}