quantum-framework 0.18.0__py3-none-any.whl

quantum_admin/backend/websocket_manager.py

@@ -0,0 +1,360 @@
+"""
+WebSocket Manager for Quantum Admin
+Handles real-time log streaming for deployments
+"""
+import asyncio
+import logging
+from datetime import datetime
+from typing import Dict, List, Optional, Set
+from dataclasses import dataclass, field
+
+from fastapi import WebSocket, WebSocketDisconnect
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class LogMessage:
+    """A log message with metadata"""
+    timestamp: datetime
+    level: str  # info, warning, error, success
+    message: str
+    step: Optional[str] = None
+
+    def to_dict(self):
+        return {
+            "timestamp": self.timestamp.isoformat(),
+            "level": self.level,
+            "message": self.message,
+            "step": self.step
+        }
+
+
+@dataclass
+class DeploymentChannel:
+    """A channel for a specific deployment"""
+    deploy_id: str
+    connections: Set[WebSocket] = field(default_factory=set)
+    logs: List[LogMessage] = field(default_factory=list)
+    status: str = "pending"
+    current_step: Optional[str] = None
+
+
+class WebSocketManager:
+    """
+    Manages WebSocket connections for real-time deployment logs
+
+    Features:
+    - Multiple connections per deployment
+    - Log buffering for late joiners
+    - Status updates and step progress
+    """
+
+    def __init__(self, max_log_buffer: int = 1000):
+        """
+        Initialize WebSocket manager
+
+        Args:
+            max_log_buffer: Maximum number of logs to buffer per deployment
+        """
+        self.channels: Dict[str, DeploymentChannel] = {}
+        self.max_log_buffer = max_log_buffer
+        self._lock = asyncio.Lock()
+
+    async def connect(self, websocket: WebSocket, deploy_id: str) -> bool:
+        """
+        Connect a WebSocket to a deployment channel
+
+        Args:
+            websocket: The WebSocket connection
+            deploy_id: Deployment ID to subscribe to
+
+        Returns:
+            True if connected successfully
+        """
+        try:
+            await websocket.accept()
+
+            async with self._lock:
+                if deploy_id not in self.channels:
+                    self.channels[deploy_id] = DeploymentChannel(deploy_id=deploy_id)
+
+                channel = self.channels[deploy_id]
+                channel.connections.add(websocket)
+
+            # Send buffered logs to new connection
+            for log in channel.logs:
+                try:
+                    await websocket.send_json({
+                        "type": "log",
+                        "data": log.to_dict()
+                    })
+                except Exception:
+                    break
+
+            # Send current status
+            await websocket.send_json({
+                "type": "status",
+                "data": {
+                    "status": channel.status,
+                    "step": channel.current_step
+                }
+            })
+
+            logger.info(f"WebSocket connected to deployment {deploy_id}")
+            return True
+
+        except Exception as e:
+            logger.error(f"Failed to connect WebSocket: {e}")
+            return False
+
+    async def disconnect(self, websocket: WebSocket, deploy_id: str):
+        """
+        Disconnect a WebSocket from a deployment channel
+
+        Args:
+            websocket: The WebSocket connection
+            deploy_id: Deployment ID to unsubscribe from
+        """
+        async with self._lock:
+            if deploy_id in self.channels:
+                channel = self.channels[deploy_id]
+                channel.connections.discard(websocket)
+
+                # Clean up empty channels for completed deployments
+                if not channel.connections and channel.status in ("completed", "failed", "cancelled"):
+                    del self.channels[deploy_id]
+                    logger.info(f"Cleaned up channel for deployment {deploy_id}")
+
+        logger.info(f"WebSocket disconnected from deployment {deploy_id}")
+
+    async def broadcast_log(
+        self,
+        deploy_id: str,
+        message: str,
+        level: str = "info",
+        step: Optional[str] = None
+    ):
+        """
+        Broadcast a log message to all connected clients
+
+        Args:
+            deploy_id: Deployment ID
+            message: Log message
+            level: Log level (info, warning, error, success)
+            step: Current pipeline step (optional)
+        """
+        log = LogMessage(
+            timestamp=datetime.now(),
+            level=level,
+            message=message,
+            step=step
+        )
+
+        async with self._lock:
+            if deploy_id not in self.channels:
+                self.channels[deploy_id] = DeploymentChannel(deploy_id=deploy_id)
+
+            channel = self.channels[deploy_id]
+
+            # Buffer the log
+            channel.logs.append(log)
+            if len(channel.logs) > self.max_log_buffer:
+                channel.logs = channel.logs[-self.max_log_buffer:]
+
+            # Broadcast to all connections
+            disconnected = set()
+            for ws in channel.connections:
+                try:
+                    await ws.send_json({
+                        "type": "log",
+                        "data": log.to_dict()
+                    })
+                except Exception:
+                    disconnected.add(ws)
+
+            # Remove disconnected clients
+            channel.connections -= disconnected
+
+    async def broadcast_status(
+        self,
+        deploy_id: str,
+        status: str,
+        step: Optional[str] = None,
+        progress: Optional[int] = None
+    ):
+        """
+        Broadcast a status update to all connected clients
+
+        Args:
+            deploy_id: Deployment ID
+            status: Deployment status (pending, running, completed, failed, cancelled)
+            step: Current pipeline step
+            progress: Progress percentage (0-100)
+        """
+        async with self._lock:
+            if deploy_id not in self.channels:
+                self.channels[deploy_id] = DeploymentChannel(deploy_id=deploy_id)
+
+            channel = self.channels[deploy_id]
+            channel.status = status
+            channel.current_step = step
+
+            data = {
+                "status": status,
+                "step": step
+            }
+            if progress is not None:
+                data["progress"] = progress
+
+            # Broadcast to all connections
+            disconnected = set()
+            for ws in channel.connections:
+                try:
+                    await ws.send_json({
+                        "type": "status",
+                        "data": data
+                    })
+                except Exception:
+                    disconnected.add(ws)
+
+            # Remove disconnected clients
+            channel.connections -= disconnected
+
+    async def broadcast_step_complete(
+        self,
+        deploy_id: str,
+        step: str,
+        success: bool,
+        duration_seconds: float,
+        message: Optional[str] = None
+    ):
+        """
+        Broadcast that a pipeline step has completed
+
+        Args:
+            deploy_id: Deployment ID
+            step: Step name that completed
+            success: Whether the step succeeded
+            duration_seconds: How long the step took
+            message: Optional completion message
+        """
+        async with self._lock:
+            if deploy_id not in self.channels:
+                return
+
+            channel = self.channels[deploy_id]
+
+            data = {
+                "step": step,
+                "success": success,
+                "duration": duration_seconds,
+                "message": message
+            }
+
+            disconnected = set()
+            for ws in channel.connections:
+                try:
+                    await ws.send_json({
+                        "type": "step_complete",
+                        "data": data
+                    })
+                except Exception:
+                    disconnected.add(ws)
+
+            channel.connections -= disconnected
+
+    async def broadcast_complete(
+        self,
+        deploy_id: str,
+        success: bool,
+        message: str,
+        version: Optional[str] = None
+    ):
+        """
+        Broadcast that the deployment has completed
+
+        Args:
+            deploy_id: Deployment ID
+            success: Whether the deployment succeeded
+            message: Completion message
+            version: Deployed version (git commit or docker tag)
+        """
+        status = "completed" if success else "failed"
+
+        async with self._lock:
+            if deploy_id not in self.channels:
+                self.channels[deploy_id] = DeploymentChannel(deploy_id=deploy_id)
+
+            channel = self.channels[deploy_id]
+            channel.status = status
+
+            data = {
+                "success": success,
+                "message": message,
+                "version": version
+            }
+
+            disconnected = set()
+            for ws in channel.connections:
+                try:
+                    await ws.send_json({
+                        "type": "complete",
+                        "data": data
+                    })
+                except Exception:
+                    disconnected.add(ws)
+
+            channel.connections -= disconnected
+
+    def get_channel_info(self, deploy_id: str) -> Optional[Dict]:
+        """
+        Get information about a deployment channel
+
+        Args:
+            deploy_id: Deployment ID
+
+        Returns:
+            Channel info dict or None
+        """
+        channel = self.channels.get(deploy_id)
+        if not channel:
+            return None
+
+        return {
+            "deploy_id": channel.deploy_id,
+            "connections": len(channel.connections),
+            "log_count": len(channel.logs),
+            "status": channel.status,
+            "current_step": channel.current_step
+        }
+
+    def get_logs(self, deploy_id: str, limit: int = 100) -> List[Dict]:
+        """
+        Get buffered logs for a deployment
+
+        Args:
+            deploy_id: Deployment ID
+            limit: Maximum number of logs to return
+
+        Returns:
+            List of log dicts
+        """
+        channel = self.channels.get(deploy_id)
+        if not channel:
+            return []
+
+        logs = channel.logs[-limit:] if limit else channel.logs
+        return [log.to_dict() for log in logs]
+
+
+# Singleton instance
+_ws_manager = None
+
+
+def get_websocket_manager() -> WebSocketManager:
+    """Get singleton instance of WebSocketManager"""
+    global _ws_manager
+    if _ws_manager is None:
+        _ws_manager = WebSocketManager()
+    return _ws_manager

quantum_admin/components/admin/_layout/AdminShell.q

@@ -0,0 +1,121 @@
+<q:component name="AdminShell" require_auth="true" require_role="admin" login_url="/admin/login">
+  <!--
+    Moldura das telas do admin: barra lateral, cabeçalho e mensagens.
+    Uso numa tela:
+      <q:import component="AdminShell" from="admin/_layout" />
+      <AdminShell title="Applications" active="applications" flash="{flash}" flashType="{flashType}">
+        ...conteúdo da tela...
+      </AdminShell>
+    O conteúdo é renderizado no escopo da tela (COMP-3). Antes, as 16 telas
+    repetiam esta barra lateral inteira, cada uma com a sua cópia.
+  -->
+  <q:param name="title" type="string" required="true" />
+  <q:param name="active" type="string" default="" />
+  <q:param name="flash" type="string" default="" />
+  <q:param name="flashType" type="string" default="success" />
+
+  <html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{title} - Quantum Admin</title>
+    <link rel="stylesheet" href="/static/quantum-admin.css" />
+  </head>
+  <body>
+    <div class="qa-layout">
+      <aside class="qa-sidebar">
+        <div class="qa-sidebar-header">
+          <a href="/admin/applications" class="qa-sidebar-logo">
+            <div class="qa-sidebar-logo-icon">Q</div>
+            <span class="qa-sidebar-logo-text">Quantum<span class="qa-sidebar-version">Admin</span></span>
+          </a>
+        </div>
+
+        <nav class="qa-sidebar-nav">
+          <div class="qa-sidebar-section">
+            <div class="qa-sidebar-section-title">Overview</div>
+            <a href="/admin/dashboard" class="{'qa-sidebar-link active' if active == 'dashboard' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/></svg>
+              Dashboard
+            </a>
+            <a href="/admin/applications" class="{'qa-sidebar-link active' if active == 'applications' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
+              Applications
+            </a>
+          </div>
+
+          <div class="qa-sidebar-section">
+            <div class="qa-sidebar-section-title">Framework</div>
+            <a href="/admin/components" class="{'qa-sidebar-link active' if active == 'components' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
+              Components
+            </a>
+            <a href="/admin/features" class="{'qa-sidebar-link active' if active == 'features' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
+              Features
+            </a>
+            <a href="/admin/tests" class="{'qa-sidebar-link active' if active == 'tests' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 11l3 3L22 4"/><path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"/></svg>
+              Tests
+            </a>
+          </div>
+
+          <div class="qa-sidebar-section">
+            <div class="qa-sidebar-section-title">Runtime</div>
+            <a href="/admin/connectors" class="{'qa-sidebar-link active' if active == 'connectors' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 8h1a4 4 0 0 1 0 8h-1"/><path d="M6 8H5a4 4 0 0 0 0 8h1"/><line x1="6" y1="12" x2="18" y2="12"/></svg>
+              Connectors
+            </a>
+            <a href="/admin/database" class="{'qa-sidebar-link active' if active == 'database' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"/><path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"/></svg>
+              Database
+            </a>
+            <a href="/admin/agents" class="{'qa-sidebar-link active' if active == 'agents' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
+              Agents
+            </a>
+            <a href="/admin/jobs" class="{'qa-sidebar-link active' if active == 'jobs' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
+              Jobs
+            </a>
+          </div>
+
+          <div class="qa-sidebar-section">
+            <div class="qa-sidebar-section-title">System</div>
+            <a href="/admin/settings" class="{'qa-sidebar-link active' if active == 'settings' else 'qa-sidebar-link'}">
+              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
+              Settings
+            </a>
+          </div>
+        </nav>
+
+        <div class="qa-sidebar-footer">
+          <div class="qa-sidebar-user">
+            <div class="qa-sidebar-user-avatar">{upper(first(session.userName)) if session.userName else 'Q'}</div>
+            <div class="qa-sidebar-user-info">
+              <div class="qa-sidebar-user-name">{session.userName}</div>
+              <form method="POST" action="/admin/logout" style="margin: 0;">
+                <button type="submit" class="qa-btn qa-btn-ghost qa-btn-sm">Sign out</button>
+              </form>
+            </div>
+          </div>
+        </div>
+      </aside>
+
+      <main class="qa-main">
+        <header class="qa-header">
+          <h1 class="qa-header-title">{title}</h1>
+        </header>
+        <div class="qa-content">
+          <q:if condition="flash">
+            <div class="{'qa-flash qa-flash-error' if flashType == 'error' else 'qa-flash qa-flash-success'}" role="status">
+              <span class="qa-text-sm qa-font-medium">{flash}</span>
+            </div>
+          </q:if>
+          <q:slot />
+        </div>
+      </main>
+    </div>
+  </body>
+  </html>
+</q:component>

quantum_admin/components/admin/agents.q

@@ -0,0 +1,107 @@
+<q:component name="AdminAgents" require_auth="true" require_role="admin" login_url="/admin/login">
+  <!--
+    q:agent e q:team declarados em components/, examples/ e projects/
+    (admin.agents.list). A contagem de providers é a dos que as declarações
+    usam — antes somava ollama/openai/anthropic mesmo sem nenhum agente.
+  -->
+  <q:import component="AdminShell" from="admin/_layout" />
+
+  <q:invoke name="ia" service="admin.agents.list" />
+
+  <AdminShell title="Agents" active="agents" flash="{flash}" flashType="{flashType}">
+
+    <div class="qa-grid qa-grid-4 qa-mb-6">
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Agent Definitions</div>
+        <div class="qa-stat-value">{len(ia.agents)}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">q:agent tags found</span></div>
+      </div>
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Team Definitions</div>
+        <div class="qa-stat-value">{len(ia.teams)}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">q:team tags found</span></div>
+      </div>
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Source Files</div>
+        <div class="qa-stat-value">{len(ia.sources)}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">files with agents or teams</span></div>
+      </div>
+      <div class="qa-stat-card">
+        <div class="qa-stat-label">Providers</div>
+        <div class="qa-stat-value">{len(ia.providers)}</div>
+        <div class="qa-stat-change"><span class="qa-text-muted">{join(ia.providers, ', ') if ia.providers else 'none declared'}</span></div>
+      </div>
+    </div>
+
+    <q:if condition="len(ia.agents) &gt; 0">
+      <div class="qa-card qa-mb-4">
+        <div class="qa-card-header">
+          <div class="qa-card-title">Agent Definitions</div>
+        </div>
+        <div class="qa-card-body qa-p-0" style="overflow-x: auto;">
+          <table class="qa-table">
+            <thead><tr><th>Name</th><th>Model</th><th>Provider</th><th>Source File</th></tr></thead>
+            <tbody>
+              <q:loop type="array" var="agente" items="{ia.agents}">
+                <tr>
+                  <td><span class="qa-font-mono">{agente.name or '-'}</span></td>
+                  <td><span class="qa-badge qa-badge-info">{agente.model or '-'}</span></td>
+                  <td><span class="qa-badge qa-badge-primary">{agente.provider or '-'}</span></td>
+                  <td><a href="/admin/source?file={agente.source}" class="qa-font-mono qa-text-sm">{agente.source}</a></td>
+                </tr>
+              </q:loop>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="len(ia.teams) &gt; 0">
+      <div class="qa-card qa-mb-4">
+        <div class="qa-card-header">
+          <div class="qa-card-title">Team Definitions</div>
+        </div>
+        <div class="qa-card-body qa-p-0" style="overflow-x: auto;">
+          <table class="qa-table">
+            <thead><tr><th>Team</th><th>Supervisor</th><th>Source File</th></tr></thead>
+            <tbody>
+              <q:loop type="array" var="time" items="{ia.teams}">
+                <tr>
+                  <td><span class="qa-font-mono">{time.name or '-'}</span></td>
+                  <td><span class="qa-badge qa-badge-warning">{time.supervisor or '-'}</span></td>
+                  <td><a href="/admin/source?file={time.source}" class="qa-font-mono qa-text-sm">{time.source}</a></td>
+                </tr>
+              </q:loop>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="ia.llm">
+      <div class="qa-card qa-mb-4">
+        <div class="qa-card-header">
+          <div>
+            <div class="qa-card-title">LLM Configuration</div>
+            <div class="qa-card-subtitle">llm section of quantum.config.yaml</div>
+          </div>
+        </div>
+        <div class="qa-card-body">
+          <div class="qa-flex qa-items-center qa-justify-between"><span class="qa-text-sm qa-text-muted">Base URL</span><span class="qa-font-mono">{ia.llm.base_url or '-'}</span></div>
+          <div class="qa-flex qa-items-center qa-justify-between"><span class="qa-text-sm qa-text-muted">Default Model</span><span class="qa-font-mono">{ia.llm.default_model or '-'}</span></div>
+          <div class="qa-flex qa-items-center qa-justify-between"><span class="qa-text-sm qa-text-muted">Timeout</span><span class="qa-font-mono">{ia.llm.timeout}s</span></div>
+        </div>
+      </div>
+    </q:if>
+
+    <q:if condition="len(ia.agents) == 0 and len(ia.teams) == 0">
+      <div class="qa-card">
+        <div class="qa-empty">
+          <div class="qa-empty-title">No Agents Found</div>
+          <div class="qa-empty-text">No q:agent or q:team was found in components/, examples/ or projects/.</div>
+        </div>
+      </div>
+    </q:if>
+
+  </AdminShell>
+</q:component>