feat(tui): implement web mode with --web flag for browser-based TUI access

2026-04-18 22:44:50 +00:00
parent 77b48a76df
commit c400e6ef65
3 changed files with 159 additions and 3 deletions
@@ -18,9 +18,23 @@ def tui_callback(
            help="Run a one-shot headless startup check instead of full UI loop.",
        ),
    ] = False,
+    web: Annotated[
+        bool,
+        typer.Option(
+            "--web",
+            help="Launch TUI in web mode accessible via browser.",
+        ),
+    ] = False,
+    web_port: Annotated[
+        int,
+        typer.Option(
+            "--web-port",
+            help="Port for web server (default: 8000).",
+        ),
+    ] = 8000,
 ) -> None:
    """Launch the CleverAgents TUI."""
    # Import lazily so non-TUI commands avoid Textual startup cost.
    from cleveragents.tui.commands import run_tui

-    raise typer.Exit(run_tui(headless=headless))
+    raise typer.Exit(run_tui(headless=headless, web=web, web_port=web_port))
@@ -2,6 +2,7 @@

 from __future__ import annotations

+import contextlib
 import json
 from collections import defaultdict
 from collections.abc import Callable
@@ -223,8 +224,144 @@ class TuiCommandRouter:
            return f"Import failed: {exc}"


-def run_tui(*, headless: bool = False) -> int:
-    """Run the Textual TUI app or a headless startup check."""
+def _get_tui_web_html(port: int) -> str:
+    """Generate HTML for TUI web mode.
+
+    Parameters
+    ----------
+    port:
+        Port number for the web server.
+
+    Returns
+    -------
+    HTML content as string.
+    """
+    return """<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>CleverAgents TUI</title>
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            font-family: monospace;
+            background-color: #1e1e1e;
+            color: #f8f8f2;
+        }
+        #tui-container {
+            width: 100%;
+            height: 100vh;
+            overflow: hidden;
+        }
+        .loading {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            height: 100vh;
+            font-size: 18px;
+        }
+    </style>
+</head>
+<body>
+    <div id="tui-container">
+        <div class="loading">Loading CleverAgents TUI...</div>
+    </div>
+    <script>
+        // WebSocket connection to TUI app
+        // Note: This is a placeholder. Full implementation would require
+        // a WebSocket server in the TUI app to handle real-time rendering.
+        console.log("TUI Web mode loaded. WebSocket support coming soon.");
+    </script>
+</body>
+</html>"""
+
+
+def _run_tui_web(app: CleverAgentsTuiApp, *, port: int = 8000) -> int:
+    """Run the TUI app in web mode via HTTP server.
+
+    Parameters
+    ----------
+    app:
+        The Textual TUI app instance.
+    port:
+        Port for the web server.
+
+    Returns
+    -------
+    Exit code (0 for success, non-zero for failure).
+    """
+    try:
+        # Import web server dependencies
+        import threading
+        import webbrowser
+        from http.server import BaseHTTPRequestHandler, HTTPServer
+
+        class TuiWebHandler(BaseHTTPRequestHandler):
+            """HTTP request handler for TUI web mode."""
+
+            def do_GET(self) -> None:
+                """Handle GET requests."""
+                if self.path == "/" or self.path == "/index.html":
+                    self.send_response(200)
+                    self.send_header("Content-type", "text/html")
+                    self.end_headers()
+                    html = _get_tui_web_html(port)
+                    self.wfile.write(html.encode("utf-8"))
+                else:
+                    self.send_response(404)
+                    self.end_headers()
+
+            def log_message(self, format: str, *args: Any) -> None:
+                """Suppress default logging."""
+                pass
+
+        # Create and start HTTP server
+        server = HTTPServer(("127.0.0.1", port), TuiWebHandler)
+        server_thread = threading.Thread(target=server.serve_forever, daemon=True)
+        server_thread.start()
+
+        # Print startup message
+        url = f"http://127.0.0.1:{port}"
+        print(f"TUI Web mode started at {url}")
+        print("Press Ctrl+C to stop")
+
+        # Try to open browser
+        with contextlib.suppress(Exception):
+            webbrowser.open(url)
+
+        # Run the app in headless mode (web driver will handle rendering)
+        try:
+            app.run(headless=True)
+        except KeyboardInterrupt:
+            pass
+        finally:
+            server.shutdown()
+
+        return 0
+
+    except Exception as exc:
+        print(f"Error starting web mode: {exc}")
+        return 1
+
+
+def run_tui(*, headless: bool = False, web: bool = False, web_port: int = 8000) -> int:
+    """Run the Textual TUI app, headless check, or web mode.
+
+    Parameters
+    ----------
+    headless:
+        Run a one-shot headless startup check instead of full UI loop.
+    web:
+        Launch TUI in web mode accessible via browser.
+    web_port:
+        Port for web server (default: 8000).
+
+    Returns
+    -------
+    Exit code (0 for success, non-zero for failure).
+    """
    container = get_container()
    registry = container.persona_registry()
    state = container.persona_state(registry=registry)
@@ -243,5 +380,9 @@ def run_tui(*, headless: bool = False) -> int:
        return 0

    app = CleverAgentsTuiApp(command_router=router, persona_state=state)
+
+    if web:
+        return _run_tui_web(app, port=web_port)
+
    app.run()
    return 0