- Base: código de producción de srvv-nexxa (1.2.1), importado y verificado por hash (P335/F3) - Pools por individuo (lib_pools): mente y red, mezclan proveedores, keys compartidas o exclusivas - API: /disponible/mente|red y /estado por rol, pool_vacio explícito, /pools (CRUD admin), liberar admin - Revertir el agotada propio + motivo y quién la agotó (de P334/F4) - nexxa-web: sección Pools, motivo y botón Liberar, provider libre con sugerencias, escape de texto externo - Convención REG002: lib_*, cli_*, tool_humo_pool; contratos externos con su nombre - Suite local sobre copia aislada: humo HTTP, pools, revertir; servidor_prueba para mirar la web Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: GEMMA <noreply@gemma.dtic>
7.1 KiB
Germen — Individuo Circulatorio (rm-apid06-nexxa)
Entregar este archivo como primer mensaje a la IA ejecutora del nacimiento
Este germen NO es el de OpenClaw (Miguel, r-WEBs, PEGGY, ABBY). Aquellos hacen nacer un agente LLM-céntrico con gateway y canal conversacional. Tampoco es el de RUBBY, que aunque es chasis F1 nativo determinístico en runtime, sí lleva un Arquitecto (LLM) para génesis offline de piezas nuevas. NEXXA nace sin ningún LLM, en ninguna capa, ni siquiera para su propia génesis (decisión del Operador, P200/Fase2) — el organismo más minimalista del linaje hasta hoy. Reutiliza el proceso de nacimiento de RUBBY (checkpoints por etapa, separación script/individuo, secrets por env, gate entre etapas), no su contenido.
Tu misión
Hacer nacer el organismo mínimo viable de rotación/fallback de API keys para
el equipo F1. De cara afuera, NEXXA responde consultas de sus pares vía
apids chat sobre qué key/provider está disponible ahora; por dentro es un
registro de estado (cuotas por provider) y una lógica de decisión puramente
determinística — sin capa de razonamiento en ningún punto del camino.
El diseño ya está hecho — no lo reinventes. El delta de dominio completo
vive en _docs/RM-LABs/rm-APIDs/D045_diseno-nexxa-f1.md (repo dtic-GEMMA), y el
modelo F1 base en D025. Tu trabajo es materializarlo, no rediseñarlo. Si
algo del diseño no cierra contra la realidad del hábitat, lo reportás y esperás
decisión — no improvisás una variante.
Principio rector — diseño como objetivo, no receta: este germen te da el qué (el organismo a lograr, sus restricciones, su criterio de vida). El cómo (estructura exacta de los archivos Ruby, comandos) lo investigás y resolvés vos contra el hábitat real.
Etapa 1 — Relevamiento (antes de tocar nada)
Hábitat:
- La LXC
rm-apid06-nexxaen srv-pmox2 (VMID y recursos definidos en la corrida de creación — ver Fase 3 del plan P200). Confirmá que existe, que arranca y que tenés acceso SSH a ella. - Ruby disponible dentro de la LXC. Es el único sustrato — no hay Node/OpenClaw acá.
- NEXXA no necesita salida propia a internet para su función central (consulta estado de cuotas que ya le llegaron por registro, no llama a los providers directamente para verificar salud, al menos en el alcance mínimo de este nacimiento — D045 §3 deja el contrato exacto a cerrar en esta misma fase).
Secrets — protocolo estricto, sin excepciones (ME-293):
- NEXXA no tiene key LLM propia (no hay Arquitecto). Los secrets que sí maneja
son las keys de terceros que registra en su base (Gemini/Groq/… de otros
individuos) — nunca en el
.confversionado, siempre en.envo vía candados, nunca en argv (ME-293). - Verificás presencia de secrets contando, sin mostrar valores.
Al cerrar el relevamiento: resumen (sin valores de secrets) y confirmación explícita del operador antes de la Etapa 2.
Etapa 2 — El organismo a materializar (el objetivo, no la receta)
Del diseño D045, dos órganos — ninguno con LLM:
-
Registro de cuotas (
registro.jsono similar — nombre exacto a definir contra el hábitat) — una sola fuente de verdad. Cada entrada:provider,email/identificador de la key,dueño(individuo consumidor ocompartida),disponible_desde(mismo cálculo queapirot.rb,ultimo_uso + reset). Delta sobre apirot (D045/P200 Fase2-2.3): NEXXA nace con registro propio y limpio, inspirado en el concepto de apirot pero no dependiente de su código ni de su archivo — apirot.rb sigue existiendo tal cual para uso interno de GEMMA. -
Router de consulta (
maestro.rbo equivalente mínimo) — matching exactoestímulo → respuesta de estado, cero semántica en runtime, cero LLM. Ante consulta "¿qué key uso para provider X?": busca en el registro la primera condisponible_desde <= ahora; si ninguna, responde explícito y accionable (ej.GEMINI: agotado, próxima en 2h15m), nunca silencioso (D045 §0, patrón ya usado en el linaje).
Sin Arquitecto, sin telemetría de génesis (a diferencia de RUBBY/D025 §5): no hay génesis reactiva que medir — si en el futuro hace falta una pieza nueva, la escribe GEMMA/Operador a mano (ver nota de arquitectura compartida futura, inbox ME de P200/Fase2).
Restricciones heredadas del linaje (no las redescubras):
- Gobernanza en código, nunca declarada solo en docs.
- El código del organismo vive versionado en el repo, no solo dentro del LXC (srv-pmox2 es RAID0 sin redundancia).
- Nunca proxy/interceptor de tráfico de modelo, nunca MCP (restricciones heredadas de P199, D045 §0).
Presentás el plan de materialización al operador y esperás aprobación antes de ejecutar.
Etapa 3 — Nacimiento por checkpoints (reutiliza el patrón RUBBY/r-WEBs)
STAGE |
Qué nace | Gate de la etapa |
|---|---|---|
esqueleto |
Registro de cuotas + router, con 0 keys cargadas | El router arranca, lee registro vacío, responde "sin datos" ante una consulta de prueba |
conexion |
Canal apids chat verificado de punta a punta (patrón ya usado con ABBY/MIGUEL/RUBBY/PEGGY) + al menos 1 key real cargada (vía candados, no génesis) |
Una consulta real por apids chat devuelve el estado correcto de esa key |
servicio |
Servicio systemd + onboot=1 — el organismo revive tras reinicio del hipervisor |
El servicio levanta el router solo; sobrevive a un reinicio de la LXC |
Secrets siempre por env exportado o candados. Al cerrar cada etapa: verificás, registrás, y esperás OK del operador antes de la siguiente.
Criterio de vida (qué es "nació bien")
El organismo está vivo cuando, sin intervención:
- Responde una consulta real de un par (
apids chat) sobre disponibilidad de una key/provider, con el dato correcto. - Responde explícito y accionable cuando no hay ninguna key disponible (nunca silencioso).
- El servicio revive tras un reinicio de la LXC.
Primer caso real de aplicación (Fase 4 del plan P200): ABBY-F1 consulta a NEXXA para sus 3 keys de Gemini — no es parte de este nacimiento, es el smoke test posterior.
individuo.conf (parámetros — el operador completa)
# Identidad
NOMBRE=NEXXA # bautizado por el Operador (2026-08-02) — concepto de switch/conmutación
MAQUINA=rm-apid06-nexxa
VMID=(a definir en Fase 3)
IP=(a definir en Fase 3 — requiere aprobación explícita del Operador, nunca se asigna sin OK)
HABITAT=srv-pmox2
# Función
PROPOSITO=rotación/fallback de API keys para el equipo F1 — alcance mínimo (no el "sistema circulatorio" amplio de ME-289)
# Sin Arquitecto — NEXXA no tiene key LLM propia, no genera piezas nuevas por su cuenta
Referencias
- Delta de dominio:
_docs/RM-LABs/rm-APIDs/D045_diseno-nexxa-f1.md(dtic-GEMMA) - Modelo F1 base:
D025_diseno-fundacional-rubby-f1.md - Plan:
_docs/RM-LABs/p_P200_*.md(dtic-GEMMA) - Precedente de proceso:
rm-apid01-rubby/germen.md(checkpoints, etapas, gate) - ME: 289, 292, 293, 330, 331, 335, 417, 468