@windagency/valora 2.0.1

package/dist/exploration/container-manager.js

@@ -0,0 +1,390 @@
+/**
+ * Container Manager - Docker container lifecycle management
+ *
+ * Handles creating, monitoring, and destroying Docker containers for explorations
+ */
+import { exec } from 'child_process';
+import { getLogger } from '../output/logger.js';
+import * as path from 'path';
+import { promisify } from 'util';
+import { formatErrorMessage } from '../utils/error-handler.js';
+const execAsync = promisify(exec);
+const logger = getLogger();
+export class ContainerManager {
+    containers;
+    constructor() {
+        this.containers = new Map();
+    }
+    /**
+     * Create and start a container
+     */
+    async createContainer(config) {
+        const { command, container_name: containerName, cpu_limit: cpuLimit, environment, image, memory_limit: memoryLimit, port, shared_volume_path: sharedVolumePath, worktree_path: worktreePath } = config;
+        // Build docker run command
+        const dockerArgs = [
+            'run',
+            '-d', // Detached mode
+            `--name ${containerName}`,
+            `--cpus=${cpuLimit}`,
+            `--memory=${memoryLimit}`,
+            `-v ${path.resolve(worktreePath)}:/workspace`,
+            `-v ${path.resolve(sharedVolumePath)}:/shared`,
+            '-w /workspace' // Set working directory
+        ];
+        // Add port mapping if specified
+        if (port) {
+            dockerArgs.push(`-p ${port}:${port}`);
+        }
+        // Add environment variables
+        for (const [key, value] of Object.entries(environment)) {
+            dockerArgs.push(`-e ${key}="${value}"`);
+        }
+        // Add image
+        dockerArgs.push(image);
+        // Add command if specified
+        if (command && command.length > 0) {
+            dockerArgs.push(...command.map((arg) => `"${arg}"`));
+        }
+        const dockerCommand = `docker ${dockerArgs.join(' ')}`;
+        try {
+            logger.debug(`Creating container: ${dockerCommand}`);
+            const { stderr, stdout } = await execAsync(dockerCommand);
+            if (stderr && !stderr.includes('WARNING')) {
+                logger.warn(`Docker stderr: ${stderr}`);
+            }
+            const containerId = stdout.trim();
+            // Store container info
+            this.containers.set(containerName, {
+                container_id: containerId,
+                container_name: containerName,
+                started_at: new Date().toISOString(),
+                status: 'running'
+            });
+            logger.info(`Container ${containerName} created: ${containerId.substring(0, 12)}`);
+            return containerId;
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to create container ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Create multiple containers in parallel
+     */
+    async createMultipleContainers(configs) {
+        const promises = configs.map((config) => this.createContainer(config));
+        return Promise.all(promises);
+    }
+    /**
+     * Stop a container
+     */
+    async stopContainer(containerName, timeout = 30) {
+        try {
+            logger.debug(`Stopping container: ${containerName} (timeout: ${timeout}s)`);
+            await execAsync(`docker stop -t ${timeout} ${containerName}`);
+            // Update container info
+            const info = this.containers.get(containerName);
+            if (info) {
+                info.status = 'exited';
+                info.finished_at = new Date().toISOString();
+            }
+            logger.info(`Container ${containerName} stopped`);
+        }
+        catch (error) {
+            // If container doesn't exist or already stopped, that's okay
+            const errorMessage = formatErrorMessage(error);
+            if (!errorMessage.includes('No such container') && !errorMessage.includes('is not running')) {
+                throw new Error(`Failed to stop container ${containerName}: ${errorMessage}`);
+            }
+            logger.warn(`Container ${containerName} not found or already stopped`);
+        }
+    }
+    /**
+     * Stop multiple containers in parallel
+     */
+    async stopMultipleContainers(containerNames, timeout = 30) {
+        const promises = containerNames.map((name) => this.stopContainer(name, timeout));
+        await Promise.all(promises);
+    }
+    /**
+     * Remove a container
+     */
+    async removeContainer(containerName, force = false) {
+        const forceFlag = force ? '-f' : '';
+        const command = `docker rm ${forceFlag} ${containerName}`.trim();
+        try {
+            logger.debug(`Removing container: ${containerName}`);
+            await execAsync(command);
+            // Remove from tracking
+            this.containers.delete(containerName);
+            logger.info(`Container ${containerName} removed`);
+        }
+        catch (error) {
+            // If container doesn't exist, that's okay
+            const errorMessage = formatErrorMessage(error);
+            if (!errorMessage.includes('No such container')) {
+                throw new Error(`Failed to remove container ${containerName}: ${errorMessage}`);
+            }
+            logger.warn(`Container ${containerName} not found`);
+        }
+    }
+    /**
+     * Remove multiple containers in parallel
+     */
+    async removeMultipleContainers(containerNames, force = false) {
+        const promises = containerNames.map((name) => this.removeContainer(name, force));
+        await Promise.all(promises);
+    }
+    /**
+     * Get container status
+     */
+    async getContainerStatus(containerName) {
+        try {
+            const { stdout } = await execAsync(`docker inspect --format="{{.State.Status}}|{{.State.ExitCode}}|{{.State.StartedAt}}|{{.State.FinishedAt}}" ${containerName}`);
+            const parts = stdout.trim().split('|');
+            const status = parts[0] ?? 'exited';
+            const exitCode = parts[1] ?? '0';
+            const startedAt = parts[2] ?? '0001-01-01T00:00:00Z';
+            const finishedAt = parts[3] ?? '0001-01-01T00:00:00Z';
+            const info = {
+                container_id: containerName, // Will be replaced with actual ID below
+                container_name: containerName,
+                exit_code: exitCode !== '0' ? parseInt(exitCode) : undefined,
+                finished_at: finishedAt !== '0001-01-01T00:00:00Z' ? finishedAt : undefined,
+                started_at: startedAt !== '0001-01-01T00:00:00Z' ? startedAt : undefined,
+                status: status
+            };
+            // Get actual container ID
+            const { stdout: idOutput } = await execAsync(`docker inspect --format="{{.Id}}" ${containerName}`);
+            info.container_id = idOutput.trim();
+            // Update cached info
+            this.containers.set(containerName, info);
+            return info;
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to get container status for ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Get container statistics
+     */
+    async getContainerStats(containerName, worktreeIndex) {
+        try {
+            // Get container stats (no-stream for single snapshot)
+            const { stdout } = await execAsync(`docker stats ${containerName} --no-stream --format "{{.Container}}|{{.CPUPerc}}|{{.MemUsage}}"`);
+            const parts = stdout.trim().split('|');
+            const containerId = parts[0] ?? '';
+            const cpuPercStr = parts[1] ?? '0%';
+            const memUsageStr = parts[2] ?? '0MiB / 0MiB';
+            // Parse CPU percentage (e.g., "15.23%")
+            const cpuUsagePercent = parseFloat(cpuPercStr.replace('%', ''));
+            // Parse memory usage (e.g., "256MiB / 2GiB")
+            const memParts = memUsageStr.split(' / ');
+            const memUsageMb = this.parseMemoryString(memParts[0] ?? '0MiB');
+            const memLimitMb = this.parseMemoryString(memParts[1] ?? '0MiB');
+            // Get container status
+            const info = await this.getContainerStatus(containerName);
+            return {
+                container_id: containerId,
+                cpu_usage_percent: cpuUsagePercent,
+                exit_code: info.exit_code,
+                memory_limit_mb: memLimitMb,
+                memory_usage_mb: memUsageMb,
+                status: info.status === 'running' ? 'running' : info.status === 'exited' ? 'exited' : 'stopped',
+                uptime_seconds: this.calculateUptime(info.started_at, info.finished_at),
+                worktree_index: worktreeIndex
+            };
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to get container stats for ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Get statistics for multiple containers
+     */
+    async getMultipleContainerStats(containerNames, worktreeIndices) {
+        const promises = containerNames.map((name, index) => this.getContainerStats(name, worktreeIndices[index] ?? 0));
+        return Promise.all(promises);
+    }
+    /**
+     * Get container logs
+     */
+    async getContainerLogs(containerName, tail = 100) {
+        try {
+            const { stdout } = await execAsync(`docker logs --tail ${tail} ${containerName}`);
+            return stdout;
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to get logs for ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Execute a command in a running container
+     */
+    async execInContainer(containerName, command) {
+        try {
+            const dockerCommand = `docker exec ${containerName} ${command.join(' ')}`;
+            const { stderr, stdout } = await execAsync(dockerCommand);
+            return { stderr, stdout };
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to execute command in ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Check if a container exists
+     */
+    async containerExists(containerName) {
+        try {
+            await execAsync(`docker inspect ${containerName}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Wait for container to exit
+     */
+    async waitForContainer(containerName, timeout) {
+        try {
+            const timeoutArg = timeout ? `-t ${timeout}` : '';
+            const { stdout } = await execAsync(`docker wait ${timeoutArg} ${containerName}`.trim());
+            return parseInt(stdout.trim());
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to wait for container ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Pull Docker image if not present
+     */
+    async pullImageIfNeeded(image) {
+        try {
+            // Check if image exists locally
+            await execAsync(`docker image inspect ${image}`);
+            logger.debug(`Image ${image} already exists locally`);
+            return false;
+        }
+        catch {
+            // Image doesn't exist, pull it
+            logger.info(`Pulling Docker image: ${image}`);
+            try {
+                await execAsync(`docker pull ${image}`);
+                logger.info(`Successfully pulled image: ${image}`);
+                return true;
+            }
+            catch (error) {
+                const errorMessage = formatErrorMessage(error);
+                throw new Error(`Failed to pull image ${image}: ${errorMessage}`);
+            }
+        }
+    }
+    /**
+     * Pause a container
+     */
+    async pauseContainer(containerName) {
+        try {
+            await execAsync(`docker pause ${containerName}`);
+            const info = this.containers.get(containerName);
+            if (info) {
+                info.status = 'paused';
+            }
+            logger.info(`Container ${containerName} paused`);
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to pause container ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Unpause a container
+     */
+    async unpauseContainer(containerName) {
+        try {
+            await execAsync(`docker unpause ${containerName}`);
+            const info = this.containers.get(containerName);
+            if (info) {
+                info.status = 'running';
+            }
+            logger.info(`Container ${containerName} unpaused`);
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            throw new Error(`Failed to unpause container ${containerName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Kill a container (force stop)
+     */
+    async killContainer(containerName, signal = 'SIGKILL') {
+        try {
+            await execAsync(`docker kill -s ${signal} ${containerName}`);
+            const info = this.containers.get(containerName);
+            if (info) {
+                info.status = 'exited';
+                info.finished_at = new Date().toISOString();
+            }
+            logger.info(`Container ${containerName} killed with ${signal}`);
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            if (!errorMessage.includes('No such container')) {
+                throw new Error(`Failed to kill container ${containerName}: ${errorMessage}`);
+            }
+        }
+    }
+    /**
+     * Get all tracked containers
+     */
+    getTrackedContainers() {
+        return Array.from(this.containers.values());
+    }
+    /**
+     * Clear tracking for a container
+     */
+    untrackContainer(containerName) {
+        this.containers.delete(containerName);
+    }
+    /**
+     * Clear all tracking
+     */
+    clearTracking() {
+        this.containers.clear();
+    }
+    /**
+     * Parse memory string (e.g., "256MiB", "2GiB") to MB
+     */
+    parseMemoryString(memStr) {
+        const match = memStr.match(/^([\d.]+)(MiB|GiB|KiB|B)$/);
+        if (!match) {
+            return 0;
+        }
+        const value = match[1] ? parseFloat(match[1]) : 0;
+        const unit = match[2] ?? 'MiB';
+        const unitMultipliers = {
+            B: 1 / (1024 * 1024),
+            GiB: 1024,
+            KiB: 1 / 1024,
+            MiB: 1
+        };
+        return value * (unitMultipliers[unit] ?? 0);
+    }
+    /**
+     * Calculate uptime in seconds
+     */
+    calculateUptime(startedAt, finishedAt) {
+        if (!startedAt) {
+            return 0;
+        }
+        const start = new Date(startedAt);
+        const end = finishedAt ? new Date(finishedAt) : new Date();
+        return Math.floor((end.getTime() - start.getTime()) / 1000);
+    }
+}
+//# sourceMappingURL=container-manager.js.map

package/dist/exploration/container-manager.js.map

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

package/dist/exploration/dashboard-controls.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Dashboard Controls - Interactive controls for exploration management
+ *
+ * Provides keyboard shortcuts and controls for pause/resume/stop operations
+ */
+import type { Exploration } from '../types/exploration.types.js';
+import React from 'react';
+interface ControlsProps {
+    exploration: Exploration;
+    onExit: () => void;
+    onExplorationUpdate: (exploration: Exploration) => void;
+}
+/**
+ * Interactive controls component
+ */
+export declare const DashboardControls: React.FC<ControlsProps>;
+/**
+ * Help panel showing available commands
+ */
+export declare const HelpPanel: React.FC<{
+    visible: boolean;
+}>;
+export {};
+//# sourceMappingURL=dashboard-controls.d.ts.map

package/dist/exploration/dashboard-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-controls.d.ts","sourceRoot":"","sources":["../../src/exploration/dashboard-controls.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,KAAsC,MAAM,OAAO,CAAC;AAa3D,UAAU,aAAa;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mBAAmB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;CACxD;AAiMD;;GAEG;AAEH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAqHrD,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAmCpD,CAAC"}

package/dist/exploration/dashboard-controls.js

@@ -0,0 +1,221 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getLogger } from '../output/logger.js';
+import { useEffect, useRef, useState } from 'react';
+import { getTUIAdapter } from '../ui/tui-adapter.interface.js';
+import { formatErrorMessage } from '../utils/error-utils.js';
+import { ContainerManager } from './container-manager.js';
+import { ExplorationStateManager } from './exploration-state.js';
+const tui = getTUIAdapter();
+// eslint-disable-next-line @typescript-eslint/naming-convention -- React components must be PascalCase
+const { Box, Text } = tui;
+const logger = getLogger();
+/**
+ * Custom hook to manage exploration operations
+ */
+function useExplorationControls(exploration, onExplorationUpdate, setState, showMessage, onExit, exitTimeoutRef) {
+    const containerManagerRef = useRef(null);
+    const stateManagerRef = useRef(null);
+    containerManagerRef.current ??= new ContainerManager();
+    stateManagerRef.current ??= new ExplorationStateManager();
+    const containerManager = containerManagerRef.current;
+    const stateManager = stateManagerRef.current;
+    const pauseExploration = async () => {
+        try {
+            logger.info('Pausing exploration...');
+            showMessage('Pausing containers...', 'info');
+            for (const worktree of exploration.worktrees) {
+                if (worktree.container_id && worktree.status === 'running') {
+                    await containerManager.pauseContainer(worktree.container_id);
+                }
+            }
+            exploration.status = 'stopped';
+            await stateManager.saveExploration(exploration);
+            onExplorationUpdate(exploration);
+            setState((prev) => ({ ...prev, isPaused: true }));
+            showMessage('Exploration paused', 'success');
+            logger.info('Exploration paused successfully');
+        }
+        catch (error) {
+            const message = formatErrorMessage(error);
+            logger.error(`Failed to pause: ${message}`);
+            showMessage(`Failed to pause: ${message}`, 'error');
+        }
+    };
+    const resumeExploration = async () => {
+        try {
+            logger.info('Resuming exploration...');
+            showMessage('Resuming containers...', 'info');
+            for (const worktree of exploration.worktrees) {
+                if (worktree.container_id && exploration.status === 'stopped') {
+                    await containerManager.unpauseContainer(worktree.container_id);
+                }
+            }
+            exploration.status = 'running';
+            await stateManager.saveExploration(exploration);
+            onExplorationUpdate(exploration);
+            setState((prev) => ({ ...prev, isPaused: false }));
+            showMessage('Exploration resumed', 'success');
+            logger.info('Exploration resumed successfully');
+        }
+        catch (error) {
+            const message = formatErrorMessage(error);
+            logger.error(`Failed to resume: ${message}`);
+            showMessage(`Failed to resume: ${message}`, 'error');
+        }
+    };
+    const stopExploration = async () => {
+        try {
+            logger.info('Stopping exploration...');
+            showMessage('Stopping all containers...', 'info');
+            for (const worktree of exploration.worktrees) {
+                if (worktree.container_id) {
+                    try {
+                        await containerManager.stopContainer(worktree.container_id);
+                    }
+                    catch (error) {
+                        const message = formatErrorMessage(error);
+                        logger.warn(`Failed to stop container ${worktree.container_id}: ${message}`);
+                    }
+                }
+            }
+            exploration.status = 'stopped';
+            exploration.completed_at = new Date().toISOString();
+            await stateManager.saveExploration(exploration);
+            onExplorationUpdate(exploration);
+            showMessage('Exploration stopped', 'success');
+            logger.info('Exploration stopped successfully');
+            if (exitTimeoutRef.current) {
+                clearTimeout(exitTimeoutRef.current);
+            }
+            exitTimeoutRef.current = setTimeout(() => {
+                onExit();
+            }, 2000);
+        }
+        catch (error) {
+            const message = formatErrorMessage(error);
+            logger.error(`Failed to stop: ${message}`);
+            showMessage(`Failed to stop: ${message}`, 'error');
+        }
+    };
+    const killExploration = async () => {
+        try {
+            logger.info('Killing exploration...');
+            showMessage('Forcefully killing all containers...', 'info');
+            for (const worktree of exploration.worktrees) {
+                if (worktree.container_id) {
+                    try {
+                        await containerManager.killContainer(worktree.container_id);
+                    }
+                    catch (error) {
+                        const message = formatErrorMessage(error);
+                        logger.warn(`Failed to kill container ${worktree.container_id}: ${message}`);
+                    }
+                }
+            }
+            exploration.status = 'failed';
+            exploration.completed_at = new Date().toISOString();
+            await stateManager.saveExploration(exploration);
+            onExplorationUpdate(exploration);
+            showMessage('Exploration killed', 'success');
+            logger.info('Exploration killed successfully');
+            if (exitTimeoutRef.current) {
+                clearTimeout(exitTimeoutRef.current);
+            }
+            exitTimeoutRef.current = setTimeout(() => {
+                onExit();
+            }, 2000);
+        }
+        catch (error) {
+            const message = formatErrorMessage(error);
+            logger.error(`Failed to kill: ${message}`);
+            showMessage(`Failed to kill: ${message}`, 'error');
+        }
+    };
+    return {
+        killExploration,
+        pauseExploration,
+        resumeExploration,
+        stopExploration
+    };
+}
+/**
+ * Handle keyboard input for dashboard controls
+ */
+function handleKeyboardInput(input, key, state, handlers) {
+    if (input === 'q' || (key.ctrl === true && input === 'c')) {
+        handlers.onExit();
+        return;
+    }
+    const keyHandlers = {
+        k: () => void handlers.killExploration(),
+        p: state.isPaused ? undefined : () => void handlers.pauseExploration(),
+        r: state.isPaused ? () => void handlers.resumeExploration() : undefined,
+        s: () => void handlers.stopExploration()
+    };
+    const handler = keyHandlers[input];
+    handler?.();
+}
+/**
+ * Interactive controls component
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention -- React component must be PascalCase
+export const DashboardControls = ({ exploration, onExit, onExplorationUpdate }) => {
+    const [state, setState] = useState({
+        isPaused: false
+    });
+    // Refs to track timeouts for cleanup (prevents memory leaks)
+    const messageTimeoutRef = useRef(null);
+    const exitTimeoutRef = useRef(null);
+    // Cleanup all timeouts on unmount
+    useEffect(() => {
+        return () => {
+            if (messageTimeoutRef.current) {
+                clearTimeout(messageTimeoutRef.current);
+                messageTimeoutRef.current = null;
+            }
+            if (exitTimeoutRef.current) {
+                clearTimeout(exitTimeoutRef.current);
+                exitTimeoutRef.current = null;
+            }
+        };
+    }, []);
+    const showMessage = (message, type = 'info') => {
+        // Clear any existing message timeout to prevent accumulation
+        if (messageTimeoutRef.current) {
+            clearTimeout(messageTimeoutRef.current);
+        }
+        setState((prev) => ({ ...prev, message, messageType: type }));
+        messageTimeoutRef.current = setTimeout(() => {
+            setState((prev) => ({ ...prev, message: undefined, messageType: undefined }));
+            messageTimeoutRef.current = null;
+        }, 3000);
+    };
+    const { killExploration, pauseExploration, resumeExploration, stopExploration } = useExplorationControls(exploration, onExplorationUpdate, setState, showMessage, onExit, exitTimeoutRef);
+    // Keyboard input handling
+    tui.useInput((input, key) => {
+        handleKeyboardInput(input, key, state, {
+            killExploration,
+            onExit,
+            pauseExploration,
+            resumeExploration,
+            stopExploration
+        });
+    });
+    const messageColorMap = {
+        error: 'red',
+        info: 'cyan',
+        success: 'green'
+    };
+    const messageColor = state.messageType ? messageColorMap[state.messageType] : 'cyan';
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { borderColor: "blue", borderStyle: "round", padding: 1, children: _jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Text, { bold: true, color: "blue", children: "\uD83C\uDFAE Controls" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["[P] ", state.isPaused ? 'Paused' : 'Pause', " | [R] Resume | [S] Stop | [K] Kill | [Q] Quit"] }) }), state.message && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: messageColor, children: ["\u2192 ", state.message] }) }))] }) }), _jsxs(Box, { marginTop: 1, children: [state.isPaused && (_jsx(Text, { bold: true, color: "yellow", children: "\u23F8\uFE0F PAUSED" })), exploration.status === 'running' && !state.isPaused && (_jsx(Text, { bold: true, color: "green", children: "\u25B6\uFE0F RUNNING" })), exploration.status === 'stopped' && (_jsx(Text, { bold: true, color: "yellow", children: "\u23F9\uFE0F STOPPED" })), exploration.status === 'completed' && (_jsx(Text, { bold: true, color: "green", children: "\u2705 COMPLETED" })), exploration.status === 'failed' && (_jsx(Text, { bold: true, color: "red", children: "\u274C FAILED" }))] })] }));
+};
+/**
+ * Help panel showing available commands
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention -- React component must be PascalCase
+export const HelpPanel = ({ visible }) => {
+    if (!visible)
+        return null;
+    return (_jsx(Box, { borderColor: "cyan", borderStyle: "round", padding: 1, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: "cyan", children: "\u2328\uFE0F Keyboard Shortcuts" }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "P" }), _jsx(Text, { dimColor: true, children: " - Pause all containers" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "R" }), _jsx(Text, { dimColor: true, children: " - Resume paused exploration" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "S" }), _jsx(Text, { dimColor: true, children: " - Stop exploration gracefully" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "K" }), _jsx(Text, { dimColor: true, children: " - Kill exploration (force stop)" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Q" }), _jsx(Text, { dimColor: true, children: " - Quit dashboard (Ctrl+C also works)" })] })] })] }) }));
+};
+//# sourceMappingURL=dashboard-controls.js.map