@nexus-cortex/executors 4.26.0

package/dist/implementations/addon/SandboxViewServer.d.ts

@@ -0,0 +1,127 @@
+import { type Express } from 'express';
+import { Server as SocketIOServer } from 'socket.io';
+/**
+ * SandboxViewServer - Real-time sandbox viewing server
+ *
+ * Provides a web-based dashboard for users to view sandbox operations in real-time.
+ * Features:
+ * - Embedded iframe showing sandbox UI
+ * - Live console logs via WebSocket
+ * - File change notifications
+ * - Screenshot gallery with timeline
+ * - Network request monitoring
+ * - Multi-sandbox management
+ *
+ * Architecture:
+ * - Express HTTP server serves HTML dashboard
+ * - Socket.io WebSocket server broadcasts events
+ * - SandboxEventBroadcaster provides events
+ * - Each sandbox gets a unique room for isolated events
+ *
+ * User Flow:
+ * 1. Model creates sandbox → Server auto-starts (if not running)
+ * 2. Server emits view URL: http://localhost:4001/sandbox/{sandboxId}
+ * 3. User opens URL in browser
+ * 4. Dashboard loads with embedded iframe of sandbox UI
+ * 5. WebSocket subscribes to sandbox events
+ * 6. As model interacts, user sees live updates:
+ *    - Console logs appear in sidebar
+ *    - Files changed trigger reload notifications
+ *    - Screenshots appear in gallery
+ *    - Network requests show in timeline
+ *
+ * Example Usage:
+ * ```
+ * // Start server
+ * const server = SandboxViewServer.getInstance();
+ * await server.start(4001);
+ *
+ * // View URL auto-included in CreateAddon output
+ * // User opens: http://localhost:4001/sandbox/abc-123
+ *
+ * // Server automatically streams events via WebSocket
+ * ```
+ */
+export declare class SandboxViewServer {
+    private static instance;
+    private app;
+    private httpServer;
+    private io;
+    private port;
+    private isRunning;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): SandboxViewServer;
+    /**
+     * Master switch for the dashboard/view-server system (tmux viewer + sandbox
+     * viewer share this one server). When false, the dashboard NEVER binds a port —
+     * not at server boot and not via the tools' demand-start paths.
+     */
+    static isEnabled(): boolean;
+    /**
+     * Agent-facing guidance for when the dashboard is disabled or fails to start.
+     * Surfaced through tool results so the model knows exactly how to proceed.
+     */
+    static readonly DISABLED_NOTICE: string;
+    /**
+     * Start the server with dynamic port conflict resolution
+     */
+    start(startPort?: number): Promise<void>;
+    /**
+     * Try to start server on a specific port
+     */
+    private tryStartOnPort;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get view URL for a sandbox
+     */
+    getViewUrl(sandboxId: string): string;
+    /**
+     * Setup HTTP routes
+     */
+    private setupRoutes;
+    /**
+     * Setup WebSocket event streaming
+     */
+    private setupWebSocket;
+    /**
+     * Generate multi-sandbox dashboard HTML
+     */
+    private generateDashboardHTML;
+    /**
+     * Generate sandbox-specific view HTML
+     */
+    private generateSandboxViewHTML;
+    /**
+     * Generate 404 page
+     */
+    private generate404HTML;
+    /**
+     * Check if server is running
+     */
+    isServerRunning(): boolean;
+    /**
+     * Get current port
+     */
+    getPort(): number;
+    /**
+     * Get Express app instance for route registration
+     * Allows other servers (like TmuxViewServer) to add routes
+     */
+    getApp(): Express;
+    /**
+     * Get Socket.IO server instance for WebSocket handling
+     * Allows other servers to register WebSocket event handlers
+     */
+    getIO(): SocketIOServer;
+}
+/**
+ * Export singleton instance
+ */
+export declare const viewServer: SandboxViewServer;
+//# sourceMappingURL=SandboxViewServer.d.ts.map

package/dist/implementations/addon/SandboxViewServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxViewServer.d.ts","sourceRoot":"","sources":["../../../src/implementations/addon/SandboxViewServer.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,OAAO,EAA+B,MAAM,SAAS,CAAC;AAE7E,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,IAAI,CAAsD;IAClE,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO;IAcP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,eAAe,SAKkC;IAEjE;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C9C;;OAEG;YACW,cAAc;IAuB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,OAAO,CAAC,WAAW;IAkQnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoJ7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2G/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,MAAM,IAAI,OAAO;IAIjB;;;OAGG;IACH,KAAK,IAAI,cAAc;CAGxB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,mBAAkC,CAAC"}