# Artigo Técnico: Runtime & AI Gateway OmniRoute — PCL AEOS

==================================================
1. VISÃO GERAL DO RUNTIME DE INFERÊNCIA E ORQUESTRAÇÃO
==================================================

O Runtime do **PCL AEOS** é a camada responsável pela execução das chamadas de inferência de IA, roteamento dinâmico de prompts, prompt caching e exibição do painel de orquestração de agentes.

---

## 2. COMPONENTES CHAVE DO RUNTIME

### 1. **OmniRoute AI Gateway** (Porta `:20130`)
- **EBITDA Shield**: Cache semântico de prompts para evitar re-computação de contextos idênticos e economizar custos de tokens.
- **Fallback Dinâmico**: Roteamento transparente. Se uma GPU local falhar ou estourar a memória (OOM), o OmniRoute direciona a requisição para provedores de nuvem (Gemini / Claude / OpenAI) sem quebrar a sessão do agente.
- **Token Budgeting**: Limite de tokens por agente e sessão com logs de telemetria enviados ao `pcl-db`.

### 2. **PaperClip Dashboard** (Porta `:3100`)
- Painel web de orquestração em tempo real dos 15 papéis de agentes.
- Visualização de estados dos agentes, logs de execução por Execution Cell e triggers de tarefas.

---

## 3. CICLO DE VIDA DA REQUISIÇÃO DE INFERÊNCIA

```mermaid
sequenceDiagram
    autonumber
    participant Agent as Agente IA
    participant Omni as OmniRoute Gateway (:20130)
    participant Cache as EBITDA Shield Cache
    participant GPU as GPU Local (Ollama/LM Studio)
    participant Cloud as Cloud LLM (Gemini/Claude)

    Agent->>Omni: POST /v1/chat/completions (Prompt)
    Omni->>Cache: Checa Hash de Prompt no Cache
    alt Cache Hit (EBITDA Shield)
        Cache-->>Omni: Retorna Resposta Cacheada (0 Cost)
        Omni-->>Agent: Resposta Instantânea
    else Cache Miss
        Omni->>GPU: Tenta Inferência na GPU Local
        alt GPU Sucesso
            GPU-->>Omni: Retorna Tokens Gerados
        else GPU OOM / Off-line (Fallback)
            Omni->>Cloud: Roteia para Provider Cloud
            Cloud-->>Omni: Retorna Resposta Cloud
        end
        Omni->>Cache: Salva Resposta no Cache
        Omni-->>Agent: Resposta Final + Métricas
    end
```

---

## 4. INTEGRAÇÃO COM OS DIAGRAMAS INTERATIVOS
- 🟡 **[seq-omniroute-routing.html](file:///c:/PromptCore_Labs/projects/Living%20Architecture%20PCL%20AEOS/diagrams/interactive/seq-omniroute-routing.html)**: Ciclo de vida da requisição no OmniRoute.
- 🟡 **[seq-tripartite-memory-drp.html](file:///c:/PromptCore_Labs/projects/Living%20Architecture%20PCL%20AEOS/diagrams/interactive/seq-tripartite-memory-drp.html)**: Ciclo de vida da Memória Tripartida & DRP.
- 🟡 **[life-cortex-micro-loop.html](file:///c:/PromptCore_Labs/projects/Living%20Architecture%20PCL%20AEOS/diagrams/interactive/life-cortex-micro-loop.html)**: Ciclo de vida do micro-loop de execução dos agentes.

---

## 5. RESILIÊNCIA & MEMÓRIA TRIPARTIDA
- **Cold SQL Backup (Longo Prazo)**: Snapshots de `pcl-db` compactados e criptografados em AES-256 enviados para o Cloudflare R2 (`pcl-backup-memoria-tripartida`).
- **Disaster Recovery Plan (DRP)**: SLAs de RPO $\le$ 1h/24h e RTO $\le$ 15min. Restauração executada via `restore-aeos-tripartido.ps1`.
- **MCP Server Cloudflare**: Integração com a IDE para monitoramento e gestão do ecossistema.