AIOS DNA

CONSOLE_UI_GUIDE

AIOS DNA Console UI Guide

Overview

The AIOS DNA Console is a comprehensive web-based interface that provides full access to all platform features, services, and capabilities. The console is accessible at http://localhost:3000 (or your configured frontend URL) after authentication.

Status: All 23 features are fully implemented and operational as of December 2024.

Features

Core Capabilities

  1. 23 Feature Tabs - ✅ All tabs fully implemented and functional
  2. Real-Time Updates - ✅ WebSocket connection for live data streaming with connection status indicator
  3. Interactive Forms - ✅ Create and manage resources directly from the UI (tenant creation, etc.)
  4. Search & Filtering - ✅ Find items quickly across large datasets (available on 7+ tabs)
  5. Charts & Visualizations - ✅ Visual representation of metrics and data (bar charts, progress bars)
  6. Detailed Views - ✅ Deep-dive into any item with full JSON details (modal view)
  7. Action Controls - ✅ Direct control over kernels, workflows, and services (pause/resume/drain)

Authentication

  1. Navigate to the login page
  2. Sign in with your credentials (or create an account via signup)
  3. Upon successful authentication, you'll be redirected to the console

Console Tabs

1. Overview

Purpose: High-level dashboard with key metrics and quick actions

Features:

  • Total Kernels count
  • Global Health status
  • Active Kernels count
  • Kernels by Domain (interactive cards)
  • Kernels Distribution chart (bar chart visualization)
  • Available Kernel Services (test connectivity)
  • Quick Actions (links to API endpoints)

Interactive Elements:

  • Click domain cards to filter kernels by domain
  • Test kernel connectivity buttons
  • Direct links to API documentation

2. Kernel Mesh

Purpose: Distributed kernel orchestration overview

Features:

  • Mesh state overview
  • Total nodes count
  • Global health status
  • Circuit breaker status
  • Kernel registry statistics

3. Kernels

Purpose: Individual kernel management and control

Features:

  • Search Bar: Filter kernels by ID or domain
  • Domain Filter: Dropdown to filter by specific domain
  • Kernel Cards: Each kernel displays:
    • Kernel ID (clickable for details)
    • Domain
    • Health status (healthy/degraded/unhealthy)
    • State (active/paused/draining)
  • Action Buttons:
    • Pause: Temporarily pause kernel operations
    • Resume: Resume paused kernels
    • Drain: Gracefully drain kernel (stop accepting new work)
    • View Details: Open detailed JSON view

Interactive Elements:

  • Search functionality
  • Domain filtering
  • Kernel control actions
  • Detailed view modal

4. Federated Memory

Purpose: Long-term, privacy-aware memory for agents

Features:

  • Memory objects list
  • Per-tenant data boundaries
  • Encryption status
  • Memory statistics

Interactive Elements:

  • Search functionality
  • View details for memory objects

5. PromptFlow

Purpose: Graph-based workflow builder for LLM chains

Features:

  • Workflow definitions
  • Versioning information
  • Approval status
  • Rollback capabilities

6. Workflows

Purpose: Workflow execution monitoring

Features:

  • Active workflow executions
  • Execution status
  • Performance metrics
  • Error tracking

Interactive Elements:

  • Search functionality
  • View execution details

7. SentinelX

Purpose: Security threat detection and response

Features:

  • Security events
  • Threat findings
  • Response actions
  • Security metrics

8. Security & Compliance

Purpose: Comprehensive security and compliance management

Features:

  • SentinelX Policies & Enforcement Points
  • RBAC (Role-Based Access Control)
  • Tenancy & Data Residency
  • Audit Logs & Evidence Collection
  • Compliance Report: SOC2, ISO27001, GDPR status

Interactive Elements:

  • View compliance controls
  • Audit log browsing
  • Compliance verification

9. Multi-Model Routing

Purpose: Smart routing across AI models

Features:

  • Available models (OpenAI, Anthropic, open-source, sovereign)
  • Routing rules
  • Cost and latency metrics
  • Compliance-based routing

10. Agent Marketplace

Purpose: Governed marketplace for AI agents

Features:

  • Published agents
  • Agent capabilities
  • Pricing information
  • Usage statistics

Interactive Elements:

  • Search functionality
  • View agent details

11. AGI Agents

Purpose: AGI agent management and monitoring

Features:

  • Overview Cards:
    • Active Agents count
    • Insight Chains count
    • Cognitive Loops count
    • Average Reasoning Depth
  • Agents List:
    • Agent name/ID
    • Domain
    • Capabilities count
    • State (active/inactive)
  • Insight Chains: Reasoning traceability
  • Cognitive Loops: Continuous learning cycles

Interactive Elements:

  • Search functionality
  • View agent details
  • View insight chain graphs

12. Billing & Revenue

Purpose: Monetization and revenue tracking

Features:

  • Revenue summary
  • Profitability metrics
  • Product catalog (SKUs)
  • Marketplace revenue
  • Cost breakdown
  • API key management

Interactive Elements:

  • Revenue charts
  • SKU management
  • Billing dashboard

13. Enterprise

Purpose: Enterprise-grade features

Features:

  • Overview Cards:
    • Active Processes
    • Total Profit
    • Revenue Strategies
    • Digital Twin Status
  • Process Management: DAG-based process execution
  • Enterprise Memory: Business object graph
  • KPI Engine: Enterprise KPIs with attribution
  • Revenue Engine: Revenue optimization
  • Governance: Audit logging and compliance
  • Human-AI Bridge: Approval workflows
  • Digital Twin: Enterprise digital representation
  • Resource Planner: Budget-aware scaling

Interactive Elements:

  • Search functionality
  • Process creation
  • KPI tracking
  • Revenue strategy management

14. SLOs

Purpose: Service Level Objective monitoring

Features:

  • SLO status by domain
  • Error budgets
  • Violations tracking
  • SLO definitions

15. Chaos Engineering

Purpose: Resilience testing and validation

Features:

  • Chaos scenarios list
  • Experiment results
  • Resilience reports
  • Scenario execution controls

Interactive Elements:

  • View scenario details
  • Run chaos experiments
  • View resilience reports

16. Incidents

Purpose: Incident management and tracking

Features:

  • Active incidents count
  • Incident list with details
  • Incident analytics
  • Mitigation tracking

Interactive Elements:

  • Search functionality
  • View incident details
  • Mitigate incidents
  • Close incidents

17. Analytics

Purpose: Launch analytics and business intelligence

Features:

  • Metrics Cards:
    • Page Views
    • CTA Clicks
    • Lead Conversions
  • Analytics Chart: Visual distribution of metrics
  • Timeseries data access

Interactive Elements:

  • Interactive bar charts
  • Timeseries data viewing

18. Autonomous

Purpose: Autonomous operations and self-improvement

Features:

  • Discovered opportunities
  • Corporate Brain status
  • Autonomous skill generation
  • Agent auto-generation
  • Workflow evolution

Interactive Elements:

  • View opportunities
  • Corporate Brain controls
  • Autonomous operation status

19. Commercial

Purpose: Commercial features and tenant management

Features:

  • Create Tenant Form:
    • Tenant name input
    • Plan selection (Free/Pro/Enterprise)
    • Domain selection (comma-separated)
  • Tenant provisioning
  • SLA management
  • Customer lifecycle
  • Billing operations

Interactive Elements:

  • Tenant creation form
  • SLA definition
  • Customer lifecycle management
  • Billing operations

20. Customer ROI

Purpose: Customer ROI tracking and success metrics

Features:

  • ROI percentage
  • Success dashboard
  • ROI experiments
  • Customer success metrics

21. Stability

Purpose: Reliability and hardening management

Features:

  • Reliability envelope scores
  • Hardening checklist
  • Golden signals monitoring
  • Consistency auditing

Interactive Elements:

  • View reliability scores by domain
  • Hardening validation
  • Golden signals dashboard

22. Onboarding

Purpose: Customer onboarding flows

Features:

  • Onboarding flow templates
  • Customer type templates
  • Flow execution status

Interactive Elements:

  • Create onboarding flows
  • Execute flows
  • View flow templates

23. PoV

Purpose: Proof-of-Value kit generation

Features:

  • PoV deployment management
  • Kit generation
  • Deployment status

Interactive Elements:

  • Generate PoV kits
  • Deploy PoV kits
  • View deployment details

Real-Time Updates

WebSocket Connection

The console maintains a WebSocket connection to /ops/stream for real-time updates:

  • Connection Status: ✅ Shown as a "Live" badge in the bottom-right corner when connected
  • Auto-Reconnect: ✅ Automatically attempts to reconnect if disconnected (5-second retry)
  • Update Types:
    • ✅ Mesh updates (mesh_overview state updates)
    • ✅ Kernel status changes (triggers kernel list refresh)
    • ✅ Workflow execution updates (triggers workflow list refresh)
    • ✅ Incident updates (triggers incident list refresh)

Refresh Mechanism

  • Manual Refresh: Click the "Refresh" button in the header
  • Auto-Refresh: Data refreshes every 30 seconds
  • Real-Time: WebSocket updates appear immediately

Interactive Features

Search & Filtering

Available On:

  • Kernels tab (search + domain filter)
  • Workflows tab
  • AGI Agents tab
  • Enterprise tab
  • Incidents tab
  • Marketplace tab
  • Memory tab

Features:

  • Real-time search as you type
  • Multi-field search (searches across ID, name, domain, etc.)
  • Clear search button
  • Domain-specific filtering (Kernels tab)

Forms & Actions

Create Operations:

  • Tenant Creation (Commercial tab):
    • Form with name, plan, and domains
    • Validates input
    • Creates tenant via API
    • Refreshes data on success

Control Operations:

  • Kernel Actions (Kernels tab):
    • Pause: Temporarily stop kernel
    • Resume: Restart paused kernel
    • Drain: Gracefully stop accepting new work
    • All actions refresh data after execution

Detailed Views

Modal Detail View:

  • Click any item (kernel, agent, etc.) to view details
  • Full JSON representation
  • Scrollable content
  • Close button or click outside to dismiss

Access Methods:

  • Click on item name/ID
  • Click "View Details" button
  • Some items have direct API links

Charts & Visualizations

Chart Types:

  1. Bar Charts:
    • Kernels Distribution (Overview tab)
    • Analytics Metrics (Analytics tab)
  2. Progress Bars:
    • Domain distribution
    • Metric percentages

Interactive Elements:

  • Hover effects
  • Clickable domain cards (filter kernels)
  • Animated transitions

Keyboard Shortcuts

  • Escape: Close detail view modal
  • Enter: Submit forms
  • Tab: Navigate between form fields

Best Practices

For Operators

  1. Monitor Overview Tab: Check global health and kernel counts regularly
  2. Use Search: Quickly find specific kernels or agents
  3. Real-Time Updates: Keep WebSocket connection active for live monitoring
  4. Kernel Control: Use Pause/Resume for maintenance, Drain for graceful shutdowns
  5. Detailed Views: Use detail modals to troubleshoot issues

For Administrators

  1. Compliance Tab: Regularly review audit logs and compliance status
  2. Security Tab: Monitor SentinelX findings and actions
  3. Analytics Tab: Track business metrics and conversions
  4. Commercial Tab: Manage tenants and billing
  5. Stability Tab: Monitor reliability scores and golden signals

For Developers

  1. API Links: Use "View API" links to access Swagger documentation
  2. WebSocket: Monitor real-time updates for debugging
  3. Detail Views: Inspect full JSON for API integration
  4. Test Connections: Use kernel connectivity tests in Overview tab

Troubleshooting

Tabs Not Visible

  • Solution: Use horizontal scroll on the tab bar
  • All 23 tabs are available, scroll to see more

WebSocket Not Connecting

  • Check: Backend WebSocket endpoint is running
  • Fallback: Data still refreshes every 30 seconds via polling
  • Indicator: "Live" badge will not appear if disconnected

Search Not Working

  • Check: Ensure you're on a tab that supports search
  • Clear: Use the X button to clear search and see all items

Forms Not Submitting

  • Check: All required fields are filled
  • Check: Network connection to backend
  • Check: Browser console for errors

API Integration

All console features integrate with the backend API:

  • Base URL: Configured via NEXT_PUBLIC_API_URL (default: http://localhost:8000)
  • Authentication: Bearer token stored in localStorage
  • CORS: Enabled for cross-origin requests
  • WebSocket: Connects to ws://localhost:8000/ops/stream

Browser Support

  • Chrome/Edge: Full support
  • Firefox: Full support
  • Safari: Full support
  • Mobile: Responsive design, some features may be limited

Performance

  • Initial Load: < 2 seconds
  • Tab Switch: < 100ms
  • Search: Real-time, no delay
  • WebSocket: < 50ms latency
  • Auto-Refresh: Every 30 seconds

Security

  • Authentication: Required for all access
  • Token Storage: Secure localStorage
  • HTTPS: Recommended for production
  • CORS: Configured for allowed origins
  • XSS Protection: React's built-in protections

Future Enhancements

Planned improvements:

  • Export data to CSV/JSON
  • Customizable dashboards
  • Alert configuration UI
  • Bulk operations
  • Advanced filtering options
  • Dark/Light theme toggle
  • Keyboard navigation improvements

Implementation Status

Last Updated: December 2024

✅ Complete Implementation

All 23 console features are fully implemented and operational:

  • ✅ Overview - Dashboard with kernel health, tenant info, self-healing activity, resilience checks
  • ✅ Kernel Mesh - Mesh state overview with nodes count, health status, domain distribution
  • ✅ Kernels - Full kernel management with search, domain filter, pause/resume/drain actions
  • ✅ Federated Memory - Memory objects list with search
  • ✅ PromptFlow - Workflow definitions with versioning and approval status
  • ✅ Workflows - Execution monitoring with search and status tracking
  • ✅ SentinelX - Security events and threat findings
  • ✅ Security & Compliance - Compliance reports and audit logs
  • ✅ Multi-Model Routing - Model routes with cost and latency metrics
  • ✅ Agent Marketplace - Published agents with search
  • ✅ AGI Agents - Agent management with overview cards, search, and metrics
  • ✅ Billing & Revenue - Revenue summary, charts, and SKU management
  • ✅ Enterprise - Process management, KPIs with search
  • ✅ SLOs - SLO status by domain, error budgets, and violations
  • ✅ Chaos Engineering - Scenarios list and resilience reports
  • ✅ Incidents - Incident list with search and mitigation tracking
  • ✅ Analytics - Metrics cards and bar charts
  • ✅ Autonomous - Opportunities discovery and status
  • ✅ Commercial - Tenant creation form with validation
  • ✅ Customer ROI - ROI percentage and success metrics
  • ✅ Stability - Reliability scores by domain
  • ✅ Onboarding - Onboarding flows with status tracking
  • ✅ PoV - PoV deployment management

Key Features Implemented

  • ✅ WebSocket connection for real-time updates with connection status indicator
  • ✅ Detail view modal for viewing full JSON of any item
  • ✅ Search and filtering on 7+ tabs (Kernels, Workflows, AGI Agents, Enterprise, Incidents, Marketplace, Memory)
  • ✅ Domain filtering on Kernels tab
  • ✅ Interactive kernel actions (pause/resume/drain)
  • ✅ Tenant creation form with validation
  • ✅ Comprehensive error handling and loading states
  • ✅ Responsive design for all tabs
  • ✅ Auto-refresh on tab switch
  • ✅ Real-time data updates via WebSocket

Support

For issues or questions:

  • Check API documentation: /docs endpoint
  • Review logs: Browser console and backend logs
  • Contact: Support team or check documentation

Was this helpful?