Protocolos internos · 0.1.0
Límites de servicios internos
Los protocolos de analizador, actualizador y conector Advisor se documentan aparte de la API de control.
La referencia de la API está en inglés.
Estos protocolos conectan componentes internos del entorno. Son interfaces de implementación, no puntos de integración admitidos para terceros. Usa la API de control con los permisos de cliente admitidos para los flujos de aplicación.
Asigna una responsabilidad acotada a cada servicio
Coordinador
- Worker de trabajos
Controla la operación duradera y los vínculos exactos con servicios.
Protocolos separados
- Protocolo del analizador
Ejecuciones acotadas, hallazgos paginados y acuse explícito del resultado.
- Protocolo del actualizador
Preparación y reconciliación de componentes revisados sin acceso al código de proyectos.
- Protocolo del conector Advisor
Trabajo vinculado a concesiones, destinos y estado de cancelación exactos.
Conexiones
Worker de trabajos a Protocolo del analizador
Recoge y persiste el resultado exacto antes de confirmar limpieza.
Worker de trabajos a Protocolo del actualizador
Sigue identidad y digest de solicitud durante preparación y recuperación.
Worker de trabajos a Protocolo del conector Advisor
Emite solo los permisos del proveedor necesarios para la solicitud prevista.
| Servicio | Llamante y recursos | Responsabilidad del protocolo |
|---|---|---|
| Analizador | Worker; código autorizado, instantáneas y caché validada de solo lectura | Admisión de ejecuciones, estado, hallazgos acotados, confirmación del resultado exacto y cancelación. |
| Actualizador de datos | API/worker; caché escribible y salida hacia descargas revisadas | Preparación duradera y publicación de generaciones completas, sin acceso al código de proyectos. |
| Conector Advisor | Worker; autorización dedicada y rutas de red aprobadas | Pruebas de proveedor, generación, observación y cancelación con permisos acotados. |
El núcleo solo publica su relé de entrada loopback. Estos servicios no son endpoints del sitio público. Red interna del analizador y salidas del actualizador y Advisor son distintas en Compose. Los montajes y redes declarados necesitan verificarse en imágenes y contenedores antes de tratarlos como aislamiento observado.
Analizador de ejecución
El worker inicia una ejecución estable con POST /runs, observa estado y lee páginas acotadas de hallazgos. Identidad de ejecución y digest de solicitud impiden sustituir otro comando bajo la ejecución existente. El manifiesto sellado añade digest del resultado, recuentos, identidad del flujo, resumen y declaraciones de artefactos.
Los cursores vinculan ejecución, solicitud, resultado y posición exactos. El worker valida todo el flujo antes de publicar en la base. POST /runs/{run_id}/result/ack libera el resultado temporal exacto después de persistirlo. Cancelación y limpieza mediante DELETE /runs/{run_id} deben conservar el vínculo correcto de solicitud y resultado; no son borrados arbitrarios de archivos.
Registro de ejecuciones y cola de recuperación son locales al proceso y limitados en tiempo. Reiniciar el analizador no conserva la cola como evidencia duradera. Su respuesta de salud tampoco establece que binarios, reglas y bases estén preparados. Consulta rutas, control de ejecuciones y confirmación antes de ACK.
Actualizador sin acceso al código
Recibe operaciones duraderas vinculadas a UUID y digest de solicitud. Su ejecutor recupera el estado y gestiona trabajo activo y pendiente acotado. Los handlers resuelven componentes revisados, preparan candidatos privados, los validan y sellan, y publican una generación completa. No aceptan rutas arbitrarias de repositorio, URL de descarga o comandos shell como sustitutos del catálogo revisado.
El límite HTTP privado exige Host permitido y rechaza headers de host o protocolo reenviados. Es una barrera adicional, no una razón para exponerlo públicamente. El actualizador no monta código de proyectos; el analizador consume la caché validada en solo lectura.
Activación y cancelación tienen resultados distintos. Cuando la publicación entra en su confirmación protegida, cancelar no puede interrumpirla ni revertir la selección. La reversión es otra operación validada y exige datos anteriores compatibles y vigentes. Consulta inicio y límite de solicitudes, rutas de operaciones y arquitectura de preparación.
Conector Advisor
Trabajo local y remoto pasan por el conector. El worker reserva o admite una operación acotada, presenta la concesión exigida y pide generación. El conector comprueba ruta y modelo autorizados, y valida la respuesta. Tiene material de autorización dedicado y no monta código; el worker aporta el paquete de hallazgo admitido.
La generación remota exige el flujo de un solo hallazgo confirmado por separado. La confirmación vincula configuración, autorización, transporte, destino, identidad del modelo, revisión del hallazgo y hash del prompt. La selección automática y de todo el análisis sigue siendo solo local. El transporte remoto admite rutas Ollama directas o SSH revisadas, no proveedores arbitrarios.
Admisión, observación y cancelación son endpoints explícitos. Cancelar puede detener trabajo posterior, pero no retirar contenido enviado. El worker vuelve a validar el consejo y lo descarta si el hallazgo cambió durante la generación. No modifica automáticamente ciclo de vida ni política del control.
Consulta operaciones y generación del conector, integración del worker y vínculo de divulgación.
Lee el protocolo junto a su implementación
La referencia interna describe declaraciones en su snapshot API identificado. Algunos handlers leen y validan JSON directamente; un esquema amplio generado no expresa todas las claves, vínculos o condiciones de autorización. Lee handler y llamante juntos al cambiar un protocolo.
Los esquemas por sí solos no prueban inicio, accesibilidad, autorización de proveedor, recuperación o soporte de integración. Cambiar protocolos exige validación coordinada entre servicio y llamante y pruebas de rechazo y recuperación. Las integraciones públicas no deben depender de la estabilidad de estos endpoints.