@ebowwa/sandbox 0.1.1

package/dist/runtimes/process.js

@@ -0,0 +1,230 @@
+/**
+ * Process Runtime
+ *
+ * Spawns child processes for code execution with elevated permissions.
+ * Supports filesystem and network access with configurable limits.
+ *
+ * Isolation level: 'process'
+ */
+import { spawn } from "node:child_process";
+import { setTimeout as setTimeoutPromise } from "node:timers/promises";
+/**
+ * Process Runtime
+ *
+ * Executes code in child processes with configurable permissions.
+ * Provides filesystem and network access based on permission level.
+ */
+export class ProcessRuntime {
+    name = "process";
+    capabilities = {
+        isolation: "process",
+        stateful: true,
+        async: true,
+        filesystem: true,
+        network: true,
+        maxMemory: 4 * 1024 * 1024 * 1024, // 4GB
+        wasi: false,
+    };
+    executing = false;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            shell: config.shell ?? "/bin/sh",
+            availabilityTimeout: config.availabilityTimeout ?? 5000,
+        };
+    }
+    async init() {
+        // No special initialization needed for process runtime
+    }
+    async isAvailable() {
+        // Process spawning is always available in Node.js
+        return typeof process !== "undefined" && typeof spawn === "function";
+    }
+    async execute(request, options) {
+        const startTime = Date.now();
+        this.executing = true;
+        const stdout = [];
+        const stderr = [];
+        const displays = [];
+        try {
+            // Parse limits
+            const timeout = this.parseTimeout(options.limits?.timeout);
+            const maxMemory = this.parseMemory(options.limits?.memory);
+            // Build execution command based on code type
+            const { command, args } = this.buildCommand(request, options);
+            // Create abort controller for timeout
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            // Combine with external signal if provided
+            if (options.signal) {
+                options.signal.addEventListener("abort", () => {
+                    controller.abort();
+                    clearTimeout(timeoutId);
+                });
+            }
+            // Spawn child process
+            const childProcess = spawn(command, args, {
+                cwd: options.cwd ?? process.cwd(),
+                env: {
+                    ...process.env,
+                    ...options.env,
+                    NODE_OPTIONS: `--max-old-space-size=${Math.floor(maxMemory / (1024 * 1024))}`,
+                },
+                signal: controller.signal,
+                shell: false,
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            // Collect stdout
+            childProcess.stdout?.on("data", (data) => {
+                stdout.push(data.toString("utf8"));
+            });
+            // Collect stderr
+            childProcess.stderr?.on("data", (data) => {
+                stderr.push(data.toString("utf8"));
+            });
+            // Handle process events
+            const result = await new Promise((resolve) => {
+                let returnValue = undefined;
+                childProcess.on("error", (error) => {
+                    clearTimeout(timeoutId);
+                    resolve(this.createErrorResult(`Process error: ${error.message}`, "runtime", startTime, stdout, stderr));
+                });
+                childProcess.on("close", (code, signal) => {
+                    clearTimeout(timeoutId);
+                    if (signal) {
+                        resolve(this.createErrorResult(`Process killed by signal: ${signal}`, signal === "SIGTERM" ? "timeout" : "cancel", startTime, stdout, stderr));
+                        return;
+                    }
+                    // Try to parse stdout as JSON for return value
+                    const output = stdout.join("");
+                    try {
+                        const parsed = JSON.parse(output);
+                        if (parsed.__return_value !== undefined) {
+                            returnValue = parsed.__return_value;
+                        }
+                    }
+                    catch {
+                        // Not JSON, use raw output as value
+                        returnValue = output.trim() || undefined;
+                    }
+                    resolve({
+                        success: code === 0,
+                        value: returnValue,
+                        metrics: {
+                            duration: Date.now() - startTime,
+                            memoryUsed: 0, // Not tracked at process level
+                        },
+                        output: { stdout, stderr, displays },
+                    });
+                });
+                // Write input if provided
+                if (request.input !== undefined) {
+                    const inputStr = typeof request.input === "string"
+                        ? request.input
+                        : JSON.stringify(request.input);
+                    childProcess.stdin?.write(inputStr);
+                    childProcess.stdin?.end();
+                }
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                return this.createErrorResult("Execution timed out", "timeout", startTime, stdout, stderr);
+            }
+            return this.createErrorResult(error instanceof Error ? error.message : String(error), "runtime", startTime, stdout, stderr);
+        }
+        finally {
+            this.executing = false;
+        }
+    }
+    async terminate() {
+        this.executing = false;
+    }
+    isExecuting() {
+        return this.executing;
+    }
+    /**
+     * Build command and arguments for execution
+     */
+    buildCommand(request, options) {
+        // Execute WASM using node with WASI support
+        return {
+            command: "node",
+            args: [
+                "--experimental-wasi-unstable-preview1",
+                "-e",
+                this.generateWasmRunner(request.wasm.wasmBytes, options.permissions),
+            ],
+        };
+    }
+    /**
+     * Generate WASM runner script
+     */
+    generateWasmRunner(wasmBytes, permissions) {
+        const hasFs = permissions.fs?.read || permissions.fs?.write;
+        const hasNetwork = permissions.network?.outbound || permissions.network?.inbound;
+        return `
+const { WASI } = require('wasi');
+const { readFile } = require('fs/promises');
+
+async function run() {
+  const wasmBuffer = Buffer.from([${Array.from(wasmBytes).join(",")}]);
+
+  const wasi = new WASI({
+    version: 'preview1',
+    preopens: ${hasFs ? "{ '/': process.cwd() }" : "{}"},
+    env: process.env,
+  });
+
+  const { instance } = await WebAssembly.instantiate(wasmBuffer, {
+    wasi_snapshot_preview1: wasi.wasiImport,
+  });
+
+  wasi.start(instance);
+}
+
+run().catch(console.error);
+`;
+    }
+    createErrorResult(message, type, startTime, stdout = [], stderr = []) {
+        return {
+            success: false,
+            error: { message, type },
+            metrics: {
+                duration: Date.now() - startTime,
+                memoryUsed: 0,
+            },
+            output: { stdout, stderr, displays: [] },
+        };
+    }
+    parseMemory(memory) {
+        if (!memory)
+            return 256 * 1024 * 1024; // 256MB default
+        if (typeof memory === "number")
+            return memory;
+        const match = memory.match(/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb)?$/i);
+        if (!match)
+            return 256 * 1024 * 1024;
+        const [, num, unit] = match;
+        const multipliers = {
+            b: 1, kb: 1024, mb: 1024 ** 2, gb: 1024 ** 3,
+        };
+        return Math.floor(parseFloat(num) * (multipliers[unit?.toLowerCase() ?? "b"] ?? 1));
+    }
+    parseTimeout(timeout) {
+        if (!timeout)
+            return 60000; // 60s default for process
+        if (typeof timeout === "number")
+            return timeout;
+        const match = timeout.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m)?$/i);
+        if (!match)
+            return 60000;
+        const [, num, unit] = match;
+        const multipliers = {
+            ms: 1, s: 1000, m: 60000,
+        };
+        return Math.floor(parseFloat(num) * (multipliers[unit?.toLowerCase() ?? "ms"] ?? 1));
+    }
+}
+//# sourceMappingURL=process.js.map

package/dist/runtimes/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/runtimes/process.ts"],"names":[],"mappings":"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"}

package/dist/session/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Session Primitives
+ *
+ * Stateful execution contexts for interactive use.
+ */
+export type { KernelState, KernelOptions, KernelStats, } from "./kernel.js";
+export { BaseKernel, KernelManager, } from "./kernel.js";
+export type { NotebookOptions, NotebookState, NotebookEvents, } from "./notebook.js";
+export { BaseNotebook, createNotebook, } from "./notebook.js";
+export type { REPLOptions, REPLHistoryEntry, REPLState, } from "./repl.js";
+export { BaseREPL, createREPL, } from "./repl.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,9 @@
+/**
+ * Session Primitives
+ *
+ * Stateful execution contexts for interactive use.
+ */
+export { BaseKernel, KernelManager, } from "./kernel.js";
+export { BaseNotebook, createNotebook, } from "./notebook.js";
+export { BaseREPL, createREPL, } from "./repl.js";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EACL,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AASvB,OAAO,EACL,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC"}

package/dist/session/kernel.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Kernel Primitive
+ *
+ * Language-specific execution session with state persistence.
+ * Provides REPL-like interactive execution for a single language.
+ */
+import type { Language, Kernel, ExecutionResult, ExecutionOptions, CompletionResult, InspectResult, Permissions, Limits } from "../core/types.js";
+import type { ICompiler } from "../core/compiler.js";
+import type { IRuntime } from "../core/runtime.js";
+/**
+ * Kernel state
+ */
+export type KernelState = "starting" | "ready" | "busy" | "error" | "shutting_down" | "dead";
+/**
+ * Kernel options
+ */
+export interface KernelOptions {
+    /** Kernel ID */
+    id?: string;
+    /** Display name */
+    displayName?: string;
+    /** Language */
+    language: Language;
+    /** Compiler for this language */
+    compiler: ICompiler;
+    /** Runtime for execution */
+    runtime: IRuntime;
+    /** Permissions */
+    permissions?: Permissions;
+    /** Resource limits */
+    limits?: Limits;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Kernel statistics
+ */
+export interface KernelStats {
+    /** Total executions */
+    executions: number;
+    /** Successful executions */
+    successes: number;
+    /** Failed executions */
+    failures: number;
+    /** Total execution time (ms) */
+    totalTime: number;
+    /** Average execution time (ms) */
+    avgTime: number;
+    /** Memory high water mark */
+    memoryHighWater: number;
+    /** Last execution time */
+    lastExecution?: Date;
+}
+/**
+ * Base Kernel Implementation
+ *
+ * Provides core kernel functionality with state management.
+ */
+export declare class BaseKernel implements Kernel {
+    readonly language: Language;
+    readonly displayName: string;
+    private id;
+    private state;
+    private kernelState;
+    private exports;
+    private compiler;
+    private runtime;
+    private permissions;
+    private limits;
+    private env;
+    private cwd?;
+    private stats;
+    private permissionChecker;
+    constructor(options: KernelOptions);
+    /**
+     * Get kernel ID
+     */
+    getId(): string;
+    /**
+     * Get current execution state
+     */
+    getExecutionState(): KernelState;
+    /**
+     * Get kernel state (variables)
+     */
+    getState(): Map<string, unknown>;
+    /**
+     * Get exports
+     */
+    getExports(): Map<string, unknown>;
+    /**
+     * Get statistics
+     */
+    getStats(): KernelStats;
+    /**
+     * Start the kernel
+     */
+    start(): Promise<void>;
+    /**
+     * Check if kernel is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get display name
+     */
+    getDisplayName(): string;
+    /**
+     * Get language
+     */
+    getLanguage(): Language;
+    /**
+     * Execute code
+     */
+    execute(code: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /**
+     * Complete code at position (autocomplete)
+     */
+    complete(code: string, position: number): Promise<CompletionResult>;
+    /**
+     * Inspect object at position
+     */
+    inspect(code: string, position: number): Promise<InspectResult>;
+    /**
+     * Restart kernel (clear state)
+     */
+    restart(): Promise<void>;
+    /**
+     * Shutdown kernel
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Interrupt current execution
+     */
+    interrupt(): void;
+    /**
+     * Set environment variable
+     */
+    setEnv(key: string, value: string): void;
+    /**
+     * Get environment variable
+     */
+    getEnv(key: string): string | undefined;
+    /**
+     * Update permissions
+     */
+    setPermissions(permissions: Permissions): void;
+    /**
+     * Update limits
+     */
+    setLimits(limits: Limits): void;
+    /**
+     * Create error result
+     */
+    private createErrorResult;
+    /**
+     * Update statistics
+     */
+    private updateStats;
+}
+/**
+ * Kernel Manager
+ *
+ * Manages multiple kernels across languages.
+ */
+export declare class KernelManager {
+    private kernels;
+    private languageKernels;
+    /**
+     * Create and register a kernel
+     */
+    createKernel(options: KernelOptions): Promise<BaseKernel>;
+    /**
+     * Get kernel by ID
+     */
+    getKernel(id: string): BaseKernel | undefined;
+    /**
+     * Get kernels by language
+     */
+    getKernelsByLanguage(language: Language): BaseKernel[];
+    /**
+     * Get all kernels
+     */
+    getAllKernels(): BaseKernel[];
+    /**
+     * Shutdown a kernel
+     */
+    shutdownKernel(id: string): Promise<void>;
+    /**
+     * Shutdown all kernels
+     */
+    shutdownAll(): Promise<void>;
+    /**
+     * Get kernel count
+     */
+    get count(): number;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/session/kernel.d.ts.map

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