1. La Premisa Arquitectónica
En los wrappers habituales y plataformas de agentes autónomos contemporáneos, el modelo de lenguaje opera simultáneamente como motor de inferencia, pasarela de almacenamiento, coordinador de sesión y despachador de herramientas. Si el modelo alucina o sufre una inyección de prompt, toda la frontera de seguridad colapsa.
TELHAR separa estas responsabilidades en planos arquitectónicos independientes, con ciclos de vida ortogonales y contratos estrictos. La cognición propone planes; la política dicta legalidad; la Puerta de Efecto ejecuta; y la evidencia custodia un registro inmutable.
2. Los Cinco Planos en Detalle
Plano de Memoria — Mnḗmē (ai/mneme)
Mnḗmē no es una base de datos vectorial genérica. Es un plano de memoria gobernado que preserva el contexto continuo de la persona a través de distintas superficies. Soporta decaimiento temporal, indexación semántica con pgvector y Qdrant, cifrado mediante claves DEK respaldadas por KMS, y aislamiento a nivel de fila (RLS).
Plano Cognitivo — Praxis y ARK (Agent Runtime Kernel)
El plano cognitivo gestiona la interpretación de lenguaje natural, la descomposición de tareas, el ensamblaje de contexto y la planificación. Opera bajo el Kernel de Runtime de Agentes (ARK), un autómata FSM cuyas propiedades de terminación y ausencia de livelock han sido formalmente verificadas mediante model checking en TLA+ (TLC 1.8.0, 149 estados).
Plano de Política — Foedus (security/foedus)
El Punto de Decisión de Política (PDP) único de la arquitectura. Escrito en TypeScript y Open Policy Agent (Rego), Foedus evalúa convenios explícitos por inquilino. Cualquier acción o acceso no permitido explícitamente es denegado por defecto (fail-closed).
Plano de Evidencia — Explorator y Refuto
Sustituye la confianza ciega por demostraciones empíricas. Explorator descubre inteligencia externa mediante guardas de red fail-closed y procedencia comprobable de fuentes. Refuto aporta el arnés de aseguramiento independiente que asegura que ningún agente evalúe su propio resultado.
Plano de Experiencia — Experience Platform (platform/experience)
Un único núcleo de resolución proyectado sobre múltiples modalidades perceptuales: Web (Next 15), Escritorio (Tauri 2), Móvil (React Native) y Terminal (Rust TUI). Cada modalidad se trata como un adaptador perceptual puro, sin reimplementar lógica de negocio.
3. La Puerta de Efecto Única (Chokepoint en Gateway)
Cualquier efecto colateral en el mundo exterior —escritura de archivos, llamadas a APIs externas, creación de procesos o comunicaciones de red— fluye obligatoriamente a través de la **Puerta de Efecto** en core/gateway. La puerta aplica 7 controles secuenciales:
- Autenticación e Identidad: Verificación criptográfica del token del principal (RS256).
- Aislamiento de Inquilino: Validación de fronteras de workspace y claves de inquilino.
- Límites de Tasa y Presupuesto: Techos de costos y tokens fail-closed. Superar el umbral detiene la ejecución de inmediato.
- Evaluación PDP en Foedus: Consulta sincrónica OPA. Respuestas distintas de ALLOW cancelan la invocación.
- Vinculación al Hash del Plan: Verificación del hash de un solo uso (
approvedSetHash) ligado al turno del usuario. - Atenuación de Tokens de Capacidad: Comprobación de que la capacidad fue derivada en el kernel sin escalación.
- Validación de Idempotencia: Inspección de cachés de deduplicación para prevenir efectos secundarios duplicados.
4. Topología del Ecosistema: Los 10 Servicios de la Columna Vertebral
Si bien la organización de TELHAR en GitLab abarca 51 proyectos modulares en 12 subgrupos de dominio, el runtime en vivo converge sobre 10 servicios troncales fundamentales que imponen invariantes matemáticas y arquitectónicas:
Arquitectura de Física Perceptual y Óptica de Materiales (ai/aesthesis)
A diferencia del glassmorphism superficial de CSS con valores arbitrarios de desenfoque y opacidad, ai/aesthesis deriva todo su comportamiento visual a partir de magnitudes físicas rigurosas:
El cristal se identifica por sus fronteras: reflejo rasante de Schlick Fresnel (R(θ≈85°)), lóbulo especular de Blinn-Phong (s = 2/α² - 2) y transmitancia de Beer-Lambert (T = exp(-σ·d)).
Separa la sombra de contacto densa de la penumbra ambiental difusa. Un único vector de luz (θ = 118°) gobierna simultáneamente el barrido especular, el gradiente del bisel y el desplazamiento de sombra.
Evita zonas de luminancia media ilegibles (L ≈ 0.44–0.60). El contraste del texto se calcula contra el fondo del lienzo, garantizando |Lc| ≥ 60 en todos los preajustes.
INSPECTOR DE SUPERFICIE PERCEPTUAL DE FRONTERA (AESTHESIS)
Evaluación matemática en vivo de 94 materiales físicos en 6 familias: óptica física, contraste APCA-W3, simulación CVD y transitorios multimodales.
"An agent cannot be the judge of itself. The sensory membrane enforces continuous physical laws: energy conservation in GGX microfacets, APCA dead-band contrast bounds, and strict invariant fences."
Telemetría de Contraste APCA-W3 APCA-W3
Deficiencia de Visión Cromática (Simulación CVD) Brettel / Machado
Sonda Sensorial Multimodal LRA + EBU R128
5. Cancelación de Agentes: Invariante de Autoridad Humana
En TELHAR, la agencia humana es un invariante de diseño en el código, no una aspiración retórica. Cuando una persona solicita la cancelación de un turno de agente:
- Autoridad Exclusiva: Solo el individuo soberano puede solicitar cancelación vía HTTP autenticado (
/v1/agent-runs/:runId/cancelar). - Cero Autoridad del Modelo: El modelo de IA carece de cualquier atribución para retrasar, omitir o rechazar su propia cancelación.
- Propagación Determinista:
AgentRunServiceasientacancelRequestedAtde forma idempotente y propaga la orden haciatelhar-cli(serve.rs). - Frontera de Ejecución: La acción en curso concluye su paso acotado, pero ningún acto posterior es despachado. El turno concluye en estado terminal
CANCELLED.
6. Autoridad por Contrato y Esquemas Canónicos
TELHAR rechaza los contratos implícitos y las cargas JSON informales. El sistema está gobernado por 29 esquemas formales en contracts/schemas, versionados bajo SemVer estricto y serializados de manera determinista conforme al estándar RFC-8785 (Canonical JSON).
7. Topología Objetivo y Gobernanza Continua
La arquitectura objetivo a 5–10 años (Documento 11) se guía por una consolidación radical: colapsar hacia lo real. El sistema impone un único punto de entrada e inspección sin puertas traseras:
Invariantes de Identidad y Tokens
IdP único (core/sso), exclusivamente RS256/JWKS, cero atajos o bypass con HS256/HMAC. La comunicación entre servicios internos opera estrictamente con mTLS o tokens firmados.
Aislamiento de Inquilinos y Row-Level Security
La separación entre inquilinos no depende de cláusulas WHERE manuales y frágiles. Postgres Row-Level Security (RLS) actúa como salvaguarda a nivel de base de datos bajo cada consulta en Mnḗmē.