@ebowwa/sandbox 0.1.1

package/dist/session/kernel.js

@@ -0,0 +1,400 @@
+/**
+ * Kernel Primitive
+ *
+ * Language-specific execution session with state persistence.
+ * Provides REPL-like interactive execution for a single language.
+ */
+import { PermissionChecker, createPermissions } from "../core/permissions.js";
+import { LimitsParser, LimitsEnforcer, DEFAULT_LIMITS } from "../core/limits.js";
+import { v4 as uuid } from "uuid";
+/**
+ * Base Kernel Implementation
+ *
+ * Provides core kernel functionality with state management.
+ */
+export class BaseKernel {
+    language;
+    displayName;
+    id;
+    state = "starting";
+    kernelState = new Map();
+    exports = new Map();
+    compiler;
+    runtime;
+    permissions;
+    limits;
+    env;
+    cwd;
+    stats = {
+        executions: 0,
+        successes: 0,
+        failures: 0,
+        totalTime: 0,
+        avgTime: 0,
+        memoryHighWater: 0,
+    };
+    permissionChecker;
+    constructor(options) {
+        this.id = options.id ?? uuid();
+        this.language = options.language;
+        this.displayName = options.displayName ?? `${options.language} kernel`;
+        this.compiler = options.compiler;
+        this.runtime = options.runtime;
+        this.permissions = options.permissions ?? {};
+        this.limits = options.limits ?? {};
+        this.env = options.env ?? {};
+        this.cwd = options.cwd;
+        this.permissionChecker = new PermissionChecker(this.permissions);
+    }
+    /**
+     * Get kernel ID
+     */
+    getId() {
+        return this.id;
+    }
+    /**
+     * Get current execution state
+     */
+    getExecutionState() {
+        return this.state;
+    }
+    /**
+     * Get kernel state (variables)
+     */
+    getState() {
+        return new Map(this.kernelState);
+    }
+    /**
+     * Get exports
+     */
+    getExports() {
+        return new Map(this.exports);
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Start the kernel
+     */
+    async start() {
+        this.state = "starting";
+        try {
+            // Check if compiler is available
+            if (!(await this.compiler.isAvailable())) {
+                throw new Error(`Compiler for ${this.language} is not available`);
+            }
+            // Initialize runtime
+            await this.runtime.init();
+            // Check if runtime is available
+            if (!(await this.runtime.isAvailable())) {
+                throw new Error(`Runtime ${this.runtime.name} is not available`);
+            }
+            this.state = "ready";
+        }
+        catch (error) {
+            this.state = "error";
+            throw error;
+        }
+    }
+    /**
+     * Check if kernel is running
+     */
+    isRunning() {
+        return this.state === "ready" || this.state === "busy";
+    }
+    /**
+     * Get display name
+     */
+    getDisplayName() {
+        return this.displayName;
+    }
+    /**
+     * Get language
+     */
+    getLanguage() {
+        return this.language;
+    }
+    /**
+     * Execute code
+     */
+    async execute(code, options) {
+        if (this.state !== "ready" && this.state !== "busy") {
+            return this.createErrorResult(`Kernel is not ready (state: ${this.state})`, "runtime");
+        }
+        this.state = "busy";
+        const startTime = Date.now();
+        try {
+            // Parse limits
+            const parsedLimits = LimitsParser.parse(this.limits);
+            const enforcer = new LimitsEnforcer(parsedLimits);
+            enforcer.start();
+            // Check for abort signal
+            if (options?.signal?.aborted) {
+                return this.createErrorResult("Execution cancelled", "cancel");
+            }
+            // Compile
+            const compiled = await this.compiler.compile(code, this.permissions, this.limits, { optimize: true });
+            // Create execution request
+            const request = {
+                wasm: compiled,
+                entrypoint: options?.entrypoint,
+                args: options?.args,
+                input: options?.input,
+                state: this.kernelState,
+            };
+            // Execute
+            const result = await this.runtime.execute(request, {
+                permissions: this.permissions,
+                limits: this.limits,
+                env: this.env,
+                cwd: this.cwd,
+                signal: options?.signal,
+            });
+            // Update state if successful
+            if (result.success && result.state) {
+                for (const [key, value] of result.state) {
+                    this.kernelState.set(key, value);
+                }
+            }
+            // Update exports
+            if (result.exports) {
+                for (const [key, value] of result.exports) {
+                    this.exports.set(key, value);
+                }
+            }
+            // Update stats
+            this.updateStats(result, Date.now() - startTime);
+            this.state = "ready";
+            return result;
+        }
+        catch (error) {
+            this.state = "ready";
+            const result = this.createErrorResult(error instanceof Error ? error.message : String(error), "runtime");
+            this.updateStats(result, Date.now() - startTime);
+            return result;
+        }
+    }
+    /**
+     * Complete code at position (autocomplete)
+     */
+    async complete(code, position) {
+        // Basic implementation - override in language-specific kernels
+        const beforeCursor = code.slice(0, position);
+        const match = beforeCursor.match(/(\w+)$/);
+        const prefix = match ? match[1] : "";
+        // Get completions from state
+        const matches = [];
+        for (const key of this.kernelState.keys()) {
+            if (key.startsWith(prefix)) {
+                matches.push(key);
+            }
+        }
+        for (const key of this.exports.keys()) {
+            if (key.startsWith(prefix)) {
+                matches.push(key);
+            }
+        }
+        return {
+            matches,
+            cursorStart: position - prefix.length,
+            cursorEnd: position,
+        };
+    }
+    /**
+     * Inspect object at position
+     */
+    async inspect(code, position) {
+        // Basic implementation - override in language-specific kernels
+        const beforeCursor = code.slice(0, position);
+        const match = beforeCursor.match(/(\w+)$/);
+        const name = match ? match[1] : "";
+        if (!name) {
+            return { found: false };
+        }
+        const value = this.kernelState.get(name) ?? this.exports.get(name);
+        if (value === undefined) {
+            return { found: false };
+        }
+        return {
+            found: true,
+            details: {
+                type: typeof value,
+                documentation: undefined,
+                signature: undefined,
+            },
+        };
+    }
+    /**
+     * Restart kernel (clear state)
+     */
+    async restart() {
+        this.kernelState.clear();
+        this.exports.clear();
+        this.state = "ready";
+        // Reset stats
+        this.stats = {
+            executions: 0,
+            successes: 0,
+            failures: 0,
+            totalTime: 0,
+            avgTime: 0,
+            memoryHighWater: 0,
+        };
+    }
+    /**
+     * Shutdown kernel
+     */
+    async shutdown() {
+        this.state = "shutting_down";
+        try {
+            await this.runtime.terminate();
+        }
+        catch {
+            // Ignore errors during shutdown
+        }
+        this.kernelState.clear();
+        this.exports.clear();
+        this.state = "dead";
+    }
+    /**
+     * Interrupt current execution
+     */
+    interrupt() {
+        // Override in implementations that support interruption
+    }
+    /**
+     * Set environment variable
+     */
+    setEnv(key, value) {
+        this.env[key] = value;
+    }
+    /**
+     * Get environment variable
+     */
+    getEnv(key) {
+        return this.env[key];
+    }
+    /**
+     * Update permissions
+     */
+    setPermissions(permissions) {
+        this.permissions = permissions;
+        this.permissionChecker = new PermissionChecker(permissions);
+    }
+    /**
+     * Update limits
+     */
+    setLimits(limits) {
+        this.limits = limits;
+    }
+    /**
+     * Create error result
+     */
+    createErrorResult(message, type) {
+        return {
+            success: false,
+            error: { message, type },
+            metrics: {
+                duration: 0,
+                memoryUsed: 0,
+            },
+            output: { stdout: [], stderr: [], displays: [] },
+        };
+    }
+    /**
+     * Update statistics
+     */
+    updateStats(result, duration) {
+        this.stats.executions++;
+        this.stats.totalTime += duration;
+        this.stats.avgTime = this.stats.totalTime / this.stats.executions;
+        this.stats.lastExecution = new Date();
+        if (result.success) {
+            this.stats.successes++;
+        }
+        else {
+            this.stats.failures++;
+        }
+        const memoryUsed = result.metrics.memoryUsed;
+        if (memoryUsed > this.stats.memoryHighWater) {
+            this.stats.memoryHighWater = memoryUsed;
+        }
+    }
+}
+/**
+ * Kernel Manager
+ *
+ * Manages multiple kernels across languages.
+ */
+export class KernelManager {
+    kernels = new Map();
+    languageKernels = new Map();
+    /**
+     * Create and register a kernel
+     */
+    async createKernel(options) {
+        const kernel = new BaseKernel(options);
+        await kernel.start();
+        this.kernels.set(kernel.getId(), kernel);
+        if (!this.languageKernels.has(options.language)) {
+            this.languageKernels.set(options.language, new Set());
+        }
+        this.languageKernels.get(options.language).add(kernel.getId());
+        return kernel;
+    }
+    /**
+     * Get kernel by ID
+     */
+    getKernel(id) {
+        return this.kernels.get(id);
+    }
+    /**
+     * Get kernels by language
+     */
+    getKernelsByLanguage(language) {
+        const ids = this.languageKernels.get(language);
+        if (!ids)
+            return [];
+        return Array.from(ids)
+            .map(id => this.kernels.get(id))
+            .filter((k) => k !== undefined);
+    }
+    /**
+     * Get all kernels
+     */
+    getAllKernels() {
+        return Array.from(this.kernels.values());
+    }
+    /**
+     * Shutdown a kernel
+     */
+    async shutdownKernel(id) {
+        const kernel = this.kernels.get(id);
+        if (!kernel)
+            return;
+        await kernel.shutdown();
+        // Remove from language index
+        const langSet = this.languageKernels.get(kernel.language);
+        if (langSet) {
+            langSet.delete(id);
+        }
+        this.kernels.delete(id);
+    }
+    /**
+     * Shutdown all kernels
+     */
+    async shutdownAll() {
+        const shutdowns = Array.from(this.kernels.keys()).map(id => this.shutdownKernel(id));
+        await Promise.all(shutdowns);
+    }
+    /**
+     * Get kernel count
+     */
+    get count() {
+        return this.kernels.size;
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/session/kernel.js.map

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

package/dist/session/notebook.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Notebook Primitive
+ *
+ * Multi-cell, multi-language document with sequential execution.
+ * Jupyter-style notebook with cell dependencies and state sharing.
+ */
+import type { Language, Notebook, NotebookMetadata, NotebookRunOptions, NotebookResult, Cell, ExecutionResult, ExecutionOptions, Permissions, Limits } from "../core/types.js";
+import type { ExecutableCell } from "../core/cell.js";
+import { BaseKernel, KernelManager } from "./kernel.js";
+/**
+ * Notebook options
+ */
+export interface NotebookOptions {
+    /** Notebook ID */
+    id?: string;
+    /** Notebook name */
+    name?: string;
+    /** Default language */
+    defaultLanguage?: Language;
+    /** Initial cells */
+    cells?: Cell[];
+    /** Permissions */
+    permissions?: Permissions;
+    /** Resource limits */
+    limits?: Limits;
+    /** Kernel manager to use */
+    kernelManager?: KernelManager;
+    /** Kernel factory */
+    kernelFactory?: (language: Language) => Promise<BaseKernel>;
+}
+/**
+ * Notebook state
+ */
+export type NotebookState = "idle" | "running" | "error" | "cancelled";
+/**
+ * Notebook events
+ */
+export interface NotebookEvents {
+    onCellStart?: (cellId: string, cell: ExecutableCell) => void;
+    onCellComplete?: (cellId: string, result: ExecutionResult) => void;
+    onCellError?: (cellId: string, error: Error) => void;
+    onNotebookComplete?: (results: NotebookResult[]) => void;
+    onNotebookError?: (error: Error) => void;
+    onProgress?: (completed: number, total: number) => void;
+}
+/**
+ * Base Notebook Implementation
+ */
+export declare class BaseNotebook implements Notebook {
+    readonly id: string;
+    readonly metadata: NotebookMetadata;
+    private registry;
+    private kernelManager;
+    private kernelFactory?;
+    private kernels;
+    private permissions;
+    private limits;
+    private state;
+    private executionCount;
+    private events;
+    private abortController?;
+    constructor(options: NotebookOptions);
+    /**
+     * Get current state
+     */
+    getState(): NotebookState;
+    /**
+     * Set event handlers
+     */
+    setEvents(events: NotebookEvents): void;
+    /**
+     * Get all cells
+     */
+    get cells(): ExecutableCell[];
+    /**
+     * 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;
+    /**
+     * Update cell source
+     */
+    updateCell(cellId: string, source: string): void;
+    /**
+     * Get or create kernel for language
+     */
+    private getKernel;
+    /**
+     * Execute all cells
+     */
+    runAll(options?: NotebookRunOptions): Promise<NotebookResult[]>;
+    /**
+     * Execute single cell
+     */
+    runCell(cellId: string, options?: ExecutionOptions): Promise<NotebookResult>;
+    /**
+     * Execute cells from index
+     */
+    runFrom(startIndex: number): Promise<NotebookResult[]>;
+    /**
+     * Run cells that depend on a changed cell
+     */
+    runDependents(cellId: string): Promise<NotebookResult[]>;
+    /**
+     * Cancel execution
+     */
+    cancel(): void;
+    /**
+     * Clear all cell outputs
+     */
+    clearOutputs(): void;
+    /**
+     * Restart all kernels
+     */
+    restart(): Promise<void>;
+    /**
+     * Export notebook
+     */
+    export(format: "ipynb" | "json" | "markdown"): string;
+    /**
+     * Import notebook
+     */
+    static import(data: string, format: "ipynb" | "json" | "markdown"): BaseNotebook;
+    /**
+     * Export to Jupyter format
+     */
+    private toIpynb;
+    /**
+     * Export to JSON
+     */
+    private toJson;
+    /**
+     * Export to Markdown
+     */
+    private toMarkdown;
+    /**
+     * Import from Jupyter format
+     */
+    static fromIpynb(data: string): BaseNotebook;
+    /**
+     * Import from JSON
+     */
+    static fromJson(data: string): BaseNotebook;
+    /**
+     * Import from Markdown
+     */
+    static fromMarkdown(data: string): BaseNotebook;
+    /**
+     * Convert cell outputs to Jupyter format
+     */
+    private cellToOutputs;
+}
+/**
+ * Create a notebook
+ */
+export declare function createNotebook(options: NotebookOptions): BaseNotebook;
+//# sourceMappingURL=notebook.d.ts.map

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

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