Camada de Entrada (Frontend)

Interface React/TanStack Start de baixa latência. Renderiza estados do fluxo, coleta intenção humana e exibe telemetria. Nenhuma decisão é tomada aqui.

Camada de Orquestração (Núcleo Agêntico)

Fluxos sequenciais, paralelos e hierárquicos com supervisor que avalia complexidade e despacha para RAG clássico (consultas simples) ou agentes especialistas (decisões complexas).

Camada de Conectividade e Ferramentas (MCP)

Padronização segura de ferramentas via contratos JSON (handshake, execução, resposta). Toda chamada passa pelo guardrail e registra telemetria.

Camada de Conhecimento e Recuperação (RAG & Dados)

Vetores (pgvector) + grafos de conhecimento, com memória episódica isolada e indexação temporal para evitar State Drift entre sessões.

Roteador inteligente

RAG clássico para consultas simples; agentes hierárquicos apenas quando a complexidade justifica o custo de latência e tokens.

Guardrails e portão humano

Nenhuma ação de escrita ou comando via MCP ocorre sem validação humana. O estado APPROVAL_GATE é obrigatório e inegociável.

Memória episódica isolada

Indexação temporal no Data Layer impede contaminação de contexto entre sessões e elimina deriva de estado acumulada.

mcp_handshake.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "protocol_version": {
      "type": "string",
      "example": "1.0"
    },
    "client_info": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "mindcore-omniflow"
        },
        "version": {
          "type": "string",
          "example": "3.0"
        }
      },
      "required": [
        "name",
        "version"
      ]
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "example": [
        "rag",
        "tools"
      ]
    }
  },
  "required": [
    "protocol_version",
    "client_info",
    "capabilities"
  ]
}

mcp_tool_execution.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "example": "rag.search"
    },
    "execution_context": {
      "type": "object",
      "properties": {
        "session_id": {
          "type": "string",
          "example": "sess_01J…"
        },
        "security_tier": {
          "type": "string",
          "enum": [
            "read",
            "write",
            "admin"
          ],
          "example": "read"
        }
      },
      "required": [
        "session_id",
        "security_tier"
      ]
    },
    "arguments": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "tool_name",
    "execution_context",
    "arguments"
  ]
}

mcp_response.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "SUCCESS",
        "FAILED",
        "PENDING_HUMAN_APPROVAL"
      ],
      "example": "SUCCESS"
    },
    "data": {
      "type": "object",
      "description": "Resultado bruto gerado pela ferramenta executada."
    },
    "telemetry": {
      "type": "object",
      "properties": {
        "latency_ms": {
          "type": "integer",
          "example": 342
        },
        "tokens_consumed": {
          "type": "integer",
          "example": 185
        },
        "guardrail_checked": {
          "type": "boolean",
          "example": true
        }
      },
      "required": [
        "latency_ms",
        "tokens_consumed",
        "guardrail_checked"
      ]
    }
  },
  "required": [
    "status",
    "data",
    "telemetry"
  ]
}