@ebowwa/sandbox 0.1.1

package/dist/multi/polyglot.js

@@ -0,0 +1,319 @@
+/**
+ * Polyglot Primitive
+ *
+ * Execute code across multiple languages with shared state.
+ * Enables true multi-language programming with seamless data exchange.
+ */
+import { BaseKernel, KernelManager } from "../session/kernel.js";
+import { CellRegistry } from "../core/cell.js";
+import { v4 as uuid } from "uuid";
+/**
+ * Built-in language bridges
+ */
+const BUILTIN_BRIDGES = {
+    // JSON is universal
+    "javascript:python": createJsonBridge("javascript", "python"),
+    "python:javascript": createJsonBridge("python", "javascript"),
+    "javascript:typescript": createJsonBridge("javascript", "typescript"),
+    "typescript:javascript": createJsonBridge("typescript", "javascript"),
+    "python:typescript": createJsonBridge("python", "typescript"),
+    "typescript:python": createJsonBridge("typescript", "python"),
+};
+/**
+ * Create JSON-based language bridge
+ */
+function createJsonBridge(from, to) {
+    return {
+        from,
+        to,
+        serialize(value) {
+            return new TextEncoder().encode(JSON.stringify(value));
+        },
+        deserialize(bytes) {
+            return JSON.parse(new TextDecoder().decode(bytes));
+        },
+        canBridge(type) {
+            // JSON can bridge most primitive and composite types
+            return ["number", "string", "boolean", "object", "array"].includes(type);
+        },
+    };
+}
+/**
+ * Polyglot Session
+ *
+ * Manages multi-language execution with variable sharing.
+ */
+export class PolyglotSession {
+    kernelManager;
+    kernelFactory;
+    kernels = new Map();
+    bridges;
+    sharedState = new Map();
+    variableBindings = new Map();
+    permissions;
+    limits;
+    constructor(options = {}) {
+        this.kernelManager = options.kernelManager ?? new KernelManager();
+        this.kernelFactory = options.kernelFactory;
+        this.permissions = options.permissions ?? {};
+        this.limits = options.limits ?? {};
+        this.bridges = new Map(Object.entries(BUILTIN_BRIDGES));
+    }
+    /**
+     * Execute code in a language
+     */
+    async execute(code, language, options) {
+        const kernel = await this.getKernel(language);
+        // Import variables from other languages
+        if (options?.imports) {
+            const importCode = await this.generateImportCode(language, options.imports);
+            code = importCode + "\n" + code;
+        }
+        const result = await kernel.execute(code);
+        // Capture exports to shared state
+        if (result.success && result.exports) {
+            for (const [name, value] of result.exports) {
+                this.sharedState.set(`${language}:${name}`, value);
+            }
+        }
+        return result;
+    }
+    /**
+     * Execute polyglot cell (multiple language variants)
+     */
+    async executePolyglot(cell, preferredLanguage) {
+        // Try preferred language first
+        const langOrder = preferredLanguage
+            ? [preferredLanguage, ...cell.variants.keys()].filter((v, i, a) => a.indexOf(v) === i)
+            : Array.from(cell.variants.keys());
+        for (const language of langOrder) {
+            const code = cell.variants.get(language);
+            if (!code)
+                continue;
+            try {
+                const kernel = await this.getKernel(language);
+                if (!kernel.isRunning()) {
+                    await kernel.start();
+                }
+                const result = await kernel.execute(code);
+                return { language, result };
+            }
+            catch (error) {
+                // Try next language
+                continue;
+            }
+        }
+        throw new Error("No available language for polyglot cell");
+    }
+    /**
+     * Get or create kernel for language
+     */
+    async getKernel(language) {
+        let kernel = this.kernels.get(language);
+        if (!kernel) {
+            if (this.kernelFactory) {
+                kernel = await this.kernelFactory(language);
+            }
+            else {
+                throw new Error(`No kernel available for language: ${language}`);
+            }
+            this.kernels.set(language, kernel);
+        }
+        return kernel;
+    }
+    /**
+     * Generate import code for a language
+     */
+    async generateImportCode(targetLanguage, imports) {
+        const lines = [];
+        for (const [name, sourceLanguage] of imports) {
+            const value = this.sharedState.get(`${sourceLanguage}:${name}`);
+            if (value === undefined)
+                continue;
+            const bridge = this.getBridge(sourceLanguage, targetLanguage);
+            if (!bridge) {
+                throw new Error(`No bridge from ${sourceLanguage} to ${targetLanguage}`);
+            }
+            const serialized = bridge.serialize(value);
+            const deserialized = bridge.deserialize(serialized);
+            // Generate language-specific import
+            const importLine = this.generateVariableAssignment(targetLanguage, name, deserialized);
+            lines.push(importLine);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Generate variable assignment in target language
+     */
+    generateVariableAssignment(language, name, value) {
+        const json = JSON.stringify(value);
+        switch (language) {
+            case "javascript":
+            case "typescript":
+                return `const ${name} = ${json};`;
+            case "python":
+                return `${name} = ${json}`;
+            case "assemblyscript":
+                return `const ${name} = ${json};`;
+            case "json":
+                return json;
+            default:
+                return `// ${name} = ${json}`;
+        }
+    }
+    /**
+     * Get bridge between languages
+     */
+    getBridge(from, to) {
+        return this.bridges.get(`${from}:${to}`);
+    }
+    /**
+     * Register custom bridge
+     */
+    registerBridge(bridge) {
+        this.bridges.set(`${bridge.from}:${bridge.to}`, bridge);
+    }
+    /**
+     * Set shared variable
+     */
+    setVariable(language, name, value) {
+        this.sharedState.set(`${language}:${name}`, value);
+    }
+    /**
+     * Get shared variable
+     */
+    getVariable(language, name) {
+        return this.sharedState.get(`${language}:${name}`);
+    }
+    /**
+     * Transfer variable between languages
+     */
+    async transferVariable(fromLanguage, name, toLanguage) {
+        const value = this.sharedState.get(`${fromLanguage}:${name}`);
+        if (value === undefined) {
+            throw new Error(`Variable ${name} not found in ${fromLanguage}`);
+        }
+        const bridge = this.getBridge(fromLanguage, toLanguage);
+        if (!bridge) {
+            throw new Error(`No bridge from ${fromLanguage} to ${toLanguage}`);
+        }
+        const serialized = bridge.serialize(value);
+        const transferred = bridge.deserialize(serialized);
+        // Store in target language
+        this.sharedState.set(`${toLanguage}:${name}`, transferred);
+        return transferred;
+    }
+    /**
+     * Get all shared variables
+     */
+    getSharedVariables() {
+        return new Map(this.sharedState);
+    }
+    /**
+     * Clear shared state
+     */
+    clearState() {
+        this.sharedState.clear();
+        this.variableBindings.clear();
+    }
+    /**
+     * Shutdown all kernels
+     */
+    async shutdown() {
+        for (const kernel of this.kernels.values()) {
+            await kernel.shutdown();
+        }
+        this.kernels.clear();
+    }
+}
+/**
+ * Polyglot Notebook
+ *
+ * Notebook with multi-language cells and variable sharing.
+ */
+export class PolyglotNotebook {
+    cells = new Map();
+    session;
+    executionOrder = [];
+    constructor(options) {
+        this.session = new PolyglotSession(options);
+    }
+    /**
+     * Add polyglot cell
+     */
+    addCell(variants, id) {
+        const cell = {
+            id: id ?? uuid(),
+            variants,
+        };
+        this.cells.set(cell.id, cell);
+        this.executionOrder.push(cell.id);
+        return cell;
+    }
+    /**
+     * Add single-language cell
+     */
+    addSingleCell(language, code, id) {
+        const variants = new Map();
+        variants.set(language, code);
+        return this.addCell(variants, id);
+    }
+    /**
+     * Execute all cells
+     */
+    async runAll() {
+        const results = [];
+        for (const cellId of this.executionOrder) {
+            const cell = this.cells.get(cellId);
+            if (!cell)
+                continue;
+            const { language, result } = await this.session.executePolyglot(cell);
+            results.push({ cellId, language, result });
+            if (!result.success) {
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute single cell
+     */
+    async runCell(cellId, preferredLanguage) {
+        const cell = this.cells.get(cellId);
+        if (!cell) {
+            throw new Error(`Cell not found: ${cellId}`);
+        }
+        return this.session.executePolyglot(cell, preferredLanguage);
+    }
+    /**
+     * Get cell
+     */
+    getCell(id) {
+        return this.cells.get(id);
+    }
+    /**
+     * Get all cells
+     */
+    getCells() {
+        return this.executionOrder.map(id => this.cells.get(id)).filter(Boolean);
+    }
+    /**
+     * Get session
+     */
+    getSession() {
+        return this.session;
+    }
+}
+/**
+ * Create polyglot session
+ */
+export function createPolyglotSession(options) {
+    return new PolyglotSession(options);
+}
+/**
+ * Create polyglot notebook
+ */
+export function createPolyglotNotebook(options) {
+    return new PolyglotNotebook(options);
+}
+//# sourceMappingURL=polyglot.js.map

package/dist/multi/polyglot.js.map

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

package/dist/runtimes/docker.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Docker Runtime
+ *
+ * Runs code in Docker containers for maximum isolation.
+ * Provides full filesystem and network control with container-level security.
+ *
+ * Isolation level: 'container'
+ */
+import type { ExecutionResult } from "../core/types.js";
+import type { IRuntime, RuntimeOptions, ExecutionRequest, RuntimeCapabilities } from "../core/runtime.js";
+/** Docker runtime configuration */
+export interface DockerRuntimeConfig {
+    /** Default Docker image to use */
+    defaultImage?: string;
+    /** Docker socket path */
+    dockerSocket?: string;
+    /** Network mode for containers */
+    networkMode?: "none" | "bridge" | "host";
+    /** Cleanup containers after execution */
+    autoCleanup?: boolean;
+    /** Memory limit for containers (bytes) */
+    defaultMemory?: number;
+    /** CPU limit (number of CPUs) */
+    cpuLimit?: number;
+}
+/** Container execution options */
+export interface ContainerOptions {
+    /** Docker image to use */
+    image?: string;
+    /** Container name */
+    name?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Working directory in container */
+    workdir?: string;
+    /** Mount points */
+    mounts?: Array<{
+        source: string;
+        target: string;
+        readonly?: boolean;
+    }>;
+    /** Port mappings */
+    ports?: Array<{
+        hostPort: number;
+        containerPort: number;
+        protocol?: "tcp" | "udp";
+    }>;
+    /** Network mode */
+    network?: "none" | "bridge" | "host";
+}
+/**
+ * Docker Runtime
+ *
+ * Executes code in isolated Docker containers with full resource control.
+ * Maximum isolation with configurable filesystem and network access.
+ */
+export declare class DockerRuntime implements IRuntime {
+    readonly name = "docker";
+    readonly capabilities: RuntimeCapabilities;
+    private executing;
+    private config;
+    private containers;
+    constructor(config?: DockerRuntimeConfig);
+    init(): Promise<void>;
+    isAvailable(): Promise<boolean>;
+    execute(request: ExecutionRequest, options: RuntimeOptions): Promise<ExecutionResult>;
+    terminate(): Promise<void>;
+    isExecuting(): boolean;
+    /**
+     * Check if Docker is available
+     */
+    private checkDockerAvailable;
+    /**
+     * Pull Docker image if not present
+     */
+    private pullImageIfNeeded;
+    /**
+     * Build container options from execution request
+     */
+    private buildContainerOptions;
+    /**
+     * Create Docker container
+     */
+    private createContainer;
+    /**
+     * Run code in container
+     */
+    private runInContainer;
+    /**
+     * Remove container
+     */
+    private removeContainer;
+    private createErrorResult;
+    private parseMemory;
+    private parseTimeout;
+}
+//# sourceMappingURL=docker.d.ts.map

package/dist/runtimes/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/runtimes/docker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;KAC1B,CAAC,CAAC;IACH,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAQxC;IAEF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAA6B;gBAEnC,MAAM,GAAE,mBAAwB;IAWtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CACX,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IA4FrB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,WAAW,IAAI,OAAO;IAItB;;OAEG;YACW,oBAAoB;IAQlC;;OAEG;YACW,iBAAiB;IAoB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;YACW,eAAe;IA8E7B;;OAEG;YACW,cAAc;IAqE5B;;OAEG;YACW,eAAe;IAa7B,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,YAAY;CAWrB"}