@ebowwa/sandbox 0.1.1

package/dist/core/types.d.ts

@@ -0,0 +1,380 @@
+/**
+ * Core Types for @ebowwa/sandbox
+ *
+ * Composable primitives for multi-language sandboxed execution.
+ * Each type is designed to be independently usable.
+ */
+/** Supported input languages/formats */
+export type Language = "wasm" | "javascript" | "typescript" | "assemblyscript" | "python" | "json" | "markdown" | "custom";
+/** Language capability flags */
+export interface LanguageCapabilities {
+    supportsREPL: boolean;
+    supportsState: boolean;
+    requiresCompilation: boolean;
+    hasGarbageCollection: boolean;
+    canImportModules: boolean;
+    canAccessFS: boolean;
+    canAccessNetwork: boolean;
+}
+/** Permission level - escalating access */
+export type PermissionLevel = "isolated" | "readonly" | "network" | "filesystem" | "admin" | "sudo";
+/** Individual permission flags - composable */
+export interface Permissions {
+    fs?: FileSystemPermission;
+    network?: NetworkPermission;
+    env?: EnvironmentPermission;
+    process?: ProcessPermission;
+    memory?: {
+        maxBytes?: number;
+    };
+    cpu?: CpuPermission;
+}
+/** Filesystem permission */
+export interface FileSystemPermission {
+    read?: boolean;
+    write?: boolean;
+    delete?: boolean;
+    allowedPaths?: string[];
+    deniedPaths?: string[];
+}
+/** Network permission */
+export interface NetworkPermission {
+    outbound?: boolean;
+    inbound?: boolean;
+    allowedHosts?: string[];
+    deniedHosts?: string[];
+}
+/** Environment permission */
+export interface EnvironmentPermission {
+    read?: boolean;
+    write?: boolean;
+    allowedKeys?: string[];
+}
+/** Process permission */
+export interface ProcessPermission {
+    spawn?: boolean;
+    allowedCommands?: string[];
+}
+/** CPU permission */
+export interface CpuPermission {
+    maxPercent?: number;
+    maxTimeMs?: number;
+}
+/** Convert permission level to permissions object */
+export declare function permissionsFromLevel(level: PermissionLevel): Permissions;
+/** Resource limits for execution */
+export interface Limits {
+    /** Memory limit (bytes or string like "64MB") */
+    memory?: number | string;
+    /** Execution timeout (ms or string like "5s") */
+    timeout?: number | string;
+    /** CPU time limit (ms) */
+    cpuTime?: number;
+    /** Max WASM instructions (gas/fuel) */
+    maxInstructions?: number;
+    /** Max output size (bytes) */
+    maxOutputSize?: number;
+    /** Max call stack depth */
+    maxStackDepth?: number;
+    /** Network bandwidth limits */
+    network?: {
+        maxBandwidth?: string;
+        maxConnections?: number;
+    };
+    /** Filesystem limits */
+    filesystem?: {
+        maxFileSize?: string;
+        maxTotalSize?: string;
+        maxOpenFiles?: number;
+    };
+}
+/** Parse memory string to bytes */
+export declare function parseMemory(mem: number | string | undefined): number;
+/** Parse time string to milliseconds */
+export declare function parseTime(time: number | string | undefined): number;
+/** Code cell for notebook/repl execution */
+export interface Cell {
+    id: string;
+    language: Language;
+    source: string;
+    metadata?: Record<string, unknown>;
+}
+/** Result from another cell (for imports) */
+export interface CellResult {
+    success: boolean;
+    value?: unknown;
+    error?: {
+        message: string;
+        type: string;
+    };
+    exports?: Map<string, unknown>;
+}
+/** Execution context passed to runtimes */
+export interface ExecutionContext {
+    cellId: string;
+    permissions: Permissions;
+    limits: Limits;
+    environment: Record<string, string>;
+    workingDirectory?: string;
+    /** Shared state from previous cells */
+    state?: Map<string, unknown>;
+    /** Imports from other cells */
+    imports?: Map<string, CellResult>;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/** Execution options */
+export interface ExecutionOptions {
+    entrypoint?: string;
+    args?: unknown[];
+    input?: unknown;
+    timeout?: number;
+    signal?: AbortSignal;
+    /** Pass state from previous execution */
+    state?: Map<string, unknown>;
+}
+/** Result of cell/execution */
+export interface ExecutionResult<T = unknown> {
+    /** Execution succeeded */
+    success: boolean;
+    /** Return value */
+    value?: T;
+    /** Error if failed */
+    error?: ExecutionError;
+    /** Execution metrics */
+    metrics: ExecutionMetrics;
+    /** Captured output */
+    output: {
+        stdout: string[];
+        stderr: string[];
+        displays: DisplayOutput[];
+    };
+    /** State to pass to next cells */
+    state?: Map<string, unknown>;
+    /** Exports for other cells to import */
+    exports?: Map<string, unknown>;
+}
+/** Error during execution */
+export interface ExecutionError {
+    message: string;
+    stack?: string;
+    type: "compile" | "runtime" | "permission" | "limit" | "timeout" | "cancel";
+    language?: Language;
+    line?: number;
+    column?: number;
+}
+/** Execution metrics */
+export interface ExecutionMetrics {
+    /** Wall clock time in ms */
+    duration: number;
+    /** Memory used in bytes */
+    memoryUsed: number;
+    /** CPU time in ms */
+    cpuTime?: number;
+    /** WASM instructions executed */
+    instructionsExecuted?: number;
+    /** Bytes received over network */
+    networkIn?: number;
+    /** Bytes sent over network */
+    networkOut?: number;
+}
+/** Rich display output (Jupyter-style) */
+export interface DisplayOutput {
+    type: "text" | "html" | "image" | "json" | "markdown" | "javascript";
+    data: string | Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/** Compiler: Language → WASM */
+export interface Compiler {
+    /** Language this compiler handles */
+    language: Language;
+    /** Check if code is valid for this language */
+    validate(code: string): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /** Compile source to WASM bytes */
+    compile(code: string, options: CompileOptions): Promise<Uint8Array>;
+    /** Check if compiler is available */
+    isAvailable(): Promise<boolean>;
+}
+/** Compilation options */
+export interface CompileOptions {
+    permissions: Permissions;
+    limits: Limits;
+    optimize?: boolean;
+    /** Additional compiler-specific options */
+    extra?: Record<string, unknown>;
+}
+/** Runtime: WASM → Execution */
+export interface Runtime {
+    /** Runtime name */
+    name: string;
+    /** Initialize runtime */
+    init(): Promise<void>;
+    /** Check if runtime is available */
+    isAvailable(): Promise<boolean>;
+    /** Execute WASM bytes */
+    execute(wasmBytes: Uint8Array, options: ExecutionOptions, context: ExecutionContext): Promise<ExecutionResult>;
+    /** Terminate runtime and cleanup */
+    terminate(): Promise<void>;
+}
+/** Kernel: Language-specific execution session */
+export interface Kernel {
+    /** Language this kernel handles */
+    language: Language;
+    /** Kernel display name */
+    displayName: string;
+    /** Initialize kernel */
+    start(): Promise<void>;
+    /** Check if kernel is running */
+    isRunning(): boolean;
+    /** Execute code in kernel */
+    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>;
+    /** Get current kernel state */
+    getState(): Map<string, unknown>;
+    /** Restart kernel (clear state) */
+    restart(): Promise<void>;
+    /** Shutdown kernel */
+    shutdown(): Promise<void>;
+}
+/** Autocomplete result */
+export interface CompletionResult {
+    matches: string[];
+    cursorStart: number;
+    cursorEnd: number;
+    metadata?: Record<string, unknown>;
+}
+/** Inspect result (hover/tooltip) */
+export interface InspectResult {
+    found: boolean;
+    details?: {
+        type: string;
+        documentation?: string;
+        signature?: string;
+    };
+}
+/** Notebook: Multi-cell, multi-language document */
+export interface Notebook {
+    id: string;
+    cells: Cell[];
+    metadata: NotebookMetadata;
+    /** Execute cells in order */
+    runAll(options?: NotebookRunOptions): Promise<NotebookResult[]>;
+    /** Execute single cell */
+    runCell(cellId: string, options?: ExecutionOptions): Promise<NotebookResult>;
+    /** Execute cells from index */
+    runFrom(startIndex: number): Promise<NotebookResult[]>;
+    /** Add cell */
+    addCell(cell: Omit<Cell, "id">): Cell;
+    /** Remove cell */
+    removeCell(cellId: string): void;
+    /** Move cell */
+    moveCell(cellId: string, newIndex: number): void;
+    /** Get cell by id */
+    getCell(cellId: string): Cell | undefined;
+    /** Export to format */
+    export(format: "ipynb" | "json" | "markdown"): string;
+}
+/** Notebook metadata */
+export interface NotebookMetadata {
+    name: string;
+    language?: Language;
+    kernelspec?: {
+        name: string;
+        display_name: string;
+        language: string;
+    };
+    created: Date;
+    modified: Date;
+    tags?: string[];
+}
+/** Notebook run options */
+export interface NotebookRunOptions {
+    /** Stop on first error */
+    stopOnError?: boolean;
+    /** Parallel execution where possible */
+    parallel?: boolean;
+    /** Continue from last successful cell */
+    continueFrom?: string;
+}
+/** Result of notebook cell execution */
+export interface NotebookResult {
+    cellId: string;
+    executionCount: number;
+    result: ExecutionResult;
+    timestamp: Date;
+}
+/** Session: Stateful execution context */
+export interface Session {
+    id: string;
+    /** Get active kernel for language */
+    getKernel(language: Language): Kernel | undefined;
+    /** Start a kernel for language */
+    startKernel(language: Language): Promise<Kernel>;
+    /** Execute code (auto-selects kernel) */
+    execute(code: string, language: Language, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /** Get shared state across all kernels */
+    getSharedState(): Map<string, unknown>;
+    /** Set shared state */
+    setSharedState(key: string, value: unknown): void;
+    /** Register language compiler */
+    registerCompiler(compiler: Compiler): void;
+    /** Register runtime */
+    registerRuntime(runtime: Runtime): void;
+    /** Shutdown session */
+    shutdown(): Promise<void>;
+}
+/** Polyglot cell - code that can run in multiple languages */
+export interface PolyglotCell {
+    id: string;
+    variants: Map<Language, string>;
+    preferredLanguage?: Language;
+}
+/** Bridge for passing data between languages */
+export interface LanguageBridge {
+    from: Language;
+    to: Language;
+    /** Serialize value from source language */
+    serialize(value: unknown): Uint8Array;
+    /** Deserialize value in target language */
+    deserialize(bytes: Uint8Array): unknown;
+    /** Can these types be bridged? */
+    canBridge(type: string): boolean;
+}
+/** Main Sandbox interface - combines all primitives */
+export interface Sandbox {
+    /** Create a session for interactive use */
+    createSession(options?: SessionOptions): Session;
+    /** Create a notebook */
+    createNotebook(options?: NotebookOptions): Notebook;
+    /** Quick execute (isolated, no state) */
+    execute(code: string, language: Language, options?: SandboxOptions): Promise<ExecutionResult>;
+    /** Quick execute with preset */
+    quick(code: string, preset?: "isolated" | "trusted" | "admin"): Promise<ExecutionResult>;
+}
+/** Sandbox configuration */
+export interface SandboxOptions {
+    permissions?: PermissionLevel | Permissions;
+    limits?: Limits;
+    language?: Language;
+    environment?: Record<string, string>;
+    workingDirectory?: string;
+}
+/** Session options */
+export interface SessionOptions extends SandboxOptions {
+    /** Languages to pre-warm kernels for */
+    languages?: Language[];
+    /** Enable shared memory between kernels */
+    sharedMemory?: boolean;
+}
+/** Notebook options */
+export interface NotebookOptions extends SandboxOptions {
+    name?: string;
+    defaultLanguage?: Language;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,67 @@
+/**
+ * Core Types for @ebowwa/sandbox
+ *
+ * Composable primitives for multi-language sandboxed execution.
+ * Each type is designed to be independently usable.
+ */
+/** Convert permission level to permissions object */
+export function permissionsFromLevel(level) {
+    switch (level) {
+        case "isolated":
+            return {};
+        case "readonly":
+            return { fs: { read: true } };
+        case "network":
+            return { fs: { read: true }, network: { outbound: true } };
+        case "filesystem":
+            return {
+                fs: { read: true, write: true, delete: true },
+                network: { outbound: true, inbound: true }
+            };
+        case "admin":
+            return {
+                fs: { read: true, write: true, delete: true },
+                network: { outbound: true, inbound: true },
+                env: { read: true, write: true },
+                process: { spawn: true }
+            };
+        case "sudo":
+            return {
+                fs: { read: true, write: true, delete: true },
+                network: { outbound: true, inbound: true },
+                env: { read: true, write: true },
+                process: { spawn: true }
+            };
+    }
+}
+/** Parse memory string to bytes */
+export function parseMemory(mem) {
+    if (mem === undefined)
+        return 16 * 1024 * 1024; // 16MB default
+    if (typeof mem === "number")
+        return mem;
+    const match = mem.match(/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb)?$/i);
+    if (!match)
+        return 16 * 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));
+}
+/** Parse time string to milliseconds */
+export function parseTime(time) {
+    if (time === undefined)
+        return 30000; // 30s default
+    if (typeof time === "number")
+        return time;
+    const match = time.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h)?$/i);
+    if (!match)
+        return 30000;
+    const [, num, unit] = match;
+    const multipliers = {
+        ms: 1, s: 1000, m: 60000, h: 3600000
+    };
+    return Math.floor(parseFloat(num) * (multipliers[unit?.toLowerCase() ?? "ms"] ?? 1));
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @ebowwa/sandbox
+ *
+ * Composable sandbox primitives for multi-language code execution.
+ * Jupyter/REPL-style with Python+Rust+JS+TS+WASM support.
+ *
+ * @example
+ * ```typescript
+ * import { Sandbox, createNotebook, createREPL } from "@ebowwa/sandbox";
+ *
+ * // Quick execution
+ * const sandbox = new Sandbox();
+ * const result = await sandbox.execute("console.log('Hello')", "javascript");
+ *
+ * // Notebook
+ * const notebook = createNotebook({ name: "My Notebook" });
+ * notebook.addCell({ language: "javascript", source: "const x = 42" });
+ * notebook.runAll();
+ *
+ * // REPL
+ * const repl = createREPL({ language: "python" });
+ * repl.start();
+ * ```
+ */
+export type { Language, LanguageCapabilities, PermissionLevel, Permissions, Limits, Cell, ExecutionResult, ExecutionOptions, ExecutionContext, ExecutionError, ExecutionMetrics, DisplayOutput, NotebookMetadata, NotebookRunOptions, NotebookResult, PolyglotCell, LanguageBridge, Sandbox as SandboxInterface, SandboxOptions, SessionOptions, NotebookOptions, Session, Notebook, Kernel, Compiler, Runtime, } from "./core/types.js";
+export { permissionsFromLevel, parseMemory, parseTime, } from "./core/types.js";
+export type { CompileResult, ImportDefinition, CompilerOptions, ICompiler, } from "./core/compiler.js";
+export { BaseCompiler, WasmCompiler, CompilerRegistry, defaultCompilerRegistry, } from "./core/compiler.js";
+export type { RuntimeOptions, ExecutionRequest, IRuntime, RuntimeCapabilities, } from "./core/runtime.js";
+export { Wasm2WasmRuntime, NativeWasmRuntime, RuntimeRegistry, defaultRuntimeRegistry, } from "./core/runtime.js";
+export type { ProcessRuntimeConfig, DockerRuntimeConfig, ContainerOptions, } from "./runtimes/index.js";
+export { ProcessRuntime, DockerRuntime, } from "./runtimes/index.js";
+export { PermissionChecker, PermissionBuilder, createPermissions, mergePermissions, impliesPermission, upgradePermissions, } from "./core/permissions.js";
+export type { ParsedLimits } from "./core/limits.js";
+export { DEFAULT_LIMITS, LimitsParser, LimitsEnforcer, LimitsBuilder, mergeLimits, } from "./core/limits.js";
+export type { CellMetadata, CellState, ExecutableCell, } from "./core/cell.js";
+export { CellBuilder, CellExecutor, CellRegistry, createCell, createCellsFromMarkdown, cellsToMarkdown, } from "./core/cell.js";
+export type { KernelState, KernelOptions, KernelStats, NotebookState, NotebookEvents, REPLOptions, REPLHistoryEntry, REPLState, } from "./session/index.js";
+export { BaseKernel, KernelManager, BaseNotebook, createNotebook, BaseREPL, createREPL, } from "./session/index.js";
+export type { PolyglotOptions, VariableBinding, PolyglotContext, } from "./multi/index.js";
+export { PolyglotSession, PolyglotNotebook, createPolyglotSession, createPolyglotNotebook, } from "./multi/index.js";
+import type { Language, Permissions, Limits, ExecutionResult, ExecutionOptions, SandboxOptions, SessionOptions, NotebookOptions as NotebookOpts } from "./core/types.js";
+import { BaseKernel, KernelManager } from "./session/kernel.js";
+import { BaseNotebook } from "./session/notebook.js";
+import { BaseREPL } from "./session/repl.js";
+import { PolyglotSession } from "./multi/polyglot.js";
+/**
+ * Sandbox Implementation
+ *
+ * Main entry point for sandboxed execution.
+ */
+export declare class Sandbox {
+    private defaultOptions?;
+    private kernelManager;
+    constructor(defaultOptions?: SandboxOptions | undefined);
+    /**
+     * Quick execute (isolated, no state)
+     */
+    execute(code: string, language?: Language, options?: SandboxOptions): Promise<ExecutionResult>;
+    /**
+     * Quick execute with preset
+     */
+    quick(code: string, preset?: "isolated" | "trusted" | "admin"): Promise<ExecutionResult>;
+    /**
+     * Create a session for interactive use
+     */
+    createSession(options?: SessionOptions): SandboxSession;
+    /**
+     * Create a notebook
+     */
+    createNotebook(options?: NotebookOpts): BaseNotebook;
+    /**
+     * Create a REPL
+     */
+    createREPL(options?: SessionOptions & {
+        language?: Language;
+    }): BaseREPL;
+    /**
+     * Create polyglot session
+     */
+    createPolyglot(options?: {
+        permissions?: Permissions;
+        limits?: Limits;
+    }): PolyglotSession;
+    /**
+     * Merge options with defaults
+     */
+    private mergeOptions;
+}
+/**
+ * Sandbox Session
+ *
+ * Stateful execution context.
+ */
+export declare class SandboxSession {
+    readonly id: string;
+    private kernelManager;
+    private kernels;
+    private sharedState;
+    private options;
+    constructor(kernelManager: KernelManager, options: {
+        permissions: Permissions;
+        limits: Limits;
+        environment: Record<string, string>;
+        workingDirectory: string;
+        sharedMemory: boolean;
+    });
+    /**
+     * Get kernel for language
+     */
+    getKernel(language: Language): BaseKernel | undefined;
+    /**
+     * Start kernel for language
+     */
+    startKernel(language: Language): Promise<BaseKernel>;
+    /**
+     * Execute code
+     */
+    execute(code: string, language: Language, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /**
+     * Get shared state
+     */
+    getSharedState(): Map<string, unknown>;
+    /**
+     * Set shared state
+     */
+    setSharedState(key: string, value: unknown): void;
+    /**
+     * Shutdown session
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create default sandbox instance
+ */
+export declare const sandbox: Sandbox;
+/**
+ * Quick execute helper
+ */
+export declare function execute(code: string, language?: Language, options?: SandboxOptions): Promise<ExecutionResult>;
+/**
+ * Quick execute with preset helper
+ */
+export declare function quick(code: string, preset?: "isolated" | "trusted" | "admin"): Promise<ExecutionResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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