@treesap/sandbox 0.2.0

package/dist/sandbox.js

@@ -0,0 +1,303 @@
+import { spawn } from 'child_process';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { EventEmitter } from 'events';
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Represents a single isolated sandbox instance
+ * Each sandbox has its own working directory and process management
+ */
+export class Sandbox extends EventEmitter {
+    id;
+    workDir;
+    createdAt;
+    processes = new Map();
+    runningProcesses = new Map();
+    config;
+    destroyed = false;
+    constructor(config = {}) {
+        super();
+        this.id = config.id || uuidv4();
+        this.workDir = config.workDir || path.join(process.cwd(), '.sandboxes', this.id);
+        this.config = { ...config, env: config.env || {} };
+        this.createdAt = Date.now();
+    }
+    /**
+     * Initialize the sandbox (create working directory)
+     */
+    async initialize() {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        // Create working directory
+        await fs.mkdir(this.workDir, { recursive: true });
+        this.emit('initialized', { id: this.id, workDir: this.workDir });
+    }
+    /**
+     * Execute a command and return the complete result
+     */
+    async exec(command, options = {}) {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            // Parse command and args
+            const [cmd, ...args] = this.parseCommand(command);
+            const childProcess = spawn(cmd, args, {
+                cwd: options.cwd || this.workDir,
+                env: { ...process.env, ...this.config.env, ...options.env },
+                shell: true,
+            });
+            // Handle timeout
+            let timeoutId;
+            const timeout = options.timeout || this.config.timeout;
+            if (timeout) {
+                timeoutId = setTimeout(() => {
+                    timedOut = true;
+                    childProcess.kill('SIGTERM');
+                    // Force kill after 5 seconds
+                    setTimeout(() => {
+                        if (!childProcess.killed) {
+                            childProcess.kill('SIGKILL');
+                        }
+                    }, 5000);
+                }, timeout);
+            }
+            // Capture stdout
+            childProcess.stdout?.on('data', (data) => {
+                const text = data.toString();
+                stdout += text;
+                if (options.stream && options.onOutput) {
+                    options.onOutput('stdout', text);
+                }
+                this.emit('output', { stream: 'stdout', data: text });
+            });
+            // Capture stderr
+            childProcess.stderr?.on('data', (data) => {
+                const text = data.toString();
+                stderr += text;
+                if (options.stream && options.onOutput) {
+                    options.onOutput('stderr', text);
+                }
+                this.emit('output', { stream: 'stderr', data: text });
+            });
+            // Handle process completion
+            childProcess.on('close', (exitCode) => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                const response = {
+                    success: !timedOut && exitCode === 0,
+                    stdout,
+                    stderr,
+                    exitCode: exitCode || 0,
+                    timedOut,
+                };
+                this.emit('exec_complete', response);
+                resolve(response);
+            });
+            childProcess.on('error', (error) => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                const response = {
+                    success: false,
+                    stdout,
+                    stderr: stderr + '\n' + error.message,
+                    exitCode: 1,
+                };
+                this.emit('exec_error', error);
+                resolve(response);
+            });
+        });
+    }
+    /**
+     * Start a long-running background process
+     */
+    async startProcess(command, options = {}) {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        // Check max processes limit
+        if (this.config.maxProcesses && this.runningProcesses.size >= this.config.maxProcesses) {
+            throw new Error(`Maximum process limit reached (${this.config.maxProcesses})`);
+        }
+        const processId = uuidv4();
+        const [cmd, ...args] = this.parseCommand(command);
+        const childProcess = spawn(cmd, args, {
+            cwd: options.cwd || this.workDir,
+            env: { ...process.env, ...this.config.env, ...options.env },
+            shell: true,
+        });
+        const processInfo = {
+            id: processId,
+            pid: childProcess.pid,
+            command,
+            status: 'running',
+            startTime: Date.now(),
+        };
+        this.processes.set(processId, processInfo);
+        this.runningProcesses.set(processId, childProcess);
+        // Listen for output
+        childProcess.stdout?.on('data', (data) => {
+            this.emit('process_output', {
+                processId,
+                stream: 'stdout',
+                data: data.toString(),
+            });
+        });
+        childProcess.stderr?.on('data', (data) => {
+            this.emit('process_output', {
+                processId,
+                stream: 'stderr',
+                data: data.toString(),
+            });
+        });
+        // Handle process exit
+        childProcess.on('close', (exitCode) => {
+            const info = this.processes.get(processId);
+            if (info) {
+                info.status = exitCode === 0 ? 'completed' : 'failed';
+                info.exitCode = exitCode || 0;
+            }
+            this.runningProcesses.delete(processId);
+            this.emit('process_exit', { processId, exitCode });
+        });
+        this.emit('process_started', processInfo);
+        return processInfo;
+    }
+    /**
+     * List all processes (running and completed)
+     */
+    listProcesses() {
+        return Array.from(this.processes.values());
+    }
+    /**
+     * Get information about a specific process
+     */
+    getProcess(processId) {
+        return this.processes.get(processId);
+    }
+    /**
+     * Kill a specific process
+     */
+    async killProcess(processId, signal = 'SIGTERM') {
+        const childProcess = this.runningProcesses.get(processId);
+        if (!childProcess) {
+            throw new Error(`Process ${processId} not found or already stopped`);
+        }
+        childProcess.kill(signal);
+        // Update process info
+        const info = this.processes.get(processId);
+        if (info) {
+            info.status = 'failed';
+        }
+    }
+    /**
+     * Kill all running processes
+     */
+    async killAllProcesses(signal = 'SIGTERM') {
+        const killPromises = Array.from(this.runningProcesses.keys()).map((processId) => this.killProcess(processId, signal).catch(() => {
+            // Ignore errors if process already stopped
+        }));
+        await Promise.all(killPromises);
+    }
+    /**
+     * Get sandbox status
+     */
+    getStatus() {
+        return {
+            id: this.id,
+            workDir: this.workDir,
+            createdAt: this.createdAt,
+            uptime: Date.now() - this.createdAt,
+            processCount: this.runningProcesses.size,
+            totalProcesses: this.processes.size,
+            destroyed: this.destroyed,
+        };
+    }
+    // ============================================================================
+    // Environment Variable Management
+    // ============================================================================
+    /**
+     * Set a single environment variable
+     */
+    setEnv(key, value) {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        this.config.env[key] = value;
+        this.emit('env_changed', { key, value, action: 'set' });
+    }
+    /**
+     * Set multiple environment variables at once
+     */
+    setEnvBatch(variables) {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        for (const [key, value] of Object.entries(variables)) {
+            this.config.env[key] = value;
+        }
+        this.emit('env_changed', { variables, action: 'batch_set' });
+    }
+    getEnv(key) {
+        if (key !== undefined) {
+            return this.config.env[key];
+        }
+        return { ...this.config.env };
+    }
+    /**
+     * Get list of environment variable names (for security, not exposing values)
+     */
+    getEnvKeys() {
+        return Object.keys(this.config.env);
+    }
+    /**
+     * Unset (remove) an environment variable
+     */
+    unsetEnv(key) {
+        if (this.destroyed) {
+            throw new Error('Sandbox has been destroyed');
+        }
+        if (key in this.config.env) {
+            delete this.config.env[key];
+            this.emit('env_changed', { key, action: 'unset' });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Destroy the sandbox (kill all processes, optionally clean up files)
+     */
+    async destroy(options = {}) {
+        if (this.destroyed) {
+            return;
+        }
+        // Kill all running processes
+        await this.killAllProcesses('SIGKILL');
+        // Clean up files if requested
+        if (options.cleanup) {
+            try {
+                await fs.rm(this.workDir, { recursive: true, force: true });
+            }
+            catch (error) {
+                // Ignore cleanup errors
+            }
+        }
+        this.destroyed = true;
+        this.emit('destroyed', { id: this.id });
+        this.removeAllListeners();
+    }
+    /**
+     * Parse a command string into command and arguments
+     */
+    parseCommand(command) {
+        // Simple parsing - for more complex commands, shell: true handles it
+        return command.split(' ').filter(Boolean);
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import type { Server } from 'http';
+export interface SandboxConfig {
+    port?: number;
+    projectRoot?: string;
+}
+export declare function startSandboxServer(config?: SandboxConfig): Promise<Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,aAAkB,gGA4RlE"}

package/dist/server.js

@@ -0,0 +1,240 @@
+import { Hono } from "hono";
+import { TerminalService } from "./terminal.js";
+import { WebSocketTerminalService } from "./websocket.js";
+import process from "node:process";
+export async function startSandboxServer(config = {}) {
+    const { port = 3000, projectRoot = process.cwd() } = config;
+    // Change the current working directory to the project root
+    process.chdir(projectRoot);
+    const app = new Hono();
+    // Health check endpoint
+    app.get("/", (c) => {
+        return c.json({
+            status: "ok",
+            message: "Treesap Sandbox Server",
+            version: "0.1.0",
+            endpoints: {
+                terminal_sessions: "/api/terminal/sessions",
+                websocket: "ws://localhost:" + port + "/terminal/ws"
+            }
+        });
+    });
+    // List active terminal sessions with WebSocket client info
+    app.get("/api/terminal/sessions", (c) => {
+        const sessions = TerminalService.getAllSessions();
+        const wsActiveSessions = WebSocketTerminalService.getActiveSessions();
+        return c.json({
+            sessions: sessions.map(session => {
+                const wsInfo = wsActiveSessions.find(ws => ws.sessionId === session.id);
+                return {
+                    id: session.id,
+                    createdAt: session.createdAt,
+                    lastActivity: session.lastActivity,
+                    connectedClients: wsInfo ? wsInfo.clientCount : 0
+                };
+            }),
+            totalConnectedClients: WebSocketTerminalService.getConnectedClients()
+        });
+    });
+    // Get specific terminal session status
+    app.get("/api/terminal/sessions/:sessionId/status", (c) => {
+        const sessionId = c.req.param('sessionId');
+        const session = TerminalService.getSession(sessionId);
+        if (!session) {
+            return c.json({ error: "Session not found" }, 404);
+        }
+        const clients = WebSocketTerminalService.getSessionClients(sessionId);
+        return c.json({
+            id: session.id,
+            createdAt: session.createdAt,
+            lastActivity: session.lastActivity,
+            connectedClients: clients.length,
+            clientIds: clients
+        });
+    });
+    // Send command to terminal via API
+    app.post("/api/terminal/sessions/:sessionId/command", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        const body = await c.req.json();
+        const { command } = body;
+        if (!command) {
+            return c.json({ error: "Command is required" }, 400);
+        }
+        // Get or create terminal session
+        let session = TerminalService.getSession(sessionId);
+        if (!session) {
+            session = TerminalService.createSession(sessionId);
+        }
+        const success = WebSocketTerminalService.sendCommandToSession(sessionId, command);
+        if (success) {
+            return c.json({
+                success: true,
+                message: `Command sent to session ${sessionId}`,
+                connectedClients: WebSocketTerminalService.getSessionClients(sessionId).length
+            });
+        }
+        else {
+            return c.json({ error: "Failed to send command to terminal" }, 500);
+        }
+    });
+    // Get recent output from terminal session (for API clients)
+    app.get("/api/terminal/sessions/:sessionId/output", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        const session = TerminalService.getSession(sessionId);
+        if (!session) {
+            return c.json({ error: "Session not found" }, 404);
+        }
+        // Note: This is a basic implementation. For production, you'd want to
+        // store recent output history in the TerminalService
+        return c.json({
+            sessionId,
+            message: "Output streaming available via WebSocket connection",
+            connectedClients: WebSocketTerminalService.getSessionClients(sessionId).length,
+            websocketUrl: `ws://${c.req.header('host')}/terminal/ws`
+        });
+    });
+    // Terminal endpoints
+    app.post("/terminal/execute/:sessionId", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        const body = await c.req.json();
+        const { command } = body;
+        if (!command) {
+            return c.json({ error: "Command is required" }, 400);
+        }
+        // Get or create terminal session
+        let session = TerminalService.getSession(sessionId);
+        if (!session) {
+            session = TerminalService.createSession(sessionId);
+        }
+        const success = TerminalService.executeCommand(sessionId, command);
+        if (success) {
+            return c.json({ success: true });
+        }
+        else {
+            return c.json({ error: "Failed to execute command" }, 500);
+        }
+    });
+    app.post("/terminal/input/:sessionId", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        const body = await c.req.json();
+        const { input } = body;
+        if (input === undefined) {
+            return c.json({ error: "Input is required" }, 400);
+        }
+        // Get or create terminal session
+        let session = TerminalService.getSession(sessionId);
+        if (!session) {
+            session = TerminalService.createSession(sessionId);
+        }
+        // Send input directly to PTY
+        try {
+            session.lastActivity = new Date();
+            session.process.write(input);
+            return c.json({ success: true });
+        }
+        catch (error) {
+            console.error(`Error sending input to session ${sessionId}:`, error);
+            return c.json({ error: "Failed to send input" }, 500);
+        }
+    });
+    app.get("/terminal/stream/:sessionId", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        // Get or create terminal session
+        let session = TerminalService.getSession(sessionId);
+        if (!session) {
+            session = TerminalService.createSession(sessionId);
+        }
+        // Set SSE headers
+        c.header('Content-Type', 'text/event-stream');
+        c.header('Cache-Control', 'no-cache');
+        c.header('Connection', 'keep-alive');
+        c.header('Access-Control-Allow-Origin', '*');
+        const stream = new ReadableStream({
+            start(controller) {
+                const encoder = new TextEncoder();
+                // Send initial connection event
+                controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'connected' })}\n\n`));
+                // Set up output listener
+                const handleOutput = (data) => {
+                    try {
+                        controller.enqueue(encoder.encode(`data: ${JSON.stringify(data)}\n\n`));
+                    }
+                    catch (error) {
+                        console.error('Error sending terminal output:', error);
+                        // Remove listener on error to prevent memory leaks
+                        session.eventEmitter.removeListener('output', handleOutput);
+                    }
+                };
+                session.eventEmitter.on('output', handleOutput);
+                // Handle client disconnect
+                const handleDisconnect = () => {
+                    try {
+                        session.eventEmitter.removeListener('output', handleOutput);
+                    }
+                    catch (error) {
+                        console.error('Error removing output listener:', error);
+                    }
+                };
+                // Clean up on stream close
+                return () => {
+                    handleDisconnect();
+                };
+            }
+        });
+        return new Response(stream, {
+            headers: {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                'Access-Control-Allow-Origin': '*'
+            }
+        });
+    });
+    // Delete terminal session
+    app.delete("/terminal/session/:sessionId", async (c) => {
+        const sessionId = c.req.param('sessionId');
+        if (!sessionId) {
+            return c.json({ error: "Session ID is required" }, 400);
+        }
+        const success = TerminalService.destroySession(sessionId);
+        if (success) {
+            return c.json({ message: `Terminal session ${sessionId} destroyed successfully` });
+        }
+        else {
+            console.log(`Terminal session not found: ${sessionId}`);
+            return c.json({ error: `Terminal session ${sessionId} not found` }, 404);
+        }
+    });
+    const { serve } = await import('@hono/node-server');
+    // Start the server and initialize WebSocket
+    const server = serve({
+        fetch: app.fetch,
+        port,
+    });
+    // Initialize WebSocket service
+    WebSocketTerminalService.initialize(server);
+    // Setup global graceful shutdown
+    const setupGlobalShutdown = () => {
+        const cleanup = async () => {
+            console.log('\n🛑 Shutting down sandbox server and all terminal sessions...');
+            // Clean up WebSocket connections
+            WebSocketTerminalService.cleanup();
+            process.exit(0);
+        };
+        // Handle Ctrl+C (SIGINT)
+        process.on('SIGINT', () => {
+            cleanup().catch(() => process.exit(1));
+        });
+        // Handle termination signal
+        process.on('SIGTERM', () => {
+            cleanup().catch(() => process.exit(1));
+        });
+    };
+    setupGlobalShutdown();
+    // Initialize terminal service cleanup
+    TerminalService.setupGlobalCleanup();
+    console.log(`\n🌳 Treesap Sandbox Server running at http://localhost:${port}`);
+    console.log(`🔌 WebSocket terminal server available at ws://localhost:${port}/terminal/ws\n`);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,OAAO,MAAM,cAAc,CAAC;AAOnC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAwB,EAAE;IACjE,MAAM,EACJ,IAAI,GAAG,IAAI,EACX,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,EAC5B,GAAG,MAAM,CAAC;IAEX,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAU,EAAE,EAAE;QAC1B,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,wBAAwB;YACjC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE;gBACT,iBAAiB,EAAE,wBAAwB;gBAC3C,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,cAAc;aACrD;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,2DAA2D;IAC3D,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC,CAAU,EAAE,EAAE;QAC/C,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,iBAAiB,EAAE,CAAC;QAEtE,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;gBACxE,OAAO;oBACL,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;iBAClD,CAAC;YACJ,CAAC,CAAC;YACF,qBAAqB,EAAE,wBAAwB,CAAC,mBAAmB,EAAE;SACtE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,GAAG,CAAC,GAAG,CAAC,0CAA0C,EAAE,CAAC,CAAU,EAAE,EAAE;QACjE,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEtE,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,gBAAgB,EAAE,OAAO,CAAC,MAAM;YAChC,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,GAAG,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QACzE,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAC;QACvD,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAElF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,2BAA2B,SAAS,EAAE;gBAC/C,gBAAgB,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,MAAM;aAC/E,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,GAAG,CAAC,GAAG,CAAC,0CAA0C,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QACvE,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,sEAAsE;QACtE,qDAAqD;QACrD,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,OAAO,EAAE,qDAAqD;YAC9D,gBAAgB,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,MAAM;YAC9E,YAAY,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qBAAqB;IACrB,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QAC5D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAC;QACvD,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEnE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YACrE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE3C,iCAAiC;QACjC,IAAI,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,kBAAkB;QAClB,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACtC,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC,MAAM,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,KAAK,CAAC,UAAU;gBACd,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;gBAElC,gCAAgC;gBAChC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;gBAEzF,yBAAyB;gBACzB,MAAM,YAAY,GAAG,CAAC,IAAS,EAAE,EAAE;oBACjC,IAAI,CAAC;wBACH,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC1E,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;wBACvD,mDAAmD;wBACnD,OAAQ,CAAC,YAAY,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC,CAAC;gBAEF,OAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAEjD,2BAA2B;gBAC3B,MAAM,gBAAgB,GAAG,GAAG,EAAE;oBAC5B,IAAI,CAAC;wBACH,OAAQ,CAAC,YAAY,CAAC,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;oBAC/D,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC,CAAC;gBAEF,2BAA2B;gBAC3B,OAAO,GAAG,EAAE;oBACV,gBAAgB,EAAE,CAAC;gBACrB,CAAC,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;YAC1B,OAAO,EAAE;gBACP,cAAc,EAAE,mBAAmB;gBACnC,eAAe,EAAE,UAAU;gBAC3B,YAAY,EAAE,YAAY;gBAC1B,6BAA6B,EAAE,GAAG;aACnC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,GAAG,CAAC,MAAM,CAAC,8BAA8B,EAAE,KAAK,EAAE,CAAU,EAAE,EAAE;QAC9D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAE1D,IAAI,OAAO,EAAE,CAAC;YAEZ,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,oBAAoB,SAAS,yBAAyB,EAAE,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,SAAS,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEpD,4CAA4C;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI;KACL,CAAW,CAAC;IAEb,+BAA+B;IAC/B,wBAAwB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C,iCAAiC;IACjC,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;YAE9E,iCAAiC;YACjC,wBAAwB,CAAC,OAAO,EAAE,CAAC;YAEnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,yBAAyB;QACzB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACxB,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,mBAAmB,EAAE,CAAC;IAEtB,sCAAsC;IACtC,eAAe,CAAC,kBAAkB,EAAE,CAAC;IAErC,OAAO,CAAC,GAAG,CAAC,2DAA2D,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,4DAA4D,IAAI,gBAAgB,CAAC,CAAC;IAE9F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stream-service.d.ts

@@ -0,0 +1,35 @@
+import { Sandbox, ExecOptions } from './sandbox';
+import { Readable } from 'stream';
+export type ExecEventType = 'start' | 'stdout' | 'stderr' | 'complete' | 'error';
+export interface ExecEvent {
+    type: ExecEventType;
+    data?: string;
+    exitCode?: number;
+    error?: string;
+    timestamp: number;
+}
+export interface LogEvent {
+    type: 'log';
+    data: string;
+    timestamp: number;
+    stream?: 'stdout' | 'stderr';
+}
+/**
+ * Service for creating Server-Sent Events (SSE) streams
+ */
+export declare class StreamService {
+    /**
+     * Create an SSE stream for command execution
+     */
+    static createExecStream(sandbox: Sandbox, command: string, options?: ExecOptions): Readable;
+    /**
+     * Create an SSE stream for process logs
+     */
+    static createProcessLogStream(sandbox: Sandbox, processId: string): Readable;
+    /**
+     * Helper to parse SSE stream on client side
+     * This is exported for client library usage
+     */
+    static parseSSEStream<T = ExecEvent | LogEvent>(stream: ReadableStream): AsyncGenerator<T>;
+}
+//# sourceMappingURL=stream-service.d.ts.map

package/dist/stream-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-service.d.ts","sourceRoot":"","sources":["../src/stream-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,QAAQ;IAqD/F;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ;IA8C5E;;;OAGG;WACW,cAAc,CAAC,CAAC,GAAG,SAAS,GAAG,QAAQ,EACnD,MAAM,EAAE,cAAc,GACrB,cAAc,CAAC,CAAC,CAAC;CAsCrB"}