@ebowwa/sandbox 0.1.1

package/dist/session/repl.js

@@ -0,0 +1,409 @@
+/**
+ * REPL Primitive
+ *
+ * Interactive Read-Eval-Print-Loop for multi-language execution.
+ * Provides terminal-style interactive coding experience.
+ */
+import { BaseKernel, KernelManager } from "./kernel.js";
+import { createPermissions } from "../core/permissions.js";
+import { LimitsParser } from "../core/limits.js";
+import * as readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+/**
+ * Base REPL Implementation
+ */
+export class BaseREPL {
+    kernelManager;
+    kernelFactory;
+    kernels = new Map();
+    permissions;
+    limits;
+    prompt;
+    continuationPrompt;
+    welcomeMessage;
+    languages;
+    output;
+    input;
+    rl;
+    state;
+    constructor(options = {}) {
+        this.kernelManager = options.kernelManager ?? new KernelManager();
+        this.kernelFactory = options.kernelFactory;
+        this.permissions = options.permissions ?? {};
+        this.limits = options.limits ?? {};
+        this.prompt = options.prompt ?? ">>> ";
+        this.continuationPrompt = options.continuationPrompt ?? "... ";
+        this.welcomeMessage = options.welcomeMessage ?? this.getDefaultWelcome();
+        this.languages = options.languages ?? ["javascript", "python", "wasm"];
+        this.output = options.output ?? output;
+        this.input = options.input ?? input;
+        this.state = {
+            language: options.language ?? "javascript",
+            inMultiline: false,
+            multilineBuffer: [],
+            history: [],
+            variables: new Map(),
+        };
+    }
+    /**
+     * Start REPL
+     */
+    async start() {
+        this.print(this.welcomeMessage);
+        this.print("");
+        this.rl = readline.createInterface({
+            input: this.input,
+            output: this.output,
+            prompt: this.getPrompt(),
+            history: this.getHistoryStrings(),
+        });
+        this.rl.prompt();
+        for await (const line of this.rl) {
+            await this.handleLine(line);
+            this.rl.setPrompt(this.getPrompt());
+            this.rl.prompt();
+        }
+    }
+    /**
+     * Handle a line of input
+     */
+    async handleLine(line) {
+        // Check for commands
+        if (line.startsWith("%")) {
+            await this.handleCommand(line);
+            return;
+        }
+        // Check for language switch
+        const langMatch = line.match(/^!(\w+)/);
+        if (langMatch) {
+            const lang = langMatch[1];
+            if (this.languages.includes(lang)) {
+                this.state.language = lang;
+                this.print(`Switched to ${lang}`);
+            }
+            else {
+                this.print(`Unknown language: ${lang}`);
+                this.print(`Available: ${this.languages.join(", ")}`);
+            }
+            return;
+        }
+        // Check for empty line
+        if (line.trim() === "") {
+            if (this.state.inMultiline) {
+                // Execute multiline
+                const code = this.state.multilineBuffer.join("\n");
+                this.state.multilineBuffer = [];
+                this.state.inMultiline = false;
+                await this.execute(code);
+            }
+            return;
+        }
+        // Check for continuation
+        if (this.shouldContinue(line)) {
+            this.state.inMultiline = true;
+            this.state.multilineBuffer.push(line);
+            return;
+        }
+        // Execute single line
+        if (this.state.inMultiline) {
+            this.state.multilineBuffer.push(line);
+        }
+        else {
+            await this.execute(line);
+        }
+    }
+    /**
+     * Execute code
+     */
+    async execute(code) {
+        const kernel = await this.getKernel(this.state.language);
+        const result = await kernel.execute(code);
+        // Add to history
+        this.state.history.push({
+            input: code,
+            language: this.state.language,
+            result,
+            timestamp: new Date(),
+        });
+        // Display result
+        this.displayResult(result);
+        // Update variables
+        if (result.success && result.exports) {
+            for (const [key, value] of result.exports) {
+                this.state.variables.set(key, value);
+            }
+        }
+        return result;
+    }
+    /**
+     * Handle REPL command
+     */
+    async handleCommand(command) {
+        const [cmd, ...args] = command.slice(1).split(/\s+/);
+        switch (cmd.toLowerCase()) {
+            case "help":
+                this.showHelp();
+                break;
+            case "exit":
+            case "quit":
+                this.print("Goodbye!");
+                process.exit(0);
+            case "clear":
+                console.clear();
+                break;
+            case "reset":
+                await this.reset();
+                this.print("Session reset");
+                break;
+            case "history":
+                this.showHistory();
+                break;
+            case "vars":
+                this.showVariables();
+                break;
+            case "lang":
+            case "language":
+                if (args[0]) {
+                    const lang = args[0];
+                    if (this.languages.includes(lang)) {
+                        this.state.language = lang;
+                        this.print(`Switched to ${lang}`);
+                    }
+                    else {
+                        this.print(`Unknown language: ${lang}`);
+                    }
+                }
+                else {
+                    this.print(`Current language: ${this.state.language}`);
+                    this.print(`Available: ${this.languages.join(", ")}`);
+                }
+                break;
+            case "save":
+                await this.save(args[0] ?? "session.json");
+                break;
+            case "load":
+                await this.load(args[0] ?? "session.json");
+                break;
+            default:
+                this.print(`Unknown command: ${cmd}`);
+                this.print("Type %help for available commands");
+        }
+    }
+    /**
+     * 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;
+    }
+    /**
+     * Check if input should continue to next line
+     */
+    shouldContinue(line) {
+        // Check for incomplete statements
+        const openBrackets = (line.match(/[\{\[\(]/g) ?? []).length;
+        const closeBrackets = (line.match(/[\}\]\)]/g) ?? []).length;
+        if (openBrackets > closeBrackets)
+            return true;
+        // Check for trailing operators/keywords
+        const trimmed = line.trim();
+        if (trimmed.endsWith(":") || trimmed.endsWith("\\"))
+            return true;
+        if (/^(if|else|for|while|def|function|class)\b/.test(trimmed))
+            return true;
+        return false;
+    }
+    /**
+     * Display execution result
+     */
+    displayResult(result) {
+        // Show stdout
+        for (const line of result.output.stdout) {
+            this.print(line);
+        }
+        // Show stderr
+        for (const line of result.output.stderr) {
+            this.print(`[stderr] ${line}`);
+        }
+        // Show displays
+        for (const display of result.output.displays) {
+            switch (display.type) {
+                case "text":
+                    this.print(String(display.data));
+                    break;
+                case "html":
+                case "image":
+                case "json":
+                case "markdown":
+                    this.print(`[${display.type} output]`);
+                    break;
+            }
+        }
+        // Show return value
+        if (result.success && result.value !== undefined) {
+            this.print(this.formatValue(result.value));
+        }
+        // Show error
+        if (result.error) {
+            this.print(`Error (${result.error.type}): ${result.error.message}`);
+            if (result.error.stack) {
+                this.print(result.error.stack);
+            }
+        }
+        // Show metrics
+        this.print(`[${result.metrics.duration}ms]`);
+    }
+    /**
+     * Format value for display
+     */
+    formatValue(value) {
+        if (value === undefined)
+            return "undefined";
+        if (value === null)
+            return "null";
+        if (typeof value === "string")
+            return `"${value}"`;
+        if (typeof value === "object") {
+            try {
+                return JSON.stringify(value, null, 2);
+            }
+            catch {
+                return String(value);
+            }
+        }
+        return String(value);
+    }
+    /**
+     * Get prompt string
+     */
+    getPrompt() {
+        if (this.state.inMultiline) {
+            return this.continuationPrompt;
+        }
+        return `[${this.state.language}] ${this.prompt}`;
+    }
+    /**
+     * Get history as strings
+     */
+    getHistoryStrings() {
+        return this.state.history.map(h => h.input);
+    }
+    /**
+     * Show help
+     */
+    showHelp() {
+        this.print(`
+REPL Commands:
+  %help              Show this help
+  %exit, %quit       Exit REPL
+  %clear             Clear screen
+  %reset             Reset session
+  %history           Show execution history
+  %vars              Show defined variables
+  %lang [name]       Switch or show language
+  %save [file]       Save session
+  %load [file]       Load session
+
+Shortcuts:
+  !python            Switch to Python
+  !javascript        Switch to JavaScript
+  !wasm              Switch to WASM
+
+Press Enter twice to execute multiline input.
+    `);
+    }
+    /**
+     * Show history
+     */
+    showHistory() {
+        for (let i = 0; i < this.state.history.length; i++) {
+            const entry = this.state.history[i];
+            this.print(`${i + 1}: [${entry.language}] ${entry.input.slice(0, 50)}...`);
+        }
+    }
+    /**
+     * Show variables
+     */
+    showVariables() {
+        if (this.state.variables.size === 0) {
+            this.print("No variables defined");
+            return;
+        }
+        for (const [key, value] of this.state.variables) {
+            this.print(`${key} = ${this.formatValue(value)}`);
+        }
+    }
+    /**
+     * Reset session
+     */
+    async reset() {
+        // Restart all kernels
+        for (const kernel of this.kernels.values()) {
+            await kernel.restart();
+        }
+        // Clear state
+        this.state.history = [];
+        this.state.variables.clear();
+        this.state.inMultiline = false;
+        this.state.multilineBuffer = [];
+    }
+    /**
+     * Save session
+     */
+    async save(filename) {
+        const fs = await import("node:fs/promises");
+        const data = {
+            language: this.state.language,
+            history: this.state.history,
+            variables: Array.from(this.state.variables.entries()),
+        };
+        await fs.writeFile(filename, JSON.stringify(data, null, 2));
+        this.print(`Session saved to ${filename}`);
+    }
+    /**
+     * Load session
+     */
+    async load(filename) {
+        const fs = await import("node:fs/promises");
+        const data = JSON.parse(await fs.readFile(filename, "utf-8"));
+        this.state.language = data.language;
+        this.state.history = data.history;
+        this.state.variables = new Map(data.variables);
+        this.print(`Session loaded from ${filename}`);
+    }
+    /**
+     * Print to output
+     */
+    print(message) {
+        this.output.write(message + "\n");
+    }
+    /**
+     * Get default welcome message
+     */
+    getDefaultWelcome() {
+        return `
+╔════════════════════════════════════════════════════════════════╗
+║                    @ebowwa/sandbox REPL                        ║
+║                                                                ║
+║  Multi-language sandboxed execution environment               ║
+║  Type %help for commands, !<lang> to switch language          ║
+╚════════════════════════════════════════════════════════════════╝
+    `.trim();
+    }
+}
+/**
+ * Create a REPL
+ */
+export function createREPL(options) {
+    return new BaseREPL(options);
+}
+//# sourceMappingURL=repl.js.map

package/dist/session/repl.js.map

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

package/package.json

@@ -0,0 +1,142 @@
+{
+  "name": "@ebowwa/sandbox",
+  "version": "0.1.1",
+  "description": "Composable sandbox primitives for multi-language code execution - Jupyter/REPL style with Python+Rust+JS+TS+WASM support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./core/compiler": {
+      "types": "./dist/core/compiler.d.ts",
+      "import": "./dist/core/compiler.js"
+    },
+    "./core/runtime": {
+      "types": "./dist/core/runtime.d.ts",
+      "import": "./dist/core/runtime.js"
+    },
+    "./core/permissions": {
+      "types": "./dist/core/permissions.d.ts",
+      "import": "./dist/core/permissions.js"
+    },
+    "./core/limits": {
+      "types": "./dist/core/limits.d.ts",
+      "import": "./dist/core/limits.js"
+    },
+    "./core/cell": {
+      "types": "./dist/core/cell.d.ts",
+      "import": "./dist/core/cell.js"
+    },
+    "./compilers": {
+      "types": "./dist/compilers/index.d.ts",
+      "import": "./dist/compilers/index.js"
+    },
+    "./runtimes": {
+      "types": "./dist/runtimes/index.d.ts",
+      "import": "./dist/runtimes/index.js"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.js"
+    },
+    "./session/kernel": {
+      "types": "./dist/session/kernel.d.ts",
+      "import": "./dist/session/kernel.js"
+    },
+    "./session/notebook": {
+      "types": "./dist/session/notebook.d.ts",
+      "import": "./dist/session/notebook.js"
+    },
+    "./session/repl": {
+      "types": "./dist/session/repl.d.ts",
+      "import": "./dist/session/repl.js"
+    },
+    "./multi": {
+      "types": "./dist/multi/index.d.ts",
+      "import": "./dist/multi/index.js"
+    },
+    "./multi/polyglot": {
+      "types": "./dist/multi/polyglot.d.ts",
+      "import": "./dist/multi/polyglot.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "repl": "bun run src/session/repl-cli.ts",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "uuid": "^13.0.0",
+    "zod": "^3.24.2"
+  },
+  "optionalDependencies": {
+    "assemblyscript": "^0.28.10",
+    "esbuild": "^0.27.4",
+    "@swc/core": "^1.15.18"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^11.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "assemblyscript": "^0.27.x",
+    "esbuild": "^0.19.x",
+    "@swc/core": "^1.3.x"
+  },
+  "peerDependenciesMeta": {
+    "assemblyscript": {
+      "optional": true
+    },
+    "esbuild": {
+      "optional": true
+    },
+    "@swc/core": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "sandbox",
+    "wasm",
+    "repl",
+    "jupyter",
+    "notebook",
+    "polyglot",
+    "multi-language",
+    "python",
+    "rust",
+    "javascript",
+    "typescript",
+    "isolated-execution"
+  ],
+  "author": "Ebowwa Labs <labs@ebowwa.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ebowwa/codespaces.git",
+    "directory": "packages/src/primitives/abstraction/sandbox"
+  },
+  "ownership": {
+    "domain": "execution",
+    "responsibilities": [
+      "sandboxed-execution",
+      "multi-language-support",
+      "repl-notebook"
+    ]
+  }
+}

package/src/compilers/index.ts

@@ -0,0 +1,80 @@
+/**
+ * Language Compilers
+ *
+ * Export all available compilers for the sandbox.
+ * Each compiler transforms source code to WASM format.
+ */
+
+// Python compiler
+export {
+  PythonCompiler,
+  createPythonCompiler,
+  pythonCompiler,
+  type PythonValidationResult,
+} from "./python.js";
+
+// JavaScript compiler
+export {
+  JavaScriptCompiler,
+  javascriptCompiler,
+  type JavaScriptCompilerOptions,
+} from "./javascript.js";
+
+// TypeScript compiler
+export {
+  TypeScriptCompiler,
+  typescriptCompiler,
+  type TypeScriptCompilerOptions,
+} from "./typescript.js";
+
+// Re-export base types for convenience
+export type {
+  CompileResult,
+  ImportDefinition,
+  CompilerOptions,
+  ICompiler,
+  LanguageCapabilities,
+} from "../core/compiler.js";
+
+export {
+  BaseCompiler,
+  WasmCompiler,
+  CompilerRegistry,
+  defaultCompilerRegistry,
+} from "../core/compiler.js";
+
+/**
+ * Create a compiler registry with all available compilers
+ */
+import { CompilerRegistry, defaultCompilerRegistry } from "../core/compiler.js";
+import { PythonCompiler } from "./python.js";
+import { JavaScriptCompiler } from "./javascript.js";
+import { TypeScriptCompiler } from "./typescript.js";
+
+/**
+ * Create a compiler registry pre-populated with all available compilers
+ */
+export function createCompilerRegistry(): CompilerRegistry {
+  const registry = new CompilerRegistry();
+
+  // Register Python compiler
+  registry.register(new PythonCompiler());
+
+  // Register JavaScript compiler
+  registry.register(new JavaScriptCompiler());
+
+  // Register TypeScript compiler
+  registry.register(new TypeScriptCompiler());
+
+  return registry;
+}
+
+/**
+ * Default compiler registry with all language support
+ */
+export const compilers = createCompilerRegistry();
+
+// Register all compilers with the default registry
+defaultCompilerRegistry.register(new PythonCompiler());
+defaultCompilerRegistry.register(new JavaScriptCompiler());
+defaultCompilerRegistry.register(new TypeScriptCompiler());