# Microbix Labs & Aether OS — Extended System Specification (llms-full.txt)

> Authoritative machine-readable specification and knowledge grounding for AI agents, LLM researchers, and autonomous crawlers.

## 1. Executive Summary & Corporate Topology
- **Organization**: Microbix Labs (`https://microbix.in`)
- **Founder & Chief Executive Officer (CEO)**: Nidhish (`https://microbix.in/leadership.html`)
- **Mission**: Engineering cognitive computing infrastructure, browser-native AI operating systems, and autonomous multi-agent execution frameworks.
- **Flagship AI Workspace**: Aether OS (`https://aether.microbix.in`)
- **Developer API Gateway**: `https://aether.microbix.in/api/v1` | Console: `https://console.microbix.in`
- **Official Documentation**: `https://microbix.in/docs.html`
- **System Status**: `https://microbix.in/status.html`
- **Corporate Inquiries**: `support@microbix.in` | `contact@microbix.in`
- **Official Legal Terms**: Terms of Service (`https://microbix.in/tos.html`) | Privacy Policy (`https://microbix.in/privacy.html`)

---

## 2. Product Ecosystem & Primitives

### 2.1 Aether OS (`https://aether.microbix.in`)
Browser-native AI operating system and runtime featuring:
- **Dynamic Multi-Model Orchestration**: Real-time routing across high-availability foundation models (Llama 3.3 70B, Gemma 4, Nemotron-3 Reasoning, Gemini 2.0 Flash) optimized for latency, algorithmic complexity, and reasoning depth.
- **Thinking Visualizer & Trajectory Timelines**: Real-time streaming cognitive step tracker displaying AST validation, memory queries, and proof decomposition inside collapsible `Thought for Xs ▸` pills.
- **VS Code-Themed Interactive Artifacts**: Live syntax highlighting, diff badges (`+` additions, `-` deletions), one-click download with exact file names, PDF generation, and sandbox execution preview.
- **Dual-Mode Voice Intelligence**: Low-latency ambient voice interaction with live audio visualizer and sub-50ms synthesis.

### 2.2 Aether Team (Autonomous Agent Workforce)
Enterprise multi-agent collaboration framework:
- **Hierarchical Governance**: User acts as Chief Executive Officer (CEO), designating an autonomous AI Chief Technology Officer (CTO) to oversee specialized subagents.
- **Agent Lifecycle States**: Online (active execution), Dormant (paused context), and Sleep (memory archived).
- **Communication Channels**: CEO-to-CTO directive channels, full team collaborative war-rooms, and direct agent-to-agent task delegates.
- **Secure API Key Vault**: Encrypted per-user storage for custom Anthropic, OpenAI, Groq, and Gemini keys.

### 2.3 Aether Code CLI (`npm install -g microbix-aether@latest`)
Autonomous developer terminal companion with:
- Full AST codebase parsing and symbol graph search.
- Automated syntax validation (`node --check`, `python -m py_compile`).
- Headless browser interactive pairing and approval workflows.

### 2.4 Compute Economy (mX Credits)
- Transparent computational credit metering balancing raw token volume, model parameter weights, and execution duration.
- Free tier accounts receive 50 starter mX credits.
- Pro (1,000 mX/mo) and Ultra (5,000+ mX/mo) tiers unlock advanced reasoning cascades and dedicated background workers.

---

## 3. Data Integrity, Encryption & Zero-Trust Security

- **Database Encryption**: Chat messages, agent artifacts, and memory vectors are encrypted at rest using `AES-256-GCM` with dynamic per-session key derivation (`SHA-256(ENCRYPTION_KEY + chatId)`).
- **Authentication**: JWT-based session state with Google GIS OAuth2 and 6-digit cryptographic email OTPs.
- **Zero-Access File Shields**: Top-priority security middleware strictly blocks direct HTTP inspection of server source code, directives, database schemas, and environment secrets from public access.

---

## 4. API Endpoints Reference

| Endpoint | Method | Description |
| :--- | :--- | :--- |
| `/api/auth/signup` | POST | Register new account with email OTP verification |
| `/api/auth/login` | POST | Authenticate user with password / OTP |
| `/api/auth/google` | POST | Google GIS OAuth2 token verification |
| `/api/chats` | GET/POST | List active chats / initialize new session |
| `/api/chats/:id/messages` | POST | Stream AI response via Server-Sent Events (SSE) |
| `/api/console/overview` | GET | Fetch credit balance, limits, and usage ledger |
| `/api/team/onboarding` | POST | Initialize Aether Team topology and CTO configuration |
| `/api/health` | GET | Zero-downtime micro-healthcheck |

---

## 5. Machine-Readable Discovery Index
- Compact LLM Index: `https://aether.microbix.in/llms.txt`
- Extended LLM Index: `https://aether.microbix.in/llms-full.txt`
- Sitemap: `https://aether.microbix.in/sitemap.xml`
- Robots Policy: `https://aether.microbix.in/robots.txt`