@nexus-cortex/executors 4.26.0

package/dist/implementations/tmux/TmuxViewServer.js

@@ -0,0 +1,480 @@
+/**
+ * TmuxViewServer - Live web-based tmux session viewer
+ *
+ * Extends SandboxViewServer to provide real-time tmux session viewing.
+ * No headless browser needed - renders in user's browser!
+ *
+ * Features:
+ * - Live terminal rendering with xterm.js
+ * - Real-time output streaming via WebSocket
+ * - Session list dashboard
+ * - Direct attach to tmux sessions
+ * - Works in any environment (no Chromium needed!)
+ *
+ * Architecture:
+ * - Piggybacks on SandboxViewServer (port 4001)
+ * - Adds /tmux routes alongside /sandbox routes
+ * - Uses TerminalSandbox for xterm.js rendering
+ * - Connects xterm.js to tmux session via PTY
+ *
+ * User Flow:
+ * 1. User creates tmux session
+ * 2. Server returns view URL: http://localhost:4001/tmux/{sessionId}
+ * 3. User opens URL in their browser
+ * 4. See live terminal with full colors, formatting, updates
+ * 5. Can interact if desired (type, scroll, etc.)
+ *
+ * Example:
+ * ```
+ * const viewServer = TmuxViewServer.getInstance();
+ * await viewServer.start(); // Auto-starts if not running
+ *
+ * const url = viewServer.getTmuxViewUrl("my-session");
+ * // Returns: http://localhost:4001/tmux/my-session
+ * ```
+ */
+import { SandboxViewServer } from '../addon/SandboxViewServer.js';
+import { TmuxManager } from '../../utils/TmuxManager.js';
+import { SessionPersistence } from '../../utils/SessionPersistence.js';
+export class TmuxViewServer {
+    static instance;
+    sandboxViewServer;
+    tmuxManager;
+    persistence;
+    isInitialized = false;
+    recoveredSessions = new Map();
+    constructor() {
+        this.sandboxViewServer = SandboxViewServer.getInstance();
+        this.tmuxManager = TmuxManager.getInstance();
+        // Use PROJECT_ROOT if set (server sets this to monorepo root), otherwise fallback to cwd
+        const projectRoot = process.env.PROJECT_ROOT || process.cwd();
+        this.persistence = new SessionPersistence(projectRoot);
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!TmuxViewServer.instance) {
+            TmuxViewServer.instance = new TmuxViewServer();
+        }
+        return TmuxViewServer.instance;
+    }
+    /**
+     * Initialize tmux viewing routes
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        // Start SandboxViewServer with dynamic port resolution (starting from 4001)
+        // It will automatically find the next available port if 4001 is occupied
+        await this.sandboxViewServer.start(4001);
+        // Add tmux-specific routes
+        this.addTmuxRoutes();
+        this.isInitialized = true;
+        const actualPort = this.sandboxViewServer.getPort();
+        console.log(` Tmux view routes initialized at http://localhost:${actualPort}/tmux`);
+    }
+    /**
+     * Get view URL for a tmux session (uses dynamically assigned port)
+     */
+    getTmuxViewUrl(sessionId) {
+        const port = this.sandboxViewServer.getPort();
+        return `http://localhost:${port}/tmux/${sessionId}`;
+    }
+    /**
+     * Get tmux dashboard URL (uses dynamically assigned port)
+     */
+    getTmuxDashboardUrl() {
+        const port = this.sandboxViewServer.getPort();
+        return `http://localhost:${port}/tmux`;
+    }
+    /**
+     * Get tmux API URL (uses dynamically assigned port)
+     */
+    getTmuxApiUrl() {
+        const port = this.sandboxViewServer.getPort();
+        return `http://localhost:${port}/api/tmux/sessions`;
+    }
+    markRecovered(sessionIds) {
+        const now = new Date();
+        for (const id of sessionIds) {
+            this.recoveredSessions.set(id, now);
+        }
+    }
+    /**
+     * Add tmux-specific routes to the express app
+     */
+    addTmuxRoutes() {
+        const app = this.sandboxViewServer.getApp();
+        const io = this.sandboxViewServer.getIO();
+        // Tmux dashboard - list all sessions
+        app.get('/tmux', async (req, res) => {
+            res.send(this.generateTmuxDashboardHTML());
+        });
+        // Live terminal view for specific session
+        app.get('/tmux/:sessionId', async (req, res) => {
+            const sessionId = req.params.sessionId;
+            // Check if session exists
+            if (!(await this.tmuxManager.sessionExists(sessionId))) {
+                res.status(404).send(this.generateTmux404HTML(sessionId));
+                return;
+            }
+            res.send(this.generateTmuxSessionHTML(sessionId));
+        });
+        // API: Get session list with metadata (only active sessions)
+        app.get('/api/tmux/sessions', async (req, res) => {
+            try {
+                // Get list of actually running tmux sessions
+                const activeSessions = await this.tmuxManager.listSessions();
+                // Get metadata for all sessions
+                const allMetadata = await this.persistence.listSessions();
+                const metadataMap = new Map(allMetadata.map(m => [m.sessionId, m]));
+                // Build session list - include ALL active tmux sessions
+                const sessions = await Promise.all(activeSessions.map(async (sessionId) => {
+                    // Use existing metadata if available, otherwise create minimal metadata
+                    const recovered = this.recoveredSessions.has(sessionId);
+                    const recoveredAt = this.recoveredSessions.get(sessionId) || null;
+                    if (metadataMap.has(sessionId)) {
+                        const meta = metadataMap.get(sessionId);
+                        return {
+                            sessionId: meta.sessionId,
+                            workingDirectory: meta.cwd || process.cwd(),
+                            created: meta.created,
+                            lastUsed: meta.lastUsed,
+                            commandCount: 0,
+                            recovered,
+                            recoveredAt
+                        };
+                    }
+                    else {
+                        return {
+                            sessionId,
+                            workingDirectory: process.cwd(),
+                            created: new Date(),
+                            lastUsed: new Date(),
+                            commandCount: 0,
+                            recovered,
+                            recoveredAt
+                        };
+                    }
+                }));
+                res.json({ sessions, dashboardUrl: this.getTmuxDashboardUrl() });
+            }
+            catch (error) {
+                res.status(500).json({ error: error.message });
+            }
+        });
+        // Setup WebSocket handlers for tmux
+        this.setupTmuxWebSocket(io);
+        console.log('[OK] Tmux routes registered:');
+        console.log(' GET  /tmux              - Tmux dashboard');
+        console.log(' GET  /tmux/:sessionId   - Live terminal view');
+        console.log(' GET  /api/tmux/sessions - Session list API');
+    }
+    /**
+     * Setup WebSocket handlers for tmux interaction
+     */
+    setupTmuxWebSocket(io) {
+        io.on('connection', (socket) => {
+            // Subscribe to tmux session
+            socket.on('subscribe-tmux', async (sessionId) => {
+                console.log(`[WS] Client ${socket.id} subscribed to tmux: ${sessionId}`);
+                socket.join(`tmux-${sessionId}`);
+                // Send initial capture
+                try {
+                    const output = await this.tmuxManager.capturePane(sessionId);
+                    socket.emit('tmux-output', { output });
+                }
+                catch (error) {
+                    socket.emit('tmux-error', { error: error.message });
+                }
+            });
+            // Handle terminal input from client
+            socket.on('tmux-input', async ({ sessionId, input }) => {
+                try {
+                    await this.tmuxManager.sendKeys(sessionId, input);
+                }
+                catch (error) {
+                    socket.emit('tmux-error', { error: error.message });
+                }
+            });
+            // Manual capture request
+            socket.on('tmux-capture', async (sessionId) => {
+                try {
+                    const output = await this.tmuxManager.capturePane(sessionId);
+                    socket.emit('tmux-output', { output });
+                }
+                catch (error) {
+                    socket.emit('tmux-error', { error: error.message });
+                }
+            });
+            // Unsubscribe from tmux session
+            socket.on('unsubscribe-tmux', (sessionId) => {
+                console.log(`[WS] Client ${socket.id} unsubscribed from tmux: ${sessionId}`);
+                socket.leave(`tmux-${sessionId}`);
+            });
+        });
+    }
+    /**
+     * Generate 404 page for missing tmux session
+     */
+    generateTmux404HTML(sessionId) {
+        return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Cortex Intelligence // Session Not Found</title>
+  <link href="https://fonts.googleapis.com/css2?family=Orbitron:wght@400;500;700&family=Oxygen+Mono&display=swap" rel="stylesheet">
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: 'Oxygen Mono', monospace; font-size: 12px; background: #0f172a; color: #e2e8f0; display: flex; align-items: center; justify-content: center; height: 100vh; text-align: center; }
+    .error-container { max-width: 440px; padding: 40px; background: #1e293b; border: 1px solid #334155; border-radius: 6px; }
+    h1 { font-size: 14px; font-weight: 400; letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 12px; color: #f8fafc; }
+    p { color: #94a3b8; font-size: 11px; margin-bottom: 8px; }
+    .session-id { background: #253347; padding: 8px 12px; border-radius: 6px; margin: 16px 0; color: #f87171; font-size: 11px; border: 1px solid #283548; }
+    a { color: #4a90d9; text-decoration: none; font-size: 11px; letter-spacing: 0.04em; }
+    a:hover { color: #f8fafc; }
+  </style>
+</head>
+<body>
+  <div class="error-container">
+    <h1>Tmux Session Not Found</h1>
+    <p>The tmux session you're looking for doesn't exist or has been terminated.</p>
+    <div class="session-id">${sessionId}</div>
+    <p><a href="/tmux">&larr; Back to Tmux Dashboard</a></p>
+  </div>
+</body>
+</html>
+    `;
+    }
+    /**
+     * Generate tmux dashboard HTML
+     */
+    generateTmuxDashboardHTML() {
+        return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Cortex Intelligence // Tmux Sessions</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Orbitron:wght@400;500;700&family=Oxygen+Mono&display=swap" rel="stylesheet">
+  <style>
+    :root {
+      --cx-primary: #4a90d9; --cx-primary-rgb: 74, 144, 217;
+      --cx-positive: #4ade80; --cx-positive-rgb: 74, 222, 128;
+      --cx-bg: #0f172a; --cx-bg2: #1e293b; --cx-bg3: #253347;
+      --cx-text: #e2e8f0; --cx-text2: #b0b8c4; --cx-muted: #94a3b8; --cx-heading: #f8fafc;
+      --cx-border: #334155; --cx-border2: #283548;
+      --cx-radius: 6px;
+      --cx-font: 'Oxygen Mono', monospace;
+    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: var(--cx-font); font-size: 12px; line-height: 1.5; color: var(--cx-text); background: var(--cx-bg); padding: 24px 20px; min-height: 100vh; }
+    body::before { content: ''; position: fixed; inset: 0; background: radial-gradient(ellipse at 20% 50%, rgba(var(--cx-primary-rgb), 0.04) 0%, transparent 60%), linear-gradient(180deg, var(--cx-bg) 0%, #080818 100%); pointer-events: none; z-index: 0; }
+    .shell { position: relative; z-index: 1; max-width: 1200px; margin: 0 auto; }
+    .header-bar { display: flex; align-items: center; justify-content: space-between; padding: 12px 16px; background: var(--cx-bg2); border: 1px solid var(--cx-border); border-radius: var(--cx-radius); margin-bottom: 20px; }
+    .header-bar h1 { font-family: 'Orbitron', var(--cx-font); font-size: 14px; font-weight: 500; letter-spacing: 0.12em; text-transform: uppercase; color: var(--cx-heading); }
+    .header-bar .badge { font-size: 10px; color: var(--cx-muted); padding: 2px 8px; border: 1px solid var(--cx-border2); border-radius: var(--cx-radius); }
+    .nav-link { font-size: 10px; color: var(--cx-primary); text-decoration: none; letter-spacing: 0.04em; transition: color 200ms; }
+    .nav-link:hover { color: var(--cx-heading); }
+    .sessions { display: grid; gap: 10px; }
+    .session-card { background: var(--cx-bg2); border: 1px solid var(--cx-border); border-radius: var(--cx-radius); padding: 14px 16px; transition: all 200ms ease; cursor: pointer; }
+    .session-card:hover { border-color: rgba(var(--cx-primary-rgb), 0.5); box-shadow: 0 0 16px rgba(var(--cx-primary-rgb), 0.1); }
+    .session-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 8px; }
+    .session-id { font-size: 12px; color: var(--cx-primary); letter-spacing: 0.04em; }
+    .session-status { padding: 2px 8px; border-radius: var(--cx-radius); font-size: 9px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--cx-positive); border: 1px solid rgba(var(--cx-positive-rgb), 0.3); }
+    .session-recovered { padding: 2px 8px; border-radius: var(--cx-radius); font-size: 9px; letter-spacing: 0.1em; text-transform: uppercase; color: #fbbf24; border: 1px solid rgba(251, 191, 36, 0.3); }
+    .session-info { color: var(--cx-muted); font-size: 10px; line-height: 1.8; }
+    .session-info strong { color: var(--cx-text2); }
+    .no-sessions { text-align: center; padding: 60px 20px; color: var(--cx-muted); font-size: 11px; }
+    .refresh-btn { position: fixed; bottom: 20px; right: 20px; font-family: var(--cx-font); font-size: 10px; letter-spacing: 0.06em; text-transform: uppercase; color: var(--cx-primary); background: var(--cx-bg2); border: 1px solid rgba(var(--cx-primary-rgb), 0.3); border-radius: var(--cx-radius); padding: 8px 16px; cursor: pointer; transition: all 200ms ease; z-index: 10; }
+    .refresh-btn:hover { background: rgba(var(--cx-primary-rgb), 0.08); border-color: rgba(var(--cx-primary-rgb), 0.5); box-shadow: 0 0 12px rgba(var(--cx-primary-rgb), 0.15); }
+    @keyframes fade-up { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+    .anim-in { animation: fade-up 400ms ease both; }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <div class="header-bar anim-in">
+      <div style="display: flex; align-items: center; gap: 12px;">
+        <h1>Cortex Intelligence // Tmux</h1>
+        <span class="badge">TERMINAL</span>
+      </div>
+      <div style="display: flex; align-items: center; gap: 16px;">
+        <a href="/" class="nav-link">Sandbox Dashboard</a>
+        <span style="font-size: 11px; color: var(--cx-muted);">Live terminal sessions</span>
+      </div>
+    </div>
+
+    <div class="sessions" id="sessions">
+      <div class="no-sessions">Loading sessions...</div>
+    </div>
+  </div>
+
+  <button class="refresh-btn" onclick="loadSessions()">Refresh</button>
+
+  <script>
+    async function loadSessions() {
+      try {
+        const response = await fetch('/api/tmux/sessions');
+        const data = await response.json();
+        const container = document.getElementById('sessions');
+
+        if (data.sessions.length === 0) {
+          container.innerHTML = '<div class="no-sessions">No active tmux sessions</div>';
+          return;
+        }
+
+        container.innerHTML = data.sessions.map((session, i) => \`
+          <div class="session-card anim-in" style="animation-delay: \${i * 60}ms" onclick="window.location='/tmux/\${session.sessionId}'">
+            <div class="session-header">
+              <div class="session-id">\${session.sessionId}</div>
+              <div style="display: flex; gap: 6px; align-items: center;">
+                \${session.recovered ? '<div class="session-recovered">[RECOVERED]</div>' : ''}
+                <div class="session-status">Active</div>
+              </div>
+            </div>
+            <div class="session-info">
+              <div><strong>Directory:</strong> \${session.workingDirectory}</div>
+              <div><strong>Created:</strong> \${new Date(session.created).toLocaleString()}</div>
+              <div><strong>Last Used:</strong> \${new Date(session.lastUsed).toLocaleString()}</div>
+              \${session.recovered ? '<div><strong>Recovered:</strong> ' + new Date(session.recoveredAt).toLocaleString() + '</div>' : ''}
+            </div>
+          </div>
+        \`).join('');
+      } catch (error) {
+        console.error('Failed to load sessions:', error);
+        document.getElementById('sessions').innerHTML = '<div class="no-sessions">Failed to load sessions</div>';
+      }
+    }
+
+    loadSessions();
+    setInterval(loadSessions, 5000);
+  </script>
+</body>
+</html>
+    `;
+    }
+    /**
+     * Generate live terminal view HTML for a specific session
+     */
+    generateTmuxSessionHTML(sessionId) {
+        return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Cortex Intelligence // ${sessionId}</title>
+  <link href="https://fonts.googleapis.com/css2?family=Orbitron:wght@400;500;700&family=Oxygen+Mono&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/xterm@5.3.0/css/xterm.css" />
+  <script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/socket.io-client@4.6.0/dist/socket.io.min.js"></script>
+  <style>
+    :root {
+      --cx-primary: #4a90d9; --cx-primary-rgb: 74, 144, 217;
+      --cx-positive: #4ade80; --cx-positive-rgb: 74, 222, 128;
+      --cx-negative: #f87171;
+      --cx-bg: #0f172a; --cx-bg2: #1e293b;
+      --cx-text: #e2e8f0; --cx-muted: #94a3b8; --cx-heading: #f8fafc;
+      --cx-border: #334155;
+      --cx-radius: 6px;
+      --cx-font: 'Oxygen Mono', monospace;
+    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: var(--cx-font); font-size: 12px; background: var(--cx-bg); color: var(--cx-text); overflow: hidden; }
+    #header { background: var(--cx-bg2); padding: 0 16px; height: 44px; border-bottom: 1px solid var(--cx-border); display: flex; justify-content: space-between; align-items: center; }
+    #header h1 { font-family: 'Orbitron', var(--cx-font); font-size: 12px; font-weight: 500; color: var(--cx-heading); letter-spacing: 0.1em; text-transform: uppercase; }
+    .nav-link { font-size: 10px; color: var(--cx-primary); text-decoration: none; letter-spacing: 0.04em; }
+    .nav-link:hover { color: var(--cx-heading); }
+    #status { font-size: 10px; letter-spacing: 0.08em; text-transform: uppercase; }
+    .connected { color: var(--cx-positive); }
+    .disconnected { color: var(--cx-negative); }
+    #terminal-container { position: absolute; top: 44px; left: 0; right: 0; bottom: 0; padding: 8px; background: #0a0f1a; }
+  </style>
+</head>
+<body>
+  <div id="header">
+    <div style="display: flex; align-items: center; gap: 16px;">
+      <a href="/tmux" class="nav-link">&larr; Sessions</a>
+      <h1>${sessionId}</h1>
+    </div>
+    <div id="status" class="disconnected">Connecting...</div>
+  </div>
+  <div id="terminal-container"></div>
+
+  <script>
+    const term = new Terminal({
+      cursorBlink: true,
+      fontSize: 13,
+      fontFamily: "'Oxygen Mono', 'Menlo', 'Monaco', monospace",
+      theme: {
+        background: '#0a0f1a',
+        foreground: '#e2e8f0',
+        cursor: '#4a90d9',
+        selectionBackground: 'rgba(74, 144, 217, 0.3)',
+        black: '#0f172a',
+        brightBlack: '#334155',
+        red: '#f87171',
+        brightRed: '#fca5a5',
+        green: '#4ade80',
+        brightGreen: '#86efac',
+        yellow: '#fbbf24',
+        brightYellow: '#fde68a',
+        blue: '#4a90d9',
+        brightBlue: '#93c5fd',
+        magenta: '#c084fc',
+        brightMagenta: '#d8b4fe',
+        cyan: '#22d3ee',
+        brightCyan: '#67e8f9',
+        white: '#e2e8f0',
+        brightWhite: '#f8fafc'
+      }
+    });
+
+    const fitAddon = new FitAddon.FitAddon();
+    term.loadAddon(fitAddon);
+    term.open(document.getElementById('terminal-container'));
+    fitAddon.fit();
+    window.addEventListener('resize', () => fitAddon.fit());
+
+    const statusEl = document.getElementById('status');
+    const socket = io({
+      reconnection: true,
+      reconnectionDelay: 1000,
+      reconnectionDelayMax: 5000,
+      reconnectionAttempts: Infinity
+    });
+
+    socket.on('connect', () => {
+      statusEl.textContent = 'Connected';
+      statusEl.className = 'connected';
+      socket.emit('subscribe-tmux', '${sessionId}');
+    });
+    socket.on('disconnect', () => {
+      statusEl.textContent = 'Disconnected';
+      statusEl.className = 'disconnected';
+    });
+    socket.io.on('reconnect_attempt', (attempt) => {
+      statusEl.textContent = 'Reconnecting... (' + attempt + ')';
+      statusEl.className = 'disconnected';
+    });
+    socket.on('tmux-output', (data) => term.write(data.output));
+    socket.on('tmux-error', (data) => {
+      term.write('\\r\\n[ERROR] ' + data.error + '\\r\\n');
+    });
+    term.onData((data) => socket.emit('tmux-input', { sessionId: '${sessionId}', input: data }));
+  </script>
+</body>
+</html>
+    `;
+    }
+}
+//# sourceMappingURL=TmuxViewServer.js.map

package/dist/implementations/tmux/TmuxViewServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TmuxViewServer.js","sourceRoot":"","sources":["../../../src/implementations/tmux/TmuxViewServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,CAAiB;IAChC,iBAAiB,CAAoB;IACrC,WAAW,CAAc;IACzB,WAAW,CAAqB;IAChC,aAAa,GAAY,KAAK,CAAC;IAC/B,iBAAiB,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEzD;QACE,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7C,yFAAyF;QACzF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,2BAA2B;QAC3B,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,qDAAqD,UAAU,OAAO,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAiB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,oBAAoB,IAAI,SAAS,SAAS,EAAE,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,oBAAoB,IAAI,OAAO,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,oBAAoB,IAAI,oBAAoB,CAAC;IACtD,CAAC;IAED,aAAa,CAAC,UAAoB;QAChC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAE1C,qCAAqC;QACrC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;YACrD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,0CAA0C;QAC1C,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;YAChE,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAmB,CAAC;YAEjD,0BAA0B;YAC1B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;YAClE,IAAI,CAAC;gBACH,6CAA6C;gBAC7C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;gBAE7D,gCAAgC;gBAChC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEpE,wDAAwD;gBACxD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAC,SAAS,EAAC,EAAE;oBACnC,wEAAwE;oBACxE,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACxD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;oBAClE,IAAI,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;wBACzC,OAAO;4BACL,SAAS,EAAE,IAAI,CAAC,SAAS;4BACzB,gBAAgB,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;4BAC3C,OAAO,EAAE,IAAI,CAAC,OAAO;4BACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;4BACvB,YAAY,EAAE,CAAC;4BACf,SAAS;4BACT,WAAW;yBACZ,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,OAAO;4BACL,SAAS;4BACT,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;4BAC/B,OAAO,EAAE,IAAI,IAAI,EAAE;4BACnB,QAAQ,EAAE,IAAI,IAAI,EAAE;4BACpB,YAAY,EAAE,CAAC;4BACf,SAAS;4BACT,WAAW;yBACZ,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC,CACH,CAAC;gBAEF,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oCAAoC;QACpC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAE5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,EAAO;QAChC,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAW,EAAE,EAAE;YAClC,4BAA4B;YAC5B,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;gBACtD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,EAAE,wBAAwB,SAAS,EAAE,CAAC,CAAC;gBACzE,MAAM,CAAC,IAAI,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;gBAEjC,uBAAuB;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;oBAC7D,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACzC,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAwC,EAAE,EAAE;gBAC3F,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBACpD,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,yBAAyB;YACzB,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;gBACpD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;oBAC7D,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACzC,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,SAAiB,EAAE,EAAE;gBAClD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,EAAE,4BAA4B,SAAS,EAAE,CAAC,CAAC;gBAC7E,MAAM,CAAC,KAAK,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,SAAiB;QAC3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;8BAuBmB,SAAS;;;;;KAKlC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,yBAAyB;QAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyGN,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,SAAiB;QAC/C,OAAO;;;;;;kCAMuB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAiC/B,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAoDkB,SAAS;;;;;;;;;;;;;;oEAcoB,SAAS;;;;KAIxE,CAAC;IACJ,CAAC;CACF"}

package/dist/implementations/tmux/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tmux Tool Implementations
+ */
+export { TmuxSessionTool } from './TmuxSessionTool.js';
+export { TmuxViewServer } from './TmuxViewServer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/tmux/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/tmux/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/implementations/tmux/index.js

@@ -0,0 +1,6 @@
+/**
+ * Tmux Tool Implementations
+ */
+export { TmuxSessionTool } from './TmuxSessionTool.js';
+export { TmuxViewServer } from './TmuxViewServer.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/tmux/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/tmux/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/implementations/ui/AskUserQuestionTool.d.ts

@@ -0,0 +1,77 @@
+/**
+ * AskUserQuestion Tool Executor
+ *
+ * Present multiple-choice questions to users during execution.
+ * Allows agent to gather user preferences, clarify ambiguous instructions,
+ * and get decisions on implementation choices.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Answer option for a question
+ */
+export interface QuestionOption {
+    /**
+     * Display text for this option (1-5 words)
+     */
+    label: string;
+    /**
+     * Explanation of what this option means
+     */
+    description: string;
+}
+/**
+ * Single question with multiple choice options
+ */
+export interface Question {
+    /**
+     * The complete question to ask
+     */
+    question: string;
+    /**
+     * Short label displayed as chip/tag (max 12 chars)
+     */
+    header: string;
+    /**
+     * Available choices (2-4 options)
+     */
+    options: QuestionOption[];
+    /**
+     * Allow multiple selections
+     */
+    multiSelect: boolean;
+}
+/**
+ * Parameters for the AskUserQuestion tool
+ */
+export interface AskUserQuestionToolParams {
+    /**
+     * Questions to ask (1-4 questions)
+     */
+    questions: Question[];
+    /**
+     * User's answers (filled by client)
+     */
+    answers?: Record<string, string>;
+}
+/**
+ * AskUserQuestion Tool Executor
+ *
+ * Features:
+ * - Present 1-4 multiple choice questions
+ * - Each question has 2-4 options
+ * - Support for single or multi-select
+ * - Clear formatting for user interaction
+ */
+export declare class AskUserQuestionTool extends BaseTool<AskUserQuestionToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: AskUserQuestionToolParams): string | null;
+    getDescription(params: AskUserQuestionToolParams): string;
+    execute(params: AskUserQuestionToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format questions for user display
+     */
+    private formatQuestions;
+}
+//# sourceMappingURL=AskUserQuestionTool.d.ts.map

package/dist/implementations/ui/AskUserQuestionTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserQuestionTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/ui/AskUserQuestionTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ,CAC/C,yBAAyB,EACzB,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAkF1C,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI;IAuEpE,cAAc,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;IAKnD,OAAO,CACX,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IA+DtB;;OAEG;IACH,OAAO,CAAC,eAAe;CAqCxB"}