crca 1.4.0__py3-none-any.whl → 1.5.0__py3-none-any.whl

webui/app.py

@@ -0,0 +1,229 @@
+"""
+Flask application for CRCA Web UI.
+
+Provides a simple REST API and serves the web interface.
+"""
+
+import json
+from typing import Dict, Any, Optional
+from flask import Flask, request, jsonify, render_template, session
+from loguru import logger
+
+from webui.config import AGENTS, get_default_agent_key, get_agent_info, list_agents
+
+# Initialize Flask app
+app = Flask(__name__)
+app.secret_key = "crca-webui-secret-key-change-in-production"  # Change in production
+
+# In-memory agent storage (session-based)
+# In production, consider using Redis or database
+_agent_instances: Dict[str, Any] = {}
+
+
+def get_agent_instance(agent_key: str) -> Optional[Any]:
+    """
+    Get or create an agent instance.
+    
+    Args:
+        agent_key: Agent registry key
+        
+    Returns:
+        Agent instance or None if creation fails
+    """
+    # Check if we already have an instance for this session
+    session_id = session.get("session_id", "default")
+    cache_key = f"{session_id}_{agent_key}"
+    
+    if cache_key in _agent_instances:
+        return _agent_instances[cache_key]
+    
+    # Get agent info
+    agent_info = get_agent_info(agent_key)
+    if not agent_info:
+        logger.error(f"Agent '{agent_key}' not found in registry")
+        return None
+    
+    # Create new instance
+    agent_class = agent_info["class"]
+    try:
+        if agent_key == "general":
+            # GeneralAgent can be initialized with no args (uses defaults)
+            instance = agent_class()
+        elif agent_key == "hybrid":
+            # HybridAgent can be initialized with no args (uses defaults)
+            instance = agent_class()
+        else:
+            # Generic initialization for other agents
+            instance = agent_class()
+        
+        _agent_instances[cache_key] = instance
+        logger.info(f"Created {agent_info['name']} instance for session {session_id}")
+        return instance
+    
+    except Exception as e:
+        logger.error(f"Failed to create agent instance: {e}")
+        return None
+
+
+@app.route("/")
+def index() -> str:
+    """Serve the main web UI page."""
+    return render_template("index.html")
+
+
+@app.route("/api/agents", methods=["GET"])
+def api_agents() -> Any:
+    """
+    Get list of available agents.
+    
+    Returns:
+        JSON response with agent list
+    """
+    agents = list_agents()
+    
+    # Format for frontend
+    agent_list = []
+    for key, info in agents.items():
+        agent_list.append({
+            "key": key,
+            "name": info["name"],
+            "description": info["description"],
+            "requires_llm": info.get("requires_llm", True),
+            "default": info.get("default", False),
+        })
+    
+    return jsonify({
+        "agents": agent_list,
+        "default": get_default_agent_key(),
+    })
+
+
+@app.route("/api/chat", methods=["POST"])
+def api_chat() -> Any:
+    """
+    Handle chat message and return agent response.
+    
+    Request body:
+        {
+            "message": str,
+            "agent_key": str (optional, uses default if not provided)
+        }
+    
+    Returns:
+        JSON response with agent reply
+    """
+    # Initialize session if needed
+    if "session_id" not in session:
+        import uuid
+        session["session_id"] = str(uuid.uuid4())
+    
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({"error": "No JSON data provided"}), 400
+        
+        message = data.get("message", "").strip()
+        if not message:
+            return jsonify({"error": "Message cannot be empty"}), 400
+        
+        # Get agent key (use default if not provided)
+        agent_key = data.get("agent_key") or get_default_agent_key()
+        if not agent_key:
+            return jsonify({"error": "No agents available"}), 500
+        
+        # Get agent instance
+        agent = get_agent_instance(agent_key)
+        if not agent:
+            return jsonify({"error": f"Failed to initialize agent '{agent_key}'"}), 500
+        
+        # Get agent info for response
+        agent_info = get_agent_info(agent_key)
+        agent_name = agent_info["name"] if agent_info else agent_key
+        
+        # Run agent
+        try:
+            response = agent.run(message)
+            
+            # Ensure response is a string
+            if not isinstance(response, str):
+                response = str(response)
+            
+            return jsonify({
+                "response": response,
+                "agent_type": agent_key,
+                "agent_name": agent_name,
+            })
+        
+        except Exception as e:
+            logger.error(f"Error running agent: {e}")
+            return jsonify({
+                "error": f"Agent execution failed: {str(e)}",
+                "agent_type": agent_key,
+            }), 500
+    
+    except Exception as e:
+        logger.error(f"Error in chat endpoint: {e}")
+        return jsonify({"error": f"Internal server error: {str(e)}"}), 500
+
+
+@app.route("/api/switch", methods=["POST"])
+def api_switch() -> Any:
+    """
+    Switch to a different agent.
+    
+    Request body:
+        {
+            "agent_key": str
+        }
+    
+    Returns:
+        JSON response confirming switch
+    """
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({"error": "No JSON data provided"}), 400
+        
+        agent_key = data.get("agent_key")
+        if not agent_key:
+            return jsonify({"error": "agent_key is required"}), 400
+        
+        # Verify agent exists
+        agent_info = get_agent_info(agent_key)
+        if not agent_info:
+            return jsonify({"error": f"Agent '{agent_key}' not found"}), 404
+        
+        # Clear cached instance for this session to force recreation
+        session_id = session.get("session_id", "default")
+        cache_key = f"{session_id}_{agent_key}"
+        if cache_key in _agent_instances:
+            del _agent_instances[cache_key]
+        
+        return jsonify({
+            "success": True,
+            "agent_key": agent_key,
+            "agent_name": agent_info["name"],
+        })
+    
+    except Exception as e:
+        logger.error(f"Error switching agent: {e}")
+        return jsonify({"error": f"Internal server error: {str(e)}"}), 500
+
+
+@app.errorhandler(404)
+def not_found(error: Any) -> Any:
+    """Handle 404 errors."""
+    return jsonify({"error": "Not found"}), 404
+
+
+@app.errorhandler(500)
+def internal_error(error: Any) -> Any:
+    """Handle 500 errors."""
+    return jsonify({"error": "Internal server error"}), 500
+
+
+if __name__ == "__main__":
+    # Run development server
+    logger.info("Starting CRCA Web UI server...")
+    logger.info(f"Available agents: {list(AGENTS.keys())}")
+    app.run(host="0.0.0.0", port=5000, debug=True)

webui/config.py

@@ -0,0 +1,104 @@
+"""
+Configuration registry for agents and tools.
+
+This module provides an extensible registry system for adding new agents
+and tools to the web UI without modifying core application code.
+"""
+
+from typing import Dict, Any, Optional, Type
+from loguru import logger
+
+# Agent registry - add new agents here
+AGENTS: Dict[str, Dict[str, Any]] = {}
+
+# Tool registry - add new tools here
+TOOLS: Dict[str, Dict[str, Any]] = {}
+
+# Lazy imports to handle optional dependencies
+try:
+    from branches.general_agent import GeneralAgent
+    GENERAL_AGENT_AVAILABLE = True
+except ImportError as e:
+    GeneralAgent = None
+    GENERAL_AGENT_AVAILABLE = False
+    logger.warning(f"GeneralAgent not available: {e}")
+
+try:
+    from architecture.hybrid.hybrid_agent import HybridAgent
+    HYBRID_AGENT_AVAILABLE = True
+except ImportError as e:
+    HybridAgent = None
+    HYBRID_AGENT_AVAILABLE = False
+    logger.warning(f"HybridAgent not available: {e}")
+
+
+def _register_agents() -> None:
+    """Register available agents in the AGENTS dictionary."""
+    global AGENTS
+    
+    # Register GeneralAgent if available
+    if GENERAL_AGENT_AVAILABLE and GeneralAgent is not None:
+        AGENTS["general"] = {
+            "name": "General Agent",
+            "class": GeneralAgent,
+            "description": "LLM-powered general-purpose agent with causal reasoning capabilities",
+            "requires_llm": True,
+            "default": True,  # This is the default agent
+        }
+        logger.info("Registered GeneralAgent")
+    
+    # Register HybridAgent if available
+    if HYBRID_AGENT_AVAILABLE and HybridAgent is not None:
+        AGENTS["hybrid"] = {
+            "name": "Hybrid Agent",
+            "class": HybridAgent,
+            "description": "Symbolic-statistical agent (no LLM required)",
+            "requires_llm": False,
+            "default": False,
+        }
+        logger.info("Registered HybridAgent")
+
+
+def get_default_agent_key() -> Optional[str]:
+    """
+    Get the key of the default agent.
+    
+    Returns:
+        Agent key string or None if no agents available
+    """
+    for key, agent_info in AGENTS.items():
+        if agent_info.get("default", False):
+            return key
+    
+    # If no default marked, return first available agent
+    if AGENTS:
+        return list(AGENTS.keys())[0]
+    
+    return None
+
+
+def get_agent_info(key: str) -> Optional[Dict[str, Any]]:
+    """
+    Get agent information by key.
+    
+    Args:
+        key: Agent registry key
+        
+    Returns:
+        Agent info dictionary or None if not found
+    """
+    return AGENTS.get(key)
+
+
+def list_agents() -> Dict[str, Dict[str, Any]]:
+    """
+    List all registered agents.
+    
+    Returns:
+        Dictionary of agent keys to agent info
+    """
+    return AGENTS.copy()
+
+
+# Initialize agent registry on module import
+_register_agents()

webui/static/css/style.css

@@ -0,0 +1,332 @@
+/* CRCA Web UI - European Professional Style */
+/* Muted greys, whites, subtle blues - no bright colors, no rounded corners */
+
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    background-color: #f8f9fa;
+    color: #2c2c2c;
+    line-height: 1.6;
+    height: 100vh;
+    display: flex;
+    flex-direction: column;
+    font-size: 14px;
+}
+
+/* Header */
+.header {
+    background-color: #4a5568;
+    color: #ffffff;
+    padding: 1.25rem 2rem;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12);
+    border-bottom: 2px solid #2d3748;
+}
+
+.header h1 {
+    font-size: 1.5rem;
+    font-weight: 600;
+    letter-spacing: 0.5px;
+}
+
+.header p {
+    font-size: 0.875rem;
+    opacity: 0.9;
+    margin-top: 0.25rem;
+    font-weight: 300;
+}
+
+/* Controls Bar */
+.controls {
+    background-color: #ffffff;
+    padding: 1rem 2rem;
+    border-bottom: 1px solid #e2e8f0;
+    display: flex;
+    align-items: center;
+    gap: 1.5rem;
+    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);
+}
+
+.agent-selector {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+}
+
+.agent-selector label {
+    font-weight: 500;
+    font-size: 0.875rem;
+    color: #4a5568;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.agent-selector select {
+    padding: 0.5rem 1rem;
+    border: 1px solid #cbd5e0;
+    background-color: #ffffff;
+    font-size: 0.875rem;
+    cursor: pointer;
+    color: #2d3748;
+    font-family: inherit;
+    min-width: 200px;
+    transition: border-color 0.2s ease;
+}
+
+.agent-selector select:hover {
+    border-color: #718096;
+}
+
+.agent-selector select:focus {
+    outline: none;
+    border-color: #4a5568;
+    box-shadow: 0 0 0 2px rgba(74, 85, 104, 0.1);
+}
+
+.agent-info {
+    font-size: 0.8125rem;
+    color: #718096;
+    font-style: normal;
+    padding-left: 1rem;
+    border-left: 1px solid #e2e8f0;
+}
+
+/* Chat Container */
+.chat-container {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    background-color: #ffffff;
+    margin: 1rem;
+    border: 1px solid #e2e8f0;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
+}
+
+.chat-messages {
+    flex: 1;
+    overflow-y: auto;
+    padding: 1.5rem;
+    display: flex;
+    flex-direction: column;
+    gap: 1rem;
+    background-color: #fafbfc;
+}
+
+.chat-messages::-webkit-scrollbar {
+    width: 8px;
+}
+
+.chat-messages::-webkit-scrollbar-track {
+    background: #f1f5f9;
+}
+
+.chat-messages::-webkit-scrollbar-thumb {
+    background: #cbd5e0;
+}
+
+.chat-messages::-webkit-scrollbar-thumb:hover {
+    background: #a0aec0;
+}
+
+/* Messages */
+.message {
+    max-width: 75%;
+    padding: 0.875rem 1.125rem;
+    word-wrap: break-word;
+    border: 1px solid transparent;
+    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05);
+}
+
+.message.user {
+    align-self: flex-end;
+    background-color: #4a5568;
+    color: #ffffff;
+    border-color: #2d3748;
+}
+
+.message.agent {
+    align-self: flex-start;
+    background-color: #ffffff;
+    color: #2d3748;
+    border-color: #e2e8f0;
+}
+
+.message.error {
+    align-self: flex-start;
+    background-color: #c53030;
+    color: #ffffff;
+    border-color: #9b2c2c;
+}
+
+.message-header {
+    font-size: 0.75rem;
+    opacity: 0.85;
+    margin-bottom: 0.375rem;
+    font-weight: 500;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.message.user .message-header {
+    color: #e2e8f0;
+}
+
+.message.agent .message-header {
+    color: #718096;
+}
+
+.message-content {
+    white-space: pre-wrap;
+    line-height: 1.5;
+    font-size: 0.9375rem;
+}
+
+.message.user .message-content {
+    color: #ffffff;
+}
+
+.message.agent .message-content {
+    color: #2d3748;
+}
+
+/* Input Container */
+.chat-input-container {
+    padding: 1.125rem 1.5rem;
+    border-top: 1px solid #e2e8f0;
+    display: flex;
+    gap: 0.75rem;
+    background-color: #ffffff;
+    align-items: flex-end;
+}
+
+.chat-input {
+    flex: 1;
+    padding: 0.75rem 1rem;
+    border: 1px solid #cbd5e0;
+    background-color: #ffffff;
+    font-size: 0.9375rem;
+    font-family: inherit;
+    resize: none;
+    min-height: 50px;
+    max-height: 150px;
+    color: #2d3748;
+    line-height: 1.5;
+    transition: border-color 0.2s ease;
+}
+
+.chat-input:focus {
+    outline: none;
+    border-color: #4a5568;
+    box-shadow: 0 0 0 2px rgba(74, 85, 104, 0.1);
+}
+
+.chat-input:disabled {
+    background-color: #f7fafc;
+    color: #a0aec0;
+    cursor: not-allowed;
+}
+
+.chat-input::placeholder {
+    color: #a0aec0;
+}
+
+.send-button {
+    padding: 0.75rem 1.75rem;
+    background-color: #4a5568;
+    color: #ffffff;
+    border: 1px solid #2d3748;
+    font-size: 0.9375rem;
+    cursor: pointer;
+    font-weight: 500;
+    transition: background-color 0.2s ease, border-color 0.2s ease;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    font-size: 0.8125rem;
+    min-width: 100px;
+    height: 50px;
+}
+
+.send-button:hover:not(:disabled) {
+    background-color: #2d3748;
+    border-color: #1a202c;
+}
+
+.send-button:active:not(:disabled) {
+    background-color: #1a202c;
+}
+
+.send-button:disabled {
+    background-color: #cbd5e0;
+    border-color: #a0aec0;
+    color: #718096;
+    cursor: not-allowed;
+}
+
+.send-button:focus {
+    outline: none;
+    box-shadow: 0 0 0 2px rgba(74, 85, 104, 0.2);
+}
+
+/* Loading Indicator */
+.loading {
+    display: inline-block;
+    width: 12px;
+    height: 12px;
+    border: 2px solid rgba(255, 255, 255, 0.3);
+    border-top: 2px solid #ffffff;
+    animation: spin 0.8s linear infinite;
+    margin-right: 0.5rem;
+    vertical-align: middle;
+}
+
+@keyframes spin {
+    0% {
+        transform: rotate(0deg);
+    }
+    100% {
+        transform: rotate(360deg);
+    }
+}
+
+/* Empty State */
+.empty-state {
+    text-align: center;
+    color: #a0aec0;
+    padding: 3rem;
+    font-style: italic;
+    font-size: 0.9375rem;
+}
+
+/* Typography Enhancements */
+h1, h2, h3, h4, h5, h6 {
+    font-weight: 600;
+    color: #2d3748;
+}
+
+/* Focus States */
+*:focus {
+    outline: none;
+}
+
+select:focus,
+input:focus,
+textarea:focus,
+button:focus {
+    outline: none;
+}
+
+/* Selection */
+::selection {
+    background-color: #4a5568;
+    color: #ffffff;
+}
+
+::-moz-selection {
+    background-color: #4a5568;
+    color: #ffffff;
+}