@ebowwa/sandbox 0.1.1

package/dist/index.js

@@ -0,0 +1,279 @@
+/**
+ * @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();
+ * ```
+ */
+// Type utilities
+export { permissionsFromLevel, parseMemory, parseTime, } from "./core/types.js";
+export { BaseCompiler, WasmCompiler, CompilerRegistry, defaultCompilerRegistry, } from "./core/compiler.js";
+export { Wasm2WasmRuntime, NativeWasmRuntime, RuntimeRegistry, defaultRuntimeRegistry, } from "./core/runtime.js";
+export { ProcessRuntime, DockerRuntime, } from "./runtimes/index.js";
+// Permission exports
+export { PermissionChecker, PermissionBuilder, createPermissions, mergePermissions, impliesPermission, upgradePermissions, } from "./core/permissions.js";
+export { DEFAULT_LIMITS, LimitsParser, LimitsEnforcer, LimitsBuilder, mergeLimits, } from "./core/limits.js";
+export { CellBuilder, CellExecutor, CellRegistry, createCell, createCellsFromMarkdown, cellsToMarkdown, } from "./core/cell.js";
+export { BaseKernel, KernelManager, BaseNotebook, createNotebook, BaseREPL, createREPL, } from "./session/index.js";
+export { PolyglotSession, PolyglotNotebook, createPolyglotSession, createPolyglotNotebook, } from "./multi/index.js";
+import { BaseKernel, KernelManager } from "./session/kernel.js";
+import { BaseNotebook, createNotebook } from "./session/notebook.js";
+import { BaseREPL, createREPL } from "./session/repl.js";
+import { PolyglotSession } from "./multi/polyglot.js";
+import { defaultCompilerRegistry } from "./core/compiler.js";
+import { defaultRuntimeRegistry } from "./core/runtime.js";
+import { createPermissions, permissionsFromLevel } from "./core/permissions.js";
+import { DEFAULT_LIMITS } from "./core/limits.js";
+import { ProcessRuntime } from "./runtimes/process.js";
+import { DockerRuntime } from "./runtimes/docker.js";
+// Register elevated permission runtimes
+defaultRuntimeRegistry.register(new ProcessRuntime());
+defaultRuntimeRegistry.register(new DockerRuntime());
+/**
+ * Normalize permissions to Permissions object
+ */
+function normalizePermissions(perms) {
+    if (!perms) {
+        return createPermissions("isolated");
+    }
+    if (typeof perms === "string") {
+        return permissionsFromLevel(perms);
+    }
+    return perms;
+}
+/**
+ * Sandbox Implementation
+ *
+ * Main entry point for sandboxed execution.
+ */
+export class Sandbox {
+    defaultOptions;
+    kernelManager = new KernelManager();
+    constructor(defaultOptions) {
+        this.defaultOptions = defaultOptions;
+    }
+    /**
+     * Quick execute (isolated, no state)
+     */
+    async execute(code, language = "javascript", options) {
+        const merged = this.mergeOptions(options);
+        const perms = normalizePermissions(merged.permissions);
+        // Get compiler and runtime
+        const compiler = defaultCompilerRegistry.get(language);
+        if (!compiler) {
+            throw new Error(`No compiler for language: ${language}`);
+        }
+        const runtime = defaultRuntimeRegistry.selectBest({
+            filesystem: perms.fs?.write,
+            network: perms.network?.outbound,
+        });
+        if (!runtime) {
+            throw new Error("No available runtime");
+        }
+        // Compile
+        const compiled = await compiler.compile(code, perms, merged.limits ?? {});
+        // Execute
+        return runtime.execute({ wasm: compiled }, {
+            permissions: perms,
+            limits: merged.limits ?? {},
+            env: merged.environment,
+            cwd: merged.workingDirectory,
+        });
+    }
+    /**
+     * Quick execute with preset
+     */
+    async quick(code, preset = "isolated") {
+        const levelMap = {
+            isolated: "isolated",
+            trusted: "filesystem",
+            admin: "admin",
+        };
+        const permissions = permissionsFromLevel(levelMap[preset]);
+        const limits = DEFAULT_LIMITS[preset];
+        return this.execute(code, "javascript", {
+            permissions,
+            limits: {
+                memory: limits.memoryBytes,
+                timeout: limits.timeoutMs,
+                cpuTime: limits.cpuTimeMs,
+                maxInstructions: limits.maxInstructions,
+                maxOutputSize: limits.maxOutputBytes,
+                maxStackDepth: limits.maxStackDepth,
+            },
+        });
+    }
+    /**
+     * Create a session for interactive use
+     */
+    createSession(options) {
+        const merged = this.mergeOptions(options);
+        return new SandboxSession(this.kernelManager, {
+            permissions: normalizePermissions(merged.permissions),
+            limits: merged.limits ?? {},
+            environment: merged.environment,
+            workingDirectory: merged.workingDirectory,
+            sharedMemory: options?.sharedMemory ?? false,
+        });
+    }
+    /**
+     * Create a notebook
+     */
+    createNotebook(options) {
+        const merged = this.mergeOptions(options);
+        return createNotebook({
+            name: options?.name,
+            defaultLanguage: options?.defaultLanguage,
+            permissions: normalizePermissions(merged.permissions),
+            limits: merged.limits,
+            kernelManager: this.kernelManager,
+        });
+    }
+    /**
+     * Create a REPL
+     */
+    createREPL(options) {
+        const merged = this.mergeOptions(options);
+        return createREPL({
+            language: options?.language,
+            permissions: normalizePermissions(merged.permissions),
+            limits: merged.limits,
+            kernelManager: this.kernelManager,
+        });
+    }
+    /**
+     * Create polyglot session
+     */
+    createPolyglot(options) {
+        const merged = this.mergeOptions(options);
+        return new PolyglotSession({
+            permissions: normalizePermissions(merged.permissions),
+            limits: merged.limits,
+            kernelManager: this.kernelManager,
+        });
+    }
+    /**
+     * Merge options with defaults
+     */
+    mergeOptions(options) {
+        const rawPerms = options?.permissions ?? this.defaultOptions?.permissions ?? "isolated";
+        return {
+            permissions: normalizePermissions(rawPerms),
+            limits: options?.limits ?? this.defaultOptions?.limits,
+            language: options?.language ?? this.defaultOptions?.language,
+            environment: options?.environment ?? this.defaultOptions?.environment ?? {},
+            workingDirectory: options?.workingDirectory ?? this.defaultOptions?.workingDirectory ?? process.cwd(),
+        };
+    }
+}
+/**
+ * Sandbox Session
+ *
+ * Stateful execution context.
+ */
+export class SandboxSession {
+    id;
+    kernelManager;
+    kernels = new Map();
+    sharedState = new Map();
+    options;
+    constructor(kernelManager, options) {
+        this.id = `session-${Date.now()}`;
+        this.kernelManager = kernelManager;
+        this.options = options;
+    }
+    /**
+     * Get kernel for language
+     */
+    getKernel(language) {
+        return this.kernels.get(language);
+    }
+    /**
+     * Start kernel for language
+     */
+    async startKernel(language) {
+        let kernel = this.kernels.get(language);
+        if (!kernel) {
+            const compiler = defaultCompilerRegistry.get(language);
+            const runtime = defaultRuntimeRegistry.selectBest({});
+            if (!compiler || !runtime) {
+                throw new Error(`Cannot create kernel for ${language}`);
+            }
+            const kernelOptions = {
+                language,
+                compiler,
+                runtime,
+                permissions: this.options.permissions,
+                limits: this.options.limits,
+                env: this.options.environment,
+                cwd: this.options.workingDirectory,
+            };
+            kernel = await this.kernelManager.createKernel(kernelOptions);
+            this.kernels.set(language, kernel);
+        }
+        return kernel;
+    }
+    /**
+     * Execute code
+     */
+    async execute(code, language, options) {
+        const kernel = await this.startKernel(language);
+        return kernel.execute(code, options);
+    }
+    /**
+     * Get shared state
+     */
+    getSharedState() {
+        return new Map(this.sharedState);
+    }
+    /**
+     * Set shared state
+     */
+    setSharedState(key, value) {
+        this.sharedState.set(key, value);
+    }
+    /**
+     * Shutdown session
+     */
+    async shutdown() {
+        for (const language of this.kernels.keys()) {
+            await this.kernelManager.shutdownKernel(this.kernels.get(language).getId());
+        }
+        this.kernels.clear();
+        this.sharedState.clear();
+    }
+}
+/**
+ * Create default sandbox instance
+ */
+export const sandbox = new Sandbox();
+/**
+ * Quick execute helper
+ */
+export async function execute(code, language = "javascript", options) {
+    return sandbox.execute(code, language, options);
+}
+/**
+ * Quick execute with preset helper
+ */
+export async function quick(code, preset = "isolated") {
+    return sandbox.quick(code, preset);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/multi/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Multi-Language Primitives
+ *
+ * Execute code across multiple languages with shared state.
+ */
+export type { PolyglotOptions, VariableBinding, PolyglotContext, } from "./polyglot.js";
+export { PolyglotSession, PolyglotNotebook, createPolyglotSession, createPolyglotNotebook, } from "./polyglot.js";
+export type { LanguageBridge } from "../core/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/multi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/multi/index.js

@@ -0,0 +1,7 @@
+/**
+ * Multi-Language Primitives
+ *
+ * Execute code across multiple languages with shared state.
+ */
+export { PolyglotSession, PolyglotNotebook, createPolyglotSession, createPolyglotNotebook, } from "./polyglot.js";
+//# sourceMappingURL=index.js.map

package/dist/multi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/multi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/multi/polyglot.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Polyglot Primitive
+ *
+ * Execute code across multiple languages with shared state.
+ * Enables true multi-language programming with seamless data exchange.
+ */
+import type { Language, ExecutionResult, Permissions, Limits, PolyglotCell, LanguageBridge } from "../core/types.js";
+import { BaseKernel, KernelManager } from "../session/kernel.js";
+/**
+ * Polyglot session options
+ */
+export interface PolyglotOptions {
+    /** Available languages */
+    languages?: Language[];
+    /** Permissions */
+    permissions?: Permissions;
+    /** Resource limits */
+    limits?: Limits;
+    /** Kernel manager */
+    kernelManager?: KernelManager;
+    /** Kernel factory */
+    kernelFactory?: (language: Language) => Promise<BaseKernel>;
+}
+/**
+ * Language variable binding
+ */
+export interface VariableBinding {
+    /** Variable name */
+    name: string;
+    /** Source language */
+    fromLanguage: Language;
+    /** Target language */
+    toLanguage: Language;
+    /** Serialized value */
+    serializedValue: Uint8Array;
+    /** Type information */
+    type?: string;
+}
+/**
+ * Polyglot execution context
+ */
+export interface PolyglotContext {
+    /** Current language */
+    language: Language;
+    /** Variables from other languages */
+    bindings: Map<string, VariableBinding>;
+    /** Shared state */
+    sharedState: Map<string, unknown>;
+    /** Kernel for current language */
+    kernel: BaseKernel;
+}
+/**
+ * Polyglot Session
+ *
+ * Manages multi-language execution with variable sharing.
+ */
+export declare class PolyglotSession {
+    private kernelManager;
+    private kernelFactory?;
+    private kernels;
+    private bridges;
+    private sharedState;
+    private variableBindings;
+    private permissions;
+    private limits;
+    constructor(options?: PolyglotOptions);
+    /**
+     * Execute code in a language
+     */
+    execute(code: string, language: Language, options?: {
+        imports?: Map<string, string>;
+    }): Promise<ExecutionResult>;
+    /**
+     * Execute polyglot cell (multiple language variants)
+     */
+    executePolyglot(cell: PolyglotCell, preferredLanguage?: Language): Promise<{
+        language: Language;
+        result: ExecutionResult;
+    }>;
+    /**
+     * Get or create kernel for language
+     */
+    private getKernel;
+    /**
+     * Generate import code for a language
+     */
+    private generateImportCode;
+    /**
+     * Generate variable assignment in target language
+     */
+    private generateVariableAssignment;
+    /**
+     * Get bridge between languages
+     */
+    getBridge(from: Language, to: Language): LanguageBridge | undefined;
+    /**
+     * Register custom bridge
+     */
+    registerBridge(bridge: LanguageBridge): void;
+    /**
+     * Set shared variable
+     */
+    setVariable(language: Language, name: string, value: unknown): void;
+    /**
+     * Get shared variable
+     */
+    getVariable(language: Language, name: string): unknown;
+    /**
+     * Transfer variable between languages
+     */
+    transferVariable(fromLanguage: Language, name: string, toLanguage: Language): Promise<unknown>;
+    /**
+     * Get all shared variables
+     */
+    getSharedVariables(): Map<string, unknown>;
+    /**
+     * Clear shared state
+     */
+    clearState(): void;
+    /**
+     * Shutdown all kernels
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Polyglot Notebook
+ *
+ * Notebook with multi-language cells and variable sharing.
+ */
+export declare class PolyglotNotebook {
+    private cells;
+    private session;
+    private executionOrder;
+    constructor(options?: PolyglotOptions);
+    /**
+     * Add polyglot cell
+     */
+    addCell(variants: Map<Language, string>, id?: string): PolyglotCell;
+    /**
+     * Add single-language cell
+     */
+    addSingleCell(language: Language, code: string, id?: string): PolyglotCell;
+    /**
+     * Execute all cells
+     */
+    runAll(): Promise<Array<{
+        cellId: string;
+        language: Language;
+        result: ExecutionResult;
+    }>>;
+    /**
+     * Execute single cell
+     */
+    runCell(cellId: string, preferredLanguage?: Language): Promise<{
+        language: Language;
+        result: ExecutionResult;
+    }>;
+    /**
+     * Get cell
+     */
+    getCell(id: string): PolyglotCell | undefined;
+    /**
+     * Get all cells
+     */
+    getCells(): PolyglotCell[];
+    /**
+     * Get session
+     */
+    getSession(): PolyglotSession;
+}
+/**
+ * Create polyglot session
+ */
+export declare function createPolyglotSession(options?: PolyglotOptions): PolyglotSession;
+/**
+ * Create polyglot notebook
+ */
+export declare function createPolyglotNotebook(options?: PolyglotOptions): PolyglotNotebook;
+//# sourceMappingURL=polyglot.d.ts.map

package/dist/multi/polyglot.d.ts.map

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